1mailto(samba@samba.org) 2 3manpage(smbtar htmlcommand((1)))(1)(23 Oct 1998)(Samba)(SAMBA) 4 5label(NAME) 6manpagename(smbtar)(shell script for backing up SMB/CIFS shares directly to UNIX tape drives) 7 8label(SYNOPSIS) 9manpagesynopsis() 10 11bf(smbtar) link(-s server)(minuss) [link(-p password)(minusp)] [link(-x service)(minusx)] [link(-X)(minusX)] [link(-d directory)(minusd)] [link(-u user)(minusu)] [link(-t tape)(minust)] [link(-b blocksize)(minusb)] [link(-N filename)(minusN)] [link(-i)(minusi)] [link(-r)(minusr)] [link(-l log level)(minusl)] [link(-v)(minusv)] filenames 12 13label(DESCRIPTION) 14manpagedescription() 15 16This program is part of the bf(Samba) suite. 17 18bf(smbtar) is a very small shell script on top of 19url(bf(smbclient))(smbclient.1.html) which dumps SMB shares directly 20to tape. 21 22label(OPTIONS) 23manpageoptions() 24 25startdit() 26 27label(minuss) 28dit(bf(-s server)) The SMB/CIFS server that the share resides upon. 29 30label(minusx) 31dit(bf(-x service)) The share name on the server to connect 32to. The default is tt(backup). 33 34label(minusX) 35dit(bf(-X)) Exclude mode. Exclude filenames... from tar create or 36restore. 37 38label(minusd) 39dit(bf(-d directory)) Change to initial em(directory) before restoring 40/ backing up files. 41 42label(minusv) 43dit(bf(-v)) Verbose mode. 44 45label(minusp) 46dit(bf(-p password)) The password to use to access a share. Default: 47none 48 49label(minusu) 50dit(bf(-u user)) The user id to connect as. Default: UNIX login name. 51 52label(minust) 53dit(bf(-t tape)) Tape device. May be regular file or tape 54device. Default: em(TAPE) environmental variable; if not set, a file 55called tt(tar.out). 56 57label(minusb) 58dit(bf(-b blocksize)) Blocking factor. Defaults to 20. See bf(tar (1)) 59for a fuller explanation. 60 61label(minusN) 62dit(bf(-N filename)) Backup only files newer than filename. Could be 63used (for example) on a log file to implement incremental backups. 64 65label(minusi) 66dit(bf(-i)) Incremental mode; tar files are only backed up if they 67have the archive bit set. The archive bit is reset after each file is 68read. 69 70label(minusr) 71dit(bf(-r)) Restore. Files are restored to the share from the tar 72file. 73 74label(minusl) 75dit(bf(-l log level)) Log (debug) level. Corresponds to the 76url(bf(-d))(smbclient.1.html#minusd) flag of url(bf(smbclient 77(1)))(smbclient.1.html). 78 79enddit() 80 81label(ENVIRONMENTVARIABLES) 82manpagesection(ENVIRONMENT VARIABLES) 83 84The TAPE variable specifies the default tape device to write to. May 85be overridden with the link(bf(-t))(minust) option. 86 87label(BUGS) 88manpagesection(BUGS) 89 90The bf(smbtar) script has different options from ordinary tar and tar 91called from url(bf(smbclient))(smbclient.1.html). 92 93label(CAVEATS) 94manpagesection(CAVEATS) 95 96Sites that are more careful about security may not like the way the 97script handles PC passwords. Backup and restore work on entire shares, 98should work on file lists. bf(smbtar) works best with GNU tar and may 99not work well with other versions. 100 101label(VERSION) 102manpagesection(VERSION) 103 104This man page is correct for version 2.0 of the Samba suite. 105 106label(SEEALSO) 107manpageseealso() 108 109url(bf(smbclient (1)))(smbclient.1.html), url(bf(smb.conf 110(5)))(smb.conf.5.html) 111 112label(DIAGNOSTICS) 113manpagesection(DIAGNOSTICS) 114 115See the url(bf(DIAGNOSTICS))(smbclient.1.html#DIAGNOSTICS) section for 116the url(bf(smbclient))(smbclient.1.html) command. 117 118label(AUTHOR) 119manpageauthor() 120 121The original Samba software and related utilities were created by 122Andrew Tridgell email(samba@samba.org). Samba is now developed 123by the Samba Team as an Open Source project similar to the way the 124Linux kernel is developed. 125 126Ricky Poulten email(poultenr@logica.co.uk) wrote the tar extension and 127this man page. The bf(smbtar) script was heavily rewritten and 128improved by Martin Kraemer email(Martin.Kraemer@mch.sni.de). Many 129thanks to everyone who suggested extensions, improvements, bug fixes, 130etc. The man page sources were converted to YODL format (another 131excellent piece of Open Source software available at 132url(bf(ftp://ftp.icce.rug.nl/pub/unix/))(ftp://ftp.icce.rug.nl/pub/unix/)) 133and updated for the Samba2.0 release by Jeremy Allison, 134email(samba@samba.org). 135 136See url(bf(samba (7)))(samba.7.html) to find out how to get a full 137list of contributors and details on how to submit bug reports, 138comments etc. 139 140 141