diff options
Diffstat (limited to 'appendixa/shadowpwd-desc.xml')
| -rw-r--r-- | appendixa/shadowpwd-desc.xml | 162 |
1 files changed, 68 insertions, 94 deletions
diff --git a/appendixa/shadowpwd-desc.xml b/appendixa/shadowpwd-desc.xml index 4ced96ec1..d71610663 100644 --- a/appendixa/shadowpwd-desc.xml +++ b/appendixa/shadowpwd-desc.xml @@ -6,136 +6,110 @@ <sect3><title>Program file descriptions</title> -<sect4><title>chage</title> -<para>chage changes the number of days between password changes and the date of -the last password change.</para></sect4> +<para><command>chage</command> is used to change the maximum number of +days between obligatory password changes.</para> -<sect4><title>chfn</title> -<para>chfn changes a user's full name and other information -(office room number, office phone number, and -home phone number).</para></sect4> +<para><command>chfn</command> is used to change a user's full name and +some other info.</para> -<sect4><title>chpasswd</title> -<para>chpasswd reads a file of user name and password pairs from standard -input and uses this information to update a group of -existing users.</para></sect4> +<para><command>chpasswd</command> is used to update the passwords of a +whole series of user accounts in one go.</para> -<sect4><title>chsh</title> -<para>chsh changes the user login shell.</para></sect4> +<para><command>chsh</command> is used to change a user's default + login shell.</para> -<sect4><title>dpasswd</title> -<para>dpasswd adds, deletes and updates dial-up passwords for -user login shells.</para></sect4> +<para><command>dpasswd</command> is used to change dial-up passwords for +user login shells.</para> -<sect4><title>expiry</title> -<para>expiry checks and enforces a password expiration policy.</para></sect4> +<para><command>expiry</command> checks and enforces the current password +expiration policy.</para> -<sect4><title>faillog</title> -<para>faillog formats the contents of the failure log, /var/log/faillog, and -maintains failure counts and limits.</para></sect4> +<para><command>faillog</command> is used to examine the log of login +failures, to set a maximum number of failures before an account is blocked, +or to reset the failure count.</para> -<sect4><title>gpasswd</title> -<para>gpasswd is used to administer the /etc/group file.</para></sect4> +<para><command>gpasswd</command> is used to add and delete members and +administrators to groups.</para> -<sect4><title>groupadd</title> -<para>The groupadd command creates a new group account using the values -specified on the command line and the default values from -the system.</para></sect4> +<para><command>groupadd</command> creates a group with the given +name.</para> -<sect4><title>groupdel</title> -<para>The groupdel command modifies the system account files, deleting all -entries that refer to group.</para></sect4> +<para><command>groupdel</command> deletes the group with the given +name.</para> -<sect4><title>groupmod</title> -<para>The groupmod command modifies the system account files to reflect the -changes that are specified on the command line.</para></sect4> +<para><command>groupmod</command> is used to modify the given group's +name or GID.</para> -<sect4><title>groups</title> -<para>groups prints the groups which a user is in.</para></sect4> +<para><command>groups</command> reports the groups of which the given +users are members.</para> -<sect4><title>grpck</title> -<para>grpck verifies the integrity of the system authentication -information.</para></sect4> +<para><command>grpck</command> verifies the integrity of the group files, +<filename>/etc/group</filename> and <filename>/etc/gshadow</filename>.</para> -<sect4><title>grpconv</title> -<para>grpunconv converts to shadow group files from normal -group files.</para></sect4> +<para><command>grpconv</command> creates or updates the shadow group file +from the normal group file.</para> -<sect4><title>grpunconv</title> -<para>grpunconv converts from shadow group files to normal -group files.</para></sect4> +<para><command>grpunconv</command> updates <filename>/etc/group</filename> +from <filename>/etc/gshadow</filename> and then deletes the latter.</para> -<sect4><title>lastlog</title> -<para>lastlog formats and prints the contents of the last login log, -/var/log/lastlog. The login-name, port and last login time will be -printed.</para></sect4> +<para><command>lastlog</command> reports the most recent login of all +users, or of a given user.</para> -<sect4><title>login</title> -<para>login is used to establish a new session with the system.</para></sect4> +<para><command>login</command> is used by the system let users sign on.</para> -<sect4><title>logoutd</title> -<para>logoutd enforces the login time and port restrictions specified in -/etc/porttime.</para></sect4> +<para><command>logoutd</command> is a daemon used to enforce restrictions +on log-on time and ports.</para> -<sect4><title>mkpasswd</title> -<para>mkpasswd reads a file in the format given by the flags and converts it -to the corresponding database file format.</para></sect4> +<para><command>mkpasswd</command> encrypts the given password using the +also given perturbation.</para> -<sect4><title>newgrp</title> -<para>newgrp is used to change the current group ID during a -login session.</para></sect4> +<para><command>newgrp</command> is used to change the current GID during +a login session.</para> -<sect4><title>newusers</title> -<para>newusers reads a file of user name and clear text password pairs and uses -this information to update a group of existing users or to create new -users.</para></sect4> +<para><command>newusers</command> is used to create or update a whole +series of user accounts in one go.</para> -<sect4><title>passwd</title> -<para>passwd changes passwords for user and group accounts.</para></sect4> +<para><command>passwd</command> is used to change the password for a user +or group account.</para> -<sect4><title>pwck</title> -<para>pwck verifies the integrity of the password files.</para></sect4> +<para><command>pwck</command> verifies the integrity of the password files, +<filename>/etc/passwd</filename> and <filename>/etc/shadow</filename>.</para> -<sect4><title>pwconv</title> -<para>pwconv converts the normal password file -to a shadowed password file.</para></sect4> +<para><command>pwconv</command> creates or updates the shadow password file +from the normal password file.</para> -<sect4><title>pwunconv</title> -<para>pwunconv converts a shadowed password file -to a normal password file.</para></sect4> +<para><command>pwunconv</command> updates <filename>/etc/passwd</filename> +from <filename>/etc/shadow</filename> and then deletes the latter.</para> -<sect4><title>sg</title> -<para>sg sets the user's GID to that of the given group, or executes a -given command as member of the given group.</para></sect4> +<para><command>sg</command> executes a given command while the user's GID +is set to that of the given group.</para> -<sect4><title>useradd</title> -<para>useradd creates a new user or updates default new user -information.</para></sect4> +<para><command>useradd</command> creates a new user with the given name, +or updates the default new-user information.</para> -<sect4><title>userdel</title> -<para>userdel modifies the system account files, deleting all entries that -refer to a specified login name.</para></sect4> +<para><command>userdel</command> deletes the given user account.</para> -<sect4><title>usermod</title> -<para>usermod modifies the system account files to reflect the changes that -are specified on the command line.</para></sect4> +<para><command>usermod</command> is used to modify the given user's +login name, UID, shell, initial group, home directory, and the like.</para> -<sect4><title>vipw and vigr</title> -<para>vipw and vigr will edit the files /etc/passwd and /etc/group, -respectively. With the -s flag, they will edit the shadow versions of -those files, /etc/shadow and /etc/gshadow, respectively.</para></sect4> +<para><command>vigr</command> can be used to edit the +<filename>/etc/group</filename> or <filename>/etc/gshadow</filename> +files.</para> + +<para><command>vipw</command> can be used to edit the +<filename>/etc/passwd</filename> or <filename>/etc/shadow</filename> +files.</para> </sect3> <sect3><title>Library file descriptions</title> -<sect4><title>libmisc</title> -<para>No description is currently available.</para></sect4> +<para><command>libmisc</command>...</para> -<sect4><title>libshadow</title> -<para>libshadow provides common functionality for the shadow -programs.</para></sect4> +<para><command>libshadow</command> contains functions used by most +programs in this package.</para> </sect3> </sect2> + |