# &tool; Manual

## 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:

System menu

- Choose Administration 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 the following elements:

Users list

- Shows the available users. depending on the mateconf key "/apps/mate-system-tools/users/showall" it will show the system users too.

User manipulation buttons

- Allows to add or delete users or modify user settings.

Manage groups button

- Shows a similar dialog to modify group settings.

### &tool; groups editor

Groups editor.

## Usage

### To add a new user

Press the Add button in the main dialog, 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.

### To modify an existing user

Select the user you want to modify and press the Properties button, a window similar to the one 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 in the groups dialog, 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 in the groups dialog 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 in the groups dialog 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.