Content
Data
license:
Version number: 4.9.5-Debian
Developer / Owner: Andrew Tridgell, Ricky Poulten (tar plugin maker)
Short description:
The manual page and help for the smbtar linux command. Smbtar is a very small shell script that runs on smbclient to archive SMB shares.
Man page output
man smbtar
SMBTAR(1) User Commands SMBTAR(1)
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 part of version 4.9.5-Debian of the Samba suite.
SEE ALSO
smbd(8), smbclient(1), 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 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.
Samba 4.9.5-Debian 09/02/2019 SMBTAR(1)
Help output
smbtar
Usage: smbtar [<options>] [<include/exclude files>] Function: backup/restore a Windows PC directories to a local tape file Options: (Description) (Default) -r Restore from tape file to PC Save from PC to tapefile -i Incremental mode Full backup mode -a Reset archive bit mode Don't reset archive bit -v Verbose mode: echo command Don't echo anything -s <server> Specify PC Server -p <password> Specify PC Password -x <share> Specify PC Share backup -X Exclude mode Include -N <newer> File for date comparison -b <blocksize> Specify tape's blocksize -d <dir> Specify a directory in share \ -l <log> Specify a Samba Log Level 2 -u <user> Specify User Name botond -t <tape> Specify Tape device tar.out Please enter a command line parameter!
Related Content
- Manual page - smb.conf
- Manual Page - smbcacls
- Manual Page - smbclient
- Manual Page - smbcontrol
- Manual Page - smbcquotas
- Manual page - smbd
- Manual Page - smbget
- Manual Page - smbpasswd
- Manual Page - smbstatus
- Manual Page - smbtree
- Manual page - pdbedit
- Manual page - testparm
- How to share directories between Linux and Windows
- 18 views