From 209f940bf0ee262b35e01c553e941c1b291e1a4c Mon Sep 17 00:00:00 2001 From: Dru Lavigne Date: Wed, 23 Oct 2013 17:29:49 +0000 Subject: [PATCH] Added some clarifications and Table headings to sections 4.3 to 4.3.2.5. The pw section should have at least one example. The limiting users section needs to be moved elsewhere. To be followed by a whitespace fix. --- .../books/handbook/basics/chapter.xml | 104 ++++++++++-------- 1 file changed, 56 insertions(+), 48 deletions(-) diff --git a/en_US.ISO8859-1/books/handbook/basics/chapter.xml b/en_US.ISO8859-1/books/handbook/basics/chapter.xml index bbe1ddc79f..44618dd062 100644 --- a/en_US.ISO8859-1/books/handbook/basics/chapter.xml +++ b/en_US.ISO8859-1/books/handbook/basics/chapter.xml @@ -620,10 +620,14 @@ Password: &os; provides a variety of different commands to manage - user accounts. The most common commands are summarized below, - followed by more detailed examples of their usage. + user accounts. The most common commands are summarized in Table 4.1, + followed by some examples of their usage. Refer to the manual + page for each utility for more details and usage + examples. + + + Utilities for Managing User Accounts - @@ -655,7 +659,7 @@ Password: &man.passwd.1; - The simple command-line tool to change user + The command-line tool to change user passwords. @@ -666,7 +670,7 @@ Password: - +
<command>adduser</command> @@ -683,14 +687,25 @@ Password: class="directory">/usr/share/skel skeleton directory - &man.adduser.8; is a simple program for adding new users + The recommended program for adding new users is &man.adduser.8;. When a new user is added, this program automatically updates /etc/passwd and /etc/group. It also creates a home directory for the new user, copies in the default configuration files from /usr/share/skel, and can - optionally mail the new user a welcome message. + optionally mail the new user a welcome message. This utility + must be run as the superuser + + The &man.adduser.8; utility is interactive and walks + through the steps for creating a new user account. As seen in + Example 4.2, either input the required information or press + Return to accept the default value shown in + square brackets. In this example, the user has been invited + into the wheel group, which is + required to provide the account with superuser + access. When finished, the utility will prompt to either + create another user or to exit. Adding a User on &os; @@ -743,13 +758,13 @@ Goodbye! removing - To completely remove a user from the system use - &man.rmuser.8;. This command performs the following + To completely remove a user from the system, run + &man.rmuser.8; as the superuser. This command performs the following steps: - Removes the user's &man.crontab.1; entry if one + Removes the user's &man.crontab.1; entry, if one exists. @@ -768,7 +783,7 @@ Goodbye! - Removes the user's home directory, if it is owned by + Optionally removes the user's home directory, if it is owned by the user. @@ -786,14 +801,11 @@ Goodbye! Finally, removes the username from all groups to which - it belongs in /etc/group. - - - If a group becomes empty and the group name is the + it belongs in /etc/group. If a group + becomes empty and the group name is the same as the username, the group is removed. This complements the per-user unique groups created by &man.adduser.8;. - @@ -813,12 +825,7 @@ Matching password entry: jru:*:1001:1001::0:0:J. Random User:/home/jru:/usr/local/bin/zsh Is this the entry you wish to remove? y Remove user's home directory (/home/jru)? y -Updating password file, updating databases, done. -Updating group file: trusted (removing group jru -- personal group is empty) done. -Removing user's incoming mail file /var/mail/jru: done. -Removing files belonging to jru from /tmp: done. -Removing files belonging to jru from /var/tmp: done. -Removing files belonging to jru from /var/tmp/vi.recover: done. +Removing user (jru): mailspool home passwd. &prompt.root; @@ -827,12 +834,9 @@ Removing files belonging to jru from /var/tmp/vi.recover: done. <command>chpass</command> chpass - &man.chpass.1; can be used to change user database - information such as passwords, shells, and personal - information. - - Only the superuser can change other users' information and - passwords with &man.chpass.1;. + Any user can use &man.chpass.1; to change their default + shell and personal + information associated with their user account. The superuser can use this utility to change additional account information for any user. When passed no options, aside from an optional username, &man.chpass.1; displays an editor containing user information. @@ -840,12 +844,19 @@ Removing files belonging to jru from /var/tmp/vi.recover: done. updated with the new information. - You will be asked for your password after exiting the - editor if you are not the superuser. + This utility will prompt for the user's password when exiting the + editor, unless the utility is run as the superuser. + + In Example 4.4, the superuser has typed + chpass jru and is now viewing the fields + that can be changed for this user. If + jru runs this command instead, only the + last six fields will be displayed and available for + editing. This is shown in Example 4.5. - Interactive <command>chpass</command> by + <title>Using <command>chpass</command> as Superuser #Changing user database information for jru. @@ -865,11 +876,8 @@ Home Phone: Other information: - A user can change only a small subset of this - information, and only for their own user account. - - Interactive <command>chpass</command> by Normal + <title>Using <command>chpass</command> as Regular User #Changing user database information for jru. @@ -884,8 +892,8 @@ Other information: &man.chfn.1; and &man.chsh.1; are links to &man.chpass.1;, as are &man.ypchpass.1;, &man.ypchfn.1;, and - &man.ypchsh.1;. NIS support is - automatic, so specifying the yp before + &man.ypchsh.1;. Since NIS support is + automatic, specifying the yp before the command is not necessary. How to configure NIS is covered in . @@ -898,16 +906,10 @@ Other information: accounts changing password - &man.passwd.1; is the usual way to change your own - password as a user, or another user's password as the - superuser. - - - To prevent accidental or unauthorized changes, the user - must enter their original password before a new password can - be set. This is not the case when the superuser changes a - user's password. - + Any user can easily change their password using &man.passwd.1;. + To prevent accidental or unauthorized changes, this command will + prompt for the user's original password before a new password can + be set: Changing Your Password @@ -921,6 +923,12 @@ passwd: updating the database... passwd: done + The superuser can change any user's password by specifying + the username when running &man.passwd.1;. When this utility + is run as the superuser, it will not prompt for the user's + current password. This allows the password to be changed when + a user cannot remember the original password. + Changing Another User's Password as the Superuser @@ -935,7 +943,7 @@ passwd: done As with &man.chpass.1;, &man.yppasswd.1; is a link to - &man.passwd.1;, so NIS works with either command. + &man.passwd.1;, so NIS works with either command.