diff options
author | Gerald Carter <jerry@samba.org> | 2002-11-27 02:42:12 +0000 |
---|---|---|
committer | Gerald Carter <jerry@samba.org> | 2002-11-27 02:42:12 +0000 |
commit | e2a958058c7977ba81badc4a205a8e762595f1c8 (patch) | |
tree | 827821e82be46899200f4e00e3a46fb515646ed5 /docs | |
parent | 0c1a06dfad03a45dc5cfff027dacd6e95194a786 (diff) | |
download | samba-e2a958058c7977ba81badc4a205a8e762595f1c8.tar.gz samba-e2a958058c7977ba81badc4a205a8e762595f1c8.tar.bz2 samba-e2a958058c7977ba81badc4a205a8e762595f1c8.zip |
update docs for "password server" and regenerate
also fixed a number of syntax errors in the SGML source
for several man pages (people really need to start validating
docs before checking them in).
(This used to be commit 91a21782e09562644ab4938cb0170b8fb94f0ccf)
Diffstat (limited to 'docs')
-rw-r--r-- | docs/docbook/manpages/pdbedit.8.sgml | 3 | ||||
-rw-r--r-- | docs/docbook/manpages/smb.conf.5.sgml | 19 | ||||
-rw-r--r-- | docs/docbook/manpages/testparm.1.sgml | 1 | ||||
-rw-r--r-- | docs/htmldocs/nmbd.8.html | 75 | ||||
-rw-r--r-- | docs/htmldocs/rpcclient.1.html | 103 | ||||
-rw-r--r-- | docs/htmldocs/smbclient.1.html | 116 | ||||
-rw-r--r-- | docs/htmldocs/smbd.8.html | 100 | ||||
-rw-r--r-- | docs/manpages/findsmb.1 | 4 | ||||
-rw-r--r-- | docs/manpages/nmbd.8 | 8 | ||||
-rw-r--r-- | docs/manpages/nmblookup.1 | 11 | ||||
-rw-r--r-- | docs/manpages/pdbedit.8 | 37 | ||||
-rw-r--r-- | docs/manpages/rpcclient.1 | 10 | ||||
-rw-r--r-- | docs/manpages/smb.conf.5 | 211 | ||||
-rw-r--r-- | docs/manpages/smbclient.1 | 4 | ||||
-rw-r--r-- | docs/manpages/smbd.8 | 26 | ||||
-rw-r--r-- | docs/manpages/smbpasswd.5 | 4 | ||||
-rw-r--r-- | docs/manpages/smbpasswd.8 | 15 | ||||
-rw-r--r-- | docs/manpages/smbsh.1 | 4 | ||||
-rw-r--r-- | docs/manpages/testparm.1 | 9 | ||||
-rw-r--r-- | docs/manpages/vfstest.1 | 13 | ||||
-rw-r--r-- | docs/manpages/wbinfo.1 | 14 | ||||
-rw-r--r-- | docs/manpages/winbindd.8 | 25 |
22 files changed, 391 insertions, 421 deletions
diff --git a/docs/docbook/manpages/pdbedit.8.sgml b/docs/docbook/manpages/pdbedit.8.sgml index ed49b9f540..1484bfec9a 100644 --- a/docs/docbook/manpages/pdbedit.8.sgml +++ b/docs/docbook/manpages/pdbedit.8.sgml @@ -278,7 +278,7 @@ <listitem><para>Display an account policy</para> <para>Valid policies are: minimum password age, reset count minutes, disconnect time, user must logon to change password, password history, lockout duration, min password length, - maximum password age and bad lockout attempt. + maximum password age and bad lockout attempt.</para> <para>Example: <command>pdbedit -P "bad lockout attempt"</command></para> <para><programlisting> @@ -293,6 +293,7 @@ <listitem><para>Sets an account policy to a specified value. This option may only be used in conjunction with the <parameter>-P</parameter> option. + </para> <para>Example: <command>pdbedit -P "bad lockout attempt" -V 3</command></para> <para><programlisting> diff --git a/docs/docbook/manpages/smb.conf.5.sgml b/docs/docbook/manpages/smb.conf.5.sgml index 6ed870ed3e..13fdb1c6cb 100644 --- a/docs/docbook/manpages/smb.conf.5.sgml +++ b/docs/docbook/manpages/smb.conf.5.sgml @@ -5377,10 +5377,11 @@ <listitem><para><command>ldapsam_nua</command> - The LDAP based passdb backend, with non unix account support. Takes an LDAP URL as an optional argument (defaults to <command>ldap://localhost</command>)</para> - <para>Note: In this module, any account - without a matching POSIX account is regarded - as 'non unix'. - <para>See also <link linkend="NONUNIXACCOUNTRANGE"> + + <para>Note: In this module, any account without a matching POSIX account is regarded + as 'non unix'. </para> + + <para>See also <link linkend="NONUNIXACCOUNTRANGE"> <parameter>non unix account range</parameter></link></para> @@ -5650,6 +5651,12 @@ doing a query for the name <constant>WORKGROUP<1C></constant> and then contacting each server returned in the list of IP addresses from the name resolution source. </para> + + <para>If the list of servers contains both names and the '*' + character, the list is treated as a list of preferred + domain controllers, but an auto lookup of all remaining DC's + will be added to the list as well. Samba will not attempt to optimize + this list by locating the closest DC.</para> <para>If the <parameter>security</parameter> parameter is set to <constant>server</constant>, then there are different @@ -5677,7 +5684,7 @@ <para>Default: <command>password server = <empty string></command> </para> - <para>Example: <command>password server = NT-PDC, NT-BDC1, NT-BDC2 + <para>Example: <command>password server = NT-PDC, NT-BDC1, NT-BDC2, * </command></para> <para>Example: <command>password server = *</command></para> </listitem> @@ -6547,7 +6554,7 @@ <listitem><para>This is a integer parameter, and mirrors as much as possible the functinality the <constant>RestrictAnonymous</constant> - registry key does on NT/Win2k. + registry key does on NT/Win2k. </para> <para>Default: <command>restrict anonymous = 0</command></para> </listitem> diff --git a/docs/docbook/manpages/testparm.1.sgml b/docs/docbook/manpages/testparm.1.sgml index 254ede7265..f34528a43d 100644 --- a/docs/docbook/manpages/testparm.1.sgml +++ b/docs/docbook/manpages/testparm.1.sgml @@ -92,6 +92,7 @@ <listitem><para> Output data in specified encoding. </para></listitem> + </varlistentry> <varlistentry> <term>configfilename</term> diff --git a/docs/htmldocs/nmbd.8.html b/docs/htmldocs/nmbd.8.html index 05bf860124..c427e488dc 100644 --- a/docs/htmldocs/nmbd.8.html +++ b/docs/htmldocs/nmbd.8.html @@ -1,11 +1,12 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >nmbd</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.77"></HEAD +CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ +"></HEAD ><BODY CLASS="REFENTRY" BGCOLOR="#FFFFFF" @@ -15,9 +16,7 @@ VLINK="#840084" ALINK="#0000FF" ><H1 ><A -NAME="NMBD" -></A ->nmbd</H1 +NAME="NMBD">nmbd</H1 ><DIV CLASS="REFNAMEDIV" ><A @@ -30,20 +29,18 @@ NAME="AEN5" ><DIV CLASS="REFSYNOPSISDIV" ><A -NAME="AEN8" -></A -><H2 +NAME="AEN8"><H2 >Synopsis</H2 ><P ><B CLASS="COMMAND" >nmbd</B -> [-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 +> [-D] [-a] [-i] [-o] [-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="AEN24" +NAME="AEN23" ></A ><H2 >DESCRIPTION</H2 @@ -56,7 +53,7 @@ CLASS="COMMAND" > is a server that understands and can reply to NetBIOS over IP name service requests, like those produced by SMB/CIFS clients such as Windows 95/98/ME, - Windows NT, Windows 2000, and LanManager clients. It also + Windows NT, Windows 2000, Windows XP and LanManager clients. It also participates in the browsing protocols which make up the Windows "Network Neighborhood" view.</P ><P @@ -72,12 +69,9 @@ CLASS="COMMAND" specified it will respond with the IP number of the host it is running on. Its "own NetBIOS name" is by default the primary DNS name of the host it is running on, - but this can be overridden with the <SPAN -CLASS="emphasis" -><I + but this can be overridden with the <I CLASS="EMPHASIS" >-n</I -></SPAN > option (see OPTIONS below). Thus <B CLASS="COMMAND" @@ -117,7 +111,7 @@ CLASS="COMMAND" ><DIV CLASS="REFSECT1" ><A -NAME="AEN41" +NAME="AEN40" ></A ><H2 >OPTIONS</H2 @@ -190,7 +184,7 @@ CLASS="COMMAND" >.</P ></DD ><DT ->-H <filename></DT +>-H <filename></DT ><DD ><P >NetBIOS lmhosts file. The lmhosts @@ -209,24 +203,18 @@ CLASS="FILENAME" ></A > to resolve any NetBIOS name queries needed by the server. Note - that the contents of this file are <SPAN -CLASS="emphasis" -><I + that the contents of this file are <I CLASS="EMPHASIS" >NOT</I -></SPAN > used by <B CLASS="COMMAND" >nmbd</B > to answer any name queries. Adding a line to this file affects name NetBIOS resolution - from this host <SPAN -CLASS="emphasis" -><I + from this host <I CLASS="EMPHASIS" >ONLY</I -></SPAN >.</P ><P >The default path to this file is compiled into @@ -264,7 +252,7 @@ CLASS="COMMAND" >.</P ></DD ><DT ->-d <debug level></DT +>-d <debug level></DT ><DD ><P >debuglevel is an integer @@ -300,7 +288,7 @@ CLASS="FILENAME" > file.</P ></DD ><DT ->-l <log directory></DT +>-l <log directory></DT ><DD ><P >The -l parameter specifies a directory @@ -320,12 +308,9 @@ CLASS="FILENAME" <TT CLASS="FILENAME" >/var/log/log.nmb</TT ->. <SPAN -CLASS="emphasis" -><I +>. <I CLASS="EMPHASIS" >Beware:</I -></SPAN > If the directory specified does not exist, <B CLASS="COMMAND" @@ -335,7 +320,7 @@ CLASS="COMMAND" </P ></DD ><DT ->-n <primary NetBIOS name></DT +>-n <primary NetBIOS name></DT ><DD ><P >This option allows you to override @@ -360,7 +345,7 @@ CLASS="FILENAME" >.</P ></DD ><DT ->-p <UDP port number></DT +>-p <UDP port number></DT ><DD ><P >UDP port number is a positive integer value. @@ -373,7 +358,7 @@ CLASS="COMMAND" won't need help!</P ></DD ><DT ->-s <configuration file></DT +>-s <configuration file></DT ><DD ><P >The default configuration file name @@ -400,7 +385,7 @@ CLASS="FILENAME" ><DIV CLASS="REFSECT1" ><A -NAME="AEN131" +NAME="AEN130" ></A ><H2 >FILES</H2 @@ -523,12 +508,9 @@ CLASS="FILENAME" >If <B CLASS="COMMAND" >nmbd</B -> is acting as a <SPAN -CLASS="emphasis" -><I +> is acting as a <I CLASS="EMPHASIS" > browse master</I -></SPAN > (see the <A HREF="smb.conf.5.html#LOCALMASTER" TARGET="_top" @@ -559,7 +541,7 @@ CLASS="FILENAME" ><DIV CLASS="REFSECT1" ><A -NAME="AEN178" +NAME="AEN177" ></A ><H2 >SIGNALS</H2 @@ -568,12 +550,9 @@ NAME="AEN178" CLASS="COMMAND" >nmbd</B > process it is recommended - that SIGKILL (-9) <SPAN -CLASS="emphasis" -><I + that SIGKILL (-9) <I CLASS="EMPHASIS" >NOT</I -></SPAN > be used, except as a last resort, as this may leave the name database in an inconsistent state. The correct way to terminate <B @@ -624,18 +603,18 @@ CLASS="COMMAND" ><DIV CLASS="REFSECT1" ><A -NAME="AEN194" +NAME="AEN193" ></A ><H2 >VERSION</H2 ><P ->This man page is correct for version 2.2 of +>This man page is correct for version 3.0 of the Samba suite.</P ></DIV ><DIV CLASS="REFSECT1" ><A -NAME="AEN197" +NAME="AEN196" ></A ><H2 >SEE ALSO</H2 @@ -700,7 +679,7 @@ TARGET="_top" ><DIV CLASS="REFSECT1" ><A -NAME="AEN214" +NAME="AEN213" ></A ><H2 >AUTHOR</H2 diff --git a/docs/htmldocs/rpcclient.1.html b/docs/htmldocs/rpcclient.1.html index 3669e19b03..e6953122c4 100644 --- a/docs/htmldocs/rpcclient.1.html +++ b/docs/htmldocs/rpcclient.1.html @@ -1,11 +1,12 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >rpcclient</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.77"></HEAD +CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ +"></HEAD ><BODY CLASS="REFENTRY" BGCOLOR="#FFFFFF" @@ -15,9 +16,7 @@ VLINK="#840084" ALINK="#0000FF" ><H1 ><A -NAME="RPCCLIENT" -></A ->rpcclient</H1 +NAME="RPCCLIENT">rpcclient</H1 ><DIV CLASS="REFNAMEDIV" ><A @@ -30,15 +29,13 @@ NAME="AEN5" ><DIV CLASS="REFSYNOPSISDIV" ><A -NAME="AEN8" -></A -><H2 +NAME="AEN8"><H2 >Synopsis</H2 ><P ><B CLASS="COMMAND" >rpcclient</B -> [-A authfile] [-c <command string>] [-d debuglevel] [-h] [-l logfile] [-N] [-s <smb config file>] [-U username[%password]] [-W workgroup] [-N] [-I destinationIP] {server}</P +> [-A authfile] [-c <command string>] [-d debuglevel] [-h] [-l logfile] [-N] [-s <smb config file>] [-U username[%password]] [-W workgroup] [-N] [-I destinationIP] {server}</P ></DIV ><DIV CLASS="REFSECT1" @@ -105,12 +102,21 @@ CLASS="FILENAME" password used in the connection. The format of the file is </P ><P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD ><PRE CLASS="PROGRAMLISTING" -> username = <value> - password = <value> - domain = <value> +> username = <value> + password = <value> + domain = <value> </PRE +></TD +></TR +></TABLE ></P ><P >Make certain that the permissions on the file restrict @@ -124,25 +130,6 @@ CLASS="PROGRAMLISTING" below)) </P ></DD ><DT ->-d|--debug=debuglevel</DT -><DD -><P ->set the debuglevel. Debug level 0 is the lowest - and 100 being the highest. This should be set to 100 if you are - planning on submitting a bug report to the Samba team (see <TT -CLASS="FILENAME" ->BUGS.txt</TT ->). - </P -></DD -><DT ->-h|--help</DT -><DD -><P ->Print a summary of command line options. - </P -></DD -><DT >-I IP-address</DT ><DD ><P @@ -275,17 +262,14 @@ CLASS="COMMAND" ><DIV CLASS="REFSECT1" ><A -NAME="AEN101" +NAME="AEN92" ></A ><H2 >COMMANDS</H2 ><P -><SPAN -CLASS="emphasis" ><I CLASS="EMPHASIS" >LSARPC</I -></SPAN ></P ><P ></P @@ -326,12 +310,9 @@ CLASS="COMMAND" ><P > </P ><P -><SPAN -CLASS="emphasis" ><I CLASS="EMPHASIS" >SAMR</I -></SPAN ></P ><P ></P @@ -396,12 +377,9 @@ CLASS="COMMAND" ><P > </P ><P -><SPAN -CLASS="emphasis" ><I CLASS="EMPHASIS" >SPOOLSS</I -></SPAN ></P ><P ></P @@ -410,7 +388,7 @@ CLASS="EMPHASIS" ><P ><B CLASS="COMMAND" ->adddriver <arch> <config></B +>adddriver <arch> <config></B > - Execute an AddPrinterDriver() RPC to install the printer driver information on the server. Note that the driver files should @@ -437,6 +415,12 @@ CLASS="PARAMETER" > parameter is defined as follows: </P ><P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD ><PRE CLASS="PROGRAMLISTING" > Long Printer Name:\ @@ -448,6 +432,9 @@ CLASS="PROGRAMLISTING" Default Data Type:\ Comma Separated list of Files </PRE +></TD +></TR +></TABLE ></P ><P >Any empty fields should be enter as the string "NULL". </P @@ -463,8 +450,8 @@ CLASS="PROGRAMLISTING" ><P ><B CLASS="COMMAND" ->addprinter <printername> - <sharename> <drivername> <port></B +>addprinter <printername> + <sharename> <drivername> <port></B > - Add a printer on the remote server. This printer will be automatically shared. Be aware that the printer driver @@ -510,7 +497,7 @@ CLASS="COMMAND" ><P ><B CLASS="COMMAND" ->enumjobs <printer></B +>enumjobs <printer></B > - List the jobs and status of a given printer. This command corresponds to the MS Platform SDK EnumJobs() @@ -552,7 +539,7 @@ CLASS="COMMAND" ><P ><B CLASS="COMMAND" ->getdata <printername></B +>getdata <printername></B > - Retrieve the data for a given printer setting. See the <B @@ -566,7 +553,7 @@ CLASS="COMMAND" ><P ><B CLASS="COMMAND" ->getdriver <printername></B +>getdriver <printername></B > - Retrieve the printer driver information (such as driver file, config file, dependent files, etc...) for @@ -578,7 +565,7 @@ CLASS="COMMAND" ><P ><B CLASS="COMMAND" ->getdriverdir <arch></B +>getdriverdir <arch></B > - Execute a GetPrinterDriverDirectory() RPC to retrieve the SMB share name and subdirectory for @@ -596,7 +583,7 @@ CLASS="PARAMETER" ><P ><B CLASS="COMMAND" ->getprinter <printername></B +>getprinter <printername></B > - Retrieve the current printer information. This command corresponds to the GetPrinter() MS Platform SDK function. @@ -606,7 +593,7 @@ CLASS="COMMAND" ><P ><B CLASS="COMMAND" ->openprinter <printername></B +>openprinter <printername></B > - Execute an OpenPrinterEx() and ClosePrinter() RPC against a given printer. </P @@ -615,8 +602,8 @@ CLASS="COMMAND" ><P ><B CLASS="COMMAND" ->setdriver <printername> - <drivername></B +>setdriver <printername> + <drivername></B > - Execute a SetPrinter() command to update the printer driver associated with an installed printer. The printer driver must @@ -634,12 +621,9 @@ CLASS="COMMAND" ></LI ></UL ><P -><SPAN -CLASS="emphasis" ><I CLASS="EMPHASIS" >GENERAL OPTIONS</I -></SPAN ></P ><P ></P @@ -677,7 +661,7 @@ CLASS="COMMAND" ><DIV CLASS="REFSECT1" ><A -NAME="AEN221" +NAME="AEN212" ></A ><H2 >BUGS</H2 @@ -692,12 +676,9 @@ CLASS="COMMAND" ><P >From Luke Leighton's original rpcclient man page:</P ><P -><SPAN -CLASS="emphasis" ><I CLASS="EMPHASIS" >"WARNING!</I -></SPAN > The MSRPC over SMB code has been developed from examining Network traces. No documentation is available from the original creators (Microsoft) on how MSRPC over @@ -722,7 +703,7 @@ CLASS="COMMAND" ><DIV CLASS="REFSECT1" ><A -NAME="AEN231" +NAME="AEN222" ></A ><H2 >VERSION</H2 @@ -733,7 +714,7 @@ NAME="AEN231" ><DIV CLASS="REFSECT1" ><A -NAME="AEN234" +NAME="AEN225" ></A ><H2 >AUTHOR</H2 diff --git a/docs/htmldocs/smbclient.1.html b/docs/htmldocs/smbclient.1.html index 1e251c2ca5..35867420eb 100644 --- a/docs/htmldocs/smbclient.1.html +++ b/docs/htmldocs/smbclient.1.html @@ -1,11 +1,12 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >smbclient</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.77"></HEAD +CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ +"></HEAD ><BODY CLASS="REFENTRY" BGCOLOR="#FFFFFF" @@ -15,9 +16,7 @@ VLINK="#840084" ALINK="#0000FF" ><H1 ><A -NAME="SMBCLIENT" -></A ->smbclient</H1 +NAME="SMBCLIENT">smbclient</H1 ><DIV CLASS="REFNAMEDIV" ><A @@ -30,15 +29,13 @@ NAME="AEN5" ><DIV CLASS="REFSYNOPSISDIV" ><A -NAME="AEN8" -></A -><H2 +NAME="AEN8"><H2 >Synopsis</H2 ><P ><B CLASS="COMMAND" >smbclient</B -> {servicename} [password] [-b <buffer size>] [-d debuglevel] [-D Directory] [-U username] [-W workgroup] [-M <netbios name>] [-m maxprotocol] [-A authfile] [-N] [-l logfile] [-L <netbios name>] [-I destinationIP] [-E <terminal code>] [-c <command string>] [-i scope] [-O <socket options>] [-p port] [-R <name resolve order>] [-s <smb config file>] [-T<c|x>IXFqgbNan]</P +> {servicename} [password] [-b <buffer size>] [-d debuglevel] [-D Directory] [-U username] [-W workgroup] [-M <netbios name>] [-m maxprotocol] [-A authfile] [-N] [-l logfile] [-L <netbios name>] [-I destinationIP] [-E] [-c <command string>] [-i scope] [-O <socket options>] [-p port] [-R <name resolve order>] [-s <smb config file>] [-T<c|x>IXFqgbNan]</P ></DIV ><DIV CLASS="REFSECT1" @@ -196,7 +193,7 @@ CLASS="FILENAME" options. </P ></DD ><DT ->-R <name resolve order></DT +>-R <name resolve order></DT ><DD ><P >This option is used by the programs in the Samba @@ -349,12 +346,9 @@ CLASS="FILENAME" > for a description of how to handle incoming WinPopup messages in Samba. </P ><P -><SPAN -CLASS="emphasis" ><I CLASS="EMPHASIS" >Note</I -></SPAN >: Copy WinPopup into the startup group on your WfWg PCs if you want them to always be able to receive messages. </P @@ -373,12 +367,9 @@ CLASS="FILENAME" CLASS="FILENAME" >rfc1002.txt</TT >. - NetBIOS scopes are <SPAN -CLASS="emphasis" -><I + NetBIOS scopes are <I CLASS="EMPHASIS" >very</I -></SPAN > rarely used, only set this parameter if you are the system administrator in charge of all the NetBIOS systems you communicate with. </P @@ -435,20 +426,14 @@ CLASS="REPLACEABLE" ><I >debuglevel</I ></TT -> is set to the letter 'A', then <SPAN -CLASS="emphasis" -><I +> is set to the letter 'A', then <I CLASS="EMPHASIS" >all </I -></SPAN > debug messages will be printed. This setting - is for developers only (and people who <SPAN -CLASS="emphasis" -><I + is for developers only (and people who <I CLASS="EMPHASIS" >really</I -></SPAN > want to know how the code works internally). </P ><P @@ -610,12 +595,21 @@ CLASS="COMMAND" password used in the connection. The format of the file is </P ><P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="90%" +><TR +><TD ><PRE CLASS="PROGRAMLISTING" ->username = <value> -password = <value> -domain = <value> +>username = <value> +password = <value> +domain = <value> </PRE +></TD +></TR +></TABLE ></P ><P >If the domain parameter is missing the current workgroup name @@ -651,18 +645,12 @@ CLASS="COMMAND" > how to interpret filenames coming from the remote server. Usually Asian language multibyte UNIX implementations use different character sets than - SMB/CIFS servers (<SPAN -CLASS="emphasis" -><I + SMB/CIFS servers (<I CLASS="EMPHASIS" >EUC</I -></SPAN -> instead of <SPAN -CLASS="emphasis" -><I +> instead of <I CLASS="EMPHASIS" > SJIS</I -></SPAN > for example). Setting this parameter will let <B CLASS="COMMAND" @@ -876,12 +864,9 @@ CLASS="PARAMETER" ></LI ></UL ><P -><SPAN -CLASS="emphasis" ><I CLASS="EMPHASIS" >Tar Long File Names</I -></SPAN ></P ><P ><B @@ -897,24 +882,18 @@ CLASS="COMMAND" files in the archive with relative names, not absolute names. </P ><P -><SPAN -CLASS="emphasis" ><I CLASS="EMPHASIS" >Tar Filenames</I -></SPAN ></P ><P >All file names can be given as DOS path names (with '\' as the component separator) or as UNIX path names (with '/' as the component separator). </P ><P -><SPAN -CLASS="emphasis" ><I CLASS="EMPHASIS" >Examples</I -></SPAN ></P ><P >Restore from tar file <TT @@ -1016,7 +995,7 @@ NAME="AEN310" ><P ><TT CLASS="PROMPT" ->smb:\> </TT +>smb:\> </TT ></P ><P >The backslash ("\") indicates the current working directory @@ -1036,7 +1015,7 @@ CLASS="PROMPT" ><P >Parameters shown in square brackets (e.g., "[parameter]") are optional. If not given, the command will use suitable defaults. Parameters - shown in angle brackets (e.g., "<parameter>") are required. + shown in angle brackets (e.g., "<parameter>") are required. </P ><P >Note that all commands operating on the server are actually @@ -1127,7 +1106,7 @@ CLASS="REPLACEABLE" directory on the server will be reported. </P ></DD ><DT ->del <mask></DT +>del <mask></DT ><DD ><P >The client will request that the server attempt @@ -1140,7 +1119,7 @@ CLASS="REPLACEABLE" directory on the server. </P ></DD ><DT ->dir <mask></DT +>dir <mask></DT ><DD ><P >A list of the files matching <TT @@ -1160,7 +1139,7 @@ CLASS="REPLACEABLE" from the program. </P ></DD ><DT ->get <remote file name> [local file name]</DT +>get <remote file name> [local file name]</DT ><DD ><P >Copy the file called <TT @@ -1225,13 +1204,13 @@ CLASS="REPLACEABLE" lowercase filenames are the norm on UNIX systems. </P ></DD ><DT ->ls <mask></DT +>ls <mask></DT ><DD ><P >See the dir command above. </P ></DD ><DT ->mask <mask></DT +>mask <mask></DT ><DD ><P >This command allows the user to set up a mask @@ -1257,13 +1236,13 @@ CLASS="REPLACEABLE" mask back to "*" after using the mget or mput commands. </P ></DD ><DT ->md <directory name></DT +>md <directory name></DT ><DD ><P >See the mkdir command. </P ></DD ><DT ->mget <mask></DT +>mget <mask></DT ><DD ><P >Copy all files matching <TT @@ -1288,14 +1267,14 @@ CLASS="COMMAND" > are binary. See also the lowercase command. </P ></DD ><DT ->mkdir <directory name></DT +>mkdir <directory name></DT ><DD ><P >Create a new directory on the server (user access privileges permitting) with the specified name. </P ></DD ><DT ->mput <mask></DT +>mput <mask></DT ><DD ><P >Copy all files matching <TT @@ -1321,7 +1300,7 @@ CLASS="COMMAND" are binary. </P ></DD ><DT ->print <file name></DT +>print <file name></DT ><DD ><P >Print the specified file from the local machine @@ -1330,7 +1309,7 @@ CLASS="COMMAND" >See also the printmode command.</P ></DD ><DT ->printmode <graphics or text></DT +>printmode <graphics or text></DT ><DD ><P >Set the print mode to suit either binary data @@ -1350,7 +1329,7 @@ CLASS="COMMAND" </P ></DD ><DT ->put <local file name> [remote file name]</DT +>put <local file name> [remote file name]</DT ><DD ><P >Copy the file called <TT @@ -1382,7 +1361,7 @@ CLASS="COMMAND" >See the exit command. </P ></DD ><DT ->rd <directory name></DT +>rd <directory name></DT ><DD ><P >See the rmdir command. </P @@ -1407,7 +1386,7 @@ CLASS="COMMAND" using the mask command will be ignored. </P ></DD ><DT ->rm <mask></DT +>rm <mask></DT ><DD ><P >Remove all files matching <TT @@ -1419,14 +1398,14 @@ CLASS="REPLACEABLE" working directory on the server. </P ></DD ><DT ->rmdir <directory name></DT +>rmdir <directory name></DT ><DD ><P >Remove the specified directory (user access privileges permitting) from the server. </P ></DD ><DT ->setmode <filename> <perm=[+|\-]rsha></DT +>setmode <filename> <perm=[+|\-]rsha></DT ><DD ><P >A version of the DOS attrib command to set @@ -1451,7 +1430,7 @@ CLASS="COMMAND" </P ></DD ><DT ->tar <c|x>[IXbgNa]</DT +>tar <c|x>[IXbgNa]</DT ><DD ><P >Performs a tar operation - see the <TT @@ -1467,7 +1446,7 @@ CLASS="PARAMETER" </P ></DD ><DT ->blocksize <blocksize></DT +>blocksize <blocksize></DT ><DD ><P >Blocksize. Must be followed by a valid (greater @@ -1480,7 +1459,7 @@ CLASS="REPLACEABLE" >*TBLOCK (usually 512 byte) blocks. </P ></DD ><DT ->tarmode <full|inc|reset|noreset></DT +>tarmode <full|inc|reset|noreset></DT ><DD ><P >Changes tar's behavior with regard to archive @@ -1568,12 +1547,9 @@ CLASS="FILENAME" > /usr/samba/bin/</TT > directory, this directory readable by all, writeable only by root. The client program itself should - be executable by all. The client should <SPAN -CLASS="emphasis" -><I + be executable by all. The client should <I CLASS="EMPHASIS" >NOT</I -></SPAN > be setuid or setgid! </P ><P diff --git a/docs/htmldocs/smbd.8.html b/docs/htmldocs/smbd.8.html index 22340139ed..ff0abc2bd1 100644 --- a/docs/htmldocs/smbd.8.html +++ b/docs/htmldocs/smbd.8.html @@ -1,11 +1,12 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >smbd</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.77"></HEAD +CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ +"></HEAD ><BODY CLASS="REFENTRY" BGCOLOR="#FFFFFF" @@ -15,9 +16,7 @@ VLINK="#840084" ALINK="#0000FF" ><H1 ><A -NAME="SMBD" -></A ->smbd</H1 +NAME="SMBD">smbd</H1 ><DIV CLASS="REFNAMEDIV" ><A @@ -29,20 +28,18 @@ NAME="AEN5" ><DIV CLASS="REFSYNOPSISDIV" ><A -NAME="AEN8" -></A -><H2 +NAME="AEN8"><H2 >Synopsis</H2 ><P ><B CLASS="COMMAND" >smbd</B -> [-D] [-a] [-i] [-o] [-P] [-h] [-V] [-b] [-d <debug level>] [-l <log directory>] [-p <port number>] [-O <socket option>] [-s <configuration file>]</P +> [-D] [-i] [-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="AEN24" +NAME="AEN21" ></A ><H2 >DESCRIPTION</H2 @@ -107,7 +104,7 @@ CLASS="COMMAND" ><DIV CLASS="REFSECT1" ><A -NAME="AEN38" +NAME="AEN35" ></A ><H2 >OPTIONS</H2 @@ -137,14 +134,6 @@ CLASS="COMMAND" </P ></DD ><DT ->-a</DT -><DD -><P ->If this parameter is specified, each new - connection will append log messages to the log file. - This is the default.</P -></DD -><DT >-i</DT ><DD ><P @@ -156,29 +145,6 @@ CLASS="COMMAND" </P ></DD ><DT ->-o</DT -><DD -><P ->If this parameter is specified, the - log files will be overwritten when opened. By default, - <B -CLASS="COMMAND" ->smbd</B -> will append entries to the log - files.</P -></DD -><DT ->-P</DT -><DD -><P ->Passive option. Causes <B -CLASS="COMMAND" ->smbd</B -> not to - send any network traffic out. Used for debugging by - the developers only.</P -></DD -><DT >-h</DT ><DD ><P @@ -189,7 +155,7 @@ CLASS="COMMAND" >.</P ></DD ><DT ->-v</DT +>-V</DT ><DD ><P >Prints the version number for @@ -206,7 +172,7 @@ CLASS="COMMAND" Samba was built.</P ></DD ><DT ->-d <debug level></DT +>-d <debug level></DT ><DD ><P ><TT @@ -247,7 +213,7 @@ CLASS="FILENAME" > file.</P ></DD ><DT ->-l <log directory></DT +>-l <log directory></DT ><DD ><P >If specified, @@ -273,12 +239,9 @@ TARGET="_top" CLASS="FILENAME" > smb.conf(5)</TT ></A -> file. <SPAN -CLASS="emphasis" -><I +> file. <I CLASS="EMPHASIS" >Beware:</I -></SPAN > If the directory specified does not exist, <B CLASS="COMMAND" @@ -291,7 +254,7 @@ CLASS="COMMAND" compile time.</P ></DD ><DT ->-O <socket options></DT +>-O <socket options></DT ><DD ><P >See the <A @@ -310,7 +273,7 @@ CLASS="FILENAME" > file for details.</P ></DD ><DT ->-p <port number></DT +>-p <port number></DT ><DD ><P ><TT @@ -341,7 +304,7 @@ CLASS="REPLACEABLE" in the above situation.</P ></DD ><DT ->-s <configuration file></DT +>-s <configuration file></DT ><DD ><P >The file specified contains the @@ -366,7 +329,7 @@ CLASS="FILENAME" ><DIV CLASS="REFSECT1" ><A -NAME="AEN122" +NAME="AEN105" ></A ><H2 >FILES</H2 @@ -478,7 +441,7 @@ CLASS="FILENAME" ><DIV CLASS="REFSECT1" ><A -NAME="AEN158" +NAME="AEN141" ></A ><H2 >LIMITATIONS</H2 @@ -497,7 +460,7 @@ CLASS="COMMAND" ><DIV CLASS="REFSECT1" ><A -NAME="AEN162" +NAME="AEN145" ></A ><H2 >ENVIRONMENT VARIABLES</H2 @@ -528,7 +491,7 @@ CLASS="CONSTANT" ><DIV CLASS="REFSECT1" ><A -NAME="AEN171" +NAME="AEN154" ></A ><H2 >PAM INTERACTION</H2 @@ -549,13 +512,10 @@ TARGET="_top" ><UL ><LI ><P -><SPAN -CLASS="emphasis" ><I CLASS="EMPHASIS" >Account Validation</I -></SPAN ->: All acccesses to a +>: All accesses to a samba server are checked against PAM to see if the account is vaild, not disabled and is permitted to login at this time. This also applies to encrypted logins. @@ -563,12 +523,9 @@ CLASS="EMPHASIS" ></LI ><LI ><P -><SPAN -CLASS="emphasis" ><I CLASS="EMPHASIS" >Session Management</I -></SPAN >: When not using share level secuirty, users must pass PAM's session checks before access is granted. Note however, that this is bypassed in share level secuirty. @@ -581,18 +538,18 @@ CLASS="EMPHASIS" ><DIV CLASS="REFSECT1" ><A -NAME="AEN182" +NAME="AEN165" ></A ><H2 >VERSION</H2 ><P ->This man page is correct for version 2.2 of +>This man page is correct for version 3.0 of the Samba suite.</P ></DIV ><DIV CLASS="REFSECT1" ><A -NAME="AEN185" +NAME="AEN168" ></A ><H2 >DIAGNOSTICS</H2 @@ -615,7 +572,7 @@ NAME="AEN185" ><DIV CLASS="REFSECT1" ><A -NAME="AEN190" +NAME="AEN173" ></A ><H2 >SIGNALS</H2 @@ -637,12 +594,9 @@ CLASS="COMMAND" that <B CLASS="COMMAND" >SIGKILL (-9)</B -> <SPAN -CLASS="emphasis" -><I +> <I CLASS="EMPHASIS" >NOT</I -></SPAN > be used, except as a last resort, as this may leave the shared memory area in an inconsistent state. The safe way to terminate @@ -684,7 +638,7 @@ CLASS="COMMAND" ><DIV CLASS="REFSECT1" ><A -NAME="AEN207" +NAME="AEN190" ></A ><H2 >SEE ALSO</H2 @@ -750,7 +704,7 @@ TARGET="_top" ><DIV CLASS="REFSECT1" ><A -NAME="AEN224" +NAME="AEN207" ></A ><H2 >AUTHOR</H2 diff --git a/docs/manpages/findsmb.1 b/docs/manpages/findsmb.1 index c5553267b5..35d6f17588 100644 --- a/docs/manpages/findsmb.1 +++ b/docs/manpages/findsmb.1 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "FINDSMB" "1" "01 October 2002" "" "" +.TH "FINDSMB" "1" "26 November 2002" "" "" .SH NAME findsmb \- list info about machines that respond to SMB name queries on a subnet .SH SYNOPSIS @@ -68,7 +68,7 @@ IP ADDR NETBIOS NAME WORKGROUP/OS/VERSION .fi .SH "VERSION" .PP -This man page is correct for version 2.2 of +This man page is correct for version 3.0 of the Samba suite. .SH "SEE ALSO" .PP diff --git a/docs/manpages/nmbd.8 b/docs/manpages/nmbd.8 index d5662dbdb4..057adb8bed 100644 --- a/docs/manpages/nmbd.8 +++ b/docs/manpages/nmbd.8 @@ -3,12 +3,12 @@ .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "NMBD" "8" "01 October 2002" "" "" +.TH "NMBD" "8" "26 November 2002" "" "" .SH NAME nmbd \- NetBIOS name server to provide NetBIOS over IP naming services to clients .SH SYNOPSIS -\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 ] +\fBnmbd\fR [ \fB-D\fR ] [ \fB-a\fR ] [ \fB-i\fR ] [ \fB-o\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 @@ -17,7 +17,7 @@ This program is part of the Samba suite. \fBnmbd\fR is a server that understands and can reply to NetBIOS over IP name service requests, like those produced by SMB/CIFS clients such as Windows 95/98/ME, -Windows NT, Windows 2000, and LanManager clients. It also +Windows NT, Windows 2000, Windows XP and LanManager clients. It also participates in the browsing protocols which make up the Windows "Network Neighborhood" view. .PP @@ -226,7 +226,7 @@ to allow transient problems to be diagnosed, whilst still running at a normally low log level. .SH "VERSION" .PP -This man page is correct for version 2.2 of +This man page is correct for version 3.0 of the Samba suite. .SH "SEE ALSO" .PP diff --git a/docs/manpages/nmblookup.1 b/docs/manpages/nmblookup.1 index 49f602ab42..a61fc715f2 100644 --- a/docs/manpages/nmblookup.1 +++ b/docs/manpages/nmblookup.1 @@ -3,12 +3,12 @@ .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "NMBLOOKUP" "1" "01 October 2002" "" "" +.TH "NMBLOOKUP" "1" "26 November 2002" "" "" .SH NAME nmblookup \- NetBIOS over TCP/IP client used to lookup NetBIOS names .SH SYNOPSIS -\fBnmblookup\fR [ \fB-M\fR ] [ \fB-R\fR ] [ \fB-S\fR ] [ \fB-r\fR ] [ \fB-A\fR ] [ \fB-h\fR ] [ \fB-B <broadcast address>\fR ] [ \fB-U <unicast address>\fR ] [ \fB-d <debug level>\fR ] [ \fB-s <smb config file>\fR ] [ \fB-i <NetBIOS scope>\fR ] [ \fB-T\fR ] \fBname\fR +\fBnmblookup\fR [ \fB-M\fR ] [ \fB-R\fR ] [ \fB-S\fR ] [ \fB-r\fR ] [ \fB-A\fR ] [ \fB-h\fR ] [ \fB-B <broadcast address>\fR ] [ \fB-U <unicast address>\fR ] [ \fB-d <debug level>\fR ] [ \fB-s <smb config file>\fR ] [ \fB-i <NetBIOS scope>\fR ] [ \fB-T\fR ] [ \fB-f\fR ] \fBname\fR .SH "DESCRIPTION" .PP @@ -110,6 +110,11 @@ DNS name, and printed out before each pair that is the normal output. .TP +\fB-f\fR +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. +.TP \fBname\fR This is the NetBIOS name being queried. Depending upon the previous options this may be a NetBIOS name or IP address. @@ -134,7 +139,7 @@ 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 2.2 of +This man page is correct for version 3.0 of the Samba suite. .SH "SEE ALSO" .PP diff --git a/docs/manpages/pdbedit.8 b/docs/manpages/pdbedit.8 index 38e5efab59..79a0b2b9ad 100644 --- a/docs/manpages/pdbedit.8 +++ b/docs/manpages/pdbedit.8 @@ -3,12 +3,12 @@ .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "PDBEDIT" "8" "01 October 2002" "" "" +.TH "PDBEDIT" "8" "26 November 2002" "" "" .SH NAME pdbedit \- manage the SAM database .SH SYNOPSIS -\fBpdbedit\fR [ \fB-l\fR ] [ \fB-v\fR ] [ \fB-w\fR ] [ \fB-u username\fR ] [ \fB-f fullname\fR ] [ \fB-h homedir\fR ] [ \fB-d drive\fR ] [ \fB-s script\fR ] [ \fB-p profile\fR ] [ \fB-a\fR ] [ \fB-m\fR ] [ \fB-x\fR ] [ \fB-i passdb-backend\fR ] [ \fB-e passdb-backend\fR ] [ \fB-b passdb-backend\fR ] [ \fB-D debuglevel\fR ] +\fBpdbedit\fR [ \fB-l\fR ] [ \fB-v\fR ] [ \fB-w\fR ] [ \fB-u username\fR ] [ \fB-f fullname\fR ] [ \fB-h homedir\fR ] [ \fB-D drive\fR ] [ \fB-S script\fR ] [ \fB-p profile\fR ] [ \fB-a\fR ] [ \fB-m\fR ] [ \fB-x\fR ] [ \fB-i passdb-backend\fR ] [ \fB-e passdb-backend\fR ] [ \fB-b passdb-backend\fR ] [ \fB-d debuglevel\fR ] [ \fB-s configfile\fR ] [ \fB-P account-policy\fR ] [ \fB-V value\fR ] .SH "DESCRIPTION" .PP @@ -108,14 +108,14 @@ directory network path. Example: \fB-h "\\\\\\\\BERSERKER\\\\sorce"\fR .TP -\fB-d drive\fR +\fB-D drive\fR This option can be used while adding or modifing a user account. It will specify the windows drive letter to be used to map the home directory. Example: \fB-d "H:"\fR .TP -\fB-s script\fR +\fB-S script\fR This option can be used while adding or modifing a user account. It will specify the user's logon script path. @@ -181,6 +181,35 @@ Example: \fBpdbedit -e smbpasswd:/root/samba-users.backup\fR Use a different default passdb backend. Example: \fBpdbedit -b xml:/root/pdb-backup.xml -l\fR +.TP +\fB-P account-policy\fR +Display an account policy + +Valid policies are: minimum password age, reset count minutes, disconnect time, +user must logon to change password, password history, lockout duration, min password length, +maximum password age and bad lockout attempt. + +Example: \fBpdbedit -P "bad lockout attempt"\fR + + +.nf + account policy value for bad lockout attempt is 0 + +.fi +.TP +\fB-V account-policy-value\fR +Sets an account policy to a specified value. +This option may only be used in conjunction +with the \fI-P\fR option. + +Example: \fBpdbedit -P "bad lockout attempt" -V 3\fR + + +.nf + account policy value for bad lockout attempt was 0 + account policy value for bad lockout attempt is now 3 + +.fi .SH "NOTES" .PP This command may be used only by root. diff --git a/docs/manpages/rpcclient.1 b/docs/manpages/rpcclient.1 index 083aef4f5f..6ff5576349 100644 --- a/docs/manpages/rpcclient.1 +++ b/docs/manpages/rpcclient.1 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "RPCCLIENT" "1" "01 October 2002" "" "" +.TH "RPCCLIENT" "1" "26 November 2002" "" "" .SH NAME rpcclient \- tool for executing client side MS-RPC functions .SH SYNOPSIS @@ -47,14 +47,6 @@ access from unwanted users. execute semicolon separated commands (listed below)) .TP -\fB-d|--debug=debuglevel\fR -set the debuglevel. Debug level 0 is the lowest -and 100 being the highest. This should be set to 100 if you are -planning on submitting a bug report to the Samba team (see \fIBUGS.txt\fR). -.TP -\fB-h|--help\fR -Print a summary of command line options. -.TP \fB-I IP-address\fR \fIIP address\fR is the address of the server to connect to. It should be specified in standard "a.b.c.d" notation. diff --git a/docs/manpages/smb.conf.5 b/docs/manpages/smb.conf.5 index dc2adaba47..a9cf133c8d 100644 --- a/docs/manpages/smb.conf.5 +++ b/docs/manpages/smb.conf.5 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "SMB.CONF" "5" "03 October 2002" "" "" +.TH "SMB.CONF" "5" "26 November 2002" "" "" .SH NAME smb.conf \- The configuration file for the Samba suite .SH "SYNOPSIS" @@ -303,19 +303,6 @@ These substitutions are mostly noted in the descriptions below, but there are some general substitutions which apply whenever they might be relevant. These are: .TP -\fB%S\fR -the name of the current service, if any. -.TP -\fB%P\fR -the root directory of the current service, -if any. -.TP -\fB%u\fR -user name of the current service, if any. -.TP -\fB%g\fR -primary group name of %u. -.TP \fB%U\fR session user name (the user name that the client wanted, not necessarily the same as the one they got). @@ -323,13 +310,6 @@ wanted, not necessarily the same as the one they got). \fB%G\fR primary group name of %U. .TP -\fB%H\fR -the home directory of the user given -by %u. -.TP -\fB%v\fR -the Samba version. -.TP \fB%h\fR the Internet hostname that Samba is running on. @@ -349,17 +329,6 @@ on port 445, as clients no longer send this information \fB%M\fR the Internet name of the client machine. .TP -\fB%N\fR -the name of your NIS home directory server. -This is obtained from your NIS auto.map entry. If you have -not compiled Samba with the \fB--with-automount\fR -option then this value will be the same as %L. -.TP -\fB%p\fR -the path of the service's home directory, -obtained from your NIS auto.map entry. The NIS auto.map entry -is split up as "%N:%p". -.TP \fB%R\fR the selected protocol level after protocol negotiation. It can be one of CORE, COREPLUS, @@ -384,10 +353,44 @@ The IP address of the client machine. \fB%T\fR the current date and time. .TP +\fB%D\fR +Name of the domain or workgroup of the current user. +.TP \fB%$(\fIenvvar\fB)\fR The value of the environment variable \fIenvar\fR. .PP +The following substitutes apply only to some configuration options(only those +that are used when a connection has been established): +.TP +\fB%S\fR +the name of the current service, if any. +.TP +\fB%P\fR +the root directory of the current service, +if any. +.TP +\fB%u\fR +user name of the current service, if any. +.TP +\fB%g\fR +primary group name of %u. +.TP +\fB%H\fR +the home directory of the user given +by %u. +.TP +\fB%N\fR +the name of your NIS home directory server. +This is obtained from your NIS auto.map entry. If you have +not compiled Samba with the \fB--with-automount\fR +option then this value will be the same as %L. +.TP +\fB%p\fR +the path of the service's home directory, +obtained from your NIS auto.map entry. The NIS auto.map entry +is split up as "%N:%p". +.PP There are some quite creative things that can be done with these substitutions and other smb.conf options. .SH "NAME MANGLING" @@ -433,7 +436,7 @@ case. This option can be use with "preserve case = yes" to permit long filenames to retain their case, while short names are lowercased. Default \fByes\fR. .PP -By default, Samba 2.2 has the same semantics as a Windows +By default, Samba 3.0 has the same semantics as a Windows NT server, in that it is case insensitive but case preserving. .SH "NOTE ABOUT USERNAME/PASSWORD VALIDATION" .PP @@ -685,6 +688,9 @@ each parameter for details. Note that some are synonyms. \fIldap passwd sync\fR .TP 0.2i \(bu +\fIldap trust ids\fR +.TP 0.2i +\(bu \fIlm announce\fR .TP 0.2i \(bu @@ -1713,10 +1719,10 @@ Example: \fBannounce as = Win95\fR \fBannounce version (G)\fR This specifies the major and minor version numbers that nmbd will use when announcing itself as a server. The default -is 4.2. Do not change this parameter unless you have a specific +is 4.9. Do not change this parameter unless you have a specific need to set a Samba server to be a downlevel server. -Default: \fBannounce version = 4.5\fR +Default: \fBannounce version = 4.9\fR Example: \fBannounce version = 2.0\fR .TP @@ -1745,7 +1751,7 @@ Default: \fBavailable = yes\fR .TP \fBbind interfaces only (G)\fR This global parameter allows the Samba admin -to limit what interfaces on a machine will serve SMB requests. If +to limit what interfaces on a machine will serve SMB requests. It affects file service smbd(8) and name service nmbd(8) in slightly different ways. @@ -1764,7 +1770,7 @@ As unicast packets are received on the other sockets it allows \fBnmbd\fR to refuse to serve names to machines that send packets that arrive through any interfaces not listed in the \fIinterfaces\fR list. IP Source address spoofing -does defeat this simple check, however so it must not be used +does defeat this simple check, however, so it must not be used seriously as a security feature for \fBnmbd\fR. For file service it causes smbd(8) @@ -1806,12 +1812,12 @@ to obtain a byte range lock on a region of an open file, and the request has a time limit associated with it. If this parameter is set and the lock range requested -cannot be immediately satisfied, Samba 2.2 will internally +cannot be immediately satisfied, samba will internally queue the lock request, and periodically attempt to obtain the lock until the timeout period expires. If this parameter is set to no, then -Samba 2.2 will behave as previous versions of Samba would and +samba will behave as previous versions of Samba would and will fail the lock request immediately if the lock range cannot be obtained. @@ -2069,7 +2075,7 @@ effect. Default: \fBdebug pid = no\fR .TP \fBdebug timestamp (G)\fR -Samba 2.2 debug log messages are timestamped +Samba debug log messages are timestamped by default. If you are running at a high \fIdebug level\fR these timestamps can be distracting. This boolean parameter allows timestamping to be turned off. @@ -2483,7 +2489,7 @@ Default: \fBdns proxy = yes\fR .TP \fBdomain logons (G)\fR If set to yes, the Samba server will serve -Windows 95/98 Domain logons for the \fIworkgroup\fR it is in. Samba 2.2 also +Windows 95/98 Domain logons for the \fIworkgroup\fR it is in. Samba 2.2 has limited capability to act as a domain controller for Windows NT 4 Domains. For more details on setting up this feature see the Samba-PDC-HOWTO included in the \fIhtmldocs/\fR @@ -2933,7 +2939,7 @@ this by trying to log in as your guest user (perhaps by using the \fBsu -\fR command) and trying to print using the system print command such as \fBlpr(1)\fR or \fB lp(1)\fR. -This paramater does not accept % macros, because +This parameter does not accept % macros, because many parts of the system require this value to be constant for correct operation. @@ -3391,20 +3397,25 @@ The \fIldap ssl\fR can be set to one of three values: .RS .TP 0.2i \(bu -\fIOn\fR = Always use SSL when contacting the -\fIldap server\fR. -.TP 0.2i -\(bu \fIOff\fR = Never use SSL when querying the directory. .TP 0.2i \(bu \fIStart_tls\fR = Use the LDAPv3 StartTLS extended operation (RFC2830) for communicating with the directory server. +.TP 0.2i +\(bu +\fIOn\fR = +Use SSL on the ldaps port when contacting the +\fIldap server\fR. Only +available when the backwards-compatiblity \fB --with-ldapsam\fR option is specified +to configure. See \fIpassdb backend\fR .RE -Default : \fBldap ssl = on\fR +Default : \fBldap ssl = start_tls\fR .TP \fBldap suffix (G)\fR +Specifies where user and machine accounts are added to the tree. Can be overriden by \fBldap user suffix\fR and \fBldap machine suffix\fR. It also used as the base dn for all ldap searches. + Default : \fBnone\fR .TP \fBldap user suffix (G)\fR @@ -3440,6 +3451,23 @@ The \fIldap passwd sync\fR can be set to one of three values: Default : \fBldap passwd sync = no\fR .TP +\fBldap trust ids (G)\fR +Normally, Samba validates each entry +in the LDAP server against getpwnam(). This allows +LDAP to be used for Samba with the unix system using +NIS (for example) and also ensures that Samba does not +present accounts that do not otherwise exist. + +This option is used to disable this functionality, and +instead to rely on the presence of the appropriate +attributes in LDAP directly, which can result in a +significant performance boost in some situations. +Setting this option to yes effectivly assumes +that the local machine is running \fBnss_ldap\fR against the +same LDAP server. + +Default: \fBldap trust ids = No\fR +.TP \fBlevel2 oplocks (S)\fR This parameter controls whether Samba supports level2 (read-only) oplocks on a share. @@ -3605,7 +3633,7 @@ Example: \fBlog file = /usr/local/samba/var/log.%m The value of the parameter (a astring) allows the debug level (logging level) to be specified in the \fIsmb.conf\fR file. This parameter has been -extended since 2.2.x series, now it allow to specify the debug +extended since the 2.2.x series, now it allow to specify the debug level for multiple debug classes. This is to give greater flexibility in the configuration of the system. @@ -4056,11 +4084,21 @@ a better algorithm (generates less collisions) in the names. However, many Win32 applications store the mangled names and so changing to the new algorithm must not be done lightly as these applications may break unless reinstalled. -New installations of Samba may set the default to hash2. -Default: \fBmangling method = hash\fR +Default: \fBmangling method = hash2\fR -Example: \fBmangling method = hash2\fR +Example: \fBmangling method = hash\fR +.TP +\fBmangle prefix (G)\fR +controls the number of prefix +characters from the original name used when generating +the mangled names. A larger value will give a weaker +hash and therefore more name collisions. The minimum +value is 1 and the maximum value is 6. + +Default: \fBmangle prefix = 1\fR + +Example: \fBmangle prefix = 4\fR .TP \fBmangled stack (G)\fR This parameter controls the number of mangled names @@ -4824,7 +4862,7 @@ Default: \fBparanoid server security = yes\fR \fBpassdb backend (G)\fR This option allows the administrator to chose which backends to retrieve and store passwords with. This allows (for example) both smbpasswd and tdbsam to be used without a recompile. -Multiple backends can be specified, seperated by spaces. The backends will be searched in the order they are specified. New users are always added to the first backend specified. +Multiple backends can be specified, separated by spaces. The backends will be searched in the order they are specified. New users are always added to the first backend specified. Experimental backends must still be selected (eg --with-tdbsam) at configure time. @@ -4868,7 +4906,17 @@ backend. Takes an LDAP URL as an optional argument (defaults to backend, with non unix account support. Takes an LDAP URL as an optional argument (defaults to \fBldap://localhost\fR) -See also \fInon unix account range\fR +Note: In this module, any account without a matching POSIX account is regarded +as 'non unix'. + +See also \fInon unix account +range\fR + +LDAP connections should be secured where +possible. This may be done using either +Start-TLS (see \fIldap ssl\fR) or by +specifying \fIldaps://\fR in +the URL argument. .TP 0.2i \(bu \fBnisplussam\fR - The NIS+ based passdb backend. Takes name NIS domain as an optional argument. Only works with sun NIS+ servers. @@ -5096,6 +5144,12 @@ doing a query for the name WORKGROUP<1C> and then contacting each server returned in the list of IP addresses from the name resolution source. +If the list of servers contains both names and the '*' +character, the list is treated as a list of preferred +domain controllers, but an auto lookup of all remaining DC's +will be added to the list as well. Samba will not attempt to optimize +this list by locating the closest DC. + If the \fIsecurity\fR parameter is set to server, then there are different restrictions that \fBsecurity = domain\fR doesn't @@ -5123,7 +5177,7 @@ See also the \fIsecurity Default: \fBpassword server = <empty string>\fR -Example: \fBpassword server = NT-PDC, NT-BDC1, NT-BDC2 +Example: \fBpassword server = NT-PDC, NT-BDC1, NT-BDC2, * \fR Example: \fBpassword server = *\fR @@ -5770,30 +5824,12 @@ Default: \fBremote browse sync = <empty string> \fR .TP \fBrestrict anonymous (G)\fR -This is a boolean parameter. If it is yes, then -anonymous access to the server will be restricted, namely in the -case where the server is expecting the client to send a username, -but it doesn't. Setting it to yes will force these anonymous -connections to be denied, and the client will be required to always -supply a username and password when connecting. Use of this parameter -is only recommended for homogeneous NT client environments. - -This parameter makes the use of macro expansions that rely -on the username (%U, %G, etc) consistent. NT 4.0 -likes to use anonymous connections when refreshing the share list, -and this is a way to work around that. - -When restrict anonymous is yes, all anonymous connections -are denied no matter what they are for. This can effect the ability -of a machine to access the Samba Primary Domain Controller to revalidate -its machine account after someone else has logged on the client -interactively. The NT client will display a message saying that -the machine's account in the domain doesn't exist or the password is -bad. The best way to deal with this is to reboot NT client machines -between interactive logons, using "Shutdown and Restart", rather -than "Close all programs and logon as a different user". - -Default: \fBrestrict anonymous = no\fR +This is a integer parameter, and +mirrors as much as possible the functinality the +RestrictAnonymous +registry key does on NT/Win2k. + +Default: \fBrestrict anonymous = 0\fR .TP \fBroot (G)\fR Synonym for \fIroot directory"\fR. @@ -6553,7 +6589,8 @@ Example: \fBtotal print jobs = 5000\fR .TP \fBunicode (G)\fR Specifies whether Samba should try -to use unicode on the wire by default. +to use unicode on the wire by default. Note: This does NOT +mean that samba will assume that the unix machine uses unicode! Default: \fBunicode = yes\fR .TP @@ -6563,6 +6600,8 @@ Samba runs on uses. Samba needs to know this in order to be able to convert text to the charsets other SMB clients use. Default: \fBunix charset = ASCII\fR + +Example: \fBunix charset = UTF8\fR .TP \fBunix extensions(G)\fR This boolean parameter controls whether Samba @@ -6999,19 +7038,17 @@ Default: \fBvfs path = \fR Example: \fBvfs path = /usr/lib/samba/vfs\fR .TP \fBvfs object (S)\fR -This parameter specifies a shared object file that -is used for Samba VFS I/O operations. By default, normal +This parameter specifies a shared object files that +are used for Samba VFS I/O operations. By default, normal disk I/O operations are used but these can be overloaded -with a VFS object. The Samba VFS layer is new to Samba 2.2 and -must be enabled at compile time with --with-vfs. +with one or more VFS objects. Default : \fBno value\fR .TP \fBvfs options (S)\fR This parameter allows parameters to be passed -to the vfs layer at initialization time. The Samba VFS layer -is new to Samba 2.2 and must be enabled at compile time -with --with-vfs. See also \fI vfs object\fR. +to the vfs layer at initialization time. +See also \fI vfs object\fR. Default : \fBno value\fR .TP @@ -7313,7 +7350,7 @@ sections. In particular, ensure that the permissions on spool directories are correct. .SH "VERSION" .PP -This man page is correct for version 2.2 of +This man page is correct for version 3.0 of the Samba suite. .SH "SEE ALSO" .PP diff --git a/docs/manpages/smbclient.1 b/docs/manpages/smbclient.1 index 63d78658a6..c577e5c49b 100644 --- a/docs/manpages/smbclient.1 +++ b/docs/manpages/smbclient.1 @@ -3,12 +3,12 @@ .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "SMBCLIENT" "1" "01 October 2002" "" "" +.TH "SMBCLIENT" "1" "26 November 2002" "" "" .SH NAME smbclient \- ftp-like client to access SMB/CIFS resources on servers .SH SYNOPSIS -\fBsmbclient\fR \fBservicename\fR [ \fBpassword\fR ] [ \fB-b <buffer size>\fR ] [ \fB-d debuglevel\fR ] [ \fB-D Directory\fR ] [ \fB-U username\fR ] [ \fB-W workgroup\fR ] [ \fB-M <netbios name>\fR ] [ \fB-m maxprotocol\fR ] [ \fB-A authfile\fR ] [ \fB-N\fR ] [ \fB-l logfile\fR ] [ \fB-L <netbios name>\fR ] [ \fB-I destinationIP\fR ] [ \fB-E <terminal code>\fR ] [ \fB-c <command string>\fR ] [ \fB-i scope\fR ] [ \fB-O <socket options>\fR ] [ \fB-p port\fR ] [ \fB-R <name resolve order>\fR ] [ \fB-s <smb config file>\fR ] [ \fB-T<c|x>IXFqgbNan\fR ] +\fBsmbclient\fR \fBservicename\fR [ \fBpassword\fR ] [ \fB-b <buffer size>\fR ] [ \fB-d debuglevel\fR ] [ \fB-D Directory\fR ] [ \fB-U username\fR ] [ \fB-W workgroup\fR ] [ \fB-M <netbios name>\fR ] [ \fB-m maxprotocol\fR ] [ \fB-A authfile\fR ] [ \fB-N\fR ] [ \fB-l logfile\fR ] [ \fB-L <netbios name>\fR ] [ \fB-I destinationIP\fR ] [ \fB-E\fR ] [ \fB-c <command string>\fR ] [ \fB-i scope\fR ] [ \fB-O <socket options>\fR ] [ \fB-p port\fR ] [ \fB-R <name resolve order>\fR ] [ \fB-s <smb config file>\fR ] [ \fB-T<c|x>IXFqgbNan\fR ] .SH "DESCRIPTION" .PP diff --git a/docs/manpages/smbd.8 b/docs/manpages/smbd.8 index 7e1b35d5aa..3e350f80e9 100644 --- a/docs/manpages/smbd.8 +++ b/docs/manpages/smbd.8 @@ -3,12 +3,12 @@ .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "SMBD" "8" "01 October 2002" "" "" +.TH "SMBD" "8" "26 November 2002" "" "" .SH NAME smbd \- server to provide SMB/CIFS services to clients .SH SYNOPSIS -\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 ] +\fBsmbd\fR [ \fB-D\fR ] [ \fB-i\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 @@ -60,11 +60,6 @@ servers that provide more than casual use file and print services. This switch is assumed if \fBsmbd \fR is executed on the command line of a shell. .TP -\fB-a\fR -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 @@ -72,22 +67,11 @@ 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, -\fBsmbd\fR will append entries to the log -files. -.TP -\fB-P\fR -Passive option. Causes \fBsmbd\fR not to -send any network traffic out. Used for debugging by -the developers only. -.TP \fB-h\fR Prints the help information (usage) for \fBsmbd\fR. .TP -\fB-v\fR +\fB-V\fR Prints the version number for \fBsmbd\fR. .TP @@ -231,7 +215,7 @@ obey pam restricions smb.conf paramater. When this is set, the following restrictions apply: .TP 0.2i \(bu -\fBAccount Validation\fR: All acccesses to a +\fBAccount Validation\fR: All accesses to a samba server are checked against PAM to see if the account is vaild, not disabled and is permitted to login at this time. This also applies to encrypted logins. @@ -244,7 +228,7 @@ Note also that some older pam configuration files may need a line added for session support. .SH "VERSION" .PP -This man page is correct for version 2.2 of +This man page is correct for version 3.0 of the Samba suite. .SH "DIAGNOSTICS" .PP diff --git a/docs/manpages/smbpasswd.5 b/docs/manpages/smbpasswd.5 index 47eabcaec8..1951ab8dad 100644 --- a/docs/manpages/smbpasswd.5 +++ b/docs/manpages/smbpasswd.5 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "SMBPASSWD" "5" "01 October 2002" "" "" +.TH "SMBPASSWD" "5" "26 November 2002" "" "" .SH NAME smbpasswd \- The Samba encrypted password file .SH SYNOPSIS @@ -135,7 +135,7 @@ in seconds since the epoch (1970) that the last change was made. All other colon separated fields are ignored at this time. .SH "VERSION" .PP -This man page is correct for version 2.2 of +This man page is correct for version 3.0 of the Samba suite. .SH "SEE ALSO" .PP diff --git a/docs/manpages/smbpasswd.8 b/docs/manpages/smbpasswd.8 index ee097cf6f1..ad933517be 100644 --- a/docs/manpages/smbpasswd.8 +++ b/docs/manpages/smbpasswd.8 @@ -3,12 +3,12 @@ .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "SMBPASSWD" "8" "01 October 2002" "" "" +.TH "SMBPASSWD" "8" "26 November 2002" "" "" .SH NAME smbpasswd \- change a user's SMB password .SH SYNOPSIS -\fBsmbpasswd\fR [ \fB-a\fR ] [ \fB-x\fR ] [ \fB-d\fR ] [ \fB-e\fR ] [ \fB-D debuglevel\fR ] [ \fB-n\fR ] [ \fB-r <remote machine>\fR ] [ \fB-R <name resolve order>\fR ] [ \fB-m\fR ] [ \fB-U username[%password]\fR ] [ \fB-h\fR ] [ \fB-s\fR ] [ \fB-w pass\fR ] [ \fBusername\fR ] +\fBsmbpasswd\fR [ \fB-a\fR ] [ \fB-x\fR ] [ \fB-d\fR ] [ \fB-e\fR ] [ \fB-D debuglevel\fR ] [ \fB-n\fR ] [ \fB-r <remote machine>\fR ] [ \fB-R <name resolve order>\fR ] [ \fB-m\fR ] [ \fB-U username[%password]\fR ] [ \fB-h\fR ] [ \fB-s\fR ] [ \fB-w pass\fR ] [ \fB-i\fR ] [ \fB-L\fR ] [ \fBusername\fR ] .SH "DESCRIPTION" .PP @@ -240,6 +240,17 @@ of the admin's DN. This means that if the value of \fIldap admin dn\fR ever changes, the password will need to be manually updated as well. .TP +\fB-i\fR +This option tells smbpasswd that the account +being changed is an interdomain trust account. Currently this is used +when Samba is being used as an NT Primary Domain Controller. +The account contains the info about another trusted domain. + +This option is only available when running smbpasswd as root. +.TP +\fB-L\fR +Run in local mode. +.TP \fBusername\fR This specifies the username for all of the \fBroot only\fR options to operate on. Only root diff --git a/docs/manpages/smbsh.1 b/docs/manpages/smbsh.1 index b2eec12c81..e9c1add9e9 100644 --- a/docs/manpages/smbsh.1 +++ b/docs/manpages/smbsh.1 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "SMBSH" "1" "01 October 2002" "" "" +.TH "SMBSH" "1" "26 November 2002" "" "" .SH NAME smbsh \- Allows access to Windows NT filesystem using UNIX commands .SH SYNOPSIS @@ -138,7 +138,7 @@ names for that machine. You could then, for example, use the \fB cd\fR command t edit files, and \fBrcp\fR to copy files. .SH "VERSION" .PP -This man page is correct for version 2.2 of +This man page is correct for version 3.0 of the Samba suite. .SH "BUGS" .PP diff --git a/docs/manpages/testparm.1 b/docs/manpages/testparm.1 index a53e066acf..555c28c46c 100644 --- a/docs/manpages/testparm.1 +++ b/docs/manpages/testparm.1 @@ -3,12 +3,12 @@ .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "TESTPARM" "1" "01 October 2002" "" "" +.TH "TESTPARM" "1" "26 November 2002" "" "" .SH NAME testparm \- check an smb.conf configuration file for internal correctness .SH SYNOPSIS -\fBtestparm\fR [ \fB-s\fR ] [ \fB-h\fR ] [ \fB-v\fR ] [ \fB-L <servername>\fR ] \fBconfig filename\fR [ \fBhostname hostIP\fR ] +\fBtestparm\fR [ \fB-s\fR ] [ \fB-h\fR ] [ \fB-v\fR ] [ \fB-L <servername>\fR ] [ \fB-t <encoding>\fR ] \fBconfig filename\fR [ \fBhostname hostIP\fR ] .SH "DESCRIPTION" .PP @@ -53,6 +53,9 @@ will also output all options that were not used in \fIsmb.conf\fR and are thus set to their defaults. .TP +\fB-t encoding\fR +Output data in specified encoding. +.TP \fBconfigfilename\fR This is the name of the configuration file to check. If this parameter is not present then the @@ -86,7 +89,7 @@ loaded OK, the program then dumps all known service details to stdout. .SH "VERSION" .PP -This man page is correct for version 2.2 of +This man page is correct for version 3.0 of the Samba suite. .SH "SEE ALSO" .PP diff --git a/docs/manpages/vfstest.1 b/docs/manpages/vfstest.1 index dc3092bc66..ff407b9c71 100644 --- a/docs/manpages/vfstest.1 +++ b/docs/manpages/vfstest.1 @@ -3,7 +3,7 @@ .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "VFSTEST" "1" "01 October 2002" "" "" +.TH "VFSTEST" "1" "26 November 2002" "" "" .SH NAME vfstest \- tool for testing samba VFS modules .SH SYNOPSIS @@ -21,18 +21,9 @@ supports cascaded VFS modules. .SH "OPTIONS" .TP \fB-c|--command=command\fR -Execute the specified (colon-seperated) commands. +Execute the specified (colon-separated) commands. See below for the commands that are available. .TP -\fB-d|--debug=debuglevel\fR -set the debuglevel. Debug level 0 is the lowest -and 100 being the highest. This should be set to 100 if you are -planning on submitting a bug report to the Samba team (see -\fIBUGS.txt\fR). -.TP -\fB-h|--help\fR -Print a summary of command line options. -.TP \fB-l|--logfile=logbasename\fR File name for log/debug files. The extension \&'.client' will be appended. The log file is never removed diff --git a/docs/manpages/wbinfo.1 b/docs/manpages/wbinfo.1 index 96464987e3..57b39d2e33 100644 --- a/docs/manpages/wbinfo.1 +++ b/docs/manpages/wbinfo.1 @@ -3,12 +3,12 @@ .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "WBINFO" "1" "01 October 2002" "" "" +.TH "WBINFO" "1" "26 November 2002" "" "" .SH NAME wbinfo \- Query information from winbind daemon .SH SYNOPSIS -\fBwbinfo\fR [ \fB-u\fR ] [ \fB-g\fR ] [ \fB-h name\fR ] [ \fB-i ip\fR ] [ \fB-n name\fR ] [ \fB-s sid\fR ] [ \fB-U uid\fR ] [ \fB-G gid\fR ] [ \fB-S sid\fR ] [ \fB-Y sid\fR ] [ \fB-t\fR ] [ \fB-m\fR ] [ \fB-r user\fR ] [ \fB-a user%password\fR ] [ \fB-A user%password\fR ] +\fBwbinfo\fR [ \fB-u\fR ] [ \fB-g\fR ] [ \fB-i ip\fR ] [ \fB-N netbios-name\fR ] [ \fB-n name\fR ] [ \fB-s sid\fR ] [ \fB-U uid\fR ] [ \fB-G gid\fR ] [ \fB-S sid\fR ] [ \fB-Y sid\fR ] [ \fB-t\fR ] [ \fB-m\fR ] [ \fB-r user\fR ] [ \fB-a user%password\fR ] [ \fB-A user%password\fR ] [ \fB-p\fR ] .SH "DESCRIPTION" .PP @@ -38,14 +38,14 @@ will also be listed. Note that this operation does not assign group ids to any groups that have not already been seen by \fBwinbindd(8)\fR. .TP -\fB-h name\fR -The \fI-h\fR option +\fB-N name\fR +The \fI-N\fR option queries \fBwinbindd(8)\fR to query the WINS server for the IP address associated with the NetBIOS name specified by the \fIname\fR parameter. .TP -\fB-i ip\fR -The \fI-i\fR option +\fB-I ip\fR +The \fI-I\fR option queries \fBwinbindd(8)\fR to send a node status request to get the NetBIOS name associated with the IP address specified by the \fIip\fR parameter. @@ -119,7 +119,7 @@ succeeded, or 1 if the operation failed. If the \fBwinbindd(8) failure. .SH "VERSION" .PP -This man page is correct for version 2.2 of +This man page is correct for version 3.0 of the Samba suite. .SH "SEE ALSO" .PP diff --git a/docs/manpages/winbindd.8 b/docs/manpages/winbindd.8 index fe02c424e1..2cd25af942 100644 --- a/docs/manpages/winbindd.8 +++ b/docs/manpages/winbindd.8 @@ -3,12 +3,12 @@ .\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng <steve@ggi-project.org>. -.TH "WINBINDD" "8" "01 October 2002" "" "" +.TH "WINBINDD" "8" "26 November 2002" "" "" .SH NAME winbindd \- Name Service Switch daemon for resolving names from NT servers .SH SYNOPSIS -\fBwinbindd\fR [ \fB-i\fR ] [ \fB-d <debug level>\fR ] [ \fB-s <smb config file>\fR ] +\fBwinbindd\fR [ \fB-i\fR ] [ \fB-B\fR ] [ \fB-d <debug level>\fR ] [ \fB-s <smb config file>\fR ] [ \fB-n\fR ] .SH "DESCRIPTION" .PP @@ -85,6 +85,25 @@ Tells \fBwinbindd\fR to not become a daemon and detach from the current terminal. This option is used by developers when interactive debugging of \fBwinbindd\fR is required. +.TP +\fB-n\fR +Disable caching. This means winbindd will +always have to wait for a response from the domain controller +before it can respond to a client and this thus makes things +slower. The results will however be more accurate, since +results from the cache might not be up-to-date. This +might also temporarily hang winbindd if the DC doesn't respond. +.TP +\fB-B\fR +Dual daemon mode. This means winbindd will run +as 2 threads. The first will answer all requests from the cache, +thus making responses to clients faster. The other will +update the cache for the query that the first has just responded. +Advantage of this is that responses are accurate and fast. +.TP +\fB-s|--conf=smb.conf\fR +Specifies the location of the all-important +\fIsmb.conf\fR file. .SH "NAME AND ID RESOLUTION" .PP Users and groups on a Windows NT server are assigned @@ -291,7 +310,7 @@ This directory is by default \fI/usr/local/samba/var/locks Storage for cached user and group information. .SH "VERSION" .PP -This man page is correct for version 2.2 of +This man page is correct for version 3.0 of the Samba suite. .SH "SEE ALSO" .PP |