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