Click on any of the 687 commands below to get a description and list of available options. All links in the command summaries point to the online version of the book on Safari Bookshelf.
System administration command. Modify user account information.
Options
-ccomment
Comment field.
-ddir
Home directory.
-edate
Account expiration date. date is in the format MM/DD/YYYY; two-digit year fields are also accepted. The value is stored as the number of days since January 1, 1970. This option requires the use of shadow passwords.
-fdays
Permanently disable account this many days after the password has expired. A value of -1 disables this feature. This option requires the use of shadow passwords.
-ggroup
Initial group name or number.
-Ggroups
Supplementary groups given by name or number in a comma-separated list with no whitespace. user will be removed from any groups to which it currently belongs that are not included in groups.
-lname
Login name. This cannot be changed while the user is logged in.
-L
Lock user's password by putting a ! in front of it. This option cannot be used with -p or -U.
-o
Override. Accept a nonunique uid with the -u option.
-ppw
Encrypted password, as returned from crypt(3).
-sshell
Login shell.
-uuid
Numerical user ID. The value must be unique unless the -o option is used. Any files owned by user in the user's home directory will have their user ID changed automatically. Files outside of the home directory will not be changed. user should not be executing any processes while this is changed.
-U
Unlock the user's password by removing the ! that -L put in front of it. This option cannot be used with -p or -L.