diff options
| author | Gerald Carter <jerry@samba.org> | 2002-01-05 03:52:39 +0000 |
|---|---|---|
| committer | Gerald Carter <jerry@samba.org> | 2002-01-05 03:52:39 +0000 |
| commit | f7d900873c3553dde88d42d903b74dc49c9a6c71 (patch) | |
| tree | 61b2253bd3d107293f758640652f41361f7eb17c /docs | |
| parent | 2c09907b537147189e77810f586558be6004733b (diff) | |
| download | samba-f7d900873c3553dde88d42d903b74dc49c9a6c71.tar.gz samba-f7d900873c3553dde88d42d903b74dc49c9a6c71.tar.xz samba-f7d900873c3553dde88d42d903b74dc49c9a6c71.zip | |
merge from 2.2 and regenerate docs
Diffstat (limited to 'docs')
35 files changed, 182 insertions, 119 deletions
diff --git a/docs/Samba-HOWTO-Collection.pdf b/docs/Samba-HOWTO-Collection.pdf index 511edd4ed16..e68e2592437 100644 --- a/docs/Samba-HOWTO-Collection.pdf +++ b/docs/Samba-HOWTO-Collection.pdf @@ -1,6 +1,6 @@ %PDF-1.2 %âãÏÓ -1 0 obj<</Producer(htmldoc 1.8.11 Copyright 1997-2001 Easy Software Products, All Rights Reserved.)/CreationDate(D:20011206071218Z)/Title(SAMBA Project Documentation)/Creator(Modular DocBook HTML Stylesheet Version 1.57)>>endobj +1 0 obj<</Producer(htmldoc 1.8.11 Copyright 1997-2001 Easy Software Products, All Rights Reserved.)/CreationDate(D:20020105033916Z)/Title(SAMBA Project Documentation)/Creator(Modular DocBook HTML Stylesheet Version 1.57)>>endobj 2 0 obj<</Type/Encoding/Differences[ 32/space/exclam/quotedbl/numbersign/dollar/percent/ampersand/quotesingle/parenleft/parenright/asterisk/plus/comma/minus/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon/semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/asciicircum/underscore/grave/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z/braceleft/bar/braceright/asciitilde 128/Euro 130/quotesinglbase/florin/quotedblbase/ellipsis/dagger/daggerdbl/circumflex/perthousand/Scaron/guilsinglleft/OE 145/quoteleft/quoteright/quotedblleft/quotedblright/bullet/endash/emdash/tilde/trademark/scaron/guilsinglright/oe 159/Ydieresis/space/exclamdown/cent/sterling/currency/yen/brokenbar/section/dieresis/copyright/ordfeminine/guillemotleft/logicalnot/hyphen/registered/macron/degree/plusminus/twosuperior/threesuperior/acute/mu/paragraph/periodcentered/cedilla/onesuperior/ordmasculine/guillemotright/onequarter/onehalf/threequarters/questiondown/Agrave/Aacute/Acircumflex/Atilde/Adieresis/Aring/AE/Ccedilla/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute/Icircumflex/Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis/multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn/germandbls/agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla/egrave/eacute/ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis/eth/ntilde/ograve/oacute/ocircumflex/otilde/odieresis/divide/oslash/ugrave/uacute/ucircumflex/udieresis/yacute/thorn/ydieresis]>>endobj 3 0 obj<</Type/Font/Subtype/Type1/BaseFont/Courier/Encoding 2 0 R>>endobj 4 0 obj<</Type/Font/Subtype/Type1/BaseFont/Courier-Bold/Encoding 2 0 R>>endobj @@ -2889,7 +2889,7 @@ xref 0000202565 00000 n 0000202658 00000 n trailer -<</Size 886/Root 885 0 R/Info 1 0 R/ID[<063ee28ad25d00a6b7ea666000182d51><063ee28ad25d00a6b7ea666000182d51>]>> +<</Size 886/Root 885 0 R/Info 1 0 R/ID[<71955562bbbbfce752847baaa5e75306><71955562bbbbfce752847baaa5e75306>]>> startxref 202872 %%EOF diff --git a/docs/docbook/Makefile.in b/docs/docbook/Makefile.in index b0d445852ca..83b9920535a 100644 --- a/docs/docbook/Makefile.in +++ b/docs/docbook/Makefile.in @@ -34,7 +34,7 @@ MANPAGES=$(MANDIR)/findsmb.1 $(MANDIR)/smbclient.1 \ $(MANDIR)/smbmount.8 $(MANDIR)/swat.8 $(MANDIR)/rpcclient.1 \ $(MANDIR)/smbpasswd.5 $(MANDIR)/testparm.1 $(MANDIR)/samba.7 \ $(MANDIR)/smbpasswd.8 $(MANDIR)/testprns.1 \ - $(MANDIR)/smb.conf.5 $(MANDIR)/wbinfo.1 \ + $(MANDIR)/smb.conf.5 $(MANDIR)/wbinfo.1 $(MANDIR)/pdbedit.8 \ $(MANDIR)/smbcacls.1 $(MANDIR)/smbsh.1 $(MANDIR)/winbindd.8 \ $(MANDIR)/make_unicodemap.1 @@ -48,7 +48,7 @@ SGMLMANSRC=manpages/findsmb.1.sgml manpages/smbclient.1.sgml \ manpages/rpcclient.1.sgml manpages/smbpasswd.5.sgml \ manpages/testparm.1.sgml manpages/samba.7.sgml \ manpages/smbpasswd.8.sgml manpages/testprns.1.sgml \ - manpages/smb.conf.5.sgml \ + manpages/smb.conf.5.sgml manpages/pdbedit.8.sgml \ manpages/wbinfo.1.sgml manpages/smbcacls.1.sgml \ manpages/smbsh.1.sgml manpages/winbindd.8.sgml \ manpages/make_unicodemap.1.sgml @@ -58,29 +58,33 @@ HOWTOSRC=projdoc/DOMAIN_MEMBER.sgml projdoc/NT_Security.sgml \ projdoc/UNIX_INSTALL.sgml projdoc/winbind.sgml projdoc/OS2-Client-HOWTO.sgml \ projdoc/Samba-PDC-HOWTO.sgml projdoc/ENCRYPTION.sgml \ projdoc/CVS-Access.sgml projdoc/Integrating-with-Windows.sgml \ - projdoc/PAM-Authentication-And-Samba.sgml - -FAQSRC=faq/samba-pdc-faq.sgml + projdoc/PAM-Authentication-And-Samba.sgml projdoc/Samba-LDAP-HOWTO.sgml ###################################################################### # Make instructions ###################################################################### -all: HOWTO proj-doc man-all man-html-all - -man: $(MANPAGES) - -FAQ: $(FAQSRC) - @echo Building SAMBA PDC FAQ... +all: + @echo "Possible options to the Makefile include:" + @echo " all-docs - Force a rebuild of all documentation" + @echo " HOWTO - Build all individual HOWTOs in html format" + @echo " proj-doc - Build the Samba-HOWTO-Collection.[pdf|html] file" + @echo " man - Rebuild html and nroff versions of man pages as necessary" + @echo " syntax - Check the SGML/DocBook syntax of all source files" + +all-docs: HOWTO proj-doc man-all man-html-all + +syntax: $(SGMLMANSRC) projdoc/samba-doc.sgml + @echo Checking syntax of all SGML/DocBook source files... @(for i in $?; do \ - htmlfile=`echo $$i | sed 's,.*/,,' | sed "s/\.sgml/\.html/g"`; \ - echo "Making $$htmlfile"; \ - $(JADE) -t sgml -V nochunks -d $(SGML_SHARE)/dsssl/docbook/html/docbook.dsl \ - -f /tmp/jade.log $$i > ../htmldocs/$$htmlfile; \ - cat /tmp/jade.log | grep -v DTDDECL; \ - /bin/rm -f /tmp/jade.log; \ + echo "$$i..."; \ + $(NSGMLS) -sv $$i 2>&1 | grep -v "DTDDECL catalog entries are not supported" ; \ done) + + + +man: $(MANPAGES) HOWTO: $(HOWTOSRC) @echo Building HOWTO pages... @@ -112,9 +116,6 @@ proj-doc: @/bin/mv -f samba-doc.html ../htmldocs/Samba-HOWTO-Collection.html - - - ## generate all HTML man pages man-html-all: $(SGMLMANSRC) @echo Building HTML formatted man pages... @@ -363,6 +364,15 @@ $(MANDIR)/winbindd.8: manpages/winbindd.8.sgml @$(JADE) -t sgml -i html -V nochunks -d ./stylesheets/ldp.dsl\#html $< > $(HTMLDIR)/`echo $< | sed 's,.*/,,'| sed "s/\.sgml/\.html/g"` +$(MANDIR)/pdbedit.8: manpages/pdbedit.8.sgml + @echo "Making $@" + @$(NSGMLS) $< | $(SGMLSPL) $(SGML_SHARE)/docbook2X/docbook2man-spec.pl + @cat `echo $@ | sed 's,.*/,,'` | $(PERL) scripts/strip-links.pl > $@ + @/bin/rm -f `echo $@ | sed 's,.*/,,'` + @echo "Making HTML version of $@" + @$(JADE) -t sgml -i html -V nochunks -d ./stylesheets/ldp.dsl\#html $< > $(HTMLDIR)/`echo $< | sed 's,.*/,,'| sed "s/\.sgml/\.html/g"` + + ## Clean Rule clean: /bin/rm -f manpage.* diff --git a/docs/docbook/manpages/smb.conf.5.sgml b/docs/docbook/manpages/smb.conf.5.sgml index a7328e7cf63..9e719e1f2ac 100644 --- a/docs/docbook/manpages/smb.conf.5.sgml +++ b/docs/docbook/manpages/smb.conf.5.sgml @@ -2493,7 +2493,7 @@ causes <command>smbd</command> to authenticate against another server.</para> - <para>Default: <command>encrypt passwords = no</command></para></listitem> + <para>Default: <command>encrypt passwords = yes</command></para></listitem> </varlistentry> @@ -3451,10 +3451,13 @@ <para> This option is used to control the tcp port number used to contact the <link linkend="LDAPSERVER"><parameter>ldap server</parameter></link>. - The default is to use the stand LDAP port 389. + The default is to use the stand LDAPS port 636. </para> - <para>Default : <command>ldap port = 389</command></para> + <para>See Also: <link linkend="LDAPSSL">ldap ssl</link> + </para> + + <para>Default : <command>ldap port = 636</command></para> </listitem> </varlistentry> @@ -3502,15 +3505,15 @@ <para> The <parameter>ldap ssl</parameter> can be set to one of three values: - (a) <command>on</command> - Always use SSL when contacting the - <parameter>ldap server</parameter>, (b) <command>off</command> - - Never use SSL when querying the directory, or (c) <command>start - tls</command> - Use the LDAPv3 StartTLS extended operation + (a) <constant>on</constant> - Always use SSL when contacting the + <parameter>ldap server</parameter>, (b) <constant>off</constant> - + Never use SSL when querying the directory, or (c) <constant>start_tls</constant> + - Use the LDAPv3 StartTLS extended operation (RFC2830) for communicating with the directory server. </para> - <para>Default : <command>ldap ssl = off</command></para> + <para>Default : <command>ldap ssl = on</command></para> </listitem> </varlistentry> diff --git a/docs/docbook/manpages/smbclient.1.sgml b/docs/docbook/manpages/smbclient.1.sgml index 6cc7be654ae..4f36de15767 100644 --- a/docs/docbook/manpages/smbclient.1.sgml +++ b/docs/docbook/manpages/smbclient.1.sgml @@ -357,7 +357,7 @@ to read the password. </para> <para>A third option is to use a credentials file which - contains the plaintext of the username and password. This + contains the plaintext of the domain name, username and password. This option is mainly provided for scripts where the admin doesn't wish to pass the credentials on the command line or via environment variables. If this method is used, make certain that the permissions @@ -375,17 +375,19 @@ <varlistentry> <term>-A filename</term><listitem><para>This option allows - you to specify a file from which to read the username and + you to specify a file from which to read the username, domain name, and password used in the connection. The format of the file is </para> <para><programlisting> username = <value> password = <value> +domain = <value> </programlisting></para> - <para>Make certain that the permissions on the file restrict + <para>If the domain parameter is missing the current workgroup name + is used instead. Make certain that the permissions on the file restrict access from unwanted users. </para></listitem> </varlistentry> diff --git a/docs/htmldocs/nmbd.8.html b/docs/htmldocs/nmbd.8.html index ad8c7c61ab7..f926e46a75b 100644 --- a/docs/htmldocs/nmbd.8.html +++ b/docs/htmldocs/nmbd.8.html @@ -37,12 +37,12 @@ NAME="AEN8" ><B CLASS="COMMAND" >nmbd</B -> [-D] [-a] [-o] [-P] [-h] [-V] [-d <debug level>] [-H <lmhosts file>] [-l <log directory>] [-n <primary netbios name>] [-p <port number>] [-s <configuration file>]</P +> [-D] [-a] [-i] [-o] [-P] [-h] [-V] [-d <debug level>] [-H <lmhosts file>] [-l <log directory>] [-n <primary netbios name>] [-p <port number>] [-s <configuration file>]</P ></DIV ><DIV CLASS="REFSECT1" ><A -NAME="AEN23" +NAME="AEN24" ></A ><H2 >DESCRIPTION</H2 @@ -112,7 +112,7 @@ CLASS="COMMAND" ><DIV CLASS="REFSECT1" ><A -NAME="AEN40" +NAME="AEN41" ></A ><H2 >OPTIONS</H2 @@ -152,6 +152,17 @@ CLASS="COMMAND" This is the default.</P ></DD ><DT +>-i</DT +><DD +><P +>If this parameter is specified it causes the + server to run "interactively", not as a daemon, even if the + server is executed on the command line of a shell. Setting this + parameter negates the implicit deamon mode when run from the + command line. + </P +></DD +><DT >-o</DT ><DD ><P @@ -366,7 +377,7 @@ CLASS="FILENAME" ><DIV CLASS="REFSECT1" ><A -NAME="AEN125" +NAME="AEN130" ></A ><H2 >FILES</H2 @@ -513,7 +524,7 @@ CLASS="FILENAME" ><DIV CLASS="REFSECT1" ><A -NAME="AEN171" +NAME="AEN176" ></A ><H2 >SIGNALS</H2 @@ -574,7 +585,7 @@ CLASS="COMMAND" ><DIV CLASS="REFSECT1" ><A -NAME="AEN187" +NAME="AEN192" ></A ><H2 >VERSION</H2 @@ -585,7 +596,7 @@ NAME="AEN187" ><DIV CLASS="REFSECT1" ><A -NAME="AEN190" +NAME="AEN195" ></A ><H2 >SEE ALSO</H2 @@ -650,7 +661,7 @@ TARGET="_top" ><DIV CLASS="REFSECT1" ><A -NAME="AEN207" +NAME="AEN212" ></A ><H2 >AUTHOR</H2 diff --git a/docs/htmldocs/smb.conf.5.html b/docs/htmldocs/smb.conf.5.html index f60cd595cf8..3d7e0b992b0 100644 --- a/docs/htmldocs/smb.conf.5.html +++ b/docs/htmldocs/smb.conf.5.html @@ -7935,7 +7935,7 @@ CLASS="COMMAND" ><P >Default: <B CLASS="COMMAND" ->encrypt passwords = no</B +>encrypt passwords = yes</B ></P ></DD ><DT @@ -9778,12 +9778,18 @@ CLASS="PARAMETER" ></TT ></A >. - The default is to use the stand LDAP port 389. + The default is to use the stand LDAPS port 636. + </P +><P +>See Also: <A +HREF="#LDAPSSL" +>ldap ssl</A +> </P ><P >Default : <B CLASS="COMMAND" ->ldap port = 389</B +>ldap port = 636</B ></P ></DD ><DT @@ -9865,30 +9871,30 @@ CLASS="PARAMETER" >ldap ssl</I ></TT > can be set to one of three values: - (a) <B -CLASS="COMMAND" ->on</B + (a) <TT +CLASS="CONSTANT" +>on</TT > - Always use SSL when contacting the <TT CLASS="PARAMETER" ><I >ldap server</I ></TT ->, (b) <B -CLASS="COMMAND" ->off</B +>, (b) <TT +CLASS="CONSTANT" +>off</TT > - - Never use SSL when querying the directory, or (c) <B -CLASS="COMMAND" ->start - tls</B -> - Use the LDAPv3 StartTLS extended operation + Never use SSL when querying the directory, or (c) <TT +CLASS="CONSTANT" +>start_tls</TT +> + - Use the LDAPv3 StartTLS extended operation (RFC2830) for communicating with the directory server. </P ><P >Default : <B CLASS="COMMAND" ->ldap ssl = off</B +>ldap ssl = on</B ></P ></DD ><DT @@ -19187,7 +19193,7 @@ CLASS="COMMAND" ><DIV CLASS="REFSECT1" ><A -NAME="AEN6052" +NAME="AEN6054" ></A ><H2 >WARNINGS</H2 @@ -19217,7 +19223,7 @@ TARGET="_top" ><DIV CLASS="REFSECT1" ><A -NAME="AEN6058" +NAME="AEN6060" ></A ><H2 >VERSION</H2 @@ -19228,7 +19234,7 @@ NAME="AEN6058" ><DIV CLASS="REFSECT1" ><A -NAME="AEN6061" +NAME="AEN6063" ></A ><H2 >SEE ALSO</H2 @@ -19307,7 +19313,7 @@ CLASS="COMMAND" ><DIV CLASS="REFSECT1" ><A -NAME="AEN6081" +NAME="AEN6083" ></A ><H2 >AUTHOR</H2 diff --git a/docs/htmldocs/smbclient.1.html b/docs/htmldocs/smbclient.1.html index 16fc134405a..6c15873787d 100644 --- a/docs/htmldocs/smbclient.1.html +++ b/docs/htmldocs/smbclient.1.html @@ -556,7 +556,7 @@ CLASS="ENVAR" to read the password. </P ><P >A third option is to use a credentials file which - contains the plaintext of the username and password. This + contains the plaintext of the domain name, username and password. This option is mainly provided for scripts where the admin doesn't wish to pass the credentials on the command line or via environment variables. If this method is used, make certain that the permissions @@ -589,7 +589,7 @@ CLASS="COMMAND" ><DD ><P >This option allows - you to specify a file from which to read the username and + you to specify a file from which to read the username, domain name, and password used in the connection. The format of the file is </P ><P @@ -603,13 +603,15 @@ WIDTH="90%" CLASS="PROGRAMLISTING" >username = <value> password = <value> +domain = <value> </PRE ></TD ></TR ></TABLE ></P ><P ->Make certain that the permissions on the file restrict +>If the domain parameter is missing the current workgroup name + is used instead. Make certain that the permissions on the file restrict access from unwanted users. </P ></DD ><DT diff --git a/docs/htmldocs/smbd.8.html b/docs/htmldocs/smbd.8.html index ba7116704d1..bfd3440d7b1 100644 --- a/docs/htmldocs/smbd.8.html +++ b/docs/htmldocs/smbd.8.html @@ -36,12 +36,12 @@ NAME="AEN8" ><B CLASS="COMMAND" >smbd</B -> [-D] [-a] [-o] [-P] [-h] [-V] [-b] [-d <debug level>] [-l <log directory>] [-p <port number>] [-O <socket option>] [-s <configuration file>]</P +> [-D] [-a] [-i] [-o] [-P] [-h] [-V] [-b] [-d <debug level>] [-l <log directory>] [-p <port number>] [-O <socket option>] [-s <configuration file>]</P ></DIV ><DIV CLASS="REFSECT1" ><A -NAME="AEN23" +NAME="AEN24" ></A ><H2 >DESCRIPTION</H2 @@ -106,7 +106,7 @@ CLASS="COMMAND" ><DIV CLASS="REFSECT1" ><A -NAME="AEN37" +NAME="AEN38" ></A ><H2 >OPTIONS</H2 @@ -144,6 +144,17 @@ CLASS="COMMAND" This is the default.</P ></DD ><DT +>-i</DT +><DD +><P +>If this parameter is specified it causes the + server to run "interactively", not as a daemon, even if the + server is executed on the command line of a shell. Setting this + parameter negates the implicit deamon mode when run from the + command line. + </P +></DD +><DT >-o</DT ><DD ><P @@ -343,7 +354,7 @@ CLASS="FILENAME" ><DIV CLASS="REFSECT1" ><A -NAME="AEN115" +NAME="AEN120" ></A ><H2 >FILES</H2 @@ -441,7 +452,7 @@ CLASS="FILENAME" ><DIV CLASS="REFSECT1" ><A -NAME="AEN148" +NAME="AEN153" ></A ><H2 >LIMITATIONS</H2 @@ -460,7 +471,7 @@ CLASS="COMMAND" ><DIV CLASS="REFSECT1" ><A -NAME="AEN152" +NAME="AEN157" ></A ><H2 >ENVIRONMENT VARIABLES</H2 @@ -491,7 +502,7 @@ CLASS="CONSTANT" ><DIV CLASS="REFSECT1" ><A -NAME="AEN161" +NAME="AEN166" ></A ><H2 >INSTALLATION</H2 @@ -613,7 +624,7 @@ CLASS="COMMAND" ><DIV CLASS="REFSECT1" ><A -NAME="AEN194" +NAME="AEN199" ></A ><H2 >RUNNING THE SERVER AS A DAEMON</H2 @@ -668,7 +679,7 @@ CLASS="COMMAND" ><DIV CLASS="REFSECT1" ><A -NAME="AEN207" +NAME="AEN212" ></A ><H2 >RUNNING THE SERVER ON REQUEST</H2 @@ -804,7 +815,7 @@ CLASS="COMPUTEROUTPUT" ><DIV CLASS="REFSECT1" ><A -NAME="AEN239" +NAME="AEN244" ></A ><H2 >PAM INTERACTION</H2 @@ -849,7 +860,7 @@ TARGET="_top" ><DIV CLASS="REFSECT1" ><A -NAME="AEN250" +NAME="AEN255" ></A ><H2 >TESTING THE INSTALLATION</H2 @@ -907,7 +918,7 @@ CLASS="FILENAME" ><DIV CLASS="REFSECT1" ><A -NAME="AEN264" +NAME="AEN269" ></A ><H2 >VERSION</H2 @@ -918,7 +929,7 @@ NAME="AEN264" ><DIV CLASS="REFSECT1" ><A -NAME="AEN267" +NAME="AEN272" ></A ><H2 >DIAGNOSTICS</H2 @@ -941,7 +952,7 @@ NAME="AEN267" ><DIV CLASS="REFSECT1" ><A -NAME="AEN272" +NAME="AEN277" ></A ><H2 >SIGNALS</H2 @@ -1006,7 +1017,7 @@ CLASS="COMMAND" ><DIV CLASS="REFSECT1" ><A -NAME="AEN289" +NAME="AEN294" ></A ><H2 >SEE ALSO</H2 @@ -1072,7 +1083,7 @@ TARGET="_top" ><DIV CLASS="REFSECT1" ><A -NAME="AEN306" +NAME="AEN311" ></A ><H2 >AUTHOR</H2 diff --git a/docs/manpages/findsmb.1 b/docs/manpages/findsmb.1 index 23a51a353de..634e051d30c 100644 --- a/docs/manpages/findsmb.1 +++ b/docs/manpages/findsmb.1 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "FINDSMB" "1" "06 December 2001" "" "" +.TH "FINDSMB" "1" "04 January 2002" "" "" .SH NAME findsmb \- list info about machines that respond to SMB name queries on a subnet .SH SYNOPSIS diff --git a/docs/manpages/lmhosts.5 b/docs/manpages/lmhosts.5 index eb55aa3104a..2b9ea919611 100644 --- a/docs/manpages/lmhosts.5 +++ b/docs/manpages/lmhosts.5 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "LMHOSTS" "5" "06 December 2001" "" "" +.TH "LMHOSTS" "5" "04 January 2002" "" "" .SH NAME lmhosts \- The Samba NetBIOS hosts file .SH SYNOPSIS diff --git a/docs/manpages/make_smbcodepage.1 b/docs/manpages/make_smbcodepage.1 index bb53aeb02dd..dd1483f288b 100644 --- a/docs/manpages/make_smbcodepage.1 +++ b/docs/manpages/make_smbcodepage.1 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "MAKE_SMBCODEPAGE" "1" "06 December 2001" "" "" +.TH "MAKE_SMBCODEPAGE" "1" "04 January 2002" "" "" .SH NAME make_smbcodepage \- construct a codepage file for Samba .SH SYNOPSIS diff --git a/docs/manpages/make_unicodemap.1 b/docs/manpages/make_unicodemap.1 index 93683c2708e..fd96e89711e 100644 --- a/docs/manpages/make_unicodemap.1 +++ b/docs/manpages/make_unicodemap.1 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "MAKE_UNICODEMAP" "1" "06 December 2001" "" "" +.TH "MAKE_UNICODEMAP" "1" "04 January 2002" "" "" .SH NAME make_unicodemap \- construct a unicode map file for Samba .SH SYNOPSIS diff --git a/docs/manpages/nmbd.8 b/docs/manpages/nmbd.8 index e7786549a1e..928cfce6e5a 100644 --- a/docs/manpages/nmbd.8 +++ b/docs/manpages/nmbd.8 @@ -3,12 +3,12 @@ .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "NMBD" "8" "06 December 2001" "" "" +.TH "NMBD" "8" "04 January 2002" "" "" .SH NAME nmbd \- NetBIOS name server to provide NetBIOS over IP naming services to clients .SH SYNOPSIS .sp -\fBnmbd\fR [ \fB-D\fR ] [ \fB-a\fR ] [ \fB-o\fR ] [ \fB-P\fR ] [ \fB-h\fR ] [ \fB-V\fR ] [ \fB-d <debug level>\fR ] [ \fB-H <lmhosts file>\fR ] [ \fB-l <log directory>\fR ] [ \fB-n <primary netbios name>\fR ] [ \fB-p <port number>\fR ] [ \fB-s <configuration file>\fR ] +\fBnmbd\fR [ \fB-D\fR ] [ \fB-a\fR ] [ \fB-i\fR ] [ \fB-o\fR ] [ \fB-P\fR ] [ \fB-h\fR ] [ \fB-V\fR ] [ \fB-d <debug level>\fR ] [ \fB-H <lmhosts file>\fR ] [ \fB-l <log directory>\fR ] [ \fB-n <primary netbios name>\fR ] [ \fB-p <port number>\fR ] [ \fB-s <configuration file>\fR ] .SH "DESCRIPTION" .PP This program is part of the Samba suite. @@ -61,6 +61,13 @@ If this parameter is specified, each new connection will append log messages to the log file. This is the default. .TP +\fB-i\fR +If this parameter is specified it causes the +server to run "interactively", not as a daemon, even if the +server is executed on the command line of a shell. Setting this +parameter negates the implicit deamon mode when run from the +command line. +.TP \fB-o\fR If this parameter is specified, the log files will be overwritten when opened. By default, diff --git a/docs/manpages/nmblookup.1 b/docs/manpages/nmblookup.1 index c607a4a72d5..0913f841a6b 100644 --- a/docs/manpages/nmblookup.1 +++ b/docs/manpages/nmblookup.1 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "NMBLOOKUP" "1" "06 December 2001" "" "" +.TH "NMBLOOKUP" "1" "04 January 2002" "" "" .SH NAME nmblookup \- NetBIOS over TCP/IP client used to lookup NetBIOS names .SH SYNOPSIS diff --git a/docs/manpages/rpcclient.1 b/docs/manpages/rpcclient.1 index a29dbe28440..3db53bc751e 100644 --- a/docs/manpages/rpcclient.1 +++ b/docs/manpages/rpcclient.1 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "RPCCLIENT" "1" "06 December 2001" "" "" +.TH "RPCCLIENT" "1" "04 January 2002" "" "" .SH NAME rpcclient \- tool for executing client side MS-RPC functions .SH SYNOPSIS diff --git a/docs/manpages/samba.7 b/docs/manpages/samba.7 index ff16ff7c915..883452243f5 100644 --- a/docs/manpages/samba.7 +++ b/docs/manpages/samba.7 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "SAMBA" "7" "06 December 2001" "" "" +.TH "SAMBA" "7" "04 January 2002" "" "" .SH NAME SAMBA \- A Windows SMB/CIFS fileserver for UNIX .SH SYNOPSIS diff --git a/docs/manpages/smb.conf.5 b/docs/manpages/smb.conf.5 index 9d88615f3f8..92ad1158f58 100644 --- a/docs/manpages/smb.conf.5 +++ b/docs/manpages/smb.conf.5 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "SMB.CONF" "5" "06 December 2001" "" "" +.TH "SMB.CONF" "5" "04 January 2002" "" "" .SH NAME smb.conf \- The configuration file for the Samba suite .SH "SYNOPSIS" @@ -2682,7 +2682,7 @@ and maintain this file), or set the security = [server|domain] parameter which causes \fBsmbd\fR to authenticate against another server. -Default: \fBencrypt passwords = no\fR +Default: \fBencrypt passwords = yes\fR .TP \fBenhanced browsing (G)\fR This option enables a couple of enhancements to @@ -3428,9 +3428,11 @@ under active development. This option is used to control the tcp port number used to contact the \fIldap server\fR. -The default is to use the stand LDAP port 389. +The default is to use the stand LDAPS port 636. -Default : \fBldap port = 389\fR +See Also: ldap ssl + +Default : \fBldap port = 636\fR .TP \fBldap server (G)\fR This parameter is only available if Samba has been @@ -3457,13 +3459,13 @@ Samba SSL support which is enabled by specifying the script (see \fIssl\fR). The \fIldap ssl\fR can be set to one of three values: -(a) \fBon\fR - Always use SSL when contacting the -\fIldap server\fR, (b) \fBoff\fR - -Never use SSL when querying the directory, or (c) \fBstart -tls\fR - Use the LDAPv3 StartTLS extended operation +(a) on - Always use SSL when contacting the +\fIldap server\fR, (b) off - +Never use SSL when querying the directory, or (c) start_tls +- Use the LDAPv3 StartTLS extended operation (RFC2830) for communicating with the directory server. -Default : \fBldap ssl = off\fR +Default : \fBldap ssl = on\fR .TP \fBldap suffix (G)\fR This parameter is only available if Samba has been diff --git a/docs/manpages/smbcacls.1 b/docs/manpages/smbcacls.1 index d2da694a263..022485bdcb1 100644 --- a/docs/manpages/smbcacls.1 +++ b/docs/manpages/smbcacls.1 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "SMBCACLS" "1" "06 December 2001" "" "" +.TH "SMBCACLS" "1" "04 January 2002" "" "" .SH NAME smbcacls \- Set or get ACLs on an NT file or directory names .SH SYNOPSIS diff --git a/docs/manpages/smbclient.1 b/docs/manpages/smbclient.1 index 4c5ef0b3e4b..5278887f0a7 100644 --- a/docs/manpages/smbclient.1 +++ b/docs/manpages/smbclient.1 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "SMBCLIENT" "1" "06 December 2001" "" "" +.TH "SMBCLIENT" "1" "04 January 2002" "" "" .SH NAME smbclient \- ftp-like client to access SMB/CIFS resources on servers .SH SYNOPSIS @@ -267,7 +267,7 @@ a \fBPASSWD\fR environment variable from which to read the password. A third option is to use a credentials file which -contains the plaintext of the username and password. This +contains the plaintext of the domain name, username and password. This option is mainly provided for scripts where the admin doesn't wish to pass the credentials on the command line or via environment variables. If this method is used, make certain that the permissions @@ -283,18 +283,20 @@ it in directly. .TP \fB-A filename\fR This option allows -you to specify a file from which to read the username and +you to specify a file from which to read the username, domain name, and password used in the connection. The format of the file is .sp .nf username = <value> password = <value> +domain = <value> .sp .fi -Make certain that the permissions on the file restrict +If the domain parameter is missing the current workgroup name +is used instead. Make certain that the permissions on the file restrict access from unwanted users. .TP \fB-L\fR diff --git a/docs/manpages/smbcontrol.1 b/docs/manpages/smbcontrol.1 index 4b27119673a..673c839d80e 100644 --- a/docs/manpages/smbcontrol.1 +++ b/docs/manpages/smbcontrol.1 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "SMBCONTROL" "1" "06 December 2001" "" "" +.TH "SMBCONTROL" "1" "04 January 2002" "" "" .SH NAME smbcontrol \- send messages to smbd or nmbd processes .SH SYNOPSIS diff --git a/docs/manpages/smbd.8 b/docs/manpages/smbd.8 index a01a239e5eb..9554bba6d5a 100644 --- a/docs/manpages/smbd.8 +++ b/docs/manpages/smbd.8 @@ -3,12 +3,12 @@ .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "SMBD" "8" "20 December 2001" "" "" +.TH "SMBD" "8" "04 January 2002" "" "" .SH NAME smbd \- server to provide SMB/CIFS services to clients .SH SYNOPSIS .sp -\fBsmbd\fR [ \fB-D\fR ] [ \fB-a\fR ] [ \fB-o\fR ] [ \fB-P\fR ] [ \fB-h\fR ] [ \fB-V\fR ] [ \fB-b\fR ] [ \fB-d <debug level>\fR ] [ \fB-l <log directory>\fR ] [ \fB-p <port number>\fR ] [ \fB-O <socket option>\fR ] [ \fB-s <configuration file>\fR ] +\fBsmbd\fR [ \fB-D\fR ] [ \fB-a\fR ] [ \fB-i\fR ] [ \fB-o\fR ] [ \fB-P\fR ] [ \fB-h\fR ] [ \fB-V\fR ] [ \fB-b\fR ] [ \fB-d <debug level>\fR ] [ \fB-l <log directory>\fR ] [ \fB-p <port number>\fR ] [ \fB-O <socket option>\fR ] [ \fB-s <configuration file>\fR ] .SH "DESCRIPTION" .PP This program is part of the Samba suite. @@ -64,6 +64,13 @@ If this parameter is specified, each new connection will append log messages to the log file. This is the default. .TP +\fB-i\fR +If this parameter is specified it causes the +server to run "interactively", not as a daemon, even if the +server is executed on the command line of a shell. Setting this +parameter negates the implicit deamon mode when run from the +command line. +.TP \fB-o\fR If this parameter is specified, the log files will be overwritten when opened. By default, diff --git a/docs/manpages/smbmnt.8 b/docs/manpages/smbmnt.8 index bab134ef54e..34c1970137f 100644 --- a/docs/manpages/smbmnt.8 +++ b/docs/manpages/smbmnt.8 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "SMBMNT" "8" "06 December 2001" "" "" +.TH "SMBMNT" "8" "04 January 2002" "" "" .SH NAME smbmnt \- helper utility for mounting SMB filesystems .SH SYNOPSIS diff --git a/docs/manpages/smbmount.8 b/docs/manpages/smbmount.8 index 70a0911887a..dcfe11e4b4f 100644 --- a/docs/manpages/smbmount.8 +++ b/docs/manpages/smbmount.8 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "SMBMOUNT" "8" "06 December 2001" "" "" +.TH "SMBMOUNT" "8" "04 January 2002" "" "" .SH NAME smbmount \- mount an smbfs filesystem .SH SYNOPSIS diff --git a/docs/manpages/smbpasswd.5 b/docs/manpages/smbpasswd.5 index b1adf080e7e..9fa964c9bbb 100644 --- a/docs/manpages/smbpasswd.5 +++ b/docs/manpages/smbpasswd.5 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "SMBPASSWD" "5" "06 December 2001" "" "" +.TH "SMBPASSWD" "5" "04 January 2002" "" "" .SH NAME smbpasswd \- The Samba encrypted password file .SH SYNOPSIS diff --git a/docs/manpages/smbpasswd.8 b/docs/manpages/smbpasswd.8 index 8e5be46e318..151a3270ffa 100644 --- a/docs/manpages/smbpasswd.8 +++ b/docs/manpages/smbpasswd.8 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "SMBPASSWD" "8" "06 December 2001" "" "" +.TH "SMBPASSWD" "8" "04 January 2002" "" "" .SH NAME smbpasswd \- change a user's SMB password .SH SYNOPSIS diff --git a/docs/manpages/smbsh.1 b/docs/manpages/smbsh.1 index 349853bbc7c..598da181d12 100644 --- a/docs/manpages/smbsh.1 +++ b/docs/manpages/smbsh.1 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "SMBSH" "1" "06 December 2001" "" "" +.TH "SMBSH" "1" "04 January 2002" "" "" .SH NAME smbsh \- Allows access to Windows NT filesystem using UNIX commands .SH SYNOPSIS diff --git a/docs/manpages/smbspool.8 b/docs/manpages/smbspool.8 index 864ea348f26..d18f48b5cae 100644 --- a/docs/manpages/smbspool.8 +++ b/docs/manpages/smbspool.8 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "SMBSPOOL" "8" "06 December 2001" "" "" +.TH "SMBSPOOL" "8" "04 January 2002" "" "" .SH NAME smbspool \- send print file to an SMB printer .SH SYNOPSIS diff --git a/docs/manpages/smbstatus.1 b/docs/manpages/smbstatus.1 index 17c1df25e54..9147ad98e7a 100644 --- a/docs/manpages/smbstatus.1 +++ b/docs/manpages/smbstatus.1 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "SMBSTATUS" "1" "06 December 2001" "" "" +.TH "SMBSTATUS" "1" "04 January 2002" "" "" .SH NAME smbstatus \- report on current Samba connections .SH SYNOPSIS diff --git a/docs/manpages/smbtar.1 b/docs/manpages/smbtar.1 index 8e70d75fd81..eb4a8b03198 100644 --- a/docs/manpages/smbtar.1 +++ b/docs/manpages/smbtar.1 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "SMBTAR" "1" "06 December 2001" "" "" +.TH "SMBTAR" "1" "04 January 2002" "" "" .SH NAME smbtar \- shell script for backing up SMB/CIFS shares directly to UNIX tape drives .SH SYNOPSIS diff --git a/docs/manpages/smbumount.8 b/docs/manpages/smbumount.8 index d20826950aa..dff1dbca368 100644 --- a/docs/manpages/smbumount.8 +++ b/docs/manpages/smbumount.8 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "SMBUMOUNT" "8" "06 December 2001" "" "" +.TH "SMBUMOUNT" "8" "04 January 2002" "" "" .SH NAME smbumount \- smbfs umount for normal users .SH SYNOPSIS diff --git a/docs/manpages/swat.8 b/docs/manpages/swat.8 index 5e19f8705ce..419eccf23aa 100644 --- a/docs/manpages/swat.8 +++ b/docs/manpages/swat.8 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "SWAT" "8" "06 December 2001" "" "" +.TH "SWAT" "8" "04 January 2002" "" "" .SH NAME swat \- Samba Web Administration Tool .SH SYNOPSIS diff --git a/docs/manpages/testparm.1 b/docs/manpages/testparm.1 index d9515eddf42..23bbe1d0c62 100644 --- a/docs/manpages/testparm.1 +++ b/docs/manpages/testparm.1 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "TESTPARM" "1" "06 December 2001" "" "" +.TH "TESTPARM" "1" "04 January 2002" "" "" .SH NAME testparm \- check an smb.conf configuration file for internal correctness .SH SYNOPSIS diff --git a/docs/manpages/testprns.1 b/docs/manpages/testprns.1 index fd62ed83861..8fbb41affa9 100644 --- a/docs/manpages/testprns.1 +++ b/docs/manpages/testprns.1 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "TESTPRNS" "1" "06 December 2001" "" "" +.TH "TESTPRNS" "1" "04 January 2002" "" "" .SH NAME testprns \- check printer name for validity with smbd .SH SYNOPSIS diff --git a/docs/manpages/wbinfo.1 b/docs/manpages/wbinfo.1 index 63795899c82..a42a9ca31e4 100644 --- a/docs/manpages/wbinfo.1 +++ b/docs/manpages/wbinfo.1 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "WBINFO" "1" "06 December 2001" "" "" +.TH "WBINFO" "1" "04 January 2002" "" "" .SH NAME wbinfo \- Query information from winbind daemon .SH SYNOPSIS diff --git a/docs/manpages/winbindd.8 b/docs/manpages/winbindd.8 index cfd4fa2fb27..da5988811a8 100644 --- a/docs/manpages/winbindd.8 +++ b/docs/manpages/winbindd.8 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "WINBINDD" "8" "06 December 2001" "" "" +.TH "WINBINDD" "8" "04 January 2002" "" "" .SH NAME winbindd \- Name Service Switch daemon for resolving names from NT servers .SH SYNOPSIS |