-.TH AFPPASSWD 1 "03 Aug 2000" "netatalk 1.5"
-.SH NAME
+'\" t
+.\" Title: afppasswd
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.78.0 <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"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * 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
-.B afppasswd
-[
-.B \-acfn
-]
-[
-.B \-p\fI passwd file
-]
-[
-.B \-u\fI minimum uid
-]
-.SH DESCRIPTION
-.B afppasswd
-allows the maintenance of afppasswd files created by netatalk for
-use by some User Authentication Modules (UAMs)
-.LP
-.B afppasswd
-can either be called by root with parameters, or can be called by
-local system users with no parameters to change their passwords.
-.SH EXAMPLE
+.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" and "DHX2" UAM instead\&. Please compare with the
+Authentication chapter
+inside Netatalk\*(Aqs documentation\&.
+.sp .5v
+.RE
+.SH "EXAMPLE"
+.PP
Local user changing their own password:
.sp
-.RS
+.if n \{\
+.RS 4
+.\}
.nf
- example% afppasswd
- Enter NEW AFP password: (hidden)
- Enter NEW AFP password again: (hidden)
- afppasswd: updated password.
+example% \fBafppasswd\fR
+Enter NEW AFP password: \fB(hidden)\fR
+Enter NEW AFP password again: \fB(hidden)\fR
+afppasswd: updated password\&.
.fi
+.if n \{\
.RE
-.SH OPTIONS
-.TP
-.B \-a
+.\}
+.SH "OPTIONS"
+.PP
+\fB\-a\fR
+.RS 4
Add a new user to the
-.B afppasswd
-file.
-.TP
-.B \-c
+\fBafppasswd\fR
+file\&.
+.RE
+.PP
+\fB\-c\fR
+.RS 4
Create and/or initialize
-.B afppasswd
-file or specific user.
-.TP
-.B \-f
-Force the current action.
-.TP
-.B \-p\fI path
+\fBafppasswd\fR
+file or specific user\&.
+.RE
+.PP
+\fB\-f\fR
+.RS 4
+Force the current action\&.
+.RE
+.PP
+\fB\-p\fR\fI path\fR
+.RS 4
Path to
-.B afppasswd
-file.
-.TP
-.B \-n
+\fBafppasswd\fR
+file\&.
+.RE
+.PP
+\fB\-n\fR
+.RS 4
If cracklib support is built into
-.B netatalk
-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
-.B \-u\fI minimum uid
+\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
+.RS 4
This is the minimum
-.I user id
+\fIuser id\fR
(uid) that
-.B afppasswd
-will use when creating users.
-.SH SEE ALSO
-.BR afpd (8),
-.BR atalkd (8).
+\fBafppasswd\fR
+will use when creating users\&.
+.RE
+.SH "SEE ALSO"
+.PP
+\fBafpd\fR(8),
+\fBafp.conf\fR(5)\&.
projects / netatalk.git / blobdiff