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