amsamba − Amanda Application to interface with smbclient

     Amsamba is an Amanda Application API script. It should
not be run by users directly. It uses smbclient to backup
and restore data.

     The diskdevice in the disklist (DLE) must have the form
containing the data to be backed up, SHARE is the share to
connect, and subdir is the subdirectory to backup. '/subdir'
can be ommited, in which case the complete share is

     Unlike most applications, amsamba backs up and restores
data located on a different system from that where amsamba
itself runs. The host containing the data is the CIFS host.
In practice, amsamba is usually run on the same system as
the Amanda server, with a DLE like

localhost "//CIFSHOST/SHARENAME" amsamba−dumptype

     Include or exclude can be used, but not both. The path
for 'exclude list' or 'include list' must be absolute path
on the CIFS host. The estimate calculates the complete size
of the share, without regard for include or exclude
directives. It will be larger than the actual dump if you
use include or exclude. Using 'estimate server' in the
dumptype could give better estimate.

     This section lists the properties that control
amsamba's functionality. See amanda‐applications(7) for
information on application properties and how they are


     The path to the smbclient binary.  The default is set
     when Amanda is built by the −−with−smbclient configure


     The path to the gnutar binary.  The default is set when
     Amanda is built by the −−with−gnutar configure option.
     gnutar is used to create the index.


     Location of the amandapass file, defaulting to
     "$CONFIG_DIR/amandapass".  Relative pathnames are


     relative to the configuration directory,
     "$CONFIG_DIR/<config>".  Note that this file is located
     on the client, not on the server.  The format of the
     file is as follow:
       Sharename User%Password Domain

     Sharename is '//HOST/SHARE' without the SUBDIR.
     Sharename can be quoted, it can be '*' to match all
     share, it can be '//pc−host/*' to match all share on
     pc−host.  User is the username use to connect to the
     share.  Password is the password use to connect to the
     share.  '%Password' is optional if the user can connect
     to the share without password.  'User%Password' is
     optional, the user 'guest' without password is use to
     connect to the share.  Domain is optional. Example:
       //another−pc/share otheruser%otherpw domain
       //another−pc/share otheruser%otherpw
       //another−pc/share myuser mydomain
       //another−pc/share myuser


     This username without password is used to connect to
     the share if no matching entry is found in the
     amandapass file.


     For restore command only, the data is recoved in that
     directory. Must be a unix path for "tar" RECOVER−MODE
     or a smb path for "smb" recover−MODE.


     "tar" or "smb", default to "tar". If "tar", the data is
     recovered on the local machine, If "smb", the data is
     recovered on the smb client machine.


     If set to "YES", amsamba use the 'r' tarmode which uses
     regex to do the include and exclude pattern matching,
     it can be slow.

     This application supplies exclude lists via the
smbclient−TX option. Normal shell−style wildcard
expressions, using * and ?, are not supported. All
expressions are matched only from the base directory of the
DLE. Expressions that match a directory may have a leading
or trailing "/". Example expressions:


  ./temp−files           # exclude top−level dir "temp−files" entirely
  ./temp−files/          # same
  /temp−files            # same
  temp−files             # same
  ./temp−files/*         # BAD: does nothing
  *.iso                  # BAD: does nothing
  proxy/local/cache      # exclude "cache" in dir "proxy/local"

     Include lists are supported only if excludes are not
given. They are handled via the smbclient−TI option. Include
matching is identical to the exclude matching described

  define application app_amsamba {
    property "SMBCLIENT−PATH" "/usr/bin/smbclient"
    property "GNUTAR−PATH" "/bin/tar"
    property "AMANDAPASS" /etc/amandapass"
    property "ALLOW−ANONYMOUS" "guest"

     amanda(8), amanda.conf(5), amanda‐applications(7)

     The Amanda Wiki: :

     Jean−Louis Martineau <>
     Zmanda, Inc. (