]> arthur.barton.de Git - netatalk.git/blob - man/man1/afppasswd.1
8fd151513286b6a91e5a495fddff20f6339fe985
[netatalk.git] / man / man1 / afppasswd.1
1 .TH afppasswd 1 "22 Aug 2004" 2.0.3 Netatalk 
2 .SH NAME
3 afppasswd \- netatalk password maintenance utility
4 .SH SYNOPSIS
5 \fBafppasswd\fR [\-acfn] [ \-p
6 \fBpasswd\fR \fBfile\fR ] [ \-u
7 \fBminimum\fR \fBuid\fR ]
8 .SH DESCRIPTION
9 afppasswd allows the maintenance of afppasswd
10 files created by netatalk for use by the uams_randnum.so UAM (providing
11 the "Randnum exchange" and "2\-Way Randnum exchange" User Authentication
12 Modules).
13 .PP
14 afppasswd can either be called by root with
15 parameters, or can be called by local system users with no parameters to
16 change their AFP passwords.
17 .RS 
18 \fBNote\fR
19 .PP
20 With this utility you can only change the passwords used by two
21 specific UAMs. As they provide only weak password encryption, the use of
22 the "Randnum exchange" and "2\-Way Randnum exchange" UAMs is deprecated
23 unless one has to support very old AFP clients, that can not deal with
24 the more secure "DHCAST128" UAM instead. Please compare with the [Cross reference to non\-existant ID \(lqauthentication\(rq] inside Netatalk's
25 documentation.
26 .RE
27 .SH EXAMPLE
28 Local user changing their own password:
29 .PP
30 .nf
31 example% \fBafppasswd\fR
32 Enter NEW AFP password: \fB(hidden)\fR
33 Enter NEW AFP password again: \fB(hidden)\fR
34 afppasswd: updated password.
35 .fi
36 .SH OPTIONS
37 .TP 
38 \fB\-a\fR
39 Add a new user to the afppasswd
40 file.
41 .TP 
42 \fB\-c\fR
43 Create and/or initialize afppasswd file or
44 specific user.
45 .TP 
46 \fB\-f\fR
47 Force the current action.
48 .TP 
49 \fB\-p\fR\fI path\fR
50 Path to afppasswd file.
51 .TP 
52 \fB\-n\fR
53 If cracklib support is built into \fInetatalk\fR this option will cause cracklib
54 checking to be disabled, if the superuser does not want to have the
55 password run against the cracklib dictionary.
56 .TP 
57 \fB\-u\fR\fI minimum uid\fR
58 This is the minimum \fIuser id\fR
59 (uid) that afppasswd will use when creating
60 users.
61 .SH "SEE ALSO"
62 \fBafpd\fR(8), \fBatalkd\fR(8).
63