<body bgcolor=#ffffff> <title>Users and Groups</title> <center><img src="images/useradmin.gif"></center><br> <h2><i>This help page is incomplete</i></h2> <hr> <h3>Introduction</h3> This module allows you to create, edit and delete Unix users and groups. Typically, there is one Unix user account for each person who wants to login to your system. In addition, various system programs will have their own accounts, such as <tt>uucp</tt> or <tt>www</tt>. Every user belongs to one or more groups, one of which is the primary group for the user. <p> The main <tt>Users and Groups</tt> page shows all the local users and groups on your system. NIS and NIS+ users and groups will not be shown in the list, because they are not stored locally and cannot be edited. However, groups can contain NIS users and users can have an NIS group as their primary group. <p> If your machine is an NIS or NIS+ server and the table sources are not <tt>/etc/passwd</tt> and <tt>/etc/group</tt>, you can change the <a href="../config.cgi?useradmin">module configuration</a> to edit the appropriate files. The <tt>Command to run after change</tt> parameter can be set to something like <tt>cd /var/yp ; make</tt> to update NIS maps after every change to the password and group files. <p> <hr> <h3>Editing an Existing User</h3> To edit a user, just click on the user's name from the list on the main page. This will display a form in which you can edit the following user details :<p> <ul> <li><b>Username</b><br> The name that the user uses to login to the system. Each user must have a unique login name. <p> <li><b>Real name</b><br> The user's real name. This is stored in the comment field in the password file. <p> <li><b>Encrypted password</b> and <b>Plain text password</b><br> The Unix password file stores passwords in one-way encrypted form only. This means that the form cannot display the user's plain-text password, only the encrypted form. To set a new password for a user you can either enter the password into the <tt>Plain text password</tt> field, or copy and paste an encrypted string into the <tt>Encrypted password</tt> field. <p> <li><b>Password type</b><br> If you choose <tt>No password</tt> here, then no password is needed to login to the account. If you choose <tt>Locked</tt>, then no login is allowed. Only if <tt>Normal password</tt> is chosen will the passwords described above be used. <p> <li><b>Unix UID</b><br> The UID is the number that the system <b>really</b> uses for controlling access to files. Every user should have a unique UID. If you change the Unix UID, then the <tt>Change UID</tt> option at the bottom of the page determines what happens to files owned by that user. <p> <li><b>Home directory</b><br> Every user should have a home directory to store personal files. Typically, user home directories are all located under one parent directory, such as <tt>/home</tt>. <p> <li><b>Shell program</b><br> When a user logs into the system, their shell program is run to process whatever commands the user types. If a user has a shell like <tt>/bin/false</tt>, then they will not be able to login. This is useful for users who should only have FTP or email access. <p> <li><b>Primary group</b><br> A user's primary group is the group which will usually be assigned to any new files the user creates. If you change the primary group, the <tt>Change GID</tt> option at the bottom of the page controls what happens to files owned by that user and group. <p> <li><b>Other groups</b><br> This is a list of all the other groups a user belongs to. Only local groups will be shown, not NIS or NIS+ groups. <p> </ul><p> Some other user properties are only available if your system has a shadow password file and the module configuration knows about it. They are :<p> <ul> <li><b>foo</b><br> foo. <p> </ul><p> <hr> <h3>Creating a New User</h3> To create a new user, click on the <tt>Create New User</tt> link below the list of existing users on the main page. This will display the same form as is used for editing a user, but with almost all the fields empty. The only field that will be automatically filled in for you is the UID, which Webmin will compute by picking a free UID at the end of a sequence of existing UIDs. <p> When a new user is created, the user's home directory can be created as well. To have webmin create and set the permissions on the directory you specify, choose <tt>Create home directory</tt> at the bottom of the page. You should do this for all normal users you add. <p> The <tt>Files to copy</tt> option in the module preferences can be used to copy various files (such as <tt>.cshrc</tt> or <tt>.profile</tt>) into the home directory of a newly created user. You should change this parameter to a space-separated list of files to copy. <p> <hr> <h3>Deleting a User</h3> To delete an existing user, click on the <tt>Delete</tt> button in the user details form. This will take you to a page asking if you want to delete the user's home directory as well. Be very careful when choosing to do this, as some system users have the root directory as their home directory. <p> In general, you should never change the UID, username or shell of system users such as <tt>root</tt>, <tt>bin</tt> or <tt>nobody</tt>. Doing so could make your system unusable or unbootable. Do not try to delete any of these users either, <b>especially</b> <tt>root</tt>. <p> <hr> <h3>Editing an Existing Group</h3> To edit a group, click on the group name from the list of groups on the main page. This will bring you to a form in which you can edit the following group properties : <ul> <li><b>Group name</b><br> The unique name for this group. <p> <li><b>Group GID</b><br> Like this UID for a Unix user, this is a number that the system uses to identify the group. Each group should have a unique GID. <p> <li><b>Members</b><br> The list of all users in this group. This can include NIS or NIS+ users as well, if they are in use on your system. <p> <li><b>Password</b><br> Not used? <p> </ul><p> <hr> <h3>Creating a New Group</h3> To create a new group, click on the <tt>Create new group</tt> link beneath the list of existing groups. This links to the same form as is used for editing an existing group, but with all the fields blank except for the GID. This is automatically filled by finding a free GID for the new group. <p> <hr> <h3>Deleting a Group</h3> To delete an existing group, click on the <tt>Delete Group</tt> button on the group details page. This will immediately delete the group without asking. No files or directories will be deleted though. <p> <hr> <a href="/"><img alt="<-" align=middle border=0 src=/images/left.gif></a> <a href="">Return to module</a><p>
| Name | Type | Size | Permission | Actions |
|---|---|---|---|---|
| help | Folder | 0755 |
|
|
| images | Folder | 0755 |
|
|
| lang | Folder | 0755 |
|
|
| CHANGELOG | File | 5.66 KB | 0644 |
|
| acl_security.pl | File | 13.74 KB | 0755 |
|
| aix-lib.pl | File | 1.17 KB | 0755 |
|
| backup_config.pl | File | 749 B | 0755 |
|
| batch_exec.cgi | File | 17.21 KB | 0755 |
|
| batch_form.cgi | File | 2.42 KB | 0755 |
|
| cgi_args.pl | File | 477 B | 0755 |
|
| config-aix | File | 703 B | 0644 |
|
| config-cobalt-linux | File | 710 B | 0644 |
|
| config-coherent-linux | File | 657 B | 0644 |
|
| config-corel-linux | File | 665 B | 0644 |
|
| config-debian-linux | File | 665 B | 0644 |
|
| config-freebsd | File | 684 B | 0644 |
|
| config-generic-linux | File | 677 B | 0644 |
|
| config-gentoo-linux | File | 637 B | 0644 |
|
| config-hpux | File | 579 B | 0644 |
|
| config-irix | File | 757 B | 0644 |
|
| config-macos | File | 581 B | 0644 |
|
| config-mandrake-linux | File | 662 B | 0644 |
|
| config-msc-linux | File | 657 B | 0644 |
|
| config-netbsd | File | 623 B | 0644 |
|
| config-open-linux | File | 687 B | 0644 |
|
| config-openSUSE-Linux-15.0-ALL | File | 715 B | 0644 |
|
| config-openbsd | File | 636 B | 0644 |
|
| config-openmamba-linux | File | 657 B | 0644 |
|
| config-openserver | File | 841 B | 0644 |
|
| config-osf1 | File | 579 B | 0644 |
|
| config-pardus-linux | File | 665 B | 0644 |
|
| config-redhat-linux-15.0-ALL | File | 659 B | 0644 |
|
| config-redhat-linux-ALL-14.9 | File | 657 B | 0644 |
|
| config-slackware-linux | File | 663 B | 0644 |
|
| config-sol-linux | File | 657 B | 0644 |
|
| config-solaris | File | 631 B | 0644 |
|
| config-suse-linux | File | 677 B | 0644 |
|
| config-suse-linux-9.0-ALL | File | 715 B | 0644 |
|
| config-trustix-linux | File | 657 B | 0644 |
|
| config-turbo-linux | File | 677 B | 0644 |
|
| config-united-linux | File | 677 B | 0644 |
|
| config-unixware | File | 595 B | 0644 |
|
| config.info | File | 4.05 KB | 0644 |
|
| config.info.bg | File | 7.87 KB | 0644 |
|
| config.info.ca | File | 4.82 KB | 0644 |
|
| config.info.cs | File | 4.21 KB | 0644 |
|
| config.info.da | File | 3.7 KB | 0644 |
|
| config.info.de | File | 4.65 KB | 0644 |
|
| config.info.es | File | 4.34 KB | 0644 |
|
| config.info.fa | File | 6.04 KB | 0644 |
|
| config.info.fr | File | 2.77 KB | 0644 |
|
| config.info.hu | File | 0 B | 0644 |
|
| config.info.ja | File | 4.96 KB | 0644 |
|
| config.info.nl | File | 4.61 KB | 0644 |
|
| config.info.no | File | 4.12 KB | 0644 |
|
| config.info.pl | File | 3.01 KB | 0644 |
|
| config.info.pt_BR | File | 4.36 KB | 0644 |
|
| config.info.ru | File | 4.61 KB | 0644 |
|
| config.info.sv | File | 1.06 KB | 0644 |
|
| config.info.tr | File | 3.69 KB | 0644 |
|
| config.info.uk | File | 4.58 KB | 0644 |
|
| config.info.zh | File | 961 B | 0644 |
|
| config.info.zh_TW | File | 909 B | 0644 |
|
| cpan_modules.pl | File | 256 B | 0755 |
|
| defaultacl | File | 358 B | 0644 |
|
| delete_group.cgi | File | 2.18 KB | 0755 |
|
| delete_user.cgi | File | 4.67 KB | 0755 |
|
| edit_group.cgi | File | 4.97 KB | 0755 |
|
| edit_user.cgi | File | 18.46 KB | 0755 |
|
| export_exec.cgi | File | 2.9 KB | 0755 |
|
| export_form.cgi | File | 1.77 KB | 0755 |
|
| freebsd-lib.pl | File | 1.74 KB | 0755 |
|
| gbatch_exec.cgi | File | 8.1 KB | 0755 |
|
| gbatch_form.cgi | File | 1.59 KB | 0755 |
|
| gexport_exec.cgi | File | 1.73 KB | 0755 |
|
| gexport_form.cgi | File | 1.26 KB | 0755 |
|
| help.html | File | 6.79 KB | 0644 |
|
| hpux-lib.pl | File | 1.02 KB | 0755 |
|
| index.cgi | File | 7.38 KB | 0755 |
|
| irix-lib.pl | File | 1.09 KB | 0755 |
|
| linux-lib.pl | File | 4.75 KB | 0755 |
|
| list_logins.cgi | File | 1.55 KB | 0755 |
|
| list_who.cgi | File | 945 B | 0755 |
|
| log_parser.pl | File | 1.68 KB | 0755 |
|
| macos-lib.pl | File | 3.15 KB | 0755 |
|
| mass_delete_group.cgi | File | 2.41 KB | 0755 |
|
| mass_delete_user.cgi | File | 7.65 KB | 0755 |
|
| md5-lib.pl | File | 7.58 KB | 0755 |
|
| module.info | File | 544 B | 0644 |
|
| module.info.af | File | 0 B | 0644 |
|
| module.info.af.auto | File | 155 B | 0644 |
|
| module.info.ar | File | 173 B | 0644 |
|
| module.info.ar.auto | File | 34 B | 0644 |
|
| module.info.be | File | 0 B | 0644 |
|
| module.info.be.auto | File | 247 B | 0644 |
|
| module.info.bg | File | 0 B | 0644 |
|
| module.info.bg.auto | File | 228 B | 0644 |
|
| module.info.ca | File | 117 B | 0644 |
|
| module.info.ca.auto | File | 27 B | 0644 |
|
| module.info.cs | File | 30 B | 0644 |
|
| module.info.cs.auto | File | 134 B | 0644 |
|
| module.info.da | File | 27 B | 0644 |
|
| module.info.da.auto | File | 116 B | 0644 |
|
| module.info.de | File | 133 B | 0644 |
|
| module.info.de.auto | File | 25 B | 0644 |
|
| module.info.el | File | 0 B | 0644 |
|
| module.info.el.auto | File | 258 B | 0644 |
|
| module.info.es | File | 26 B | 0644 |
|
| module.info.es.auto | File | 136 B | 0644 |
|
| module.info.eu | File | 0 B | 0644 |
|
| module.info.eu.auto | File | 175 B | 0644 |
|
| module.info.fa | File | 0 B | 0644 |
|
| module.info.fa.auto | File | 220 B | 0644 |
|
| module.info.fi | File | 0 B | 0644 |
|
| module.info.fi.auto | File | 156 B | 0644 |
|
| module.info.fr | File | 32 B | 0644 |
|
| module.info.fr.auto | File | 154 B | 0644 |
|
| module.info.he | File | 0 B | 0644 |
|
| module.info.he.auto | File | 182 B | 0644 |
|
| module.info.hr | File | 0 B | 0644 |
|
| module.info.hr.auto | File | 147 B | 0644 |
|
| module.info.hu | File | 37 B | 0644 |
|
| module.info.hu.auto | File | 156 B | 0644 |
|
| module.info.it | File | 0 B | 0644 |
|
| module.info.it.auto | File | 129 B | 0644 |
|
| module.info.ja | File | 39 B | 0644 |
|
| module.info.ja.auto | File | 175 B | 0644 |
|
| module.info.ko | File | 29 B | 0644 |
|
| module.info.ko.auto | File | 142 B | 0644 |
|
| module.info.lt | File | 0 B | 0644 |
|
| module.info.lt.auto | File | 166 B | 0644 |
|
| module.info.lv | File | 0 B | 0644 |
|
| module.info.lv.auto | File | 167 B | 0644 |
|
| module.info.ms | File | 124 B | 0644 |
|
| module.info.ms.auto | File | 26 B | 0644 |
|
| module.info.mt | File | 0 B | 0644 |
|
| module.info.mt.auto | File | 133 B | 0644 |
|
| module.info.nl | File | 30 B | 0644 |
|
| module.info.nl.auto | File | 123 B | 0644 |
|
| module.info.no | File | 27 B | 0644 |
|
| module.info.no.auto | File | 116 B | 0644 |
|
| module.info.pl | File | 122 B | 0644 |
|
| module.info.pl.auto | File | 31 B | 0644 |
|
| module.info.pt | File | 30 B | 0644 |
|
| module.info.pt.auto | File | 124 B | 0644 |
|
| module.info.pt_BR | File | 30 B | 0644 |
|
| module.info.pt_BR.auto | File | 130 B | 0644 |
|
| module.info.ro | File | 0 B | 0644 |
|
| module.info.ro.auto | File | 167 B | 0644 |
|
| module.info.ru | File | 49 B | 0644 |
|
| module.info.ru.auto | File | 208 B | 0644 |
|
| module.info.sk | File | 0 B | 0644 |
|
| module.info.sk.auto | File | 177 B | 0644 |
|
| module.info.sl | File | 0 B | 0644 |
|
| module.info.sl.auto | File | 163 B | 0644 |
|
| module.info.sv | File | 31 B | 0644 |
|
| module.info.sv.auto | File | 128 B | 0644 |
|
| module.info.th | File | 0 B | 0644 |
|
| module.info.th.auto | File | 260 B | 0644 |
|
| module.info.tr | File | 31 B | 0644 |
|
| module.info.tr.auto | File | 147 B | 0644 |
|
| module.info.uk | File | 0 B | 0644 |
|
| module.info.uk.auto | File | 247 B | 0644 |
|
| module.info.ur | File | 0 B | 0644 |
|
| module.info.ur.auto | File | 232 B | 0644 |
|
| module.info.vi | File | 0 B | 0644 |
|
| module.info.vi.auto | File | 177 B | 0644 |
|
| module.info.zh | File | 24 B | 0644 |
|
| module.info.zh.auto | File | 103 B | 0644 |
|
| module.info.zh_TW | File | 30 B | 0644 |
|
| module.info.zh_TW.auto | File | 109 B | 0644 |
|
| my_group_chooser.cgi | File | 6.9 KB | 0755 |
|
| my_user_chooser.cgi | File | 6.56 KB | 0755 |
|
| netbsd-lib.pl | File | 1.74 KB | 0755 |
|
| openbsd-lib.pl | File | 1.74 KB | 0755 |
|
| openserver-lib.pl | File | 1.18 KB | 0755 |
|
| osf1-lib.pl | File | 1.01 KB | 0755 |
|
| prefs.info | File | 134 B | 0644 |
|
| rbac-mapping | File | 190 B | 0644 |
|
| save_group.cgi | File | 4.86 KB | 0755 |
|
| save_user.cgi | File | 20.39 KB | 0755 |
|
| search_group.cgi | File | 991 B | 0755 |
|
| search_user.cgi | File | 1.33 KB | 0755 |
|
| solaris-lib.pl | File | 1.78 KB | 0755 |
|
| unixware-lib.pl | File | 1.13 KB | 0755 |
|
| user-lib.pl | File | 71.71 KB | 0755 |
|