1 .\" live-config(7) - System Configuration Scripts
2 .\" Copyright (C) 2006-2010 Daniel Baumann <daniel@debian.org>
4 .\" live-config comes with ABSOLUTELY NO WARRANTY; for details see COPYING.
5 .\" This is free software, and you are welcome to redistribute it
6 .\" under certain conditions; see COPYING for details.
9 .\"*******************************************************************
11 .\" This file was generated with po4a. Translate the source file.
13 .\"*******************************************************************
14 .TH LIVE\-CONFIG 7 07.06.2010 2.0~a5 "Debian Live Projekt"
17 \fBlive\-config\fP \- System Konfiguration Skripte
20 \fBlive\-config\fP enthält die Skripte welche ein Debian Live System während des
21 Startvorganges (late userspace) konfigurieren.
24 \fBlive\-config\fP kann durch Boot Parameter oder Konfigurationsdateien
25 konfiguriert werden. Werden beide Mechanismen für eine bestimmte Option
26 benutzt, so gehen die Boot Parameter den Konfigurationsdateien vor. Wird
27 Persistenz benutzt, so werden die \fBlive\-config\fP Skripte nur einmal
30 .SS "Boot Parameter (Skripte)"
31 \fBlive\-config\fP ist nur aktiviert, wenn 'boot=live' als Boot Parameter
32 benutzt wird. Zusätzlich muss \fBlive\-config\fP durch den Parameter
33 \&'live\-config' angegeben werden, welche Skripte ausgeführt werden sollen,
34 oder mit dem Parameter 'live\-noconfig', welche Skripte nicht ausgeführt
35 werden sollen. Werden beide beide Parameter oder mehrmals benützt, so geht
36 der in der Reihenfolge lezte allen vorhergehenden vor.
38 .IP \fBlive\-config\fP 4
39 Alle Skripte werden ausgeführt. Auf Debian Live Images ist dies das
41 .IP "\fBlive\-config\fP=\fISKRIPT1\fP,\fISKRIPT2\fP, ... \fISKRIPTn\fP" 4
42 Nur angegebene Skripte werden ausgeführt. Die Reihenfolge ist wesentlich,
43 d.h. 'live\-config=sudo,user\-setup' würde nicht funktionieren da der Benutzer
44 zuerst angelegt werden muss bevor für ihn sudo konfiguriert werden
45 kann. Siehe Dateinamen der Skripte in /lib/live/config für ihre
47 .IP \fBlive\-noconfig\fP 4
48 Kein Skript wird ausgeführt. Dies ist das Gleiche, wie wenn weder
49 \&'live\-config' noch 'live\-noconfig' verwendet wird.
50 .IP "\fBlive\-noconfig\fP=\fISKRIPT1\fP,\fISKRIPT2\fP, ... \fISKRIPTn\fP" 4
51 Alle Skripte werden ausgeführt, ausser die hier spezifizierten Ausnahmen.
53 .SS "Boot Parameter (Optionen)"
54 Manche einzelne Skripte können durch Boot Parameter in ihrem Verhalten
57 .IP \fBlive\-config.hostname\fP=\fIRECHNERNAME\fP 4
58 Ermöglicht den Rechnernamen des Systems zu wählen. Der Standardname ist
60 .IP \fBlive\-config.username\fP=\fIBENUTZERNAME\fP 4
61 Ermöglicht den Namen des Benutzers zu wählen, welcher für den automatischen
62 Login angelegt wird. Der Standardname ist 'user'.
63 .IP "\fBlive\-config.user\-fullname\fP=\(dq\fIVOLLER BENUTZERNAME\fP\(dq" 4
64 Ermöglicht den vollen Name für den Benutzer zu wählen, welcher für den
65 automatischen Login angelegt wird. Der Standard ist 'Debian Live user'.
66 .IP \fBlive\-config.locales\fP=\fIGEBIETSSCHEMA\fP 4
67 Ermöglicht das Gebietsschema des Systems zu wählen, zum Beispiel
68 \&'de_CH.UTF\-8'. Der Standard ist 'en_US.UTF\-8'. Falls das gewünschte
69 Gebietsschema nicht schon auf dem System verfügbar ist, wird es automatisch
71 .IP \fBlive\-config.timezone\fP=\fIZEITZONE\fP 4
72 Ermöglicht die Zeitzone des Systems einzustellen, zum Beispiel
73 \&'Europe/Zurich'. Der Standard ist 'UTC'.
74 .IP \fBlive\-config.utc\fP=\fByes\fP|no 4
75 Ermöglicht zu bestimmen, ob das System davon ausgehen soll, dass die
76 Hardwareuhr auf UTC gestellt ist oder nicht. Der Standard ist 'yes'.
77 .IP \fBlive\-config.keyboard\-model\fP=\fITASTATUR_MODELL\fP 4
78 Ermöglicht das Tastatur Modell zu bestimmen. Es ist kein Standardwert
80 .IP \fBlive\-config.keyboard\-layout\fP=\fITASTATUR_LAYOUT\fP 4
81 Ermöglicht das Tastatur Layout zu bestimmen. Es ist kein Standardwert
83 .IP \fBlive\-config.keyboard\-variant\fP=\fITASTATUR_VARIANTE\fP 4
84 Ermöglicht die Tastatur Variante zu bestimmen. Es ist kein Standardwert
86 .IP \fBlive\-config.keyboard\-options\fP=\fITASTATUR_OPTIONEN\fP 4
87 Ermöglicht die Tastatur Optionen zu bestimmen. Es ist kein Standardwert
89 .IP "\fBlive\-config.hooks\fP=\fIURL1\fP|\fIURL2\fP| ...|\fIURLn\fP" 4
90 Ermöglicht eine oder mehrere beliebige Dateien herunterzuladen und
91 auszuführen. Die URLs müssen durch wget aufösbar sein und es müssen alle
92 Abhängigkeiten, die für das Ausführen der Dateien notwendig sind, bereits
93 installiert sein, zum Beispiel muss für ein Python Skript bereits Python auf
94 dem System installiert sein.
96 .SS "Boot Parameter (Abkürzungen)"
97 \fBlive\-config\fP stellt Abkürzungen für einige häufige verwendete
98 Anwendungsfälle wo sonst verschiedene einzelne Parameter kombiniert werden
99 müssten. Dies gewährleistet sowohl feine Kontrolle über alle Optionen, als
100 einfache Benutzbarkeit.
102 .IP \fBlive\-config.noroot\fP 4
103 Schaltet die sudo und policykit Skripte ab, ein Benutzer kann keine root
104 Privilegien auf dem System mehr erlangen.
105 .IP \fBlive\-config.nottyautologin\fP 4
106 Schaltet den automatischen Login via TTY ab, dies beeinflusst den
107 automatisch graphischen Login nicht.
108 .IP \fBlive\-config.noxautologin\fP 4
109 Schaltet den automatischen Login via Display Manager ab, dies beeinflusst
110 den automatischen tty Login nicht.
112 .SS Konfigurationsdateien
113 \fBlive\-config\fP kann durch Konfigurationsdateien konfiguriert (nicht aber
114 aktiviert) werden. Abgesehen von Abkürzungen können alle Optionen die durch
115 Boot Parameter konfiguriert werden, auch alternativ durch eine oder mehrere
116 Dateien konfiguriert werden. Wenn Konfigurationsdateien benützt werden, so
117 ist der 'boot=live' Parameter trotzdem noch notwendig um \fBlive\-config\fP zu
120 Die Konfigurationsdateien können entweder im Root Dateisystem selbst
121 plaziert werden (/etc/live/config.conf, /etc/live/config.conf.d/) oder auf
122 dem Live Medium (live/config.conf, live/config.conf.d/). Wenn beide Orte für
123 eine bestimmte Option verwendet werden, geht die Konfigurationsdatei auf dem
124 Live Medium dem der im Root Dateisystem enthaltenen vor.
126 Obwohl die Konfigurationsdateien welche in die conf.d Verzeichnisse abgelegt
127 werden können keinen bestimmten Namen oder Endung brauchen, ist es aus
128 Konsistenzgründen empfohlen, für diese 'vendor.conf' oder 'project.conf' als
129 Namensschema zu verwenden (wobei 'vendor' oder 'project' mit dem
130 eigentlichen Namen ersetzt wird, resultierend in einem Dateinamen wie
131 \&'debian\-eeepc.conf').
133 .IP "\fBLIVE_CONFIGS\fP=\fISKRIPT1\fP,\fISKRIPT2\fP, ... \fISKRIPTn\fP" 4
134 Diese Variable enspricht dem '\fBlive\-config\fP=\fISKRIPT1\fP,\fISKRIPT2\fP,
135 \&... \fISKRIPTn\fP' Parameter.
136 .IP "\fBLIVE_NOCONFIGS\fP=\fISKRIPT1\fP,\fISKRIPT2\fP, ... \fISKRIPTn\fP" 4
137 Diese Variable enspricht dem '\fBlive\-noconfig\fP=\fISKRIPT1\fP,\fISKRIPT2\fP,
138 \&... \fISKRIPTn\fP' Parameter.
139 .IP \fBLIVE_HOSTNAME\fP=\fIRECHNERNAME\fP 4
140 Diese Variable enspricht dem '\fBlive\-config.hostname\fP=\fIRECHNERNAME\fP'
142 .IP \fBLIVE_USERNAME\fP=\fIBENUTZERNAME\fP 4
143 Diese Variable enspricht dem '\fBlive\-config.username\fP=\fIBENUTZERNAME\fP'
145 .IP "\fBLIVE_USER_FULLNAME\fP=\(dq\fIVOLLER BENUTZERNAME\(dq\fP" 4
146 Diese Variable enspricht dem '\fBlive\-config.user\-fullname\fP="\fIVOLLER
147 BENUTZERNAME\fP"' Parameter.
148 .IP \fBLIVE_LOCALES\fP=\fIGEBIETSSCHEMA\fP 4
149 Diese Variable enspricht dem '\fBlive\-config.locales\fP=\fIGEBIETSSCHEMA\fP'
151 .IP \fBLIVE_TIMEZONE\fP=\fIZEITZONE\fP 4
152 Diese Variable enspricht dem '\fBlive\-config.timezone\fP=\fIZEITZONE\fP'
154 .IP \fBLIVE_UTC\fP=\fByes\fP|no 4
155 Diese Variable enspricht dem '\fBlive\-config.utc\fP=\fByes\fP|no' Parameter.
156 .IP \fBLIVE_KEYBOARD_MODEL\fP=\fIKEYBOARD_MODEL\fP 4
157 Diese Variable enspricht dem
158 \&'\fBlive\-config.keyboard\-model\fP=\fITASTATUR_MODELL\fP' Parameter.
159 .IP \fBLIVE_KEYBOARD_LAYOUT\fP=\fIKEYBOARD_LAYOUT\fP 4
160 Diese Variable enspricht dem
161 \&'\fBlive\-config.keyboard\-layout\fP=\fITASTATUR_LAYOUT\fP' Parameter.
162 .IP \fBLIVE_KEYBOARD_VARIANT\fP=\fIKEYBOARD_VARIANT\fP 4
163 Diese Variable enspricht dem
164 \&'\fBlive\-config.keyboard\-variant\fP=\fITASTATUR_VARIANTE\fP' Parameter.
165 .IP \fBLIVE_KEYBOARD_OPTIONS\fP=\fIKEYBOARD_OPTIONS\fP 4
166 Diese Variable enspricht dem
167 \&'\fBlive\-config.keyboard\-options\fP=\fITASTATUR_OPTIONEN\fP' Parameter.
168 .IP "\fBLIVE_HOOKS\fP=\fIURL1\fP|\fIURL2\fP| ... |\fIURLn\fP" 4
169 Diese Variable enspricht dem '\fBlive\-config.hooks\fP=\fIURL1\fP|\fIURL2\fP|
170 \&... |\fIURLn\fP' Parameter.
173 \fBlive\-config\fP kann sehr einfach angepasst werden für Downstream Projekte
174 oder lokale Verwendung.
176 .SS "Hinzufügen von neuen Konfigurationsskripten"
177 Downstream Projekte können ihre Skripte in /lib/live/config ablegen und
178 müssen nichts weiteres tun, die Skripte werden automatisch während des
181 Am Besten werden die Skripte in ein eigenes Debian Paket untergebracht. Ein
182 Beispielpaket und \-skript befindet sich in
183 /usr/share/doc/live\-config/examples.
185 .SS "Entfernen von neuen Konfigurationsskripten"
186 Es ist derzeit nicht möglich in einer vernünftigen Art und Weise Skripte zu
187 entfernen ohne das ein lokal verändertes \fBlive\-config\fP Paket verwendet
188 werden muss. Jedoch kann das selbe erreicht werden, indem bestimmte Skripte
189 durch den live\-noconfig Mechanismus abgeschaltet werden, siehe oben. Um zu
190 verhindern, dass die abzuschaltenden Skripte immer durch einen Boot
191 Parameter angegeben werden müssen, kann eine Konfigurationsdatei verwendet
194 Die Konfigurationsdateien für das Live System selber werden am Besten in
195 einem eigenen Debian Paket untergebracht. Ein Beispielpaket und
196 \-konfigurationsdatei befindet sich in /usr/share/doc/live\-config/examples.
199 \fBlive\-config\fP enthält derzeit folgende Skripte in /lib/live/config.
202 konfiguriert /etc/hostname und /etc/hosts.
203 .IP \fBuser\-setup\fP 4
204 fügt das Live Benutzerkonto hinzu.
206 räumt dem Live Benutzer sudo Privilegien ein.
208 konfiguriert locales.
210 konfiguriert /etc/timezone.
212 konfiguriert Autologin in gdm (lenny).
214 konfiguriert Autologin in gdm3 (squeeze und neuer).
216 konfiguriert Autologin in kdm.
218 konfiguriert Autologin in lxdm.
220 konfiguriert Autologin in nodm.
221 .IP "\fBconsole\-common\fP, console\-setup (lenny), \fBkeyboard\-configuration\fP (squeeze and newer)" 4
222 konfiguriert die Tastatur.
224 konfiguriert sysvinit.
227 .IP \fBgnome\-panel\-data\fP 4
228 entfernt den Sperrknopf für den Bildschirm.
229 .IP \fBgnome\-power\-manager\fP 4
230 verhindert Hibernation.
231 .IP \fBgnome\-screensaver\fP 4
232 schaltet das Sperren des Bildschirmes während der Bildschirmschoner läuft
234 .IP \fBinitramfs\-tools\fP 4
235 lässt update\-initramfs auch das Live Medium aktualisieren falls Persistency
238 schaltet den KDE Migration Wizard ab (squeeze und neuer).
239 .IP \fBkde\-services\fP 4
240 schaltet ein paar ungewollte KDE Services ab (squeeze und neuer).
241 .IP \fBkpersonalizer\fP 4
242 schaltet den KDE Configuration Wizard ab (lenny).
243 .IP \fBlive\-installer\-launcher\fP 4
244 fügt live\-installer\-launcher auf dem Benutzer Desktop hinzu.
245 .IP \fBmodule\-init\-tools\fP 4
246 lädt automatisch gewisse Module auf bestimmten Architekturen.
247 .IP \fBpolicykit\fP 4
248 räumt dem Benutzer Privilegien durch policykit ein.
250 erneuert SSL snake\-oil Zertifikate.
251 .IP \fBupdate\-notifier\fP 4
252 schaltet update\-notifier ab.
254 schaltet anacron aus.
255 .IP \fButil\-linux\fP 4
256 schaltet hwclock von util\-linux ab.
258 erlaubt beliebige Kommands von einem Skript auf dem Live Medium oder von
259 einem HTTP/FTP Server auszuführen.
262 .IP \fB/etc/live/config.conf\fP 4
263 .IP \fB/etc/live/config.conf.d/\fP 4
264 .IP \fBlive/config.conf\fP 4
265 .IP \fBlive/config.conf.d/\fP 4
266 .IP \fB/lib/live/config.sh\fP 4
267 .IP \fB/lib/live/config/\fP 4
268 .IP \fB/var/lib/live/config/\fP 4
273 \fIlive\-helper\fP(7)
276 Weitere Informationen über live\-config und das Debian Live Projekt können
277 auf der Homepage unter <\fIhttp://live.debian.net/\fP> und im Handbuch
278 unter <\fIhttp://live.debian.net/manual/\fP> gefunden werden.
281 Fehler können durch Einreichen eines Fehlerberichtes für das live\-config
282 Paket im Debian Bug Tracking System unter
283 <\fIhttp://bugs.debian.org/\fP> oder durch Senden einer E\-Mail an die
284 Debian Live Mailing Liste unter <\fIdebian\-live@lists.debian.org\fP>
285 (englischsprachig) mitgeteilt werden.
288 live\-config wurde von Daniel Baumann <\fIdaniel@debian.org\fP> für das
289 Debian Projekt geschrieben.