# The &kuser; Handbook

## Getting Started

&kuser; allows you to manage users and groups on your system.

This is a short introduction to &kuser;. For more detailed information, see Usage.

Actually, you do not need to do anything to begin using &kuser; except configuration.

If you do not launch &kuser; in administrator mode, you will get a warning, that the file `/etc/shadow` is not readable.

## Usage

### Main Window

&kuser; is a very simple application. In the main window you can see two tabs: the list of users and the list of groups. To edit a user or a group, just click on it. The user or group properties dialog will appear.

&kuser; Main Window &kuser; Main Window

### User and Group Properties

#### User Properties Dialog

The user properties dialog has two tabs.

##### User Info Tab

In the User Info tab you can modify:

- User login with the user name and a Set Password button for this account,

- User Id

- Full Name

- Login Shell (the list of login shells is taken from the `/etc/shells` file)

- Home Folder

- Two office locations

- Address

- Account disabled

##### Password Management Tab

The Password Management tab will appear in administrator mode if you have shadow passwords, or any other similar things such as `/etc/master.passwd` in BSD flavor Unices.

- Minimum number of days between password changes

- Number of days after which a password expires if it hasn't been changed

- Number of days before expiration the user will be warned

- Whether and when an account will be disabled if the password expires

- A set date when the account expires

- Class (on BSD systems)

The date of the last password change is displayed near the top of the dialog.

##### Groups Tab

The Groups tab contains all the information about the selected user's participation in groups. The primary group to which the user belongs is set with the Set as Primary button. The user can be assigned to additional groups by checking them in the large box.

#### Group Properties

The Group Properties dialog contains a list of all users in the selected group on the left and a list of all other users.

Select a user in one of both lists and use the Add and Remove buttons to manage members of the group.

### Managing Users or Groups

To add a user or group to the system, either choose Add from the User or Group menu, or click the relevant Add button on the toolbar.

A selected user or group can also be edited or deleted in the same way.

## Customizing &kuser;

### Edit user creation defaults

To edit the user creation defaults you can use the Connection tab on the General page of &kuser;'s configuration dialog, which is accessible via the menu Settings Configure &kuser;.

There you may change the defaults that are used when creating a new user: Shell and Home Folder (or home folders volume). You can choose whether to make a home folder on create or not, and to copy a skeleton (standard configuration files) to the home folder or not. You can also enable User private group mechanism, which creates a new personal group with the creation of a new user, and removes the personal group when the user is removed.

## Credits and License

&kuser;

Program copyright 1997-2000 Denis Pershin dyp@inetlab.com

Documentation copyright 1997-2000 Denis Pershin dyp@inetlab.com

Documentation copyright 2000 &Matt.Johnston; &Matt.Johnston.mail;

&underFDL; &underGPL;
&documentation.index;