summaryrefslogtreecommitdiff
path: root/docs/yodldocs/smbtar.1.yo
diff options
context:
space:
mode:
authorJeremy Allison <jra@samba.org>1998-11-03 02:04:27 +0000
committerJeremy Allison <jra@samba.org>1998-11-03 02:04:27 +0000
commit5900f6c85bfdf43712f51528b9d14b14338c8a0d (patch)
tree7a684cf4497c76a369c4330bfa2eec21c994e99d /docs/yodldocs/smbtar.1.yo
parent926aeff353674142c6fd10b85b7d55da4516ea29 (diff)
downloadsamba-5900f6c85bfdf43712f51528b9d14b14338c8a0d.tar.gz
samba-5900f6c85bfdf43712f51528b9d14b14338c8a0d.tar.bz2
samba-5900f6c85bfdf43712f51528b9d14b14338c8a0d.zip
Tidied up references to samba (7).
Added smbtar.1.yo. Jeremy. (This used to be commit f55cc67dadc3c2ea3076755e308e3467083f1001)
Diffstat (limited to 'docs/yodldocs/smbtar.1.yo')
-rw-r--r--docs/yodldocs/smbtar.1.yo126
1 files changed, 126 insertions, 0 deletions
diff --git a/docs/yodldocs/smbtar.1.yo b/docs/yodldocs/smbtar.1.yo
new file mode 100644
index 0000000000..8ef8ef00c1
--- /dev/null
+++ b/docs/yodldocs/smbtar.1.yo
@@ -0,0 +1,126 @@
+mailto(samba-bugs@samba.anu.edu.au)
+
+manpage(smbtar)(1)(23 Oct 1998)(Samba)(SAMBA)
+
+label(NAME)
+manpagename(smbtar)(shell script for backing up SMB/CIFS shares directly to UNIX tape drives)
+
+label(SYNOPSIS)
+manpagesynopsis()
+
+bf(smbtar) -s server [-p password] [-x service] [-X] [-d directory] [-u user] [-t tape] [-b blocksize] [-N filename] [-i] [-r] [-l log level] [-v] filenames
+
+label(DESCRIPTION)
+manpagedescription()
+
+This program is part of the bf(Samba) suite.
+
+bf(smbtar) is a very small shell script on top of
+url(bf(smbclient))(smbclient.1.html) which dumps SMB shares directly
+to tape.
+
+label(OPTIONS)
+manpageoptions()
+
+startdit()
+
+dit(bf(-s server)) The SMB/CIFS server that the share resides upon.
+
+dit(bf(-x service)) The share name on the server to connect
+to. The default is tt(backup).
+
+dit(bf(-X)) Exclude mode. Exclude filenames... from tar create or
+restore.
+
+dit(bf(-d directory)) Change to initial em(directory) before restoring
+/ backing up files.
+
+dit(bf(-v)) Verbose mode.
+
+dit(bf(-p password)) The password to use to access a share. Default:
+none
+
+dit(bf(-u user)) The user id to connect as. Default: UNIX login name.
+
+label(minust)
+dit(bf(-t tape)) Tape device. May be regular file or tape
+device. Default: em(TAPE) environmental variable; if not set, a file
+called tt(tar.out).
+
+dit(bf(-b blocksize)) Blocking factor. Defaults to 20. See bf(tar (1))
+for a fuller explanation.
+
+dit(bf(-N filename)) Backup only files newer than filename. Could be
+used (for example) on a log file to implement incremental backups.
+
+dit(bf(-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.
+
+dit(bf(-r)) Restore. Files are restored to the share from the tar
+file.
+
+dit(bf(-l log level)) Log (debug) level. Corresponds to the
+url(bf(-d))(smbclient.1.html#minus_d) flag of url(bf(smbclient
+(1)))(smbclient.1.html).
+
+enddit()
+
+label(ENVIRONMENT_VARIABLES)
+manpagesection(ENVIRONMENT VARIABLES)
+
+The TAPE variable specifies the default tape device to write to. May
+be overridden with the link(bf(-t))(minust) option.
+
+label(BUGS)
+manpagesection(BUGS)
+
+The bf(smbtar) script has different options from ordinary tar and tar
+called from url(bf(smbclient))(smbclient.1.html).
+
+label(CAVEATS)
+manpagesection(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. bf(smbtar) works best with GNU tar and may
+not work well with other versions.
+
+label(VERSION)
+manpagesection(VERSION)
+
+This man page is correct for version 2.0 of the Samba suite.
+
+label(SEEALSO)
+manpageseealso()
+
+url(bf(smbclient (1)))(smbclient.1.html), url(bf(smb.conf
+(5)))(smb.conf.5.html)
+
+label(DIAGNOSTICS)
+manpagesection(DIAGNOSTICS)
+
+See the url(bf(DIAGNOSTICS))(smbclient.1.html#DIAGNOSTICS) section for
+the url(bf(smbclient))(smbclient.1.html) command.
+
+label(AUTHOR)
+manpageauthor()
+
+The original Samba software and related utilities were created by
+Andrew Tridgell email(samba-bugs@samba.anu.edu.au). Samba is now developed
+by the Samba Team as an Open Source project similar to the way the
+Linux kernel is developed.
+
+Ricky Poulten email(poultenr@logica.co.uk) wrote the tar extension and
+this man page. The bf(smbtar) script was heavily rewritten and
+improved by Martin Kraemer email(Martin.Kraemer@mch.sni.de). 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) and updated for the Samba2.0
+release by Jeremy Allison, email(samba-bugs@samba.anu.edu.au).
+
+See url(bf(samba (7)))(samba.7.html) to find out how to get a full
+list of contributors and details on how to submit bug reports,
+comments etc.
+
+