diff options
| author | Timur I. Bakeyev <timur@FreeBSD.org> | 2013-02-18 14:24:56 +0000 |
|---|---|---|
| committer | Timur I. Bakeyev <timur@FreeBSD.org> | 2013-02-18 14:24:56 +0000 |
| commit | ae6b9a8f6da49f4351a36b761a4dc023f6014f9f (patch) | |
| tree | 9fd594825c87fe03caad4a7e4245110a6ab052a9 /net/samba4/files/man | |
| parent | Move samba4-devel port into samba4. Preparing for the release (diff) | |
New 4.0.3 revision of the net/samba4 port. Now we have our own AD!
Diffstat (limited to 'net/samba4/files/man')
| -rw-r--r-- | net/samba4/files/man/gentest.1 | 133 | ||||
| -rw-r--r-- | net/samba4/files/man/locktest.1 | 137 | ||||
| -rw-r--r-- | net/samba4/files/man/masktest.1 | 113 | ||||
| -rw-r--r-- | net/samba4/files/man/ndrdump.1 | 83 | ||||
| -rw-r--r-- | net/samba4/files/man/nmblookup4.1 | 157 | ||||
| -rw-r--r-- | net/samba4/files/man/ntlm_auth4.1 | 378 | ||||
| -rw-r--r-- | net/samba4/files/man/oLschema2ldif.1 | 74 | ||||
| -rw-r--r-- | net/samba4/files/man/regdiff.1 | 87 | ||||
| -rw-r--r-- | net/samba4/files/man/regpatch.1 | 81 | ||||
| -rw-r--r-- | net/samba4/files/man/regshell.1 | 177 | ||||
| -rw-r--r-- | net/samba4/files/man/regtree.1 | 89 | ||||
| -rw-r--r-- | net/samba4/files/man/smbtorture.1 | 369 |
12 files changed, 1878 insertions, 0 deletions
diff --git a/net/samba4/files/man/gentest.1 b/net/samba4/files/man/gentest.1 new file mode 100644 index 000000000000..2804db8c9816 --- /dev/null +++ b/net/samba4/files/man/gentest.1 @@ -0,0 +1,133 @@ +'\" t +.\" Title: gentest +.\" Author: [see the "AUTHOR" section] +.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/> +.\" Date: 02/03/2013 +.\" Manual: Test Suite +.\" Source: Samba 4.0 +.\" Language: English +.\" +.TH "GENTEST" "1" "02/03/2013" "Samba 4\&.0" "Test Suite" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +gentest \- Run random generic SMB operations against two SMB servers and show the differences in behavior +.SH "SYNOPSIS" +.HP \w'\fBgentest\fR\ 'u +\fBgentest\fR {//server1/share1} {//server2/share2} {\-U\ user%pass} {\-U\ user%pass} [\-s\ seed] [\-o\ numops] [\-a] [\-A] [\-i\ FILE] [\-O] [\-S\ FILE] [\-L] [\-F] [\-C] [\-X] +.SH "DESCRIPTION" +.PP +gentest +is a utility for detecting differences in behaviour between SMB servers\&. It will run a random set of generic operations against +\fI//server1/share1\fR +and then the same random set against +\fI//server2/share2\fR +and display the differences in the responses it gets\&. +.PP +This utility is used by the Samba team to find differences in behaviour between Samba and Windows servers\&. +.SH "OPTIONS" +.PP +\-U user%pass +.RS 4 +Specify the user and password to use when logging on on the shares\&. This parameter is mandatory and has to be specified twice\&. +.RE +.PP +\-s seed +.RS 4 +Seed the random number generator with the specified value\&. +.RE +.PP +\-o numops +.RS 4 +Set the number of operations to perform\&. +.RE +.PP +\-a +.RS 4 +Print the operations that are performed\&. +.RE +.PP +\-A +.RS 4 +Backtrack to find minimal number of operations required to make the response to a certain call differ\&. +.RE +.PP +\-i FILE +.RS 4 +Specify a file containing the names of fields that have to be ignored (such as time fields)\&. See below for a description of the file format\&. +.RE +.PP +\-O +.RS 4 +Enable oplocks\&. +.RE +.PP +\-S FILE +.RS 4 +Set preset seeds file\&. The default is +gentest_seeds\&.dat\&. +.RE +.PP +\-L +.RS 4 +Use preset seeds +.RE +.PP +\-F +.RS 4 +Fast reconnect (just close files) +.RE +.PP +\-C +.RS 4 +Continuous analysis mode +.RE +.PP +\-X +.RS 4 +Analyse even when the test succeeded\&. +.RE +.SH "VERSION" +.PP +This man page is correct for version 4\&.0 of the Samba suite\&. +.SH "SEE ALSO" +.PP +Samba +.SH "AUTHOR" +.PP +This utility is part of the +\m[blue]\fBSamba\fR\m[]\&\s-2\u[1]\d\s+2 +suite, which is developed by the global +\m[blue]\fBSamba Team\fR\m[]\&\s-2\u[2]\d\s+2\&. +.PP +gentest was written by Andrew Tridgell\&. +.PP +This manpage was written by Jelmer Vernooij\&. +.SH "NOTES" +.IP " 1." 4 +Samba +.RS 4 +\%http://www.samba.org/ +.RE +.IP " 2." 4 +Samba Team +.RS 4 +\%http://www.samba.org/samba/team/ +.RE diff --git a/net/samba4/files/man/locktest.1 b/net/samba4/files/man/locktest.1 new file mode 100644 index 000000000000..20c6da1abec7 --- /dev/null +++ b/net/samba4/files/man/locktest.1 @@ -0,0 +1,137 @@ +'\" t +.\" Title: locktest +.\" Author: [see the "AUTHOR" section] +.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/> +.\" Date: 02/03/2013 +.\" Manual: Test Suite +.\" Source: Samba 4.0 +.\" Language: English +.\" +.TH "LOCKTEST" "1" "02/03/2013" "Samba 4\&.0" "Test Suite" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +locktest \- Find differences in locking between two SMB servers +.SH "SYNOPSIS" +.HP \w'\fBlocktest\fR\ 'u +\fBlocktest\fR {//server1/share1} {//server2/share2} [\-U\ user%pass] [\-U\ user%pass] [\-s\ seed] [\-o\ numops] [\-a] [\-O] [\-E] [\-Z] [\-R\ range] [\-B\ base] [\-M\ min] +.SH "DESCRIPTION" +.PP +locktest +is a utility for detecting differences in behaviour in locking between SMB servers\&. It will run a random set of locking operations against +\fI//server1/share1\fR +and then the same random set against +\fI//server2/share2\fR +and display the differences in the responses it gets\&. +.PP +This utility is used by the Samba team to find differences in behaviour between Samba and Windows servers\&. +.SH "OPTIONS" +.PP +\-U user%pass +.RS 4 +Specify the user and password to use when logging on on the shares\&. This parameter can be specified twice (once for the first server, once for the second)\&. +.RE +.PP +\-s seed +.RS 4 +Seed the random number generator with the specified value\&. +.RE +.PP +\-o numops +.RS 4 +Set the number of operations to perform\&. +.RE +.PP +\-a +.RS 4 +Print the operations that are performed\&. +.RE +.PP +\-A +.RS 4 +Backtrack to find minimal number of operations required to make the response to a certain call differ\&. +.RE +.PP +\-O +.RS 4 +Enable oplocks\&. +.RE +.PP +\-u +.RS 4 +Hide unlock fails\&. +.RE +.PP +\-E +.RS 4 +enable exact error code checking +.RE +.PP +\-Z +.RS 4 +enable the zero/zero lock +.RE +.PP +\-R range +.RS 4 +set lock range +.RE +.PP +\-B base +.RS 4 +set lock base +.RE +.PP +\-M min +.RS 4 +set min lock length +.RE +.PP +\-k +.RS 4 +Use kerberos +.RE +.SH "VERSION" +.PP +This man page is correct for version 4\&.0 of the Samba suite\&. +.SH "SEE ALSO" +.PP +Samba +.SH "AUTHOR" +.PP +This utility is part of the +\m[blue]\fBSamba\fR\m[]\&\s-2\u[1]\d\s+2 +suite, which is developed by the global +\m[blue]\fBSamba Team\fR\m[]\&\s-2\u[2]\d\s+2\&. +.PP +locktest was written by Andrew Tridgell\&. +.PP +This manpage was written by Jelmer Vernooij\&. +.SH "NOTES" +.IP " 1." 4 +Samba +.RS 4 +\%http://www.samba.org/ +.RE +.IP " 2." 4 +Samba Team +.RS 4 +\%http://www.samba.org/samba/team/ +.RE diff --git a/net/samba4/files/man/masktest.1 b/net/samba4/files/man/masktest.1 new file mode 100644 index 000000000000..9451edd188ed --- /dev/null +++ b/net/samba4/files/man/masktest.1 @@ -0,0 +1,113 @@ +'\" t +.\" Title: masktest +.\" Author: [see the "AUTHOR" section] +.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/> +.\" Date: 02/03/2013 +.\" Manual: Test Suite +.\" Source: Samba 4.0 +.\" Language: English +.\" +.TH "MASKTEST" "1" "02/03/2013" "Samba 4\&.0" "Test Suite" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +masktest \- Find differences in wildcard matching between Samba\*(Aqs implementation and that of a remote server\&. +.SH "SYNOPSIS" +.HP \w'\fBmasktest\fR\ 'u +\fBmasktest\fR {//server/share} [\-U\ user%pass] [\-d\ debuglevel] [\-W\ workgroup] [\-n\ numloops] [\-s\ seed] [\-a] [\-E] [\-M\ max\ protocol] [\-f\ filechars] [\-m\ maskchars] [\-v] +.SH "DESCRIPTION" +.PP +masktest +is a utility for detecting differences in behaviour between Samba\*(Aqs own implementation and that of a remote server\&. It will run generate random filenames/masks and check if these match the same files they do on the remote file as they do on the local server\&. It will display any differences it finds\&. +.PP +This utility is used by the Samba team to find differences in behaviour between Samba and Windows servers\&. +.SH "OPTIONS" +.PP +\-U user%pass +.RS 4 +Specify the user and password to use when logging on on the shares\&. This parameter can be specified twice (once for the first server, once for the second)\&. +.RE +.PP +\-s seed +.RS 4 +Seed the random number generator with the specified value\&. +.RE +.PP +\-n numops +.RS 4 +Set the number of operations to perform\&. +.RE +.PP +\-a +.RS 4 +Print the operations that are performed\&. +.RE +.PP +\-M max_protocol +.RS 4 +Maximum protocol to use\&. +.RE +.PP +\-f +.RS 4 +Specify characters that can be used when generating file names\&. Default: abcdefghijklm\&. +.RE +.PP +\-E +.RS 4 +Abort when difference in behaviour is found\&. +.RE +.PP +\-m maskchars +.RS 4 +Specify characters used for wildcards\&. +.RE +.PP +\-v +.RS 4 +Be verbose +.RE +.SH "VERSION" +.PP +This man page is correct for version 4\&.0 of the Samba suite\&. +.SH "SEE ALSO" +.PP +Samba +.SH "AUTHOR" +.PP +This utility is part of the +\m[blue]\fBSamba\fR\m[]\&\s-2\u[1]\d\s+2 +suite, which is developed by the global +\m[blue]\fBSamba Team\fR\m[]\&\s-2\u[2]\d\s+2\&. +.PP +masktest was written by Andrew Tridgell\&. +.PP +This manpage was written by Jelmer Vernooij\&. +.SH "NOTES" +.IP " 1." 4 +Samba +.RS 4 +\%http://www.samba.org/ +.RE +.IP " 2." 4 +Samba Team +.RS 4 +\%http://www.samba.org/samba/team/ +.RE diff --git a/net/samba4/files/man/ndrdump.1 b/net/samba4/files/man/ndrdump.1 new file mode 100644 index 000000000000..c0515bfee05c --- /dev/null +++ b/net/samba4/files/man/ndrdump.1 @@ -0,0 +1,83 @@ +'\" t +.\" Title: ndrdump +.\" Author: [see the "AUTHOR" section] +.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/> +.\" Date: 02/03/2013 +.\" Manual: System Administration tools +.\" Source: Samba 4.0 +.\" Language: English +.\" +.TH "NDRDUMP" "1" "02/03/2013" "Samba 4\&.0" "System Administration tools" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +ndrdump \- DCE/RPC Packet Parser and Dumper +.SH "SYNOPSIS" +.HP \w'\fBndrdump\fR\ 'u +\fBndrdump\fR [\-c\ context] {pipe} {function} {in|out} {filename} +.HP \w'\fBndrdump\fR\ 'u +\fBndrdump\fR [pipe] +.HP \w'\fBndrdump\fR\ 'u +\fBndrdump\fR +.SH "DESCRIPTION" +.PP +ndrdump tries to parse the specified +\fIfilename\fR +using Samba\*(Aqs parser for the specified pipe and function\&. The third argument should be either +\fIin\fR +or +\fIout\fR, depending on whether the data should be parsed as a request or a reply\&. +.PP +Running ndrdump without arguments will list the pipes for which parsers are available\&. +.PP +Running ndrdump with one argument will list the functions that Samba can parse for the specified pipe\&. +.PP +The primary function of ndrdump is debugging Samba\*(Aqs internal DCE/RPC parsing functions\&. The file being parsed is usually one exported by wiresharks +\(lqExport selected packet bytes\(rq +function\&. +.PP +The context argument can be used to load context data from the request packet when parsing reply packets (such as array lengths)\&. +.SH "VERSION" +.PP +This man page is correct for version 4\&.0 of the Samba suite\&. +.SH "SEE ALSO" +.PP +wireshark, pidl +.SH "AUTHOR" +.PP +This utility is part of the +\m[blue]\fBSamba\fR\m[]\&\s-2\u[1]\d\s+2 +suite, which is developed by the global +\m[blue]\fBSamba Team\fR\m[]\&\s-2\u[2]\d\s+2\&. +.PP +ndrdump was written by Andrew Tridgell\&. +.PP +This manpage was written by Jelmer Vernooij\&. +.SH "NOTES" +.IP " 1." 4 +Samba +.RS 4 +\%http://www.samba.org/ +.RE +.IP " 2." 4 +Samba Team +.RS 4 +\%http://www.samba.org/samba/team/ +.RE diff --git a/net/samba4/files/man/nmblookup4.1 b/net/samba4/files/man/nmblookup4.1 new file mode 100644 index 000000000000..e10d2ea724e2 --- /dev/null +++ b/net/samba4/files/man/nmblookup4.1 @@ -0,0 +1,157 @@ +'\" t +.\" Title: nmblookup4 +.\" Author: [see the "AUTHOR" section] +.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/> +.\" Date: 02/03/2013 +.\" Manual: User Commands +.\" Source: Samba 3.2 +.\" Language: English +.\" +.TH "NMBLOOKUP4" "1" "02/03/2013" "Samba 3\&.2" "User Commands" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +nmblookup4 \- NetBIOS over TCP/IP client used to lookup NetBIOS names +.SH "SYNOPSIS" +.HP \w'\fBnmblookup4\fR\ 'u +\fBnmblookup4\fR [\-M] [\-R] [\-S] [\-r] [\-A] [\-h] [\-B\ <broadcast\ address>] [\-U\ <unicast\ address>] [\-d\ <debug\ level>] [\-s\ <smb\ config\ file>] [\-i\ <NetBIOS\ scope>] [\-T] [\-f] {name} +.SH "DESCRIPTION" +.PP +This tool is part of the +\fBsamba\fR(7) +suite\&. +.PP +\fBnmblookup4\fR +is used to query NetBIOS names and map them to IP addresses in a network using NetBIOS over TCP/IP queries\&. The options allow the name queries to be directed at a particular IP broadcast area or to a particular machine\&. All queries are done over UDP\&. +.SH "OPTIONS" +.PP +\-M +.RS 4 +Searches for a master browser by looking up the NetBIOS name +\fIname\fR +with a type of +\fB0x1d\fR\&. If +\fI name\fR +is "\-" then it does a lookup on the special name +\fB__MSBROWSE__\fR\&. Please note that in order to use the name "\-", you need to make sure "\-" isn\*(Aqt parsed as an argument, e\&.g\&. use : +\fBnmblookup4 \-M \-\- \-\fR\&. +.RE +.PP +\-R +.RS 4 +Set the recursion desired bit in the packet to do a recursive lookup\&. This is used when sending a name query to a machine running a WINS server and the user wishes to query the names in the WINS server\&. If this bit is unset the normal (broadcast responding) NetBIOS processing code on a machine is used instead\&. See RFC1001, RFC1002 for details\&. +.RE +.PP +\-S +.RS 4 +Once the name query has returned an IP address then do a node status query as well\&. A node status query returns the NetBIOS names registered by a host\&. +.RE +.PP +\-r +.RS 4 +Try and bind to UDP port 137 to send and receive UDP datagrams\&. The reason for this option is a bug in Windows 95 where it ignores the source port of the requesting packet and only replies to UDP port 137\&. Unfortunately, on most UNIX systems root privilege is needed to bind to this port, and in addition, if the +\fBnmbd\fR(8) +daemon is running on this machine it also binds to this port\&. +.RE +.PP +\-A +.RS 4 +Interpret +\fIname\fR +as an IP Address and do a node status query on this address\&. +.RE +.PP +\-B <broadcast address> +.RS 4 +Send the query to the given broadcast address\&. Without this option the default behavior of nmblookup4 is to send the query to the broadcast address of the network interfaces as either auto\-detected or defined in the +\m[blue]\fB\fIinterfaces\fR\fR\m[]\&\s-2\u[1]\d\s+2 +parameter of the +\fBsmb.conf\fR(5) +file\&. +.RE +.PP +\-U <unicast address> +.RS 4 +Do a unicast query to the specified address or host +\fIunicast address\fR\&. This option (along with the +\fI\-R\fR +option) is needed to query a WINS server\&. +.RE +.PP +\-T +.RS 4 +This causes any IP addresses found in the lookup to be looked up via a reverse DNS lookup into a DNS name, and printed out before each +.sp +\fIIP address \&.\&.\&.\&. NetBIOS name\fR +.sp +pair that is the normal output\&. +.RE +.PP +\-f +.RS 4 +Show which flags apply to the name that has been looked up\&. Possible answers are zero or more of: Response, Authoritative, Truncated, Recursion_Desired, Recursion_Available, Broadcast\&. +.RE +.PP +name +.RS 4 +This is the NetBIOS name being queried\&. Depending upon the previous options this may be a NetBIOS name or IP address\&. If a NetBIOS name then the different name types may be specified by appending \*(Aq#<type>\*(Aq to the name\&. This name may also be \*(Aq*\*(Aq, which will return all registered names within a broadcast area\&. +.RE +.SH "EXAMPLES" +.PP +\fBnmblookup4\fR +can be used to query a WINS server (in the same way +\fBnslookup\fR +is used to query DNS servers)\&. To query a WINS server, +\fBnmblookup4\fR +must be called like this: +.PP +\fBnmblookup4 \-U server \-R \*(Aqname\*(Aq\fR +.PP +For example, running : +.PP +\fBnmblookup4 \-U samba\&.org \-R \*(AqIRIX#1B\*(Aq\fR +.PP +would query the WINS server samba\&.org for the domain master browser (1B name type) for the IRIX workgroup\&. +.SH "VERSION" +.PP +This man page is correct for version 3 of the Samba suite\&. +.SH "SEE ALSO" +.PP +\fBnmbd\fR(8), +\fBsamba\fR(7), and +\fBsmb.conf\fR(5)\&. +.SH "AUTHOR" +.PP +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\&. +.PP +The original Samba man pages were written by Karl Auer\&. The man page sources were converted to YODL format (another excellent piece of Open Source software, available at +\m[blue]\fBftp://ftp\&.icce\&.rug\&.nl/pub/unix/\fR\m[]\&\s-2\u[2]\d\s+2) 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\&. +.SH "NOTES" +.IP " 1." 4 +\fIinterfaces\fR + +.RS 4 +\%[set $man.base.url.for.relative.links]/smb.conf.5.html#INTERFACES +.RE +.IP " 2." 4 +ftp://ftp.icce.rug.nl/pub/unix/ +.RS 4 +\%ftp://ftp.icce.rug.nl/pub/unix/ +.RE diff --git a/net/samba4/files/man/ntlm_auth4.1 b/net/samba4/files/man/ntlm_auth4.1 new file mode 100644 index 000000000000..0b2500ad2fc6 --- /dev/null +++ b/net/samba4/files/man/ntlm_auth4.1 @@ -0,0 +1,378 @@ +'\" t +.\" Title: ntlm_auth +.\" Author: [see the "AUTHOR" section] +.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/> +.\" Date: 02/04/2013 +.\" Manual: User Commands +.\" Source: Samba 4.0 +.\" Language: English +.\" +.TH "NTLM_AUTH" "1" "02/04/2013" "Samba 4\&.0" "User Commands" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +ntlm_auth \- tool to allow external access to Winbind\*(Aqs NTLM authentication function +.SH "SYNOPSIS" +.HP \w'\ 'u +ntlm_auth [\-d\ debuglevel] [\-l\ logdir] [\-s\ <smb\ config\ file>] +.SH "DESCRIPTION" +.PP +This tool is part of the +\fBsamba\fR(7) +suite\&. +.PP +ntlm_auth +is a helper utility that authenticates users using NT/LM authentication\&. It returns 0 if the users is authenticated successfully and 1 if access was denied\&. ntlm_auth uses winbind to access the user and authentication data for a domain\&. This utility is only intended to be used by other programs (currently +Squid +and +mod_ntlm_winbind) +.SH "OPERATIONAL REQUIREMENTS" +.PP +The +\fBwinbindd\fR(8) +daemon must be operational for many of these commands to function\&. +.PP +Some of these commands also require access to the directory +winbindd_privileged +in +$LOCKDIR\&. This should be done either by running this command as root or providing group access to the +winbindd_privileged +directory\&. For security reasons, this directory should not be world\-accessable\&. +.SH "OPTIONS" +.PP +\-\-helper\-protocol=PROTO +.RS 4 +Operate as a stdio\-based helper\&. Valid helper protocols are: +.PP +squid\-2\&.4\-basic +.RS 4 +Server\-side helper for use with Squid 2\&.4\*(Aqs basic (plaintext) authentication\&. +.RE +.PP +squid\-2\&.5\-basic +.RS 4 +Server\-side helper for use with Squid 2\&.5\*(Aqs basic (plaintext) authentication\&. +.RE +.PP +squid\-2\&.5\-ntlmssp +.RS 4 +Server\-side helper for use with Squid 2\&.5\*(Aqs NTLMSSP authentication\&. +.sp +Requires access to the directory +winbindd_privileged +in +$LOCKDIR\&. The protocol used is described here: +http://devel\&.squid\-cache\&.org/ntlm/squid_helper_protocol\&.html\&. This protocol has been extended to allow the NTLMSSP Negotiate packet to be included as an argument to the +YR +command\&. (Thus avoiding loss of information in the protocol exchange)\&. +.RE +.PP +ntlmssp\-client\-1 +.RS 4 +Client\-side helper for use with arbitrary external programs that may wish to use Samba\*(Aqs NTLMSSP authentication knowledge\&. +.sp +This helper is a client, and as such may be run by any user\&. The protocol used is effectively the reverse of the previous protocol\&. A +YR +command (without any arguments) starts the authentication exchange\&. +.RE +.PP +gss\-spnego +.RS 4 +Server\-side helper that implements GSS\-SPNEGO\&. This uses a protocol that is almost the same as +squid\-2\&.5\-ntlmssp, but has some subtle differences that are undocumented outside the source at this stage\&. +.sp +Requires access to the directory +winbindd_privileged +in +$LOCKDIR\&. +.RE +.PP +gss\-spnego\-client +.RS 4 +Client\-side helper that implements GSS\-SPNEGO\&. This also uses a protocol similar to the above helpers, but is currently undocumented\&. +.RE +.PP +ntlm\-server\-1 +.RS 4 +Server\-side helper protocol, intended for use by a RADIUS server or the \*(Aqwinbind\*(Aq plugin for pppd, for the provision of MSCHAP and MSCHAPv2 authentication\&. +.sp +This protocol consists of lines in the form: +Parameter: value +and +Parameter:: Base64\-encode value\&. The presence of a single period +\&. +indicates that one side has finished supplying data to the other\&. (Which in turn could cause the helper to authenticate the user)\&. +.sp +Currently implemented parameters from the external program to the helper are: +.PP +Username +.RS 4 +The username, expected to be in Samba\*(Aqs +\m[blue]\fBunix charset\fR\m[]\&. +.PP \fBExample\ \&1.\ \&\fR Username: bob +.PP \fBExample\ \&2.\ \&\fR Username:: Ym9i +.RE +.PP +NT\-Domain +.RS 4 +The user\*(Aqs domain, expected to be in Samba\*(Aqs +\m[blue]\fBunix charset\fR\m[]\&. +.PP \fBExample\ \&3.\ \&\fR NT\-Domain: WORKGROUP +.PP \fBExample\ \&4.\ \&\fR NT\-Domain:: V09SS0dST1VQ +.RE +.PP +Full\-Username +.RS 4 +The fully qualified username, expected to be in Samba\*(Aqs +\m[blue]\fBunix charset\fR\m[] +and qualified with the +\m[blue]\fBwinbind separator\fR\m[]\&. +.PP \fBExample\ \&5.\ \&\fR Full\-Username: WORKGROUP\ebob +.PP \fBExample\ \&6.\ \&\fR Full\-Username:: V09SS0dST1VQYm9i +.RE +.PP +LANMAN\-Challenge +.RS 4 +The 8 byte +LANMAN Challenge +value, generated randomly by the server, or (in cases such as MSCHAPv2) generated in some way by both the server and the client\&. +.PP \fBExample\ \&7.\ \&\fR LANMAN\-Challenge: 0102030405060708 +.RE +.PP +LANMAN\-Response +.RS 4 +The 24 byte +LANMAN Response +value, calculated from the user\*(Aqs password and the supplied +LANMAN Challenge\&. Typically, this is provided over the network by a client wishing to authenticate\&. +.PP \fBExample\ \&8.\ \&\fR LANMAN\-Response: 0102030405060708090A0B0C0D0E0F101112131415161718 +.RE +.PP +NT\-Response +.RS 4 +The >= 24 byte +NT Response +calculated from the user\*(Aqs password and the supplied +LANMAN Challenge\&. Typically, this is provided over the network by a client wishing to authenticate\&. +.PP \fBExample\ \&9.\ \&\fR NT\-Response: 0102030405060708090A0B0C0D0E0F101112131415161718 +.RE +.PP +Password +.RS 4 +The user\*(Aqs password\&. This would be provided by a network client, if the helper is being used in a legacy situation that exposes plaintext passwords in this way\&. +.PP \fBExample\ \&10.\ \&\fR Password: samba2 +.PP \fBExample\ \&11.\ \&\fR Password:: c2FtYmEy +.RE +.PP +Request\-User\-Session\-Key +.RS 4 +Upon successful authenticaiton, return the user session key associated with the login\&. +.PP \fBExample\ \&12.\ \&\fR Request\-User\-Session\-Key: Yes +.RE +.PP +Request\-LanMan\-Session\-Key +.RS 4 +Upon successful authenticaiton, return the LANMAN session key associated with the login\&. +.PP \fBExample\ \&13.\ \&\fR Request\-LanMan\-Session\-Key: Yes +.RE +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBWarning\fR +.ps -1 +.br +Implementers should take care to base64 encode + any data (such as usernames/passwords) that may contain malicous user data, such as + a newline\&. They may also need to decode strings from + the helper, which likewise may have been base64 encoded\&..sp .5v +.RE +.RE +.RE +.PP +\-\-username=USERNAME +.RS 4 +Specify username of user to authenticate +.RE +.PP +\-\-domain=DOMAIN +.RS 4 +Specify domain of user to authenticate +.RE +.PP +\-\-workstation=WORKSTATION +.RS 4 +Specify the workstation the user authenticated from +.RE +.PP +\-\-challenge=STRING +.RS 4 +NTLM challenge (in HEXADECIMAL) +.RE +.PP +\-\-lm\-response=RESPONSE +.RS 4 +LM Response to the challenge (in HEXADECIMAL) +.RE +.PP +\-\-nt\-response=RESPONSE +.RS 4 +NT or NTLMv2 Response to the challenge (in HEXADECIMAL) +.RE +.PP +\-\-password=PASSWORD +.RS 4 +User\*(Aqs plaintext password +.sp +If not specified on the command line, this is prompted for when required\&. +.sp +For the NTLMSSP based server roles, this parameter specifies the expected password, allowing testing without winbindd operational\&. +.RE +.PP +\-\-request\-lm\-key +.RS 4 +Retrieve LM session key +.RE +.PP +\-\-request\-nt\-key +.RS 4 +Request NT key +.RE +.PP +\-\-diagnostics +.RS 4 +Perform Diagnostics on the authentication chain\&. Uses the password from +\-\-password +or prompts for one\&. +.RE +.PP +\-\-require\-membership\-of={SID|Name} +.RS 4 +Require that a user be a member of specified group (either name or SID) for authentication to succeed\&. +.RE +.PP +\-d|\-\-debuglevel=level +.RS 4 +\fIlevel\fR +is an integer from 0 to 10\&. The default value if this parameter is not specified is 0\&. +.sp +The higher this value, the more detail will be logged to the log files about the activities of the server\&. At level 0, only critical errors and serious warnings will be logged\&. Level 1 is a reasonable level for day\-to\-day running \- it generates a small amount of information about operations carried out\&. +.sp +Levels above 1 will generate considerable amounts of log data, and should only be used when investigating a problem\&. Levels above 3 are designed for use only by developers and generate HUGE amounts of log data, most of which is extremely cryptic\&. +.sp +Note that specifying this parameter here will override the +\m[blue]\fBlog level\fR\m[] +parameter in the +smb\&.conf +file\&. +.RE +.PP +\-V|\-\-version +.RS 4 +Prints the program version number\&. +.RE +.PP +\-s|\-\-configfile <configuration file> +.RS 4 +The file specified contains the configuration details required by the server\&. The information in this file includes server\-specific information such as what printcap file to use, as well as descriptions of all the services that the server is to provide\&. See +smb\&.conf +for more information\&. The default configuration file name is determined at compile time\&. +.RE +.PP +\-l|\-\-log\-basename=logdirectory +.RS 4 +Base directory name for log/debug files\&. The extension +\fB"\&.progname"\fR +will be appended (e\&.g\&. log\&.smbclient, log\&.smbd, etc\&.\&.\&.)\&. The log file is never removed by the client\&. +.RE +.PP +\-?|\-\-help +.RS 4 +Print a summary of command line options\&. +.RE +.SH "EXAMPLE SETUP" +.PP +To setup ntlm_auth for use by squid 2\&.5, with both basic and NTLMSSP authentication, the following should be placed in the +squid\&.conf +file\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +auth_param ntlm program ntlm_auth \-\-helper\-protocol=squid\-2\&.5\-ntlmssp +auth_param basic program ntlm_auth \-\-helper\-protocol=squid\-2\&.5\-basic +auth_param basic children 5 +auth_param basic realm Squid proxy\-caching web server +auth_param basic credentialsttl 2 hours +.fi +.if n \{\ +.RE +.\} +.if n \{\ +.sp +.\} +.RS 4 +.it 1 an-trap +.nr an-no-space-flag 1 +.nr an-break-flag 1 +.br +.ps +1 +\fBNote\fR +.ps -1 +.br +.PP +This example assumes that ntlm_auth has been installed into your path, and that the group permissions on +winbindd_privileged +are as described above\&. +.sp .5v +.RE +.PP +To setup ntlm_auth for use by squid 2\&.5 with group limitation in addition to the above example, the following should be added to the +squid\&.conf +file\&. +.sp +.if n \{\ +.RS 4 +.\} +.nf +auth_param ntlm program ntlm_auth \-\-helper\-protocol=squid\-2\&.5\-ntlmssp \-\-require\-membership\-of=\*(AqWORKGROUP\eDomain Users\*(Aq +auth_param basic program ntlm_auth \-\-helper\-protocol=squid\-2\&.5\-basic \-\-require\-membership\-of=\*(AqWORKGROUP\eDomain Users\*(Aq +.fi +.if n \{\ +.RE +.\} +.SH "TROUBLESHOOTING" +.PP +If you\*(Aqre experiencing problems with authenticating Internet Explorer running under MS Windows 9X or Millennium Edition against ntlm_auth\*(Aqs NTLMSSP authentication helper (\-\-helper\-protocol=squid\-2\&.5\-ntlmssp), then please read +the Microsoft Knowledge Base article #239869 and follow instructions described there\&. +.SH "VERSION" +.PP +This man page is correct for version 3 of the Samba suite\&. +.SH "AUTHOR" +.PP +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\&. +.PP +The ntlm_auth manpage was written by Jelmer Vernooij and Andrew Bartlett\&. diff --git a/net/samba4/files/man/oLschema2ldif.1 b/net/samba4/files/man/oLschema2ldif.1 new file mode 100644 index 000000000000..cc026d1b7736 --- /dev/null +++ b/net/samba4/files/man/oLschema2ldif.1 @@ -0,0 +1,74 @@ +'\" t +.\" Title: oLschema2ldif +.\" Author: [see the "AUTHOR" section] +.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/> +.\" Date: 02/03/2013 +.\" Manual: System Administration tools +.\" Source: Samba 4.0 +.\" Language: English +.\" +.TH "OLSCHEMA2LDIF" "1" "02/03/2013" "Samba 4\&.0" "System Administration tools" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +oLschema2ldif \- Converts LDAP schema\*(Aqs to LDB\-compatible LDIF +.SH "SYNOPSIS" +.HP \w'\fBoLschema2ldif\fR\ 'u +\fBoLschema2ldif\fR [\-I\ INPUT\-FILE] [\-O\ OUTPUT\-FILE] +.SH "DESCRIPTION" +.PP +oLschema2ldif is a simple tool that converts standard OpenLDAP schema files to a LDIF format that is understood by LDB\&. +.SH "OPTIONS" +.PP +\-I input\-file +.RS 4 +OpenLDAP schema to read\&. If none are specified, the schema file will be read from standard input\&. +.RE +.PP +\-O output\-file +.RS 4 +File to write ldif version of schema to\&. +.RE +.SH "VERSION" +.PP +This man page is correct for version 4\&.0 of the Samba suite\&. +.SH "SEE ALSO" +.PP +ldb(7), ldbmodify, ldbdel, ldif(5) +.SH "AUTHOR" +.PP +ldb was written by +\m[blue]\fBAndrew Tridgell\fR\m[]\&\s-2\u[1]\d\s+2\&. oLschema2ldif was written by +\m[blue]\fBSimo Sorce\fR\m[]\&\s-2\u[2]\d\s+2\&. +.PP +If you wish to report a problem or make a suggestion then please see the +\m[blue]\fB\%http://ldb.samba.org/\fR\m[] +web site for current contact and maintainer information\&. +.SH "NOTES" +.IP " 1." 4 +Andrew Tridgell +.RS 4 +\%http://samba.org/~tridge/ +.RE +.IP " 2." 4 +Simo Sorce +.RS 4 +\%mailto:idra@samba.org +.RE diff --git a/net/samba4/files/man/regdiff.1 b/net/samba4/files/man/regdiff.1 new file mode 100644 index 000000000000..45a774236001 --- /dev/null +++ b/net/samba4/files/man/regdiff.1 @@ -0,0 +1,87 @@ +'\" t +.\" Title: regdiff +.\" Author: [see the "AUTHOR" section] +.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/> +.\" Date: 02/03/2013 +.\" Manual: System Administration tools +.\" Source: Samba 4.0 +.\" Language: English +.\" +.TH "REGDIFF" "1" "02/03/2013" "Samba 4\&.0" "System Administration tools" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +regdiff \- Diff program for Windows registry files +.SH "SYNOPSIS" +.HP \w'\fBregdiff\fR\ 'u +\fBregdiff\fR [\-\-help] [\-\-backend=BACKEND] [\-\-backend=BACKEND] [\-\-credentials=CREDENTIALS] [\-\-credentials=CREDENTIALS] [location] [location] +.SH "DESCRIPTION" +.PP +regdiff compares two Windows registry files key by key and value by value and generates a text file that contains the differences between the two files\&. +.PP +A file generated by regdiff can later be applied to a registry file by the regpatch utility\&. +.PP +regdiff and regpatch use the same file format as the regedit32\&.exe utility from Windows\&. +.SH "OPTIONS" +.PP +\-\-help +.RS 4 +Show list of available options\&. +.RE +.PP +\-\-backend BACKEND +.RS 4 +Name of backend to load\&. Possible values are: creg, regf, dir and rpc\&. The default is +\fIdir\fR\&. +.sp +This argument can be specified twice: once for the first registry file and once for the second\&. +.RE +.PP +\-\-credentials=CREDENTIALS +.RS 4 +Credentials to use, if any\&. Password should be separated from user name by a percent sign\&. +.sp +This argument can be specified twice: once for the first registry file and once for the second\&. +.RE +.SH "VERSION" +.PP +This man page is correct for version 4\&.0 of the Samba suite\&. +.SH "SEE ALSO" +.PP +gregedit, regshell, regpatch, regtree, samba, patch, diff +.SH "AUTHOR" +.PP +This utility is part of the +\m[blue]\fBSamba\fR\m[]\&\s-2\u[1]\d\s+2 +suite, which is developed by the global +\m[blue]\fBSamba Team\fR\m[]\&\s-2\u[2]\d\s+2\&. +.PP +This manpage and regdiff were written by Jelmer Vernooij\&. +.SH "NOTES" +.IP " 1." 4 +Samba +.RS 4 +\%http://www.samba.org/ +.RE +.IP " 2." 4 +Samba Team +.RS 4 +\%http://www.samba.org/samba/team/ +.RE diff --git a/net/samba4/files/man/regpatch.1 b/net/samba4/files/man/regpatch.1 new file mode 100644 index 000000000000..68c371a3b60c --- /dev/null +++ b/net/samba4/files/man/regpatch.1 @@ -0,0 +1,81 @@ +'\" t +.\" Title: regpatch +.\" Author: [see the "AUTHOR" section] +.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/> +.\" Date: 02/03/2013 +.\" Manual: System Administration tools +.\" Source: Samba 4.0 +.\" Language: English +.\" +.TH "REGPATCH" "1" "02/03/2013" "Samba 4\&.0" "System Administration tools" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +regpatch \- Applies registry patches to registry files +.SH "SYNOPSIS" +.HP \w'\fBregpatch\fR\ 'u +\fBregpatch\fR [\-\-help] [\-\-backend=BACKEND] [\-\-credentials=CREDENTIALS] [location] [patch\-file] +.SH "DESCRIPTION" +.PP +The regpatch utility applies registry patches to Windows registry files\&. The patch files should have the same format as is being used by the regdiff utility and regedit32\&.exe from Windows\&. +.PP +If no patch file is specified on the command line, regpatch attempts to read it from standard input\&. +.SH "OPTIONS" +.PP +\-\-help +.RS 4 +Show list of available options\&. +.RE +.PP +\-\-backend BACKEND +.RS 4 +Name of backend to load\&. Possible values are: creg, regf, dir and rpc\&. The default is +\fIdir\fR\&. +.RE +.PP +\-\-credentials=CREDENTIALS +.RS 4 +Credentials to use, if any\&. Password should be separated from user name by a percent sign\&. +.RE +.SH "VERSION" +.PP +This man page is correct for version 4\&.0 of the Samba suite\&. +.SH "SEE ALSO" +.PP +regdiff, regtree, regshell, gregedit, samba, diff, patch +.SH "AUTHOR" +.PP +This utility is part of the +\m[blue]\fBSamba\fR\m[]\&\s-2\u[1]\d\s+2 +suite, which is developed by the global +\m[blue]\fBSamba Team\fR\m[]\&\s-2\u[2]\d\s+2\&. +.PP +This manpage and regpatch were written by Jelmer Vernooij\&. +.SH "NOTES" +.IP " 1." 4 +Samba +.RS 4 +\%http://www.samba.org/ +.RE +.IP " 2." 4 +Samba Team +.RS 4 +\%http://www.samba.org/samba/team/ +.RE diff --git a/net/samba4/files/man/regshell.1 b/net/samba4/files/man/regshell.1 new file mode 100644 index 000000000000..f7f11ee11040 --- /dev/null +++ b/net/samba4/files/man/regshell.1 @@ -0,0 +1,177 @@ +'\" t +.\" Title: regshell +.\" Author: [see the "AUTHOR" section] +.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/> +.\" Date: 02/03/2013 +.\" Manual: System Administration tools +.\" Source: Samba 4.0 +.\" Language: English +.\" +.TH "REGSHELL" "1" "02/03/2013" "Samba 4\&.0" "System Administration tools" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +regshell \- Windows registry file browser using readline +.SH "SYNOPSIS" +.HP \w'\fBregshell\fR\ 'u +\fBregshell\fR [\-\-help] [\-\-backend=BACKEND] [\-\-credentials=CREDENTIALS] [location] +.SH "DESCRIPTION" +.PP +regshell is a utility that lets you browse thru a Windows registry file as if you were using a regular unix shell to browse thru a file system\&. +.SH "OPTIONS" +.PP +\-\-help +.RS 4 +Show list of available options\&. +.RE +.PP +\-\-backend BACKEND +.RS 4 +Name of backend to load\&. Possible values are: creg, regf, dir and rpc\&. The default is +\fIdir\fR\&. +.RE +.PP +\-\-credentials=CREDENTIALS +.RS 4 +Credentials to use, if any\&. Password should be separated from user name by a percent sign\&. +.RE +.SH "COMMANDS" +.PP +ck|cd <keyname> +.RS 4 +Go to the specified subkey\&. +.RE +.PP +ch|predef [predefined\-key\-name] +.RS 4 +Go to the specified predefined key\&. +.RE +.PP +list|ls +.RS 4 +List subkeys and values of the current key\&. +.RE +.PP +mkkey|mkdir <keyname> +.RS 4 +Create a key with the specified +\fIkeyname\fR +as a subkey of the current key\&. +.RE +.PP +rmval|rm <valname> +.RS 4 +Delete the specified value\&. +.RE +.PP +rmkey|rmdir <keyname> +.RS 4 +Delete the specified subkey recursively\&. +.RE +.PP +pwd|pwk +.RS 4 +Print the full name of the current key\&. +.RE +.PP +set|update +.RS 4 +Update the value of a key value\&. Not implemented at the moment\&. +.RE +.PP +help|? +.RS 4 +Print a list of available commands\&. +.RE +.PP +exit|quit +.RS 4 +Leave regshell\&. +.RE +.SH "EXAMPLES" +.PP +Browsing thru a nt4 registry file +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBregshell \-b nt4 NTUSER\&.DAT\fR +$$$PROTO\&.HIV> \fBls\fR +K AppEvents +K Console +K Control Panel +K Environment +K Identities +K Keyboard Layout +K Network +K Printers +K Software +K UNICODE Program Groups +K Windows 3\&.1 Migration Status +$$$PROTO\&.HIV> \fBexit\fR +.fi +.if n \{\ +.RE +.\} +.PP +Listing the subkeys of HKEY_CURRENT_USER\eAppEvents on a remote computer: +.sp +.if n \{\ +.RS 4 +.\} +.nf +\fBregshell \-\-remote=ncacn_np:aurelia \-c "jelmer%secret"\fR +HKEY_CURRENT_MACHINE> \fBpredef HKEY_CURRENT_USER\fR +HKEY_CURRENT_USER> \fBcd AppEvents\fR +Current path is: HKEY_CURRENT_USER\eAppEvents +HKEY_CURRENT_USER\eAppEvents> \fBls\fR +K EventLabels +K Schemes +HKEY_CURRENT_USER\eAppEvents> \fBexit\fR +.fi +.if n \{\ +.RE +.\} +.SH "VERSION" +.PP +This man page is correct for version 4\&.0 of the Samba suite\&. +.SH "SEE ALSO" +.PP +regtree, regdiff, regpatch, gregedit, samba +.SH "AUTHOR" +.PP +This utility is part of the +\m[blue]\fBSamba\fR\m[]\&\s-2\u[1]\d\s+2 +suite, which is developed by the global +\m[blue]\fBSamba Team\fR\m[]\&\s-2\u[2]\d\s+2\&. +.PP +This manpage and regshell were written by Jelmer Vernooij\&. +.SH "NOTES" +.IP " 1." 4 +Samba +.RS 4 +\%http://www.samba.org/ +.RE +.IP " 2." 4 +Samba Team +.RS 4 +\%http://www.samba.org/samba/team/ +.RE diff --git a/net/samba4/files/man/regtree.1 b/net/samba4/files/man/regtree.1 new file mode 100644 index 000000000000..ab02f5f0a968 --- /dev/null +++ b/net/samba4/files/man/regtree.1 @@ -0,0 +1,89 @@ +'\" t +.\" Title: regtree +.\" Author: [see the "AUTHOR" section] +.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/> +.\" Date: 02/03/2013 +.\" Manual: System Administration tools +.\" Source: Samba 4.0 +.\" Language: English +.\" +.TH "REGTREE" "1" "02/03/2013" "Samba 4\&.0" "System Administration tools" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +regtree \- Text\-mode registry viewer +.SH "SYNOPSIS" +.HP \w'\fBregtree\fR\ 'u +\fBregtree\fR [\-\-help] [\-\-backend=BACKEND] [\-\-fullpath] [\-\-no\-values] [\-\-credentials=CREDENTIALS] [location] +.SH "DESCRIPTION" +.PP +The regtree utility prints out all the contents of a Windows registry file\&. Subkeys are printed with one level more indentation than their parents\&. +.SH "OPTIONS" +.PP +\-\-help +.RS 4 +Show list of available options\&. +.RE +.PP +\-\-backend BACKEND +.RS 4 +Name of backend to load\&. Possible values are: creg, regf, dir and rpc\&. The default is +\fIdir\fR\&. +.RE +.PP +\-\-credentials=CREDENTIALS +.RS 4 +Credentials to use, if any\&. Password should be separated from user name by a percent sign\&. +.RE +.PP +\-\-fullpath +.RS 4 +Print the full path to each key instead of only its name\&. +.RE +.PP +\-\-no\-values +.RS 4 +Don\*(Aqt print values, just keys\&. +.RE +.SH "VERSION" +.PP +This man page is correct for version 4\&.0 of the Samba suite\&. +.SH "SEE ALSO" +.PP +gregedit, regshell, regdiff, regpatch, samba +.SH "AUTHOR" +.PP +This utility is part of the +\m[blue]\fBSamba\fR\m[]\&\s-2\u[1]\d\s+2 +suite, which is developed by the global +\m[blue]\fBSamba Team\fR\m[]\&\s-2\u[2]\d\s+2\&. +.PP +This manpage and regtree were written by Jelmer Vernooij\&. +.SH "NOTES" +.IP " 1." 4 +Samba +.RS 4 +\%http://www.samba.org/ +.RE +.IP " 2." 4 +Samba Team +.RS 4 +\%http://www.samba.org/samba/team/ +.RE diff --git a/net/samba4/files/man/smbtorture.1 b/net/samba4/files/man/smbtorture.1 new file mode 100644 index 000000000000..b71f2d01293f --- /dev/null +++ b/net/samba4/files/man/smbtorture.1 @@ -0,0 +1,369 @@ +'\" t +.\" Title: smbtorture +.\" Author: [see the "AUTHOR" section] +.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/> +.\" Date: 02/03/2013 +.\" Manual: Test Suite +.\" Source: Samba 4.0 +.\" Language: English +.\" +.TH "SMBTORTURE" "1" "02/03/2013" "Samba 4\&.0" "Test Suite" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +smbtorture \- Run a series of tests against a SMB server +.SH "SYNOPSIS" +.HP \w'\fBsmbtorture\fR\ 'u +\fBsmbtorture\fR +.HP \w'\fBsmbtorture\fR\ 'u +\fBsmbtorture\fR {//server/share} [\-d\ debuglevel] [\-U\ user%pass] [\-k] [\-N\ numprocs] [\-n\ netbios_name] [\-W\ workgroup] [\-o\ num_operations] [\-e\ num\ files(entries)] [\-O\ socket_options] [\-m\ maximum_protocol] [\-L] [\-c\ CLIENT\&.TXT] [\-t\ timelimit] [\-C\ filename] [\-A] [\-p\ port] [\-s\ seed] [\-f\ max_failures] [\-X] {BINDING\-STRING|UNC} {TEST1} [TEST2] [\&.\&.\&.] +.SH "DESCRIPTION" +.PP +smbtorture is a testsuite that runs several tests against a SMB server\&. All tests are known to succeed against a Windows 2003 server (?)\&. Smbtorture\*(Aqs primary goal is finding differences in implementations of the SMB protocol and testing SMB servers\&. +.PP +Any number of tests can be specified on the command\-line\&. If no tests are specified, all tests are run\&. +.PP +If no arguments are specified at all, all available options and tests are listed\&. +.SS "Binding string format" +.PP +The binding string format is: +.PP +TRANSPORT:host[flags] +.PP +Where TRANSPORT is either ncacn_np for SMB, ncacn_ip_tcp for RPC/TCP or ncalrpc for local connections\&. +.PP +\*(Aqhost\*(Aq is an IP or hostname or netbios name\&. If the binding string identifies the server side of an endpoint, \*(Aqhost\*(Aq may be an empty string\&. +.PP +\*(Aqflags\*(Aq can include a SMB pipe name if using the ncacn_np transport or a TCP port number if using the ncacn_ip_tcp transport, otherwise they will be auto\-determined\&. +.PP +other recognised flags are: +.PP +sign +.RS 4 +enable ntlmssp signing +.RE +.PP +seal +.RS 4 +enable ntlmssp sealing +.RE +.PP +connect +.RS 4 +enable rpc connect level auth (auth, but no sign or seal) +.RE +.PP +validate +.RS 4 +enable the NDR validator +.RE +.PP +print +.RS 4 +enable debugging of the packets +.RE +.PP +bigendian +.RS 4 +use bigendian RPC +.RE +.PP +padcheck +.RS 4 +check reply data for non\-zero pad bytes +.RE +.PP +For example, these all connect to the samr pipe: +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +ncacn_np:myserver +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +ncacn_np:myserver[samr] +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +ncacn_np:myserver[\e\epipe\e\esamr] +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +ncacn_np:myserver[/pipe/samr] +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +ncacn_np:myserver[samr,sign,print] +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +ncacn_np:myserver[\e\epipe\e\esamr,sign,seal,bigendian] +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +ncacn_np:myserver[/pipe/samr,seal,validate] +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +ncacn_np: +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +ncacn_np:[/pipe/samr] +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +ncacn_ip_tcp:myserver +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +ncacn_ip_tcp:myserver[1024] +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +ncacn_ip_tcp:myserver[1024,sign,seal] +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04'\(bu\h'+03'\c +.\} +.el \{\ +.sp -1 +.IP \(bu 2.3 +.\} +ncalrpc: +.RE +.SS "UNC Format" +.PP +The UNC format is: +.PP +//server/share +.SH "OPTIONS" +.PP +\-d debuglevel +.RS 4 +Use the specified Samba debug level\&. A higher debug level means more output\&. +.RE +.PP +\-U user%pass +.RS 4 +Use the specified username/password combination when logging in to a remote server\&. +.RE +.PP +\-k +.RS 4 +Use kerberos when authenticating\&. +.RE +.PP +\-W workgroup +.RS 4 +Use specified name as our workgroup name\&. +.RE +.PP +\-n netbios_name +.RS 4 +Use specified name as our NetBIOS name\&. +.RE +.PP +\-O socket_options +.RS 4 +Use specified socket options, equivalent of the smb\&.conf option +\(lqsocket options\(rq\&. See the smb\&.conf(5) manpage for details\&. +.RE +.PP +\-m max_protocol +.RS 4 +Specify the maximum SMB dialect that should be used\&. Possible values are: CORE, COREPLUS, LANMAN1, LANMAN2, NT1 +.RE +.PP +\-s seed +.RS 4 +Initialize the randomizer using +\fIseed\fR +as seed\&. +.RE +.PP +\-L +.RS 4 +Use oplocks\&. +.RE +.PP +\-X +.RS 4 +Enable dangerous tests\&. Use with care! This might crash your server\&.\&.\&. +.RE +.PP +\-t timelimit +.RS 4 +Specify the NBENCH time limit in seconds\&. Defaults to 600\&. +.RE +.PP +\-p ports +.RS 4 +Specify ports to connect to\&. +.RE +.PP +\-c file +.RS 4 +Read NBENCH commands from +\fIfile\fR +instead of from CLIENT\&.TXT\&. +.RE +.PP +\-A +.RS 4 +Show not just OK or FAILED but more detailed output\&. Used only by DENY test at the moment\&. +.RE +.PP +\-C filename +.RS 4 +Load a list of UNC names from the specified filename\&. Smbtorture instances will connect to a random host from this list\&. +.RE +.PP +\-N numprocs +.RS 4 +Specify number of smbtorture processes to launch\&. +.RE +.PP +\-o num_operations +.RS 4 +Number of times some operations should be tried before assuming they\*(Aqre output is consistent (default:100)\&. +.RE +.PP +\-e num_files +.RS 4 +Number of entries to use in certain tests (such as creating X files) (default: 1000)\&. +.RE +.PP +\-f max_failures +.RS 4 +Number of failures before aborting a test (default: 1)\&. +.RE +.SH "VERSION" +.PP +This man page is correct for version 4\&.0 of the Samba suite\&. +.SH "SEE ALSO" +.PP +Samba +.SH "AUTHOR" +.PP +This utility is part of the +\m[blue]\fBSamba\fR\m[]\&\s-2\u[1]\d\s+2 +suite, which is developed by the global +\m[blue]\fBSamba Team\fR\m[]\&\s-2\u[2]\d\s+2\&. +.PP +smbtorture was written by Andrew Tridgell\&. +.PP +This manpage was written by Jelmer Vernooij\&. +.SH "NOTES" +.IP " 1." 4 +Samba +.RS 4 +\%http://www.samba.org/ +.RE +.IP " 2." 4 +Samba Team +.RS 4 +\%http://www.samba.org/samba/team/ +.RE |
