Changed sulogin's respawn in inittab to 'once'
[linux_from_scratch.git] / BOOK / appendixa / shadowpwd-desc.xml
blob9f289fa82a401a300f277511409e89f9fef0d41c
1 <sect2><title>Contents of Shadow</title>
3 <para>Last checked against version &shadow-contversion;.</para>
5 <sect3><title>Program Files</title>
6 <para>chage, chfn, chpasswd, chsh, dpasswd, expiry, faillog, gpasswd, 
7 groupadd, groupdel, groupmod, groups, grpck, grpconv, grpunconv, lastlog,
8 login,  logoutd, mkpasswd, newgrp, newusers, passwd, pwck, pwconv, pwunconv,
9 sg (link to newgrp), useradd, userdel, usermod, vigr (link to vipw) and
10 vipw</para></sect3>
12 <sect3><title>Descriptions</title>
14 <sect4><title>chage</title>
15 <para>chage changes the number of days between password changes and the date of 
16 the last password change.</para></sect4>
18 <sect4><title>chfn</title>
19 <para>chfn changes a user's full name and other information
20 (office room number, office phone number, and
21 home phone number).</para></sect4>
23 <sect4><title>chpasswd</title>
24 <para>chpasswd reads a file of user name and password pairs from standard 
25 input and uses this information to update a group of 
26 existing users.</para></sect4>
28 <sect4><title>chsh</title>
29 <para>chsh  changes the user login shell.</para></sect4>
31 <sect4><title>dpasswd</title>
32 <para>dpasswd adds, deletes, and updates dial-up passwords for 
33 user login shells.</para></sect4>
35 <sect4><title>expiry</title>
36 <para>expiry checks and enforces a password expiration policy.</para></sect4>
38 <sect4><title>faillog</title>
39 <para>faillog formats the contents of the failure log,/var/log/faillog, and 
40 maintains failure counts and limits.</para></sect4>
42 <sect4><title>gpasswd</title>
43 <para>gpasswd is used to administer the /etc/group file.</para></sect4>
45 <sect4><title>groupadd</title>
46 <para>The groupadd command creates a new group account using the values 
47 specified on the command line and the default values from 
48 the system.</para></sect4>
50 <sect4><title>groupdel</title>
51 <para>The groupdel command modifies the system account files, deleting all 
52 entries that refer to group.</para></sect4>
54 <sect4><title>groupmod</title>
55 <para>The groupmod command modifies the system account files to reflect the 
56 changes that are specified on the command line.</para></sect4>
58 <sect4><title>groups</title>
59 <para>groups prints the groups which a user is in.</para></sect4>
61 <sect4><title>grpck</title>
62 <para>grpck verifies the integrity of the system authentication 
63 information.</para></sect4>
65 <sect4><title>grpconv</title>
66 <para>grpunconv converts to shadow group files from normal 
67 group files.</para></sect4>
69 <sect4><title>grpunconv</title>
70 <para>grpunconv converts from shadow group files to normal 
71 group files.</para></sect4>
73 <sect4><title>lastlog</title>
74 <para>lastlog formats and prints the contents of the last login log, 
75 /var/log/lastlog. The login-name, port, and last login time will be 
76 printed.</para></sect4>
78 <sect4><title>login</title>
79 <para>login is used to establish a new session with the system.</para></sect4>
81 <sect4><title>logoutd</title>
82 <para>logoutd enforces the login time and port restrictions specified in 
83 /etc/porttime.</para></sect4>
85 <sect4><title>mkpasswd</title>
86 <para>mkpasswd reads a file in the format given by the flags and converts it 
87 to the corresponding database file format.</para></sect4>
89 <sect4><title>newgrp</title>
90 <para>newgrp is used to change the current group ID during a 
91 login session.</para></sect4>
93 <sect4><title>newusers</title>
94 <para>newusers reads a file of user name and clear text password pairs and uses 
95 this information to update a group of existing users or to create new 
96 users.</para></sect4>
98 <sect4><title>passwd</title>
99 <para>passwd changes passwords for user and group accounts.</para></sect4>
101 <sect4><title>pwck</title>
102 <para>pwck verifies the integrity of the password files.</para></sect4>
104 <sect4><title>pwconv</title>
105 <para>pwconv converts the normal password file
106 to a shadowed password file.</para></sect4>
108 <sect4><title>pwunconv</title>
109 <para>pwunconv converts a shadowed password file
110 to a normal password file.</para></sect4>
112 <sect4><title>sg</title>
113 <para>sg sets the user's GID to that of the given group, or executes a
114 given command as member of the given group.</para></sect4>
116 <sect4><title>useradd</title>
117 <para>useradd creates a new user or update default new user 
118 information.</para></sect4>
120 <sect4><title>userdel</title>
121 <para>userdel modifies the system account files, deleting all entries that 
122 refer to a specified login name.</para></sect4>
124 <sect4><title>usermod</title>
125 <para>usermod modifies the system account files to reflect the changes that 
126 are specified on the command line.</para></sect4>
128 <sect4><title>vipw and vigr</title>
129 <para>vipw and vigr will edit the files /etc/passwd and /etc/group, 
130 respectively. With the -s flag, they will edit the shadow versions of 
131 those files, /etc/shadow  and /etc/gshadow,  respectively.</para></sect4>
133 </sect3>
135 <sect3><title>Library Files</title>
136 <para>libmisc.[a,so], libshadow.[a,so]</para></sect3>
138 <sect3><title>Descriptions</title>
140 <sect4><title>libmisc</title>
141 <para>No description is currently available.</para></sect4>
143 <sect4><title>libshadow</title>
144 <para>libshadow provides common functionality for the shadow
145 programs.</para></sect4>
147 </sect3>
149 </sect2>