<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<TITLE>KDE Display Manager (KDM): Configuring kdm</TITLE>
<META HTTP-EQUIV="content-type" CONTENT="text/html; charset=iso-8859-1">
<META NAME="keywords" CONTENT="KDM installation introduction">
<META NAME="description" CONTENT="KDM">
</HEAD>
<BODY BGCOLOR="#ffffff" LINK="#aa0000" TEXT="#000000" > 
<FONT FACE="Helvetica">
<A HREF="http://www.kde.org/"><IMG SRC="logotp3.gif" BORDER="0" ALT="The K Desktop Environment"></A>
<HR WIDTH="100%" SIZE=2 ALIGN="CENTER" NOSHADE>

 
<P ALIGN="RIGHT">

<A HREF="index-4.html">Next</A>
<A HREF="index-2.html">Previous</A>
<A HREF="index.html#toc3">Table of Contents</A>
</P>
<H3><A NAME="s3">3. Configuring kdm</A></H3>

<P>There is a graphical tool for configuring kdm. You will find it under
the menu K/Settings/Applications/. With this tool you can configure the
kdm specific options (stored in kdmrc), but kdm still has to be set up 
properly just like xdm, so please read on.
<P>The kdm-specific option are configured by editing the file
"$KDEDIR/share/config/kdmrc". There are three sections in kdmrc:
<P>
<H3><A NAME="ss3.1">3.1 KDM</A>
</H3>

<P>The keys in this section are
<BLOCKQUOTE><CODE>
<PRE>
StdFont
FailFont
GreetFont
GreetString
SessionTypes
LogoPixmap
ShutdownButton
Shutdown
Restart
UserView
Users
NoUsers
SortUsers
GUIStyle
</PRE>
</CODE></BLOCKQUOTE>
<P>A short description of the keys:
<DL>
<DT><B>*Font</B><DD><P>is a fontsstring formatted like this: Courier,12,5,iso-8859-1,50,0.
<P>
<DT><B>GreetString</B><DD><P>is the title of the kdm login window.
<P>
<DT><B>SessionTypes</B><DD><P>is a ``;'' separated list of session arguments. It
defaults to <CODE>SessionTypes=kde;failsafe</CODE>. Above example uses additionally
the fvwm2 and fvwm95 windowmanagers.
<P>
<DT><B>LogoPixmap</B><DD><P>Change this, if you dont like the logo.
<P>
<DT><B>ShutdownButton, Shutdown and Restart</B><DD><P>ShutdownButton controls when
the shutdown button is displayed and can be one of <CODE>All</CODE>, <CODE>None</CODE>,
<CODE>RootOnly</CODE> and <CODE>ConsoleOnly</CODE>. Shutdown and Restart are the
commands to run on shutdown/restart. They default to <CODE>/sbin/halt</CODE>
and <CODE>/sbin/reboot</CODE>. The meaning of All and None is very clear, if you
choose ConsoleOnly you can't do a remote shutdown.
<P>
<DT><B>UserView</B><DD><P>If this is set to ``1'', a graphical view of users will
be displayed in the kdm window.
<P>
<DT><B>Users</B><DD><P>is a ``;'' separated list of usernames that will be
displayed in the graphical user view. If <CODE>UserView</CODE> is 1 and the
<CODE>Users </CODE>entry is missing, kdm will look for users in the password
file. The users displayed are those who have a real name beside their
loginname, a home directory and a default shell - the rest is
skipped. Kdm will look in $KDEDIR/share/apps/kdm/pics/users/
for an icon for each user. If there exists an icon named johndoe.xpm, kdm
will use that for displaying user johndoe, if not kdm will use default.xpm.
So if you have a little picture of every user on your system, just place
them in $KDEDIR/share/apps/kdm/pics/users/ and have great fun
logging in with kdm ;-) 
<B>NOTE:</B> Kdm is able to handle icons with different sizes, but it might
not be too pretty to use both very small and very large icons.
<P>
<DT><B>NoUsers</B><DD><P>is a ``;'' separated list of usernames that won't be
displayed. Use it to filter ``pseudo-users'' like <CODE>sync</CODE> and
<CODE>shutdown</CODE> from the user view.
<P>
<DT><B>SortUsers</B><DD><P>If set to ``0'', the list of users are displayed in the
order it was read. The default is to display users in sorted order.
<P>
<DT><B>GUIStyle</B><DD><P>can be either <CODE>Motif</CODE> or <CODE>Windows</CODE>.
</DL>
<P>
<H3><A NAME="ss3.2">3.2 KDMDESKTOP</A>
</H3>

<P>This section controls the background. The keys are:
<BLOCKQUOTE><CODE>
<PRE>
 BackgroundPicture BackgroundColor1 BackgroundColor2 BackgroundPictureMode 
</PRE>
</CODE></BLOCKQUOTE>
<P>A short description of the keys: 
<DL>
<DT><B>BackgroundPicture</B><DD><P>is the path to an image. 
<P>
<DT><B>BackgroundColor[1|2]</B><DD><P>are named colors for solid and blended background. 
<P>
<DT><B>BackgroundPictureMode</B><DD><P>can contain one of the following options:
<P><CODE>None | Tile | Scale | Center | TopLeft | TopRight | BottomLeft | BottomRight | Fancy</CODE>
<P> Note that 
<CODE>Fancy</CODE> background looks nice, but is <B>very</B> slow.
</DL>
 
<P>
<H3><A NAME="ss3.3">3.3 Locale</A>
</H3>

<P>This section should only contain one single entry.
<P>
<DL>
<DT><B>Language</B><DD><P>is indicating the language to use for kdm. It can be changed
independently from KDE. The values are the same as usual en/de/fr/da etc.
</DL>
<P>
<P ALIGN="RIGHT">

<A HREF="index-4.html">Next</A>
<A HREF="index-2.html">Previous</A>
<A HREF="index.html#toc3">Table of Contents</A>
</P>
<CENTER>
<HR WIDTH="100%" SIZE=3 ALIGN=CENTER NOSHADE>
</CENTER>    
</FONT>

 
</BODY>
</HTML>
