1 .TH "smbtar " "1" "23 Oct 1998" "Samba" "SAMBA"
4 smbtar \- shell script for backing up SMB/CIFS shares directly to UNIX tape drives
8 \fBsmbtar\fP -s server [-p password] [-x service] [-X] [-d directory] [-u user] [-t tape] [-b blocksize] [-N filename] [-i] [-r] [-l log level] [-v] filenames
12 This program is part of the \fBSamba\fP suite\&.
14 \fBsmbtar\fP is a very small shell script on top of
15 \fBsmbclient\fP which dumps SMB shares directly
22 The SMB/CIFS server that the share resides upon\&.
24 .IP "\fB-x service\fP"
25 The share name on the server to connect
26 to\&. The default is \f(CWbackup\fP\&.
29 Exclude mode\&. Exclude filenames\&.\&.\&. from tar create or
32 .IP "\fB-d directory\fP"
33 Change to initial \fIdirectory\fP before restoring
39 .IP "\fB-p password\fP"
40 The password to use to access a share\&. Default:
44 The user id to connect as\&. Default: UNIX login name\&.
47 Tape device\&. May be regular file or tape
48 device\&. Default: \fITAPE\fP environmental variable; if not set, a file
49 called \f(CWtar\&.out\fP\&.
51 .IP "\fB-b blocksize\fP"
52 Blocking factor\&. Defaults to 20\&. See \fBtar (1)\fP
53 for a fuller explanation\&.
55 .IP "\fB-N filename\fP"
56 Backup only files newer than filename\&. Could be
57 used (for example) on a log file to implement incremental backups\&.
60 Incremental mode; tar files are only backed up if they
61 have the archive bit set\&. The archive bit is reset after each file is
65 Restore\&. Files are restored to the share from the tar
68 .IP "\fB-l log level\fP"
69 Log (debug) level\&. Corresponds to the
70 \fB-d\fP flag of \fBsmbclient
74 .SH "ENVIRONMENT VARIABLES"
76 The TAPE variable specifies the default tape device to write to\&. May
77 be overridden with the \fB-t\fP option\&.
81 The \fBsmbtar\fP script has different options from ordinary tar and tar
82 called from \fBsmbclient\fP\&.
86 Sites that are more careful about security may not like the way the
87 script handles PC passwords\&. Backup and restore work on entire shares,
88 should work on file lists\&. \fBsmbtar\fP works best with GNU tar and may
89 not work well with other versions\&.
93 This man page is correct for version 2\&.0 of the Samba suite\&.
97 \fBsmbclient (1)\fP, \fBsmb\&.conf
102 See the \fBDIAGNOSTICS\fP section for
103 the \fBsmbclient\fP command\&.
107 The original Samba software and related utilities were created by
108 Andrew Tridgell \fIsamba-bugs@samba\&.org\fP\&. Samba is now developed
109 by the Samba Team as an Open Source project similar to the way the
110 Linux kernel is developed\&.
112 Ricky Poulten \fIpoultenr@logica\&.co\&.uk\fP wrote the tar extension and
113 this man page\&. The \fBsmbtar\fP script was heavily rewritten and
114 improved by Martin Kraemer \fIMartin\&.Kraemer@mch\&.sni\&.de\fP\&. Many
115 thanks to everyone who suggested extensions, improvements, bug fixes,
116 etc\&. The man page sources were converted to YODL format (another
117 excellent piece of Open Source software available at
118 \fBftp://ftp\&.icce\&.rug\&.nl/pub/unix/\fP)
119 and updated for the Samba2\&.0 release by Jeremy Allison,
120 \fIsamba-bugs@samba\&.org\fP\&.
122 See \fBsamba (7)\fP to find out how to get a full
123 list of contributors and details on how to submit bug reports,