From 9d4aa868dbaa9abbe43a77466ff9ea363b232a32 Mon Sep 17 00:00:00 2001 From: TJ Saunders Date: Tue, 2 Aug 2016 09:47:00 -0700 Subject: [PATCH] Update the ftpasswd docs to mention the new/missing command-line options. --- doc/utils/ftpasswd.html | 59 +++++++++++++++++++++++++++++------------ 1 file changed, 42 insertions(+), 17 deletions(-) diff --git a/doc/utils/ftpasswd.html b/doc/utils/ftpasswd.html index b93b2568c4..71d5d12d3f 100644 --- a/doc/utils/ftpasswd.html +++ b/doc/utils/ftpasswd.html @@ -1,6 +1,3 @@ - - - ftpasswd: tool for ProFTPD's AuthUserFile, AuthGroupFile, UserPassword @@ -67,20 +64,20 @@

Usage

when not provided) and --gecos (not used by proftpd at all). For example: 
-  ftpasswd --passwd --name=bob --uid=1001 --home=/home/bob --shell=/bin/false
+  $ ftpasswd --passwd --name=bob --uid=1001 --home=/home/bob --shell=/bin/false
creates an account for user bob. To create a file with a name or location other than the default (which, for --passwd mode is ftpd.passwd), use the --file option. For example, to create the alternate password file in /usr/local/etc/ftpd/passwd: 
-  ftpasswd --passwd --file=/usr/local/etc/ftpd/passwd --name=bob --uid=1001 --home=/home/bob \
+  $ ftpasswd --passwd --file=/usr/local/etc/ftpd/passwd --name=bob --uid=1001 --home=/home/bob \
     --shell=/bin/false

For AuthGroupFiles, use --group: 

-  ftpasswd --group --name=group-name --gid=group-id --member=user-member1  \
+  $ ftpasswd --group --name=group-name --gid=group-id --member=user-member1  \
     --member=user-member2 ... --member=user-memberN
@@ -89,7 +86,7 @@

Usage

change a user's password. The --change-password option was provided just for this scenario: 
-  ftpasswd --passwd --name=user --change-password
+  $ ftpasswd --passwd --name=user --change-password

@@ -100,7 +97,7 @@

Usage

password hash from the file. Easier, though, is to use ftpasswd's --hash option: 
-  ftpasswd --hash
+  $ ftpasswd --hash
The password will either be prompted for, or it can be given on standard in using --stdin. @@ -123,7 +120,7 @@

Usage

option is --stdin: this allows scripts to provide a password to ftpasswd without prompting for a password. For example: 
-  echo passwd-variable | ftpasswd opts --stdin
+  $ echo passwd-variable | ftpasswd opts --stdin
Note that the --stdin option does not allow passwords to be passed to the script on the command line, but on stdin. This @@ -211,6 +208,21 @@

Options

requests that a new password be given if the entered password is the same as the current password. + --delete-user + + Remove the entry for the given user name from the file. + + -l Lock the password of the named account. This option disables a + --lock password by changing it to a value which matches no possible + encrypted value (it adds a '!' at the beginning of the + password). + + --not-previous-password + + Double-checks the given password against the previous password + for the user, and requests that a new password be given if + the entered password is the same as the previous password. + --not-system-password Double-checks the given password against the system password @@ -219,11 +231,19 @@

Options

helps to enforce different passwords for different types of access. + --sha256 Use the SHA-256 algorithm for encrypting passwords. + + --sha512 Use the SHA-512 algorithm for encrypting passwords. + --stdin Read the password directly from standard in rather than prompting for it. This is useful for writing scripts that automate use of ftpasswd. + -u Unlock the password of the named account. This option + --unlock re-enables a password by changing the password back to its + previous value (to the value before using the -l option). + --use-cracklib Causes ftpasswd to use Alec Muffet's cracklib routines in order to determine and prevent the use of bad or weak @@ -242,6 +262,10 @@

Options

Options: + --delete-group + + Remove the entry for the given group name from the file. + --enable-group-passwd Prompt for a group password. This is disabled by default, @@ -272,6 +296,10 @@

Options

the specified output-file, an entry will be created for them. Otherwise, the given fields will be updated. + --sha256 Use the SHA-256 algorithm for encrypting passwords. + + --sha512 Use the SHA-512 algorithm for encrypting passwords. + --stdin Read the password directly from standard in rather than prompting for it. This is useful for writing scripts that @@ -300,6 +328,10 @@

Options

--md5 Use the MD5 algorithm for encrypting passwords. This is the default. + --sha256 Use the SHA-256 algorithm for encrypting passwords. + + --sha512 Use the SHA-512 algorithm for encrypting passwords. + --stdin Read the password directly from standard in rather than prompting for it. This is useful for writing scripts that @@ -315,18 +347,11 @@

Options

-


- -Author: $Author: castaglia $
-Last Updated: $Date: 2011-03-03 22:17:29 $
-
- -© Copyright 2000-2011 TJ Saunders
+© Copyright 2000-2016 TJ Saunders
All Rights Reserved
 -