From owner-svn-doc-all@FreeBSD.ORG Wed Oct 23 17:29:49 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id E167055B; Wed, 23 Oct 2013 17:29:49 +0000 (UTC) (envelope-from dru@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id CCB872F79; Wed, 23 Oct 2013 17:29:49 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r9NHTnW8069232; Wed, 23 Oct 2013 17:29:49 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r9NHTnLC069231; Wed, 23 Oct 2013 17:29:49 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201310231729.r9NHTnLC069231@svn.freebsd.org> From: Dru Lavigne Date: Wed, 23 Oct 2013 17:29:49 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r43030 - head/en_US.ISO8859-1/books/handbook/basics X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 23 Oct 2013 17:29:50 -0000 Author: dru Date: Wed Oct 23 17:29:49 2013 New Revision: 43030 URL: http://svnweb.freebsd.org/changeset/doc/43030 Log: 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. Modified: head/en_US.ISO8859-1/books/handbook/basics/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/basics/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/basics/chapter.xml Wed Oct 23 16:55:20 2013 (r43029) +++ head/en_US.ISO8859-1/books/handbook/basics/chapter.xml Wed Oct 23 17:29:49 2013 (r43030) @@ -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 /va <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 /va 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.