bpluginfo(8)

NAME
bpluginfo - Bacula Plugin information utility

SYNOPSIS
bplufinfo [options] plugin_filename.so

DESCRIPTION

The main purpose of bpluginfo is to display different information about Bacula plugin. You can use it to check a plugin name, author, license and short description. You can use additional '-a' option for validating a Bacula Daemons API. In most cases it is not required.

OPTIONS
A summary of options is included below.

-h  Show usage of the program.

-v  Verbose information printing all available data from the plugin, including plugin header and implemented API.

-i  Display short information from plugin header only. This is a default option. Option incompatible with -f option.

-f  Display information about implemented API functions.

-a <api>
    You can supply the plugin initialization function with a particular Bacula API number. Without this option a default API number is '1'. Option require a numeric argument.

RETURN CODE
bpluginfo returns 0 on success, and non-zero on error.

You can check return code to find what was a cause of the error.
     * 0 - success
     * 1 - cannot load a plugin
     * 2 - cannot find a loadPlugin function
     * 3 - cannot find an unloadPlugin function
     * 10 - not enough memory

EXAMPLE USAGE
This is an example of bplufinfo usage with verbose option (-v) and default plugin.

    $ bpluginfo -v bpipe-fd.so

    Plugin type:            File Daemon plugin
    Plugin magic:           *FDPluginData*
    Plugin version:         1
    Plugin release date:    January 2008
    Plugin author:          Kern Sibbald
    Plugin license:         Bacula AGPLv3
    Plugin description:     Bacula Pipe File Daemon Plugin
    Plugin API version:     6

    Plugin functions:
     newPlugin()
     freePlugin()
     getPluginValue()
     setPluginValue()
     handlePluginEvent()
     startBackupFile()
     endBackupFile()
     startRestoreFile()
     endRestoreFile()
     pluginIO()
     createFile()
     setFileAttributes()

AUTHOR
Written by Radoslaw Korzeniewski (c) Inteos Sp. z o.o.

BUGS
Does not handle all required bacula functions callbacks which can lead to utility crash.

REPORTING BUGS
Report bugs to <support@inteos.pl>.

COPYRIGHT
Copyright © 2012 Free Software Foundation Europe e.V.
This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

SEE ALSO
bacula-dir, bacula-sd, bacula-fd, Bacula Plugins API