-.TH afppasswd 1 "22 Aug 2004" 2.0.0 Netatalk
-.SH NAME
+'\" t
+.\" Title: afppasswd
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
+.\" Date: 22 Mar 2012
+.\" Manual: Netatalk 3.0
+.\" Source: Netatalk 3.0
+.\" Language: English
+.\"
+.TH "AFPPASSWD" "1" "22 Mar 2012" "Netatalk 3.0" "Netatalk 3.0"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
afppasswd \- netatalk password maintenance utility
-.SH SYNOPSIS
-\fBafppasswd\fR [\-acfn] [ \-p
-\fBpasswd\fR \fBfile\fR ] [ \-u
-\fBminimum\fR \fBuid\fR ]
-.SH DESCRIPTION
-afppasswd allows the maintenance of afppasswd
-files created by netatalk for use by the uams_randnum.so UAM (providing
-the "Randnum exchange" and "2\-Way Randnum exchange" User Authentication
-Modules).
-.PP
-afppasswd can either be called by root with
-parameters, or can be called by local system users with no parameters to
-change their AFP passwords.
-.RS
+.SH "SYNOPSIS"
+.HP \w'\fBafppasswd\fR\fB\fR\fB\fR\ 'u
+\fBafppasswd\fR\fB\fR\fB\fR [\-acfn] [\-p\ \fIpasswd\fR\ \fIfile\fR] [\-u\ \fIminimum\fR\ \fIuid\fR]
+.SH "DESCRIPTION"
+.PP
+\fBafppasswd\fR
+allows the maintenance of afppasswd files created by netatalk for use by the uams_randnum\&.so UAM (providing the "Randnum exchange" and "2\-Way Randnum exchange" User Authentication Modules)\&.
+.PP
+\fBafppasswd\fR
+can either be called by root with parameters, or can be called by local system users with no parameters to change their AFP passwords\&.
+.if n \{\
+.sp
+.\}
+.RS 4
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.ps +1
\fBNote\fR
+.ps -1
+.br
.PP
-With this utility you can only change the passwords used by two
-specific UAMs. As they provide only weak password encryption, the use of
-the "Randnum exchange" and "2\-Way Randnum exchange" UAMs is deprecated
-unless one has to support very old AFP clients, that can not deal with
-the more secure "DHCAST128" UAM instead. Please compare with the [Cross reference to non\-existant ID \(lqauthentication\(rq] inside Netatalk's
-documentation.
+With this utility you can only change the passwords used by two specific UAMs\&. As they provide only weak password encryption, the use of the "Randnum exchange" and "2\-Way Randnum exchange" UAMs is deprecated unless one has to support very old AFP clients, that can not deal with the more secure "DHCAST128" and "DHX2" UAM instead\&. Please compare with the
+Authentication chapter
+inside Netatalk\'s documentation\&.
+.sp .5v
.RE
-.SH EXAMPLE
-Local user changing their own password:
+.SH "EXAMPLE"
.PP
+Local user changing their own password:
+.sp
+.if n \{\
+.RS 4
+.\}
.nf
example% \fBafppasswd\fR
Enter NEW AFP password: \fB(hidden)\fR
Enter NEW AFP password again: \fB(hidden)\fR
-afppasswd: updated password.
+afppasswd: updated password\&.
.fi
-.SH OPTIONS
-.TP
+.if n \{\
+.RE
+.\}
+.SH "OPTIONS"
+.PP
\fB\-a\fR
-Add a new user to the afppasswd
-file.
-.TP
+.RS 4
+Add a new user to the
+\fBafppasswd\fR
+file\&.
+.RE
+.PP
\fB\-c\fR
-Create and/or initialize afppasswd file or
-specific user.
-.TP
+.RS 4
+Create and/or initialize
+\fBafppasswd\fR
+file or specific user\&.
+.RE
+.PP
\fB\-f\fR
-Force the current action.
-.TP
+.RS 4
+Force the current action\&.
+.RE
+.PP
\fB\-p\fR\fI path\fR
-Path to afppasswd file.
-.TP
+.RS 4
+Path to
+\fBafppasswd\fR
+file\&.
+.RE
+.PP
\fB\-n\fR
-If cracklib support is built into \fInetatalk\fR this option will cause cracklib
-checking to be disabled, if the superuser does not want to have the
-password run against the cracklib dictionary.
-.TP
+.RS 4
+If cracklib support is built into
+\fBnetatalk\fR
+this option will cause cracklib checking to be disabled, if the superuser does not want to have the password run against the cracklib dictionary\&.
+.RE
+.PP
\fB\-u\fR\fI minimum uid\fR
-This is the minimum \fIuser id\fR
-(uid) that afppasswd will use when creating
-users.
+.RS 4
+This is the minimum
+\fIuser id\fR
+(uid) that
+\fBafppasswd\fR
+will use when creating users\&.
+.RE
.SH "SEE ALSO"
-\fBafpd\fR(8), \fBatalkd\fR(8).
-
+.PP
+\fBafpd\fR(8),
+\fBafp.conf\fR(5)\&.
projects / netatalk.git / blobdiff