<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
 <!ENTITY kdm "<application>kdm</application>">
 <!ENTITY % addindex "IGNORE">
 <![ %addindex; [ <!ENTITY docindex SYSTEM "docindex.docbook"> ]]>
]>
<book lang="fi">
<bookinfo>
<title>KDE Display Manager (KDM)</title>
<authorgroup>
<author>
<firstname>Steffen</firstname>
<surname>Hansen</surname>
<affiliation>
<address><email><ulink url="mailto:stefh@dit.ou.dk">stefh@dit.ou.dk</ulink></email></address>
</affiliation>
</author>
</authorgroup>
<date>Version 0.5-1, 9 July 1998 </date>
<releaseinfo><!-- information about this particular version --></releaseinfo>
<abstract>
<para>Tämä dokumentti käsittelee KDE:n graafista sisäänkirjautumisohjelmaa (Display Manager)</para>
<para>KDE</para><!-- Merge this with the previous paragraph; it comes from <META NAME="description" CONTENT="..."> --></abstract>
<keywordset>
<keyword>KDE</keyword>
</keywordset>
</bookinfo>

<chapter id="esittely">
<title>Esittely</title>

<para>KDE Display Manager on xdm:n täysin korvaava ohjelma. Pientä apuohjelmaa, kdmdesktop:ia käytetään taustakuvien näyttöön. Kdm on parempi kuin xdm seuraavilla tavoilla:
<itemizedlist>
<listitem>
<para>Kdm tukee istunnon argumentteja käyttäjäystävällisesti (xdm ei kerro käyttäjälle, mitä argumentteja se aikoo käyttää).</para>
</listitem>
<listitem>
<para>Kdm:ssä on valinnainen ``sammuta''-painonappi (kuten NT:n login-ruudussa).</para>
</listitem>
<listitem>
<para>Kdm:ssä  on valinnainen graafinen näkymä järjestelmän käyttäjistä (idea lainattu IRIX:n login-ruudusta).</para>
</listitem>
<listitem>
<para>Kdm näyttää paremmalta kuin xdm ;-)</para>
</listitem>
<listitem>
<para>Kdm voidaan konfiguroida graafisen käyttöliittymän kautta (osana KDE:n ohjauskeskusta)</para>
</listitem>
</itemizedlist>
</para>
</chapter>

<chapter id="kdmn-asennus-kdekynnistys-suoraan-graafiseen">
<title>Kdm:n asennus
KDE!käynnistys suoraan graafiseen tilaan <indexterm remap="idx"><primary>KDE!käynnistys suoraan graafiseen tilaan</primary></indexterm>
KDE!kdm:n asennus <indexterm remap="idx"><primary>KDE!kdm:n asennus</primary></indexterm></title>

<sect1 id="kdmn-asetusten-teko">
<title>Kdm:n asetusten teko</title>

<para>Lue README-tiedosto! Se kertoo miten kdm käännetään. Tavallisesti et kuitenkaan joudu kääntämään sitä itse, koska se on osa kdebase-pakettia ja on käännetty sen osana. Se asentuu
$KDEDIR/bin-hakemistoon.</para>

<para><emphasis remap="bf">HUOMAUTUS:</emphasis> <literal remap="tt">make install</literal> kirjoittaa vanhan <literal remap="tt">kdmrc</literal>:n päälle.</para>

<para>Asennuksen aikana asentuu uusi versio tiedostosta <literal remap="tt">Xsetup&lowbar;0</literal>. Erityistä siinä on rivi </para>

<para><screen>kdmdesktop
</screen>
</para>

<para>joka määrittää joitakin hienoja taustoja (kuvia ja taustavärejä). Tavallisesti löydät tämän tiedoston xdm:n asetushakemistosta 
<literal remap="tt">/etc/X11/xdm/XSetup&lowbar;0</literal> Red Hatissa ja 
<literal remap="tt">/usr/X11R6/lib/X11/xdm/XSetup&lowbar;0</literal> S.u.S.E:ssa. Jos ympäristömuuttujasi KDEDIR ei ole  /opt/kde voit joutua muuttamaan polun kdmdesktop-ohjelman takia.</para>

<para>Jos valitsit PAM:n (oletuksena Red Hat 5.0:ssa ja 5.1:ssä), sinun pitäisi tarkistaa tiedostosta  /etc/pam.conf rivit
<screen># xdm authorization
xdm    auth       required     pam_unix_auth.so
xdm    auth       required     pam_unix_acct.so
</screen>

ja lisätä ne tarvittaessa.</para>

