From 5900f6c85bfdf43712f51528b9d14b14338c8a0d Mon Sep 17 00:00:00 2001 From: Jeremy Allison Date: Tue, 3 Nov 1998 02:04:27 +0000 Subject: Tidied up references to samba (7). Added smbtar.1.yo. Jeremy. (This used to be commit f55cc67dadc3c2ea3076755e308e3467083f1001) --- docs/yodldocs/make_smbcodepage.1.yo | 2 +- docs/yodldocs/smbclient.1.yo | 3 +- docs/yodldocs/smbtar.1.yo | 126 ++++++++++++++++++++++++++++++++++++ docs/yodldocs/testparm.1.yo | 2 +- docs/yodldocs/testprns.1.yo | 2 +- 5 files changed, 131 insertions(+), 4 deletions(-) create mode 100644 docs/yodldocs/smbtar.1.yo diff --git a/docs/yodldocs/make_smbcodepage.1.yo b/docs/yodldocs/make_smbcodepage.1.yo index fe29d94e86..fbf9c0f3af 100644 --- a/docs/yodldocs/make_smbcodepage.1.yo +++ b/docs/yodldocs/make_smbcodepage.1.yo @@ -139,6 +139,6 @@ 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 (8)))(samba.7.html) to find out how to get a full +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. diff --git a/docs/yodldocs/smbclient.1.yo b/docs/yodldocs/smbclient.1.yo index 0ff1c006c2..5346f4ac6c 100644 --- a/docs/yodldocs/smbclient.1.yo +++ b/docs/yodldocs/smbclient.1.yo @@ -153,6 +153,7 @@ machine's hostname (in uppercase) as its NetBIOS name. This parameter allows you to override the host name and use whatever NetBIOS name you wish. +label(minus_d) dit(bf(-d debuglevel)) debuglevel is an integer from 0 to 10, or the letter 'A'. @@ -707,6 +708,6 @@ 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 (8)))(samba.7.html) to find out how to get a full +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. 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. + + diff --git a/docs/yodldocs/testparm.1.yo b/docs/yodldocs/testparm.1.yo index 3cde640f79..79ed611e42 100644 --- a/docs/yodldocs/testparm.1.yo +++ b/docs/yodldocs/testparm.1.yo @@ -89,6 +89,6 @@ 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 (8)))(samba.7.html) to find out how to get a full +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. diff --git a/docs/yodldocs/testprns.1.yo b/docs/yodldocs/testprns.1.yo index 196729061e..b76fc9f3c4 100644 --- a/docs/yodldocs/testprns.1.yo +++ b/docs/yodldocs/testprns.1.yo @@ -89,6 +89,6 @@ 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 (8)))(samba.7.html) to find out how to get a full +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. -- cgit