diff options
Diffstat (limited to 'docs/htmldocs/smbpasswd.8.html')
| -rw-r--r-- | docs/htmldocs/smbpasswd.8.html | 216 |
1 files changed, 87 insertions, 129 deletions
diff --git a/docs/htmldocs/smbpasswd.8.html b/docs/htmldocs/smbpasswd.8.html index 223cd02521..da3cb9f601 100644 --- a/docs/htmldocs/smbpasswd.8.html +++ b/docs/htmldocs/smbpasswd.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 >smbpasswd</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="SMBPASSWD.8" -></A ->smbpasswd</H1 +NAME="SMBPASSWD">smbpasswd</H1 ><DIV CLASS="REFNAMEDIV" ><A @@ -29,15 +28,13 @@ NAME="AEN5" ><DIV CLASS="REFSYNOPSISDIV" ><A -NAME="AEN8" -></A -><H2 +NAME="AEN8"><H2 >Synopsis</H2 ><P ><B CLASS="COMMAND" >smbpasswd</B -> [-a] [-x] [-d] [-e] [-D debuglevel] [-n] [-r <remote machine>] [-R <name resolve order>] [-m] [-U username[%password]] [-h] [-s] [-w pass] [-i] [-L] [username]</P +> [-a] [-x] [-d] [-e] [-D debuglevel] [-n] [-r <remote machine>] [-R <name resolve order>] [-m] [-U username[%password]] [-h] [-s] [-w pass] [-i] [-L] [username]</P ></DIV ><DIV CLASS="REFSECT1" @@ -47,23 +44,18 @@ NAME="AEN27" ><H2 >DESCRIPTION</H2 ><P ->This tool is part of the <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->Samba</SPAN ->(7)</SPAN +>This tool is part of the <A +HREF="samba.7.html" +TARGET="_top" +> Samba</A > suite.</P ><P >The smbpasswd program has several different - functions, depending on whether it is run by the <SPAN -CLASS="emphasis" -><I + functions, depending on whether it is run by the <I CLASS="EMPHASIS" >root</I -></SPAN -> user - or not. When run as a normal user it allows the user to change +> + user or not. When run as a normal user it allows the user to change the password used for their SMB sessions on any machines that store SMB passwords. </P ><P @@ -72,33 +64,25 @@ CLASS="EMPHASIS" similar to the way the <B CLASS="COMMAND" >passwd(1)</B -> program works. <B +> program works. + <B CLASS="COMMAND" -> smbpasswd</B +>smbpasswd</B > differs from how the passwd program works - however in that it is not <SPAN -CLASS="emphasis" -><I + however in that it is not <I CLASS="EMPHASIS" >setuid root</I -></SPAN > but works in - a client-server mode and communicates with a - locally running <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->smbd</SPAN ->(8)</SPAN + a client-server mode and communicates with a locally running + <B +CLASS="COMMAND" +>smbd(8)</B >. As a consequence in order for this to succeed the smbd daemon must be running on the local machine. On a UNIX machine the encrypted SMB passwords are usually stored in - the <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->smbpasswd</SPAN ->(5)</SPAN + the <TT +CLASS="FILENAME" +>smbpasswd(5)</TT > file. </P ><P >When run by an ordinary user with no options, smbpasswd @@ -107,28 +91,18 @@ CLASS="REFENTRYTITLE" was typed correctly. No passwords will be echoed on the screen whilst being typed. If you have a blank SMB password (specified by the string "NO PASSWORD" in the smbpasswd file) then just press - the <Enter> key when asked for your old password. </P + the <Enter> key when asked for your old password. </P ><P >smbpasswd can also be used by a normal user to change their SMB password on remote machines, such as Windows NT Primary Domain - Controllers. See the (<TT -CLASS="PARAMETER" -><I ->-r</I -></TT ->) and <TT -CLASS="PARAMETER" -><I ->-U</I -></TT -> options - below. </P + Controllers. See the (-r) and -U options below. </P ><P >When run by root, smbpasswd allows new users to be added and deleted in the smbpasswd file, as well as allows changes to - the attributes of the user in this file to be made. When run by root, <B + the attributes of the user in this file to be made. When run by root, + <B CLASS="COMMAND" -> smbpasswd</B +>smbpasswd</B > accesses the local smbpasswd file directly, thus enabling changes to be made even if smbd is not running. </P @@ -136,7 +110,7 @@ CLASS="COMMAND" ><DIV CLASS="REFSECT1" ><A -NAME="AEN51" +NAME="AEN43" ></A ><H2 >OPTIONS</H2 @@ -151,7 +125,7 @@ CLASS="VARIABLELIST" ><P >This option specifies that the username following should be added to the local smbpasswd file, with the - new password typed (type <Enter> for the old password). This + new password typed (type <Enter> for the old password). This option is ignored if the username following already exists in the smbpasswd file and it is treated like a regular change password command. Note that the default passdb backends require @@ -195,12 +169,10 @@ CLASS="CONSTANT" ><P >If the smbpasswd file is in the 'old' format (pre-Samba 2.0 format) there is no space in the user's password entry to write - this information and the command will FAIL. See <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->smbpasswd</SPAN ->(5)</SPAN + this information and the command will FAIL. See <B +CLASS="COMMAND" +>smbpasswd(5) + </B > for details on the 'old' and new password file formats. </P ><P @@ -224,12 +196,9 @@ CLASS="CONSTANT" CLASS="COMMAND" > smbpasswd</B > will FAIL to enable the account. - See <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->smbpasswd</SPAN ->(5)</SPAN + See <B +CLASS="COMMAND" +>smbpasswd (5)</B > for details on the 'old' and new password file formats. </P ><P @@ -325,12 +294,9 @@ CLASS="PARAMETER" copy of the user account database and will not allow the password change).</P ><P -><SPAN -CLASS="emphasis" ><I CLASS="EMPHASIS" >Note</I -></SPAN > that Windows 95/98 do not have a real password database so it is not possible to change passwords specifying a Win95/98 machine as remote machine target. </P @@ -344,7 +310,7 @@ CLASS="EMPHASIS" name of the host being connected to. </P ><P >The options are :"lmhosts", "host", "wins" and "bcast". They - cause names to be resolved as follows: </P + cause names to be resolved as follows : </P ><P ></P ><UL @@ -353,14 +319,12 @@ CLASS="EMPHASIS" ><TT CLASS="CONSTANT" >lmhosts</TT ->: Lookup an IP +> : Lookup an IP address in the Samba lmhosts file. If the line in lmhosts has - no name type attached to the NetBIOS name (see the <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->lmhosts</SPAN ->(5)</SPAN + no name type attached to the NetBIOS name (see the <A +HREF="lmhosts.5.html" +TARGET="_top" +>lmhosts(5)</A > for details) then any name type matches for lookup.</P ></LI @@ -369,7 +333,7 @@ CLASS="REFENTRYTITLE" ><TT CLASS="CONSTANT" >host</TT ->: Do a standard host +> : Do a standard host name to IP address resolution, using the system <TT CLASS="FILENAME" >/etc/hosts @@ -389,7 +353,7 @@ CLASS="FILENAME" ><TT CLASS="CONSTANT" >wins</TT ->: Query a name with +> : Query a name with the IP address listed in the <TT CLASS="PARAMETER" ><I @@ -404,7 +368,7 @@ CLASS="PARAMETER" ><TT CLASS="CONSTANT" >bcast</TT ->: Do a broadcast on +> : Do a broadcast on each of the known local interfaces listed in the <TT CLASS="PARAMETER" @@ -421,12 +385,10 @@ CLASS="PARAMETER" CLASS="COMMAND" >lmhosts, host, wins, bcast</B > - and without this parameter or any entry in the <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->smb.conf</SPAN ->(5)</SPAN + and without this parameter or any entry in the + <TT +CLASS="FILENAME" +>smb.conf</TT > file the name resolution methods will be attempted in this order. </P ></DD @@ -512,7 +474,7 @@ CLASS="PARAMETER" >. Note that the password is stored in the <TT CLASS="FILENAME" ->secrets.tdb</TT +>private/secrets.tdb</TT > and is keyed off of the admin's DN. This means that if the value of <TT CLASS="PARAMETER" @@ -547,12 +509,9 @@ CLASS="PARAMETER" ><DD ><P >This specifies the username for all of the - <SPAN -CLASS="emphasis" -><I + <I CLASS="EMPHASIS" >root only</I -></SPAN > options to operate on. Only root can specify this parameter as only root has the permission needed to modify attributes directly in the local smbpasswd file. @@ -564,7 +523,7 @@ CLASS="EMPHASIS" ><DIV CLASS="REFSECT1" ><A -NAME="AEN189" +NAME="AEN173" ></A ><H2 >NOTES</H2 @@ -578,71 +537,70 @@ CLASS="COMMAND" is to add a restriction to the hosts that may access the <B CLASS="COMMAND" > smbd</B -> running on the local machine by specifying either <TT +> running on the local machine by specifying a + <TT CLASS="PARAMETER" ><I ->allow - hosts</I +>allow hosts</I ></TT > or <TT CLASS="PARAMETER" ><I >deny hosts</I ></TT -> entry in - the <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->smb.conf</SPAN ->(5)</SPAN +> + entry in the <TT +CLASS="FILENAME" +>smb.conf</TT > file and neglecting to allow "localhost" access to the smbd. </P ><P >In addition, the smbpasswd command is only useful if Samba - has been set up to use encrypted passwords. See the document <A -HREF="pwencrypt.html" -TARGET="_top" -> "LanMan and NT Password Encryption in Samba"</A + has been set up to use encrypted passwords. See the file + <TT +CLASS="FILENAME" +>ENCRYPTION.txt</TT > in the docs directory for details on how to do this. </P ></DIV ><DIV CLASS="REFSECT1" ><A -NAME="AEN201" +NAME="AEN183" ></A ><H2 >VERSION</H2 ><P ->This man page is correct for version 3.0 of the Samba suite.</P +>This man page is correct for version 3.0 of + the Samba suite.</P ></DIV ><DIV CLASS="REFSECT1" ><A -NAME="AEN204" +NAME="AEN186" ></A ><H2 >SEE ALSO</H2 ><P -><SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->smbpasswd</SPAN ->(5)</SPAN ->, <SPAN -CLASS="CITEREFENTRY" -><SPAN -CLASS="REFENTRYTITLE" ->Samba</SPAN ->(7)</SPAN ->.</P +><A +HREF="smbpasswd.5.html" +TARGET="_top" +><TT +CLASS="FILENAME" +>smbpasswd(5)</TT +></A +>, + <A +HREF="samba.7.html" +TARGET="_top" +>samba(7)</A +> + </P ></DIV ><DIV CLASS="REFSECT1" ><A -NAME="AEN213" +NAME="AEN192" ></A ><H2 >AUTHOR</H2 @@ -654,14 +612,14 @@ NAME="AEN213" ><P >The original Samba man pages were written by Karl Auer. The man page sources were converted to YODL format (another - excellent piece of Open Source software, available at <A + excellent piece of Open Source software, available at + <A HREF="ftp://ftp.icce.rug.nl/pub/unix/" TARGET="_top" > ftp://ftp.icce.rug.nl/pub/unix/</A >) and updated for the Samba 2.0 release by Jeremy Allison. The conversion to DocBook for - Samba 2.2 was done by Gerald Carter. The conversion to DocBook XML 4.2 - for Samba 3.0 was done by Alexander Bokovoy.</P + Samba 2.2 was done by Gerald Carter</P ></DIV ></BODY ></HTML |