Name

fwpasswd — create and update password authentication files

Synopsis

fwpasswd passwd_file user_name

Description

Program fwpasswd is used to create and update files, in which usernames and passwords for password authentication in Kernun firewall are stored. The program has two parameters: the password file name and the user name. The user's password is read from the standard input. If the password file does not exist, it is created. Otherwise, the file is updated. If the user name is already contained in the file, a new password is set. Otherwise, the user is added with an empty list of groups.

The return value of fwpasswd is 0 if the password file is successfully created or updated. If an error occurs, the password file remains unchanged and fwpasswd returns nonzero.

Each line of the password file contains colon-separated information about one user: user name, password (encrypted by crypt(3) function), and optionally a list of (comma-separated) groups the user belongs to. Program fwpasswd uses a temporary file named as the password file with additional suffix .tmp.

For existing users, fwpasswd modifies only the password. Any text editor can be used to rename or delete a user or to change the list of groups for a user.

Restrictions

  • Usernames may not include the character ':'.

  • The length of a password file line (username, encrypted password, and list of groups) is limited to 200 characters.

  • Passwords may not include the character '@'. (This is because of ftp-proxy, in which both proxy password and server password can be given at once, delimited with the character '@'.)

See Also

auth(7)

Authors

This man page is a part of Kernun Firewall.
Copyright © 2000–2023 Trusted Network Solutions, a. s.
All rights reserved.