man/man1/afppasswd.1

   1 '\" t
   2 .\"     Title: afppasswd
   3 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
   4 .\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/>
   5 .\"      Date: 22 Mar 2012
   6 .\"    Manual: Netatalk 3.0
   7 .\"    Source: Netatalk 3.0
   8 .\"  Language: English
   9 .\"
  10 .TH "AFPPASSWD" "1" "22 Mar 2012" "Netatalk 3.0" "Netatalk 3.0"
  11 .\" -----------------------------------------------------------------
  12 .\" * Define some portability stuff
  13 .\" -----------------------------------------------------------------
  14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15 .\" http://bugs.debian.org/507673
  16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18 .ie \n(.g .ds Aq \(aq
  19 .el       .ds Aq '
  20 .\" -----------------------------------------------------------------
  21 .\" * set default formatting
  22 .\" -----------------------------------------------------------------
  23 .\" disable hyphenation
  24 .nh
  25 .\" disable justification (adjust text to left margin only)
  26 .ad l
  27 .\" -----------------------------------------------------------------
  28 .\" * MAIN CONTENT STARTS HERE *
  29 .\" -----------------------------------------------------------------
  30 .SH "NAME"
  31 afppasswd \- netatalk password maintenance utility
  32 .SH "SYNOPSIS"
  33 .HP \w'\fBafppasswd\fR\fB\fR\fB\fR\ 'u
  34 \fBafppasswd\fR\fB\fR\fB\fR [\-acfn] [\-p\ \fIpasswd\fR\ \fIfile\fR] [\-u\ \fIminimum\fR\ \fIuid\fR]
  35 .SH "DESCRIPTION"
  36 .PP
  37 \fBafppasswd\fR
  38 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)\&.
  39 .PP
  40 \fBafppasswd\fR
  41 can either be called by root with parameters, or can be called by local system users with no parameters to change their AFP passwords\&.
  42 .if n \{\
  43 .sp
  44 .\}
  45 .RS 4
  46 .it 1 an-trap
  47 .nr an-no-space-flag 1
  48 .nr an-break-flag 1
  49 .br
  50 .ps +1
  51 \fBNote\fR
  52 .ps -1
  53 .br
  54 .PP
  55 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
  56 Authentication chapter
  57 inside Netatalk\*(Aqs documentation\&.
  58 .sp .5v
  59 .RE
  60 .SH "EXAMPLE"
  61 .PP
  62 Local user changing their own password:
  63 .sp
  64 .if n \{\
  65 .RS 4
  66 .\}
  67 .nf
  68 example% \fBafppasswd\fR
  69 Enter NEW AFP password: \fB(hidden)\fR
  70 Enter NEW AFP password again: \fB(hidden)\fR
  71 afppasswd: updated password\&.
  72 .fi
  73 .if n \{\
  74 .RE
  75 .\}
  76 .SH "OPTIONS"
  77 .PP
  78 \fB\-a\fR
  79 .RS 4
  80 Add a new user to the
  81 \fBafppasswd\fR
  82 file\&.
  83 .RE
  84 .PP
  85 \fB\-c\fR
  86 .RS 4
  87 Create and/or initialize
  88 \fBafppasswd\fR
  89 file or specific user\&.
  90 .RE
  91 .PP
  92 \fB\-f\fR
  93 .RS 4
  94 Force the current action\&.
  95 .RE
  96 .PP
  97 \fB\-p\fR\fI path\fR
  98 .RS 4
  99 Path to
 100 \fBafppasswd\fR
 101 file\&.
 102 .RE
 103 .PP
 104 \fB\-n\fR
 105 .RS 4
 106 If cracklib support is built into
 107 \fBnetatalk\fR
 108 this option will cause cracklib checking to be disabled, if the superuser does not want to have the password run against the cracklib dictionary\&.
 109 .RE
 110 .PP
 111 \fB\-u\fR\fI minimum uid\fR
 112 .RS 4
 113 This is the minimum
 114 \fIuser id\fR
 115 (uid) that
 116 \fBafppasswd\fR
 117 will use when creating users\&.
 118 .RE
 119 .SH "SEE ALSO"
 120 .PP
 121 \fBafpd\fR(8),
 122 \fBafp.conf\fR(5)\&.