docs/textdocs/SMBTAR.notes

   1
   2 Intro
   3 -----
   4
   5 sambatar is just a small extension to the smbclient program distributed with
   6 samba. A basic front end shell script, smbtar, is provided as an interface
   7 to the smbclient extensions.
   8
   9 Extensions
  10 ----------
  11
  12 This release adds the following extensions to smbclient,
  13
  14 tar [c|x] filename
  15   creates or restores from a tar file. The tar file may be a tape
  16 or a unix tar file. tar's behaviour is modified with the newer and tarmode
  17 commands.
  18
  19 tarmode [full|inc|reset|noreset]
  20   With no arguments, tarmode prints the current tar mode (by default full,
  21 noreset). In full mode, every file is backed up during a tar command.
  22 In incremental, only files with the dos archive bit set are backed up.
  23 The archive bit is reset if in reset mode, or left untouched if in noreset.
  24 In reset mode, the share has to be writable, which makes sambatar even
  25 less secure. An alternative might be to use tarmode inc noreset which
  26 would implement an "expanding incremental" backup (which some may prefer
  27 anyway).
  28
  29 setmode <setmode string> filename
  30   This is a "freebie" - nothing really to do with sambatar. This
  31 is a crude attrib like command (only the other way around). Setmode string
  32 is a combination of +-rhsa. So for example -rh would reset the read only
  33 bit on filename.
  34
  35 newer filename
  36   This is in fact part of the 1.9.13 samba distribution, but comes
  37 into its own with sambatar. This causes tar (or get, mget, etc) to
  38 only copy files newer than the specified file name. Could be used
  39 against the previous nights (or whatever) log file to implement incremental
  40 backups.