smbtar

Name

smbtar — shell script for backing up SMB/CIFS shares + directly to UNIX tape drives

Synopsis

smbtar [-r] [-i] [-a] [-v] {-s server} [-p password] [-x services] [-X] [-N filename] [-b blocksize] [-d directory] [-l loglevel] [-u user] [-t tape] {filenames}

DESCRIPTION

This tool is part of the samba(7) suite.

smbtar is a very small shell script on top + of smbclient(1) which dumps SMB shares directly to tape.

OPTIONS

-s server: The SMB/CIFS server that the share resides + upon.
-x service: The share name on the server to connect to. + The default is "backup".
-X: Exclude mode. Exclude filenames... from tar + create or restore.
-d directory: Change to initial directory + before restoring / backing up files.
-v: Verbose mode.
-p password: The password to use to access a share. + Default: none
-u user: The user id to connect as. Default: + UNIX login name.
-a: Reset DOS archive bit mode to + indicate file has been archived.
-t tape: Tape device. May be regular file or tape + device. Default: $TAPE environmental + variable; if not set, a file called tar.out +.
-b blocksize: Blocking factor. Defaults to 20. See + tar(1) for a fuller explanation.
-N filename: Backup only files newer than filename. Could + be used (for example) on a log file to implement incremental + backups.
-i: Incremental mode; tar files are only backed + up if they have the archive bit set. The archive bit is reset + after each file is read.
-r: Restore. Files are restored to the share + from the tar file.
-l log level: Log (debug) level. Corresponds to the + -d flag of smbclient(1).

ENVIRONMENT VARIABLES

The $TAPE variable specifies the + default tape device to write to. May be overridden + with the -t option.

BUGS

The smbtar script has different + options from ordinary tar and from smbclient's tar command.

CAVEATS

Sites that are more careful about security may not like + the way the script handles PC passwords. Backup and restore work + on entire shares; should work on file lists. smbtar works best + with GNU tar and may not work well with other versions.

DIAGNOSTICS

See the DIAGNOSTICS section for the smbclient(1) command.

VERSION

This man page is correct for version 3.0 of + the Samba suite.

AUTHOR

The original Samba software and related utilities + were created by Andrew Tridgell. Samba is now developed + by the Samba Team as an Open Source project similar + to the way the Linux kernel is developed.

Ricky Poulten + wrote the tar extension and this man page. The smbtar + script was heavily rewritten and improved by Martin Kraemer. Many + thanks to everyone who suggested extensions, improvements, bug + fixes, etc. The man page sources were converted to YODL format (another + excellent piece of Open Source software, available at + ftp://ftp.icce.rug.nl/pub/unix/) and updated for the Samba 2.0 + release by Jeremy Allison. The conversion to DocBook for + Samba 2.2 was done by Gerald Carter. The conversion to DocBook XML 4.2 for + Samba 3.0 was done by Alexander Bokovoy.