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