You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
266 lines
8.1 KiB
266 lines
8.1 KiB
<?xml version="1.0" ?>
|
|
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
|
|
"dtd/kdex.dtd" [
|
|
<!ENTITY kappname "&kuser;">
|
|
<!ENTITY % addindex "IGNORE">
|
|
<!ENTITY % English "INCLUDE" > <!-- change language only here -->
|
|
]>
|
|
|
|
<book lang="&language;">
|
|
|
|
<bookinfo>
|
|
<title>The &kuser; Handbook</title>
|
|
<authorgroup>
|
|
<author>
|
|
<firstname>Matt</firstname>
|
|
<surname>Johnston</surname>
|
|
<affiliation>
|
|
<address><email>mattj@flashmail.com</email></address>
|
|
</affiliation>
|
|
</author>
|
|
|
|
<othercredit role="reviewer">
|
|
<firstname>Lauri</firstname>
|
|
<surname>Watts</surname>
|
|
<affiliation>
|
|
<address><email>lauri@kde.org</email></address>
|
|
</affiliation>
|
|
<contrib>Reviewer</contrib>
|
|
</othercredit>
|
|
<othercredit role="reviewer">
|
|
<firstname>Jonathan</firstname>
|
|
<surname>Singer</surname>
|
|
<affiliation>
|
|
<address><email>jsinger@leeta.net</email></address>
|
|
</affiliation>
|
|
<contrib>Reviewer</contrib>
|
|
</othercredit>
|
|
<!-- TRANS:ROLES_OF_TRANSLATORS -->
|
|
</authorgroup>
|
|
|
|
<copyright>
|
|
<year>2000</year>
|
|
<holder>Matt Johnston</holder>
|
|
</copyright>
|
|
<legalnotice>&FDLNotice;</legalnotice>
|
|
|
|
|
|
<date>2002-10-08</date>
|
|
<releaseinfo>1.0</releaseinfo>
|
|
|
|
<abstract><para>This documentation describes &kuser; version 1.0. This
|
|
program allows you to manage users and groups on your system.</para>
|
|
</abstract>
|
|
|
|
<keywordset>
|
|
<keyword>kuser</keyword>
|
|
<keyword>user</keyword>
|
|
<keyword>management</keyword>
|
|
<keyword>admin</keyword>
|
|
<keyword>tools</keyword>
|
|
<keyword>group</keyword>
|
|
<keyword>password</keyword>
|
|
</keywordset>
|
|
</bookinfo>
|
|
|
|
<chapter id="start">
|
|
<title>Getting Started</title>
|
|
|
|
<para>This is a short introduction to &kuser;. For more detailed
|
|
information, see <link linkend="using">Usage</link>.</para>
|
|
|
|
<para>Actually, you do not need to do anything to begin using &kuser;
|
|
except <link linkend="customizing">configuration</link>.</para>
|
|
|
|
<para>When you have made the changes you want, you must
|
|
<guimenuitem>Save</guimenuitem> them for them to take effect. Either
|
|
choose the Toolbar icon, or use the <guimenu>File</guimenu> menu.</para>
|
|
|
|
</chapter>
|
|
|
|
<chapter id="using">
|
|
<title>Usage</title>
|
|
|
|
<sect1 id="sec1mainwindow">
|
|
<title>Main Window</title>
|
|
|
|
<para>&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 double click on it. The user or group properties dialog
|
|
will appear.</para>
|
|
<screenshot>
|
|
<screeninfo>&kuser; Main Window</screeninfo>
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="kuser.png" format="PNG"/>
|
|
</imageobject>
|
|
<textobject>
|
|
<phrase>&kuser; Main Window</phrase>
|
|
</textobject>
|
|
</mediaobject>
|
|
</screenshot>
|
|
|
|
</sect1>
|
|
|
|
<sect1 id="user-properties">
|
|
<title>User Properties Dialog</title>
|
|
|
|
<para>The user properties dialog has various tabs.</para>
|
|
|
|
<para>The number of tabs depends on the type of the user storage system
|
|
and whether quotas are being used. Additional tabs will appear if you
|
|
have shadow passwords, or any other similar things such as
|
|
<filename>/etc/master.passwd</filename> in BSD flavor Unices.</para>
|
|
|
|
<sect2 id="user-info">
|
|
<title><guilabel>User Info</guilabel> Tab</title>
|
|
|
|
<para>In the <guilabel>User Info</guilabel> tab you can modify:
|
|
</para>
|
|
|
|
<itemizedlist>
|
|
<listitem><para><guilabel>User Id</guilabel></para></listitem>
|
|
<listitem><para><guilabel>Full Name</guilabel></para></listitem>
|
|
<listitem><para><guilabel>Login Shell</guilabel> (the list of login shells is
|
|
taken from the <filename>/etc/shells</filename> file)</para></listitem>
|
|
<listitem><para><guilabel>Home Folder</guilabel></para></listitem>
|
|
<listitem><para><guilabel>Two office locations</guilabel></para></listitem>
|
|
<listitem><para><guilabel>Address</guilabel></para></listitem>
|
|
<listitem><para><guilabel>Password</guilabel></para></listitem>
|
|
</itemizedlist>
|
|
|
|
</sect2>
|
|
|
|
<sect2 id="password-management-info">
|
|
<title><guilabel>Password Management</guilabel> Tab</title>
|
|
|
|
<para>The <guilabel>Password Management</guilabel> tab will appear if you have
|
|
shadow passwords, or any other similar things such as
|
|
<filename>/etc/master.passwd</filename> in <acronym>BSD</acronym> flavor
|
|
Unices.</para>
|
|
|
|
<para>In the <guilabel>Extended Info</guilabel> tab you can modify
|
|
parameters related to extended account control: </para>
|
|
|
|
<itemizedlist>
|
|
<listitem><para>Minimum number of days between password
|
|
changes</para></listitem>
|
|
<listitem><para>Number of days after which a password expires if it hasn't been
|
|
changed</para></listitem>
|
|
<listitem><para>Number of days before expiration the user will be
|
|
warned</para></listitem>
|
|
<listitem><para>Whether and when an account will be disabled if the password
|
|
expires</para></listitem>
|
|
<listitem><para>A set date when the account expires</para></listitem>
|
|
<listitem><para><guilabel>Class</guilabel> (on <acronym>BSD</acronym>
|
|
systems)</para></listitem>
|
|
</itemizedlist>
|
|
<para>The date of the last password change is displayed near the top of the
|
|
dialog.</para>
|
|
|
|
|
|
</sect2>
|
|
|
|
<sect2 id="quota">
|
|
<title><guilabel>Quota</guilabel> Tab</title>
|
|
|
|
<para>You will probably see the <guilabel>Quota</guilabel> tab only if you
|
|
have at least one mounted volume with quota enabled and a quota file
|
|
present. There you may modify all quota related parameters: </para>
|
|
|
|
<itemizedlist>
|
|
<listitem><para><guilabel>File Soft Quota</guilabel></para></listitem>
|
|
<listitem><para><guilabel>File Hard Quota</guilabel></para></listitem>
|
|
<listitem><para><guilabel>File Time Limit (Grace
|
|
Period)</guilabel></para></listitem>
|
|
<listitem><para><guilabel>iNode Soft Quota</guilabel></para></listitem>
|
|
<listitem><para><guilabel>iNode Hard Quota</guilabel></para></listitem>
|
|
<listitem><para><guilabel>iNode Time Limit (Grace
|
|
Period)</guilabel></para></listitem>
|
|
</itemizedlist>
|
|
|
|
<para> All these parameters can be changed for each filesystem that has user
|
|
quota enabled. Filesystems can be changed using the <guilabel>Quota
|
|
Filesystem</guilabel> box.</para>
|
|
|
|
</sect2>
|
|
|
|
<sect2 id="group">
|
|
<title><guilabel>Groups</guilabel> Tab</title>
|
|
|
|
<para>The <guilabel>Groups</guilabel> tab contains all the information about the
|
|
selected user's participation in groups. The primary group to which the user
|
|
belongs
|
|
is set in the <guilabel>Primary Group</guilabel> box. The user can be assigned
|
|
to additional groups by checking them in the large box.</para>
|
|
|
|
</sect2>
|
|
</sect1>
|
|
|
|
<sect1 id="group-properties">
|
|
<title><guilabel>Group Properties</guilabel></title>
|
|
|
|
<para>The <guilabel>Group Properties</guilabel> dialog contains a list of all
|
|
users. Check
|
|
the boxes for each user to be assigned to the selected group.</para>
|
|
|
|
</sect1>
|
|
|
|
<sect1 id="add-user">
|
|
<title>Adding, Editing and Deleting Users or Groups</title>
|
|
|
|
<para>To add a user or group to the system, either choose
|
|
<guimenuitem>Add</guimenuitem> from the <guimenu>User</guimenu> or
|
|
<guimenu>Group</guimenu> menu, or click the relevant <guiicon>Add</guiicon>
|
|
button on
|
|
the toolbar. The selected user or group can also be edited or deleted in the
|
|
same way.</para>
|
|
</sect1>
|
|
</chapter>
|
|
|
|
<chapter id="customizing">
|
|
<title>Customizing &kuser;</title>
|
|
|
|
<sect1 id="defaults">
|
|
<title>Edit user creation defaults</title>
|
|
|
|
<para>To edit the user creation defaults you can use the <guilabel>Edit
|
|
defaults</guilabel> dialog, which is accessible via the menu
|
|
<menuchoice><guimenu>Settings</guimenu>
|
|
<guimenuitem>Configure &kuser;</guimenuitem></menuchoice>. 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 <quote>create</quote> or not,and to copy a
|
|
skeleton (standard configuration files) to the home folder or not. You can
|
|
also enable
|
|
<guilabel>User Private Group</guilabel> mechanism, which creates a new
|
|
personal group with the creation of a new user, and removes the personal
|
|
group when the user is removed.</para>
|
|
<para>The skeleton files for new users can be specified in the <guilabel>Sources
|
|
</guilabel> tab.</para>
|
|
|
|
</sect1>
|
|
</chapter>
|
|
|
|
<chapter id="credits">
|
|
<title>Credits and License</title>
|
|
|
|
<para>&kuser;</para>
|
|
|
|
<para>Program copyright 1997-2000 Denis Pershin
|
|
<email>dyp@inetlab.com</email></para>
|
|
|
|
<para>Documentation copyright 1997-2000 Denis Pershin
|
|
<email>dyp@inetlab.com</email></para>
|
|
<para>Documentation copyright 2000 Matt Johnston
|
|
<email>mattj@flashmail.com</email></para>
|
|
<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
|
|
|
|
&underFDL;
|
|
&underGPL;
|
|
|
|
</chapter>
|
|
&documentation.index;
|
|
|
|
</book>
|