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 + + + %globalentities; + ]> + + + + smbtar + 1 + + + + + smbtar + shell script for backing up SMB/CIFS shares + directly to UNIX tape drives + + + + + 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 smbclient1 + 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 + 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 + 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 + smbclient1 + . + + + + + + + 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 + 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 + with GNU tar and may not work well with other versions. + + + + + DIAGNOSTICS + + See the DIAGNOSTICS section for the + smbclient1 + command. + + + + + VERSION + + This man page is correct for version 3.0 of + the Samba suite. + + + + SEE ALSO + smbd + 8, + smbclient1 + , smb.conf + 5. + + + + 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 + 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 + 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.