<para>Nyt on aika testata kdm. Sinun pitää siirtyä ajotasolle, jossa xdm ei käynnisty. Tee se muokkaamalla tiedostoa <literal remap="tt">/etc/inittab</literal>, josta etsit seuraavan kaltaisia rivejä:
<screen># default runlevel
id:3:initdefault:
</screen>

Arvo id: jäljessä on oletusajotason numero, jonka merkitys vaihtelee levitysversiosta toiseen, mutta on yleensä hyvin dokumentoitu. Graafisen sisäänkirjautumisen (xdm) ajotasot ovat yleisimmissä levitysversioissa:
<itemizedlist>
<listitem>
<para>5  Red Hat 3.x, 4.x ja 5.x, LST</para>
</listitem>
<listitem>
<para>4  Slackware</para>
</listitem>
<listitem>
<para>3  S.u.S.E. 4.x ja 5.x</para>
</listitem>
</itemizedlist>
</para>

<para>Tämän jälkeen voit kokeilla kdm:n käynnistämistä seuraavalla komennolla komentotulkissa:
<screen>&gt; kdm -nodaemon
</screen>

Jos näytölle ilmaantuu kdm:n sisäänkirjautumisruutu ja pystyt kirjautumaan sisään, kaikki on kunnossa. Yleisin virhetilanne on, että jaettuja Qt:n tai KDE:n kirjastoja ei löydy. Tämä estää myös normaalin KDE:n käynnistymisen, joten ongelman ratkaisu selviää tutkimalla KDE:n asennuksen ohjeita. Kun kaikki toimii, voit korvata xdm:n kdm:llä. Tämä on jälleen levitysversiokohtaista.
<itemizedlist>
<listitem>
<para>Red Hatissa muokkaat tiedostoa <literal remap="tt">/etc/inittab</literal>, etsit merkkijonoa xdm ja korvaat sen kdm:llä (muuta myös polku oikeaksi). </para>
</listitem>
<listitem>
<para>S.u.S.E:ssa muokkaat tiedostoa <literal remap="tt">/sbin/init.d/xdm</literal> ja lisäät siihen:
<screen>. /etc/rc.config
DISPLAYMANAGER=kdm
export DISPLAYMANAGER
</screen>
</para>
</listitem>
<listitem>
<para>Muissa levitysversiossa muutos tehdään yleensä samoin kuin Red Hatissa.</para>
</listitem>
</itemizedlist>

Kaikissa levitysversiossa, jotka tunnen, pitää vaihtaa oletusajotaso /etc/inittab-tiedostossa (5 Red Hatissa, 3 S.u.S.E:ssa ylläolevan taulukon mukaan tai kuten inittab-tiedostossa itsessään on dokumentoitu). Jos sinulla on valmiiksi käännetyt KDE:n kirjastot, varmista, että kdm on asennettu hakemistoon, johon kirjastot uskovan sen olevan asennetun. Tavallisesti hakemisto on /opt/kde/bin. Jos et halua muokata inittab-tiedostoa voit muuttaa xdm:n nimeksi xdm.bak ja tehdä dxm:stä symboolisen linkin kdm:ään. Kdm lukee yleiset näytön hallinnan (display manager) asetukset xdm:n konfigurointitiedostoista ja kdm:lle ominaiset asetukset tiedostosta &dollar;KDEDIR/share/config/kdmrc. Kdmdesktop lukee myös tiedoston kdmrc.</para>
</sect1>

<sect1 id="useiden-ikkunamanagerien-kytt-kdmn-kanssa-ch">
<title>Useiden ikkunamanagerien käyttö kdm:n kanssa (chooser)
ikkunamanagerin valinta <indexterm remap="idx"><primary>ikkunamanagerin valinta</primary></indexterm></title>

<para>Jos sinun on käytettävä erilaisia ikkunamanagereja tai vain haluat kokeilla niitä, voit käyttää kdm:ään rakennettua valitsijaa. Valitsijan avulla voit valita ikkunamanagerin määritellystä listasta. Tämä vaatii jälleen joitakin muutoksia konfigurointitiedostoihin. Ensin joudut muokkaamaan <literal remap="tt">Xsession</literal>-tiedostoa (polku on <literal remap="tt">/etc/X11/xdm/</literal> Red Hatissa ja <literal remap="tt">/usr/X11R6/lib/X11/xdm/</literal> S.u.S.E:ssa), jossa määritellään välitettävät parametrit. Etsi rivejä <literal remap="tt">'exec $startup'</literal> ja muuta se <literal remap="tt">'exec &dollar;startup " &dollar;@"'</literal> (ilman '-merkkiä). Tämän jälkeen joudut muokkaamaan tai luomaan /etc/xinitrc tai  /.xinitrc-tiedostoa käsittelemään eri ikkunamanagerien käynnistämiset. Seuraavassa esimerkissä on on kolmen ikkunamanagerin käynnistys. Voit lisätä niitä mallin mukaan. Muista myös kopioida <literal remap="tt">.xinitrc</literal>-tiedosto hakemistoon <literal remap="tt">/etc/skel</literal>, jotta se kopioituisi jatkossa automaattisesti uusia käyttäjiä luotaessa.
<screen>#!/bin/bash
#
# .xsession/.xinitrc
#
# Valitse ikkunamanageri
#

defaultwm=kde
#set the window manager to $1 if it was supplied
windowmgr=${1:-$defaultwm}

#start the respective window managers
case ${windowmgr} in
  kde|kwm|kdestart)
	WINDOWMANAGER=startkde
	;;
  fvwm|fvwm2)
	WINDOWMANAGER=fvwm2
	;;

  fvwm95)
	WINDOWMANAGER=fvwm95
	;;

  *)    WINDOWMANAGER=windowmgr   # default for unknown wm's

