blob: 79524f941b6fe34cd60ee0cf1e142131cbd4a3a4 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
|
.TH SMBPASSWD 8 "19 Sep 1998" "smbpasswd 2.0.0-alpha6"
.SH NAME
smbpasswd \- change a users smb password in the smbpasswd file.
.SH SYNOPSIS
.B smbpasswd
[
.B \-a
] [
.B \-r
remote_machine
] [
.B username
]
.SH DESCRIPTION
This program is part of the Samba suite.
.B smbpasswd
allows a user to change their encrypted smb password which
is stored in the smbpasswd file (usually kept in the
.I private
directory under the
.I Samba
directory hierarchy. Ordinary users can only run the command
with no options. It 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.
.B New for 1.9.18p4.
smbpasswd will now allow a user to change their password
on a Windows NT server. To use this add the
.I \-r
.I \<remote_machine\>
paramter to the smbpasswd command. The machine name is looked
up using the "name resolve order" parameter defined in the
smb.conf [global] section. Note that when changing a Windows
NT password for a domain user,
.I \<remote machine\>
must be the name of the Primary domain controller.
To allow users to change their passwords from "NO PASSWORD"
in the smbpasswd file to a valid password the administrator
must set the following parameter in the [global] section of
the smb.conf :
null passwords = true
This is
.B NOT
recommended as a general policy, it is recommended that
new users be assigned a default password instead.
The
.I \-a
and
.I username
options can only be used by a user running as root.
.SH OPTIONS
.I \-a
.RS 3
Specifies that the username following should be added to
the
.I 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
.I smbpasswd
file and it is treated like a regular change password
command. Note that the user to be added
.B must
already exist in the system password file (usually /etc/passwd)
else the request to add the user will fail.
.RE
.I username
.RS 3
You may only specify a username to the smbpasswd command
if you are running as root. Only root should have the
permission to modify other users smb passwords.
.RE
.RE
.SH INSTALLATION
The location of the server and its support files is a matter for individual
system administrators. The following are thus suggestions only.
It is recommended that the
.B smbpasswd
program be installed in the /usr/local/samba/bin directory. This should be
a directory readable by all, writeable only by root. The program should be
executable by all. The program
.B must not
be setuid root.
.SH VERSION
This man page is correct for version 1.9.18p4 of the Samba suite.
These notes will necessarily lag behind
development of the software, so it is possible that your version of
the program has extensions or parameter semantics that differ from or are not
covered by this man page. Please notify these to the address below for
rectification.
.SH SEE ALSO
.BR smbd (8),
.BR smb.conf (5)
.SH
.B BUGS
.RE
The
.B smbpasswd
command is only useful if
.I Samba
has been set up to use encrypted passwords. See the file
.I ENCRYPTION.txt
in the docs directory for details on how to do this.
.SH CREDITS
.RE
The original Samba software and related utilities were created by
Andrew Tridgell (samba-bugs@samba.anu.edu.au). Andrew is also the Keeper
of the Source for this project. smbpasswd and the encrypted password
file code was written by Jeremy Allison (samba-bugs@samba.anu.edu.au).
This man page was written by Jeremy Allison. Bug reports to samba-bugs@samba.anu.edu.au.
See
.BR smb.conf (5)
for a full list of contributors and details of how to
submit bug reports, comments etc.
|
