# &tool; Manual V&manrevision;

2004
Carlos Garnacho Parro
Carlos Garnacho Parro

&legal;

Carlos
Garnacho Parro
&tool; Manual V&manrevision;
&date;

carlosg@gnome.org (Carlos Garnacho Parro)

carlosg@gnome.org (Carlos Garnacho Parro)

This manual describes version &toolversion; of &tool;.

## Feedback

To report a bug or make a suggestion regarding the &tool; or this manual, follow the directions in the GNOME Feedback Page.

## Introduction

The &tool; allows you add, delete and modify the existing users and groups in your system.

## Getting started

You can start &tool; in the following ways:

Applications menu

  Choose System Tools Users and groups.

Command line

  Execute the following command: `users-admin`

When you start &tool;, you will be prompted for the administrator password, this is necessary because the changes done with this tool will affect the whole system.

After entering the administrator password, the following window is displayed.

### &tool; main window

Shows &tool; main window.

The &tool; main window contains two tabbed sections:

Users

  Shows the list of users and enables you to add new users and to modify or delete the current ones.

Groups

  Shows the list of groups and enables you to add new groups and to modify or delete the current ones.

## Usage

### To add a new user

Press the Add button, a new window will appear asking for the new user data. For adding a new user, you must provide at least the username and password (automatically generated or by hand). Optionally you can specify or modify real name, office location, work phone, home phone, main group, used shell, home directory, user ID and a list of the secondary groups for the user.

Main group, used shell, home directory and user ID are automatically guessed depending on the selected profile, so you may be interested in creating different profiles for different groups of users.

### To modify an existing user

Select the user you want to modify and press the Properties button, A window similar to the used for adding new users will appear with all the user data, allowing you to modify them.

### To delete an existing user

Select the user or users that you want to delete and press the Delete button in the Users tab, due to the importance of this data, you will be asked for confirmation for every user you want to delete.

For security reasons, the home directory of the deleted users will not be deleted.

### To add a new group

Press the Add button, a new window will appear asking for the new group data. For adding a new group, you must provide at least the group name and the group ID. Optionally you can specify the users that will belong to this group.

### To modify an existing group

Select the group you want to modify and press the Properties button, A window will appear with the group's data allowing you to modify them.

### To delete an existing group

Select the group or groups that you want to delete and press the Delete button in the Groups tab, due to the importance of this data, you will be asked for confirmation for every group you want to delete.

### To create new profile

For opening the profiles window, you must press the Edit user profiles that is inside the new users window, then press the Add button, a new window will appear asking you for the new profile data. For creating a new profile, you must at least provide the profile name, the default home directory, the default shell and the default maximum/minimum user/group ID.

If you want to replace any part of the default home directory with the user name, you can use the $user keyword (i.e.: /home/$user).

### To modify an existing profile

In the profiles window, select the profile you want to modify and press the Properties button, a new window will appear with the profile data, allowing you to modify them.

### To delete an existing profile

Select the profile or profiles that you want to delete and press the Delete button in the profiles window, note that at least the default profile is needed, so you can not delete it.