esac

#
# ladataan resurssit
#

if [ -f /usr/X11R6/lib/X11/Xmodmap ]; then
    xmodmap /usr/X11R6/lib/X11/Xmodmap
fi

if [ -f ~/.Xmodmap ]; then
    xmodmap ~/.Xmodmap
fi

if [ -f ~/.Xdefaults ]; then
    xrdb -merge ~/.Xdefaults
fi

if [ -f ~/.Xresources ]; then
    xrdb -merge ~/.Xresources
fi
# 
# käynnistetään lopuksi ikkunamanageri
#
exec $WINDOWMANAGER

</screen>
</para>
</sect1>
</chapter>

<chapter id="kdmn-konfigurointi">
<title>Kdm:n konfigurointi</title>

<para>Kdm voidaa konfiguroida graafisella apuohjelmalla. Löydät sen KDE:n paneelista reittiä <emphasis>sovellusten käynnistäjä &gt; Asetukset &gt; Sovellukset</emphasis>. Tämän ohjelman avulla voit konfiguroida kdm:lle ominaiset asetukset (tiedostossa kdmrc), mutta kdm pitää silti asentaa kunnolla, kuten xdm, joten jatka lukemista.</para>

<para>Kdm:lle ominaiset asetukset konfiguroidaan muokkaamalla tiedostoa "&dollar;KDEDIR/share/config/kdmrc". Siinä on kolme sektiota:
KDE!kdmrc <indexterm remap="idx"><primary>KDE!kdmrc</primary></indexterm>
KDE!kdm:n konfigurointitiedosto <indexterm remap="idx"><primary>KDE!kdm:n konfigurointitiedosto</primary></indexterm></para>

<sect1 id="kdm">
<title>KDM</title>

<para>Avaimet tässä sektiossa ovat
<screen>StdFont
FailFont
GreetFont
GreetString
SessionTypes
LogoPixmap
ShutdownButton
Shutdown
Restart
UserView
Users
NoUsers
SortUsers
GUIStyle
</screen>
</para>

