Changeset 231 for branches/samba-3.2.x/docs/manpages/smbpasswd.8
- Timestamp:
- May 27, 2009, 9:08:03 AM (16 years ago)
- File:
-
- 1 edited
-
branches/samba-3.2.x/docs/manpages/smbpasswd.8 (modified) (13 diffs)
Legend:
- Unmodified
- Added
- Removed
-
branches/samba-3.2.x/docs/manpages/smbpasswd.8
r229 r231 1 1 .\" Title: smbpasswd 2 .\" Author: 3 .\" Generator: DocBook XSL Stylesheets v1.7 3.1<http://docbook.sf.net/>4 .\" Date: 12/19/20082 .\" Author: [see the "AUTHOR" section] 3 .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> 4 .\" Date: 02/03/2009 5 5 .\" Manual: System Administration tools 6 6 .\" Source: Samba 3.2 7 .\" Language: English 7 8 .\" 8 .TH "SMBPASSWD" "8" "12/19/2008" "Samba 3\.2" "System Administration tools" 9 .TH "SMBPASSWD" "8" "02/03/2009" "Samba 3\&.2" "System Administration tools" 10 .\" ----------------------------------------------------------------- 11 .\" * (re)Define some macros 12 .\" ----------------------------------------------------------------- 13 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 14 .\" toupper - uppercase a string (locale-aware) 15 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 16 .de toupper 17 .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ 18 \\$* 19 .tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz 20 .. 21 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 22 .\" SH-xref - format a cross-reference to an SH section 23 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 24 .de SH-xref 25 .ie n \{\ 26 .\} 27 .toupper \\$* 28 .el \{\ 29 \\$* 30 .\} 31 .. 32 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 33 .\" SH - level-one heading that works better for non-TTY output 34 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 35 .de1 SH 36 .\" put an extra blank line of space above the head in non-TTY output 37 .if t \{\ 38 .sp 1 39 .\} 40 .sp \\n[PD]u 41 .nr an-level 1 42 .set-an-margin 43 .nr an-prevailing-indent \\n[IN] 44 .fi 45 .in \\n[an-margin]u 46 .ti 0 47 .HTML-TAG ".NH \\n[an-level]" 48 .it 1 an-trap 49 .nr an-no-space-flag 1 50 .nr an-break-flag 1 51 \." make the size of the head bigger 52 .ps +3 53 .ft B 54 .ne (2v + 1u) 55 .ie n \{\ 56 .\" if n (TTY output), use uppercase 57 .toupper \\$* 58 .\} 59 .el \{\ 60 .nr an-break-flag 0 61 .\" if not n (not TTY), use normal case (not uppercase) 62 \\$1 63 .in \\n[an-margin]u 64 .ti 0 65 .\" if not n (not TTY), put a border/line under subheading 66 .sp -.6 67 \l'\n(.lu' 68 .\} 69 .. 70 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 71 .\" SS - level-two heading that works better for non-TTY output 72 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 73 .de1 SS 74 .sp \\n[PD]u 75 .nr an-level 1 76 .set-an-margin 77 .nr an-prevailing-indent \\n[IN] 78 .fi 79 .in \\n[IN]u 80 .ti \\n[SN]u 81 .it 1 an-trap 82 .nr an-no-space-flag 1 83 .nr an-break-flag 1 84 .ps \\n[PS-SS]u 85 \." make the size of the head bigger 86 .ps +2 87 .ft B 88 .ne (2v + 1u) 89 .if \\n[.$] \&\\$* 90 .. 91 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 92 .\" BB/BE - put background/screen (filled box) around block of text 93 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 94 .de BB 95 .if t \{\ 96 .sp -.5 97 .br 98 .in +2n 99 .ll -2n 100 .gcolor red 101 .di BX 102 .\} 103 .. 104 .de EB 105 .if t \{\ 106 .if "\\$2"adjust-for-leading-newline" \{\ 107 .sp -1 108 .\} 109 .br 110 .di 111 .in 112 .ll 113 .gcolor 114 .nr BW \\n(.lu-\\n(.i 115 .nr BH \\n(dn+.5v 116 .ne \\n(BHu+.5v 117 .ie "\\$2"adjust-for-leading-newline" \{\ 118 \M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] 119 .\} 120 .el \{\ 121 \M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] 122 .\} 123 .in 0 124 .sp -.5v 125 .nf 126 .BX 127 .in 128 .sp .5v 129 .fi 130 .\} 131 .. 132 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 133 .\" BM/EM - put colored marker in margin next to block of text 134 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 135 .de BM 136 .if t \{\ 137 .br 138 .ll -2n 139 .gcolor red 140 .di BX 141 .\} 142 .. 143 .de EM 144 .if t \{\ 145 .br 146 .di 147 .ll 148 .gcolor 149 .nr BH \\n(dn 150 .ne \\n(BHu 151 \M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[] 152 .in 0 153 .nf 154 .BX 155 .in 156 .fi 157 .\} 158 .. 159 .\" ----------------------------------------------------------------- 160 .\" * set default formatting 161 .\" ----------------------------------------------------------------- 9 162 .\" disable hyphenation 10 163 .nh 11 164 .\" disable justification (adjust text to left margin only) 12 165 .ad l 13 .SH "NAME" 14 smbpasswd - change a user's SMB password 15 .SH "SYNOPSIS" 16 .HP 1 17 smbpasswd [\-a] [\-c\ <config\ file>] [\-x] [\-d] [\-e] [\-D\ debuglevel] [\-n] [\-r\ <remote\ machine>] [\-R\ <name\ resolve\ order>] [\-m] [\-U\ username[%password]] [\-h] [\-s] [\-w\ pass] [\-W] [\-i] [\-L] [username] 166 .\" ----------------------------------------------------------------- 167 .\" * MAIN CONTENT STARTS HERE * 168 .\" ----------------------------------------------------------------- 169 .SH "Name" 170 smbpasswd \- change a user\'s SMB password 171 .SH "Synopsis" 172 .fam C 173 .HP \w'\ 'u 174 \FCsmbpasswd\F[] [\-a] [\-c\ <config\ file>] [\-x] [\-d] [\-e] [\-D\ debuglevel] [\-n] [\-r\ <remote\ machine>] [\-R\ <name\ resolve\ order>] [\-m] [\-U\ username[%password]] [\-h] [\-s] [\-w\ pass] [\-W] [\-i] [\-L] [username] 175 .fam 18 176 .SH "DESCRIPTION" 19 177 .PP 20 178 This tool is part of the 21 179 \fBsamba\fR(7) 22 suite\ .180 suite\&. 23 181 .PP 24 182 The smbpasswd program has several different functions, depending on whether it is run by the 25 183 \fIroot\fR 26 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\.27 .PP 28 By default (when run with no arguments) it will attempt to change the current user\'s SMB password on the local machine\ . This is similar to the way the29 passwd(1) 30 program works\ .31 smbpasswd 184 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\&. 185 .PP 186 By default (when run with no arguments) it will attempt to change the current user\'s SMB password on the local machine\&. This is similar to the way the 187 \FCpasswd(1)\F[] 188 program works\&. 189 \FC smbpasswd\F[] 32 190 differs from how the passwd program works however in that it is not 33 191 \fIsetuid root\fR 34 192 but works in a client\-server mode and communicates with a locally running 35 \fBsmbd\fR(8)\ . 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 the193 \fBsmbd\fR(8)\&. 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 36 194 \fBsmbpasswd\fR(5) 37 file\ .38 .PP 39 When run by an ordinary user with no options, smbpasswd will prompt them for their old SMB password and then ask them for their new password twice, to ensure that the new password 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\.40 .PP 41 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 (\fI\-r\fR) and195 file\&. 196 .PP 197 When run by an ordinary user with no options, smbpasswd will prompt them for their old SMB password and then ask them for their new password twice, to ensure that the new password 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\&. 198 .PP 199 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 (\fI\-r\fR) and 42 200 \fI\-U\fR 43 options below\ .44 .PP 45 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,46 smbpasswd 47 accesses the local smbpasswd file directly, thus enabling changes to be made even if smbd is not running\ .201 options below\&. 202 .PP 203 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, 204 \FC smbpasswd\F[] 205 accesses the local smbpasswd file directly, thus enabling changes to be made even if smbd is not running\&. 48 206 .SH "OPTIONS" 49 207 .PP 50 208 \-a 51 209 .RS 4 52 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 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 the user to already exist in the system password file (usually53 \ fI/etc/passwd\fR), else the request to add the user will fail\.54 .sp 55 This option is only available when running smbpasswd as root\ .210 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 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 the user to already exist in the system password file (usually 211 \FC/etc/passwd\F[]), else the request to add the user will fail\&. 212 .sp 213 This option is only available when running smbpasswd as root\&. 56 214 .RE 57 215 .PP … … 59 217 .RS 4 60 218 This option can be used to specify the path and file name of the 61 \ fIsmb\.conf\fR62 configuration file when it is important to use other than the default file and / or location\ .219 \FCsmb\&.conf\F[] 220 configuration file when it is important to use other than the default file and / or location\&. 63 221 .RE 64 222 .PP 65 223 \-x 66 224 .RS 4 67 This option specifies that the username following should be deleted from the local smbpasswd file\ .68 .sp 69 This option is only available when running smbpasswd as root\ .225 This option specifies that the username following should be deleted from the local smbpasswd file\&. 226 .sp 227 This option is only available when running smbpasswd as root\&. 70 228 .RE 71 229 .PP … … 74 232 This option specifies that the username following should be 75 233 \fBdisabled\fR 76 in the local smbpasswd file\ . This is done by writing a234 in the local smbpasswd file\&. This is done by writing a 77 235 \fB\'D\'\fR 78 flag into the account control space in the smbpasswd file\ . Once this is done all attempts to authenticate via SMB using this username will fail\.79 .sp 80 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\. See236 flag into the account control space in the smbpasswd file\&. Once this is done all attempts to authenticate via SMB using this username will fail\&. 237 .sp 238 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 81 239 \fBsmbpasswd\fR(5) 82 for details on the \'old\' and new password file formats\ .83 .sp 84 This option is only available when running smbpasswd as root\ .240 for details on the \'old\' and new password file formats\&. 241 .sp 242 This option is only available when running smbpasswd as root\&. 85 243 .RE 86 244 .PP … … 89 247 This option specifies that the username following should be 90 248 \fBenabled\fR 91 in the local smbpasswd file, if the account was previously disabled\ . If the account was not disabled this option has no effect\. Once the account is enabled then the user will be able to authenticate via SMB once again\.249 in the local smbpasswd file, if the account was previously disabled\&. If the account was not disabled this option has no effect\&. Once the account is enabled then the user will be able to authenticate via SMB once again\&. 92 250 .sp 93 251 If the smbpasswd file is in the \'old\' format, then 94 smbpasswd 95 will FAIL to enable the account\ . See252 \FC smbpasswd\F[] 253 will FAIL to enable the account\&. See 96 254 \fBsmbpasswd\fR(5) 97 for details on the \'old\' and new password file formats\ .98 .sp 99 This option is only available when running smbpasswd as root\ .255 for details on the \'old\' and new password file formats\&. 256 .sp 257 This option is only available when running smbpasswd as root\&. 100 258 .RE 101 259 .PP … … 103 261 .RS 4 104 262 \fIdebuglevel\fR 105 is an integer from 0 to 10\ . The default value if this parameter is not specified is zero\.106 .sp 107 The higher this value, the more detail will be logged to the log files about the activities of smbpasswd\ . At level 0, only critical errors and serious warnings will be logged\.108 .sp 109 Levels above 1 will generate considerable amounts of log data, and should only be used when investigating a problem\ . Levels above 3 are designed for use only by developers and generate HUGE amounts of log data, most of which is extremely cryptic\.263 is an integer from 0 to 10\&. The default value if this parameter is not specified is zero\&. 264 .sp 265 The higher this value, the more detail will be logged to the log files about the activities of smbpasswd\&. At level 0, only critical errors and serious warnings will be logged\&. 266 .sp 267 Levels above 1 will generate considerable amounts of log data, and should only be used when investigating a problem\&. Levels above 3 are designed for use only by developers and generate HUGE amounts of log data, most of which is extremely cryptic\&. 110 268 .RE 111 269 .PP 112 270 \-n 113 271 .RS 4 114 This option specifies that the username following should have their password set to null (i\ .e\. a blank password) in the local smbpasswd file\. This is done by writing the string "NO PASSWORD" as the first part of the first password stored in the smbpasswd file\.272 This option specifies that the username following should have their password set to null (i\&.e\&. a blank password) in the local smbpasswd file\&. This is done by writing the string "NO PASSWORD" as the first part of the first password stored in the smbpasswd file\&. 115 273 .sp 116 274 Note that to allow users to logon to a Samba server once the password has been set to "NO PASSWORD" in the smbpasswd file the administrator must set the following parameter in the [global] section of the 117 \ fIsmb\.conf\fR275 \FCsmb\&.conf\F[] 118 276 file : 119 277 .sp 120 null passwords = yes 121 .sp 122 This option is only available when running smbpasswd as root\ .278 \FCnull passwords = yes\F[] 279 .sp 280 This option is only available when running smbpasswd as root\&. 123 281 .RE 124 282 .PP 125 283 \-r remote machine name 126 284 .RS 4 127 This option allows a user to specify what machine they wish to change their password on\ . Without this parameter smbpasswd defaults to the local host\. The285 This option allows a user to specify what machine they wish to change their password on\&. Without this parameter smbpasswd defaults to the local host\&. The 128 286 \fIremote machine name\fR 129 is the NetBIOS name of the SMB/CIFS server to contact to attempt the password change\ . This name is resolved into an IP address using the standard name resolution mechanism in all programs of the Samba suite\. See the287 is the NetBIOS name of the SMB/CIFS server to contact to attempt the password change\&. This name is resolved into an IP address using the standard name resolution mechanism in all programs of the Samba suite\&. See the 130 288 \fI\-R name resolve order\fR 131 parameter for details on changing this resolving mechanism\ .132 .sp 133 The username whose password is changed is that of the current UNIX logged on user\ . See the289 parameter for details on changing this resolving mechanism\&. 290 .sp 291 The username whose password is changed is that of the current UNIX logged on user\&. See the 134 292 \fI\-U username\fR 135 parameter for details on changing the password for a different username\ .136 .sp 137 Note that if changing a Windows NT Domain password the remote machine specified must be the Primary Domain Controller for the domain (Backup Domain Controllers only have a read\-only copy of the user account database and will not allow the password change)\ .293 parameter for details on changing the password for a different username\&. 294 .sp 295 Note that if changing a Windows NT Domain password the remote machine specified must be the Primary Domain Controller for the domain (Backup Domain Controllers only have a read\-only copy of the user account database and will not allow the password change)\&. 138 296 .sp 139 297 \fINote\fR 140 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\ .298 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\&. 141 299 .RE 142 300 .PP 143 301 \-R name resolve order 144 302 .RS 4 145 This option allows the user of smbpasswd to determine what name resolution services to use when looking up the NetBIOS name of the host being connected to\ .146 .sp 147 The options are :"lmhosts", "host", "wins" and "bcast"\ . They cause names to be resolved as follows:303 This option allows the user of smbpasswd to determine what name resolution services to use when looking up the NetBIOS name of the host being connected to\&. 304 .sp 305 The options are :"lmhosts", "host", "wins" and "bcast"\&. They cause names to be resolved as follows: 148 306 .sp 149 307 .RS 4 … … 155 313 .IP \(bu 2.3 156 314 .\} 157 \fBlmhosts\fR: Lookup an IP address in the Samba lmhosts file\ . If the line in lmhosts has no name type attached to the NetBIOS name (see the315 \fBlmhosts\fR: 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 158 316 \fBlmhosts\fR(5) 159 for details) then any name type matches for lookup\ .317 for details) then any name type matches for lookup\&. 160 318 .RE 161 319 .sp … … 169 327 .\} 170 328 \fBhost\fR: Do a standard host name to IP address resolution, using the system 171 \ fI/etc/hosts \fR, NIS, or DNS lookups\. This method of name resolution is operating system depended for instance on IRIX or Solaris this may be controlled by the172 \ fI/etc/nsswitch\.conf\fR173 file)\ . Note that this method is only used if the NetBIOS name type being queried is the 0x20 (server) name type, otherwise it is ignored\.329 \FC/etc/hosts \F[], NIS, or DNS lookups\&. This method of name resolution is operating system depended for instance on IRIX or Solaris this may be controlled by the 330 \FC/etc/nsswitch\&.conf\F[] 331 file)\&. Note that this method is only used if the NetBIOS name type being queried is the 0x20 (server) name type, otherwise it is ignored\&. 174 332 .RE 175 333 .sp … … 184 342 \fBwins\fR: Query a name with the IP address listed in the 185 343 \fIwins server\fR 186 parameter\ . If no WINS server has been specified this method will be ignored\.344 parameter\&. If no WINS server has been specified this method will be ignored\&. 187 345 .RE 188 346 .sp … … 197 355 \fBbcast\fR: Do a broadcast on each of the known local interfaces listed in the 198 356 \fIinterfaces\fR 199 parameter\ . This is the least reliable of the name resolution methods as it depends on the target host being on a locally connected subnet\.357 parameter\&. This is the least reliable of the name resolution methods as it depends on the target host being on a locally connected subnet\&. 200 358 .sp 201 359 .RE 202 360 The default order is 203 lmhosts, host, wins, bcast 361 \FClmhosts, host, wins, bcast\F[] 204 362 and without this parameter or any entry in the 205 363 \fBsmb.conf\fR(5) 206 file the name resolution methods will be attempted in this order\ .364 file the name resolution methods will be attempted in this order\&. 207 365 .RE 208 366 .PP 209 367 \-m 210 368 .RS 4 211 This option tells smbpasswd that the account being changed is a MACHINE account\ . Currently this is used when Samba is being used as an NT Primary Domain Controller\.212 .sp 213 This option is only available when running smbpasswd as root\ .369 This option tells smbpasswd that the account being changed is a MACHINE account\&. Currently this is used when Samba is being used as an NT Primary Domain Controller\&. 370 .sp 371 This option is only available when running smbpasswd as root\&. 214 372 .RE 215 373 .PP … … 218 376 This option may only be used in conjunction with the 219 377 \fI\-r\fR 220 option\ . When changing a password on a remote machine it allows the user to specify the user name on that machine whose password will be changed\. It is present to allow users who have different user names on different systems to change these passwords\.378 option\&. When changing a password on a remote machine it allows the user to specify the user name on that machine whose password will be changed\&. It is present to allow users who have different user names on different systems to change these passwords\&. 221 379 .RE 222 380 .PP … … 224 382 .RS 4 225 383 This option prints the help string for 226 smbpasswd, selecting the correct one for running as root or as an ordinary user\.384 \FC smbpasswd\F[], selecting the correct one for running as root or as an ordinary user\&. 227 385 .RE 228 386 .PP 229 387 \-s 230 388 .RS 4 231 This option causes smbpasswd to be silent (i\ .e\. not issue prompts) and to read its old and new passwords from standard input, rather than from232 \ fI/dev/tty\fR389 This option causes smbpasswd to be silent (i\&.e\&. not issue prompts) and to read its old and new passwords from standard input, rather than from 390 \FC/dev/tty\F[] 233 391 (like the 234 passwd(1) 235 program does)\ . This option is to aid people writing scripts to drive smbpasswd392 \FCpasswd(1)\F[] 393 program does)\&. This option is to aid people writing scripts to drive smbpasswd 236 394 .RE 237 395 .PP 238 396 \-w password 239 397 .RS 4 240 This parameter is only available if Samba has been compiled with LDAP support\ . The398 This parameter is only available if Samba has been compiled with LDAP support\&. The 241 399 \fI\-w\fR 242 400 switch is used to specify the password to be used with the 243 \ fIldap admin dn\fR\. Note that the password is stored in the244 \ fIsecrets\.tdb\fR245 and is keyed off of the admin\'s DN\ . This means that if the value of401 \m[blue]\fBldap admin dn\fR\m[]\&. Note that the password is stored in the 402 \FCsecrets\&.tdb\F[] 403 and is keyed off of the admin\'s DN\&. This means that if the value of 246 404 \fIldap admin dn\fR 247 ever changes, the password will need to be manually updated as well\ .405 ever changes, the password will need to be manually updated as well\&. 248 406 .RE 249 407 .PP 250 408 \-W 251 409 .RS 4 252 NOTE: 253 This option is same as "\-w" except that the password should be entered using stdin\ .254 .sp 255 This parameter is only available if Samba has been compiled with LDAP support\ . The410 \FCNOTE: \F[] 411 This option is same as "\-w" except that the password should be entered using stdin\&. 412 .sp 413 This parameter is only available if Samba has been compiled with LDAP support\&. The 256 414 \fI\-W\fR 257 415 switch is used to specify the password to be used with the 258 \ fIldap admin dn\fR\. Note that the password is stored in the259 \ fIsecrets\.tdb\fR260 and is keyed off of the admin\'s DN\ . This means that if the value of416 \m[blue]\fBldap admin dn\fR\m[]\&. Note that the password is stored in the 417 \FCsecrets\&.tdb\F[] 418 and is keyed off of the admin\'s DN\&. This means that if the value of 261 419 \fIldap admin dn\fR 262 ever changes, the password will need to be manually updated as well\ .420 ever changes, the password will need to be manually updated as well\&. 263 421 .RE 264 422 .PP 265 423 \-i 266 424 .RS 4 267 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\.268 .sp 269 This option is only available when running smbpasswd as root\ .425 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\&. 426 .sp 427 This option is only available when running smbpasswd as root\&. 270 428 .RE 271 429 .PP 272 430 \-L 273 431 .RS 4 274 Run in local mode\ .432 Run in local mode\&. 275 433 .RE 276 434 .PP … … 279 437 This specifies the username for all of the 280 438 \fIroot only\fR 281 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\.439 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\&. 282 440 .RE 283 441 .SH "NOTES" 284 442 .PP 285 443 Since 286 smbpasswd 287 works in client\-server mode communicating with a local smbd for a non\-root user then the smbd daemon must be running for this to work\ . A common problem is to add a restriction to the hosts that may access the288 smbd 444 \FCsmbpasswd\F[] 445 works in client\-server mode communicating with a local smbd for a non\-root user then the smbd daemon must be running for this to work\&. A common problem is to add a restriction to the hosts that may access the 446 \FC smbd\F[] 289 447 running on the local machine by specifying either 290 448 \fIallow hosts\fR … … 293 451 entry in the 294 452 \fBsmb.conf\fR(5) 295 file and neglecting to allow "localhost" access to the smbd\ .296 .PP 297 In addition, the smbpasswd command is only useful if Samba has been set up to use encrypted passwords\ .453 file and neglecting to allow "localhost" access to the smbd\&. 454 .PP 455 In addition, the smbpasswd command is only useful if Samba has been set up to use encrypted passwords\&. 298 456 .SH "VERSION" 299 457 .PP 300 This man page is correct for version 3 of the Samba suite\ .458 This man page is correct for version 3 of the Samba suite\&. 301 459 .SH "SEE ALSO" 302 460 .PP 303 461 \fBsmbpasswd\fR(5), 304 \fBSamba\fR(7)\ .462 \fBSamba\fR(7)\&. 305 463 .SH "AUTHOR" 306 464 .PP 307 The original Samba software and related utilities were created by Andrew Tridgell\ . Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed\.308 .PP 309 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 at310 ftp://ftp\ .icce\.rug\.nl/pub/unix/) 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\.465 The original Samba software and related utilities were created by Andrew Tridgell\&. Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed\&. 466 .PP 467 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 468 ftp://ftp\&.icce\&.rug\&.nl/pub/unix/) 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\&.
Note:
See TracChangeset
for help on using the changeset viewer.