<para>Lyhyt kuvaus avainten merkityksestä:
<variablelist>
<varlistentry>
<term>*Font</term>
<listitem>
<para>kirjasimen nimi tyyliin: Courier,12,5,iso-8859-1,50,0.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>GreetString</term>
<listitem>
<para>on otsikko sisäänkirjautumisruudussa.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>SessionTypes</term>
<listitem>
<para>on ``;''-merkeillä eroteltu lista session parametreistä. Oletus on <literal remap="tt">SessionTypes=kde;failsafe</literal>. Yllä oleva esimerkki käyttää lisäksi fvwm2 ja fvwm95 ikkunamanagereita.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>LogoPixmap</term>
<listitem>
<para>Muuta tämä, jos et pidä alkuperäisestä logosta.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ShutdownButton, Shutdown ja Restart</term>
<listitem>
<para>ShutdownButton määrittelee milloin Sammuta-painike (shutdown) näytetään ja voi olla joko <literal remap="tt">All</literal>, <literal remap="tt">None</literal>, <literal remap="tt">RootOnly</literal> tai <literal remap="tt">ConsoleOnly</literal>. Shutdown ja Restart ovat komentoja, jotka suoritetaan sammuttaessa ja uudelleenkäynnistyksessä. Niiden oletukset ovat <literal remap="tt">/sbin/halt</literal> ja  <literal remap="tt">/sbin/reboot</literal>. Arvojen All (kaikki) ja None (ei kukaan) on selvä ja ConsoleOnly tarkoittaa, että et voi sammuttaa verkkoyhteyden kautta.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>UserView</term>
<listitem>
<para>Jos tämä arvona on ``1'', graafinen näkymä käyttäjistä näytetään kdm:n ikkunassa.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Users</term>
<listitem>
<para>on ``;''-merkeillä eroteltu lista käyttäjätunnuksista, jotka näytetään grrafisessa käyttäjien näkymässä. Jos <literal remap="tt">UserView</literal> on 1 ja <literal remap="tt">Users</literal>-määrittely puuttuu, kdm etsii käyttäjiä /etc/passwd-tiedostosta. Listassa näkyvät käyttäjät, joilla on myös oikea nimi, kotihakemisto ja oletuskomentotulkki, muita ei näytetä. Kdm etsii hakemistosta &dollar;KDEDIR/share/apps/kdm/pics/users/ käyttäjille kuvakkeita. Jos sieltä löytyy tiedosto johndoe.xpm, kdm käyttää sitä käyttäjän johndoe kuvakkeena, jos ei löydy, käytetään tiedostoa default.xpm. Joten, jos sinulla on pienet (valo)kuvat käyttäjistä, laita ne hakemistoon &dollar;KDEDIR/share/apps/kdm/pics/users/ ja sisäänkirjautuminen on hauskempaa ;-) 
<emphasis remap="bf">HUOMAUTUS:</emphasis> Kdm pystyy käsittelemään eri kokoisia kuvaketiedostoja, mutta sekä hyvin suurien ja hyvin pienien käyttö ei ehkä näytä kovin hyvältä.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>NoUsers</term>
<listitem>
<para>on ``;''-mekeillä eroteltu lista käyttäjänimistä, joita ei näytetä. Käytä sitä poistamaan erikoiskäyttäjiä, kuten <literal remap="tt">sync</literal> ja <literal remap="tt">shutdown</literal> käyttäjien listasta.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>SortUsers</term>
<listitem>
<para>Jos arvona on ``0'', käyttäjälista näytetään siinä järjestyksessä kuin se luettiin. Oletus on näyttää käyttäjät aakkosjärjestyksessä.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>GUIStyle</term>
<listitem>
<para>voi olla joko <literal remap="tt">Motif</literal> tai <literal remap="tt">Windows</literal>.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="kdmdesktop">
<title>KDMDESKTOP</title>

<para>Tämä sektio määrittelee taustan. Avaimet ovat:
<screen>BackgroundPicture
BackgroundColor
BackgroundPictureTile
BackgroundPictureCenter
FancyBackground
</screen>
</para>

<para>Ensimmäinen on polku kuvatiedostoon, toinen nimetty väri ja loput ovat boolean arvoja (<literal remap="tt">0</literal> tai <literal remap="tt">1</literal>). Huomaa, että <literal remap="tt">FancyBackground=1</literal> näyttää hyvältä, mutta on <emphasis remap="bf">hyvin</emphasis> hidas.</para>
</sect1>

<sect1 id="locale">
<title>Locale</title>

<para>Tässä sektiossa pitäisi olla vain yksi kohta.</para>

<para><variablelist>
<varlistentry>
<term>Language</term>
<listitem>
<para>Määrittelee kdm:n käyttämän kielen. Se voidaan muuttaa KDE:stä riippumatta. Arvot ovat tavanomaiset en/de/fr/da/fi jne.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
</chapter>

<chapter id="lakiasiaa">
<title>Lakiasiaa</title>

<para>Kdm on kehitetty xdm:stä, joten mikä on copyright? Kdm 0.1:n teki Matthias Ettrich. Kaikki myöhemmät versiot Steffen Hansen <literal remap="tt"><ulink url="mailto:stefh@dit.ou.dk">stefh@dit.ou.dk</ulink></literal></para>

<para>Kdm on vapaa ohjelma. En tiedä tarkalleen mikä lisenssi on, koska mukana on paljon xdm:n koodia. </para>

<para>Kdm tarvitsee Qt-kirjastoa, jonka copyright on Troll Tech AS:n. Vapaasti levitettävät ohjelmat voivat yleensä käyttää Qt:tä ilmaiseksi, tiedostossa README.QT on yksityiskohdat. Kuka tahansa voi muuttaa kdm:ää ja levittää muutettua versiota, kunhan minun (Steffan Hansen?) nimeni mainitaan.</para>

<para>Kdm ei sisällä mitään takuuta soveltuvuudesta mihinkään tai toimivuudesta.</para>

<para>Dokumentointia täydensi Gregor Zumstein<literal remap="tt"><ulink url="mailto:zumstein@ssd.ethz.ch">zumstein@ssd.ethz.ch</ulink></literal>. Viimeinen muutos tehtiin 9. heinäkuuta 1998.</para>

<para>Suomennos Raimo Koski.</para>
</chapter>
<![ %addindex; [ &docindex; ]]>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
sgml-general-insert-case: lower
End:
-->
