Provided by: live-config-doc_3.0.23-1+deb8u1_all
NAME
live-config - System Konfiguration Skripte
BESCHREIBUNG
live-config enthält die Skripte welche ein Debian Live System während des Startvorganges (late userspace) konfigurieren.
KONFIGURATION
live-config kann durch Boot Parameter oder Konfigurationsdateien konfiguriert werden. Werden beide Mechanismen für eine bestimmte Option benutzt, so gehen die Boot Parameter den Konfigurationsdateien vor. Wird Persistenz benutzt, so werden die live-config Skripte nur einmal ausgeführt. Um die Boot Parameter von live-config welche standardmässig in einem Live System benutzt werden zu konfigurieren, siehe --bootappend-live Option in der lb_config(1) Manpage. Boot Parameter (Skripte) live-config ist nur aktiviert, wenn 'boot=live' als Boot Parameter benutzt wird. Zusätzlich muss live-config durch den Parameter 'live-config' angegeben werden, welche Skripte ausgeführt werden sollen, oder mit dem Parameter 'live-noconfig', welche Skripte nicht ausgeführt werden sollen. Werden beide beide Parameter oder mehrmals benützt, so geht der in der Reihenfolge lezte allen vorhergehenden vor. live-config | config Alle Skripte werden ausgeführt. Auf Debian Live Images ist dies das Standardverhalten. live-config=SKRIPT1,SKRIPT2, ... SKRIPTn | config=SKRIPT1,SKRIPT2, ... SKRIPTn Nur angegebene Skripte werden ausgeführt. Die Reihenfolge ist wesentlich, d.h. 'live-config=sudo,user-setup' würde nicht funktionieren da der Benutzer zuerst angelegt werden muss bevor für ihn sudo konfiguriert werden kann. Siehe Dateinamen der Skripte in /lib/live/config für ihre Ordnungsnummer. live-noconfig | noconfig Kein Skript wird ausgeführt. Dies ist das Gleiche, wie wenn weder 'live-config' noch 'live-noconfig' verwendet wird. live-noconfig=SKRIPT1,SKRIPT2, ... SKRIPTn | noconfig=SKRIPT1,SKRIPT2, ... SKRIPTn Alle Skripte werden ausgeführt, ausser die hier spezifizierten Ausnahmen. Boot Parameter (Optionen) Manche einzelne Skripte können durch Boot Parameter in ihrem Verhalten beinflusst werden. live-config.debconf-preseed=filesystem|medium|URL1|URL2| ... |URLn | debconf-preseed=medium|filesystem|URL1|URL2| ... |URLn Ermöglicht eine oder mehrere Debconf Preseed Dateien auf die Debconf Datenbank anzuwenden. Die URLs müssen durch wget (http, ftp oder file://) aufösbar sein. Falls die Datei sich auf dem Live Medium befindet, kann sie mittels file:///lib/live/mount/medium/FILE benutzt werden, falls sie sich im Root Dateisystem des Live Systems selbst befindet, mittels file:///FILE. Alle Preseed Dateien in /lib/live/config-preseed/ im Root Dateisystem des Live Systems können mit der Option 'filesystem' automatisch aktiviert werden. Alle Preseed Dateien in /live/config-preseed/ auf dem Live Medium können mit der Option 'medium' automatisch aktiviert werden. Werden verschiedene Mechanismen kombiniert, so werden die Dateisystem Preseed Dateien zuerst ausgeführt, dann die des Mediums und zuletzt die sich im Netzwerk befindende. live-config.hostname=RECHNERNAME | hostname=RECHNERNAME Ermöglicht den Rechnernamen des Systems zu wählen. Der Standardname ist 'debian'. live-config.username=BENUTZERNAME | username=BENUTZERNAME Ermöglicht den Namen des Benutzers zu wählen, welcher für den automatischen Login angelegt wird. Der Standardname ist 'user'. live-config.user-default-groups=GRUPPE1,GRUPPE2 ... GRUPPEn | user-default-groups=GRUPPE1,GRUPPE2 ... GRUPPEn Ermöglicht die Standardgruppen für den Benutzer zu wählen, welcher für den automatischen Login angelegt wird. Der Standard ist 'audio cdrom dip floppy video plugdev netdev powerdev scanner bluetooth'. live-config.user-fullname="VOLLER BENUTZERNAME" | user-fullname="VOLLER BENUTZERNAME" Ermöglicht den vollen Name für den Benutzer zu wählen, welcher für den automatischen Login angelegt wird. Der Standard ist 'Debian Live user'. live-config.locales=GEBIETSSCHEMA1,GEBIETSSCHEMA2 ... GEBIETSSCHEMAn | locales=GEBIETSSCHEMA1,GEBIETSSCHEMA2 ... GEBIETSSCHEMAn Ermöglicht das Gebietsschema des Systems zu wählen, zum Beispiel 'de_CH.UTF-8'. Der Standard ist 'en_US.UTF-8'. Falls das gewünschte Gebietsschema nicht schon auf dem System verfügbar ist, wird es automatisch bei Bedarf generiert. live-config.timezone=ZEITZONE | timezone=ZEITZONE Ermöglicht die Zeitzone des Systems einzustellen, zum Beispiel 'Europe/Zurich'. Der Standard ist 'UTC'. live-config.keyboard-model=TASTATUR_MODELL | keyboard-model=TASTATUR_MODELL Ermöglicht das Tastatur Modell zu bestimmen. Es ist kein Standardwert gesetzt. live-config.keyboard-layouts=TASTATUR_LAYOUT1,TASTATUR_LAYOUT2 ... TASTATUR_LAYOUTn | keyboard-layouts=TASTATUR_LAYOUT1,TASTATUR_LAYOUT2 ... TASTATUR_LAYOUTn Ermöglicht die Tastatur Layouts zu bestimmen. Wenn mehr als ein Layout angegeben wird, ermöglichen die Tools der Desktopumgebung das Wechseln unter X11. Es ist kein Standardwert gesetzt. live-config.keyboard-variants=TASTATUR_VARIANTE1,TASTATUR_VARIANTE2 ... TASTATUR_VARIANTEn | keyboard-variants=TASTATUR_VARIANTE1,TASTATUR_VARIANTE2 ... TASTATUR_VARIANTEn Ermöglicht die Tastatur Variante zu bestimmen. Wenn mehr als eine Variante angegeben wird, sollte die gleiche Anzahl an Werten wie Tastatur Layouts angegeben werden weil diese jeweils eins zu eins zugeordnet werden. Leere Werte sind ebenfalls zulässig. Die Tools der Desktopumgebung ermöglichen das Wechseln zwischen jedem Layout und Varianten Paar unter X11. Es ist kein Standardwert gesetzt. live-config.keyboard-options=TASTATUR_OPTIONEN | keyboard-options=TASTATUR_OPTIONEN Ermöglicht die Tastatur Optionen zu bestimmen. Es ist kein Standardwert gesetzt. live-config.sysv-rc=SERVICE1,SERVICE2 ... SERVICEn | sysv-rc=SERVICE1,SERVICE2 ... SERVICEn Ermöglicht Services durch update-rc.d abzuschalten. live-config.utc=yes|no | utc=yes|no Ermöglicht zu bestimmen, ob das System davon ausgehen soll, dass die Hardwareuhr auf UTC gestellt ist oder nicht. Der Standard ist 'yes'. live-config.x-session-manager=X_SESSION_MANAGER | x-session-manager=X_SESSION_MANAGER Ermöglicht den x-session-manager durch update-alternatives zu konfigurieren. live-config.xorg-driver=XORG_TREIBER | xorg-driver=XORG_TREIBER Ermöglicht den Xorg Treiber manuell statt automatisch zu bestimmen. Wird eine PCI ID in /usr/share/live/config/xserver-xorg/TREIBER.ids innerhalb des Live Systems angegeben, wird TREIBER für diese Geräte verwended. Wird sowohl ein Boot Parameter als auch ein Vorgabe mittels PCI ID gemacht, hat der Boot Parameter Vorrang. live-config.xorg-resolution=XORG_AUFLÖSUNG | xorg-resolution=XORG_AUFLÖSUNG Ermöglicht die Xorg Auflösung manuell statt automatisch zu bestimmen. z.B. 1024x768. live-config.hooks=filesystem|medium|URL1|URL2| ... |URLn | hooks=URL1|URL2| ... |URLn Ermöglicht eine oder mehrere beliebige Dateien herunterzuladen und auszuführen. Die URLs müssen durch wget (http, ftp oder file://) aufösbar sein, die Dateien werden in /tmp des laufenden Live Systems ausgeführt und es müssen alle Abhängigkeiten, die für das Ausführen der Dateien notwendig sind,bereits installiert sein, zum Beispiel muss für ein Python Skript bereits Python auf dem System installiert sein. Einige Hooks für häufige Anwendungsfälle sind in /usr/share/doc/live-config/examples/hooks/ und unter <http://live.debian.net/other/hooks> verfügbar. Falls die Datei sich auf dem Live Medium befindet, kann sie mittels file:///lib/live/mount/medium/FILE benutzt werden, falls sie sich im Root Dateisystem des Live Systems selbst befindet, mittels file:///FILE. Alle Dateien in /lib/live/config-hooks/ im Root Dateisystem des Live Systems können mit der Option 'filesystem' automatisch aktiviert werden. Alle Dateien in /live/config-hooks/ auf dem Live Medium können mit der Option 'medium' automatisch aktiviert werden. Werden verschiedene Mechanismen kombiniert, so werden die Dateisystem Hooks zuerst ausgeführt, dann die des Mediums und zuletzt die sich im Netzwerk befindende. Boot Parameter (Abkürzungen) live-config stellt Abkürzungen für einige häufige verwendete Anwendungsfälle wo sonst verschiedene einzelne Parameter kombiniert werden müssten. Dies gewährleistet sowohl feine Kontrolle über alle Optionen, als einfache Benutzbarkeit. live-config.noroot | noroot Schaltet die sudo und policykit Skripte ab, ein Benutzer kann keine root Privilegien auf dem System mehr erlangen. live-config.nottyautologin | noautologin Schaltet sowohl den den automatischen Login via TTY ab als auch den automatischen graphischen Login. live-config.nottyautologin | nottyautologin Schaltet den automatischen Login via TTY ab, dies beeinflusst den automatisch graphischen Login nicht. live-config.nox11autologin | nox11autologin Schaltet den automatischen Login via Display Manager ab, dies beeinflusst den automatischen tty Login nicht. Boot Parameter (Spezielle Optionen) Für spezielle Anwendungsfälle gibt es ein paar spezielle Bootparameter. live-config.debug | debug Schaltet debug Ausgaben in live-config an. Konfigurationsdateien live-config kann durch Konfigurationsdateien konfiguriert (nicht aber aktiviert) werden. Abgesehen von Abkürzungen können alle Optionen die durch Boot Parameter konfiguriert werden, auch alternativ durch eine oder mehrere Dateien konfiguriert werden. Wenn Konfigurationsdateien benützt werden, so ist der 'boot=live' Parameter trotzdem noch notwendig um live-config zu aktivieren. Die Konfigurationsdateien können entweder im Root Dateisystem selbst plaziert werden (/etc/live/config.conf, /etc/live/config/*) oder auf dem Live Medium (live/config.conf, live/config/*). Wenn beide Orte für eine bestimmte Option verwendet werden, geht die Konfigurationsdatei auf dem Live Medium dem der im Root Dateisystem enthaltenen vor. Obwohl die Konfigurationsdateien welche in die conf.d Verzeichnisse abgelegt werden können keinen bestimmten Namen oder Endung brauchen, ist es aus Konsistenzgründen empfohlen, für diese 'vendor.conf' oder 'project.conf' als Namensschema zu verwenden (wobei 'vendor' oder 'project' mit dem eigentlichen Namen ersetzt wird, resultierend in einem Dateinamen wie 'debian-eeepc.conf'). Der eigentliche Inhalt der Konfigurationsdateien besteht aus einer oder mehreren der folgenden Variablen. LIVE_CONFIGS=SKRIPT1,SKRIPT2, ... SKRIPTn Diese Variable enspricht dem 'live-config=SKRIPT1,SKRIPT2, ... SKRIPTn' Parameter. LIVE_NOCONFIGS=SKRIPT1,SKRIPT2, ... SKRIPTn Diese Variable enspricht dem 'live-noconfig=SKRIPT1,SKRIPT2, ... SKRIPTn' Parameter. LIVE_DEBCONF_PRESEED=filesystem|medium|URL1|URL2| ... |URLn Diese Variable enspricht dem 'live-config.debconf-preseed=filesystem|medium|URL1|URL2| ... |URLn' Parameter. LIVE_HOSTNAME=RECHNERNAME Diese Variable enspricht dem 'live-config.hostname=RECHNERNAME' Parameter. LIVE_USERNAME=BENUTZERNAME Diese Variable enspricht dem 'live-config.username=BENUTZERNAME' Parameter. LIVE_USER_DEFAULT_GROUPS=GRUPPE1,GRUPPE2 ... GRUPPEn Diese Variable enspricht dem 'live-config.user-default-groups=GRUPPE1 GRUPPE2 ... GRUPPEn' Parameter. LIVE_USER_FULLNAME="VOLLER BENUTZERNAME" Diese Variable enspricht dem 'live-config.user-fullname="VOLLER BENUTZERNAME"' Parameter. LIVE_LOCALES=GEBIETSSCHEMA1,GEBIETSSCHEMA2 ... GEBIETSSCHEMAn Diese Variable enspricht dem 'live-config.locales=GEBIETSSCHEMA1,GEBIETSSCHEMA2 ... GEBIETSSCHEMAn' Parameter. LIVE_TIMEZONE=ZEITZONE Diese Variable enspricht dem 'live-config.timezone=ZEITZONE' Parameter. LIVE_KEYBOARD_MODEL=TASTATUR_MODELL Diese Variable enspricht dem 'live-config.keyboard-model=TASTATUR_MODELL' Parameter. LIVE_KEYBOARD_LAYOUTS=TASTATUR_LAYOUT1,TASTATUR_LAYOUT2 ... TASTATUR_LAYOUTn Diese Variable enspricht dem 'live-config.keyboard-layouts=TASTATUR_LAYOUT1,TASTATUR_LAYOUT2 ... TASTATUR_LAYOUTn' Parameter. LIVE_KEYBOARD_VARIANTS=TASTATUR_VARIANTE1,TASTATUR_VARIANTE2 ... TASTATUR_VARIANTEn Diese Variable enspricht dem 'live-config.keyboard-variants=TASTATUR_VARIANTE1,TASTATUR_VARIANTE2 ... TASTATUR_VARIANTEn' Parameter. LIVE_KEYBOARD_OPTIONS=TASTATUR_OPTIONEN Diese Variable enspricht dem 'live-config.keyboard-options=TASTATUR_OPTIONEN' Parameter. LIVE_SYSV_RC=SERVICE1,SERVICE2 ... SERVICEn Diese Variable enspricht dem 'live-config.sysv-rc=SERVICE1,SERVICE2 ... SERVICEn' Parameter. LIVE_UTC=yes|no Diese Variable enspricht dem 'live-config.utc=yes|no' Parameter. LIVE_X_SESSION_MANAGER=X_SESSION_MANAGER Diese Variable enspricht dem 'live-config.x-session-manager=X_SESSION_MANAGER' Parameter. LIVE_XORG_DRIVER=XORG_TREIBER Diese Variable enspricht dem 'live-config.xorg-driver=XORG_TREIBER' Parameter. LIVE_XORG_RESOLUTION=XORG_AUFLÖSUNG Diese Variable enspricht dem 'live-config.xorg-resolution=XORG_AUFLÖSUNG' Parameter. LIVE_HOOKS=filesystem|medium|URL1|URL2| ... |URLn Diese Variable enspricht dem 'live-config.hooks=filesystem|medium|URL1|URL2| ... |URLn' Parameter.
ANPASSUNG
live-config kann sehr einfach angepasst werden für Downstream Projekte oder lokale Verwendung. Hinzufügen von neuen Konfigurationsskripten Downstream Projekte können ihre Skripte in /lib/live/config ablegen und müssen nichts weiteres tun, die Skripte werden automatisch während des Startens ausgeführt. Am Besten werden die Skripte in ein eigenes Debian Paket untergebracht. Ein Beispielpaket und -skript befindet sich in /usr/share/doc/live-config/examples. Entfernen von neuen Konfigurationsskripten Es ist derzeit nicht möglich in einer vernünftigen Art und Weise Skripte zu entfernen ohne das ein lokal verändertes live-config Paket oder dpkg-divert verwendet werden muss. Jedoch kann das selbe erreicht werden, indem bestimmte Skripte durch den live-noconfig Mechanismus abgeschaltet werden, siehe oben. Um zu verhindern, dass die abzuschaltenden Skripte immer durch einen Boot Parameter angegeben werden müssen, kann eine Konfigurationsdatei verwendet werden, siehe oben. Die Konfigurationsdateien für das Live System selber werden am Besten in einem eigenen Debian Paket untergebracht. Ein Beispielpaket und -konfigurationsdatei befindet sich in /usr/share/doc/live-config/examples.
SKRIPTE
live-config enthält derzeit folgende Skripte in /lib/live/config. debconf erlaubt beliebige Preseed Dateien auf dem Live Medium oder von einem HTTP/FTP Server anzuwenden. hostname konfiguriert /etc/hostname und /etc/hosts. user-setup fügt das Live Benutzerkonto hinzu. sudo räumt dem Live Benutzer sudo Privilegien ein. locales konfiguriert locales. locales-all konfiguriert locales-all. tzdata konfiguriert /etc/timezone. gdm konfiguriert Autologin in gdm. gdm3 konfiguriert Autologin in gdm3 (squeeze und neuer). kdm konfiguriert Autologin in kdm. lightdm konfiguriert Autologin in lightdm. lxdm konfiguriert Autologin in lxdm. nodm konfiguriert Autologin in nodm. slim konfiguriert Autologin in slim. xinit konfiguriert Autologin mit xinit. keyboard-configuration konfiguriert die Tastatur. sysvinit konfiguriert sysvinit. sysv-rc konfiguriert sysv-rc durch abschalten von angegebenen Services. login schaltet lastlog ab. apport schaltet apport ab. gnome-panel-data entfernt den Sperrknopf für den Bildschirm. gnome-power-manager verhindert Hibernation. gnome-screensaver schaltet das Sperren des Bildschirmes während der Bildschirmschoner läuft ab. kaboom schaltet den KDE Migration Wizard ab (squeeze und neuer). kde-services schaltet ein paar ungewollte KDE Services ab (squeeze und neuer). debian-installer-launcher fügt debian-installer-launcher auf dem Benutzer Desktop hinzu. module-init-tools lädt automatisch gewisse Module auf bestimmten Architekturen. policykit räumt dem Benutzer Privilegien durch policykit ein. sslcert erneuert SSL snake-oil Zertifikate. update-notifier schaltet update-notifier ab. anacron schaltet anacron aus. util-linux schaltet hwclock von util-linux ab. login schaltet lastlog ab. xserver-xorg konfiguriert xserver-xorg. ureadahead (nur Ubuntu) schaltet ureadahead ab. openssh-server erstellt OpenSSH-Server Host Schlüssel. xfce4-panel konfiguriert Standarteinstellungen für xfce4-panel. hooks erlaubt beliebige Kommands von einem Skript auf dem Live Medium oder von einem HTTP/FTP Server auszuführen.
DATEIEN
/etc/live/config.conf /etc/live/config/* live/config.conf live/config/* /lib/live/config.sh /lib/live/config/ /var/lib/live/config/ /var/log/live/config.log /live/config-hooks/* live/config-hooks/* /live/config-preseed/* live/config-preseed/*
SIEHE AUCH
live-boot(7) live-build(7) live-tools(7)
HOMEPAGE
Weitere Informationen über live-config und das Debian Live Projekt können auf der Homepage unter <http://live.debian.net/> und im Handbuch unter <http://live.debian.net/manual/> gefunden werden.
FEHLER
Fehler können durch Einreichen eines Fehlerberichtes für das live-config Paket im Debian Bug Tracking System unter <http://bugs.debian.org/> oder durch Senden einer E-Mail an die Debian Live Mailing Liste unter <debian-live@lists.debian.org> (englischsprachig) mitgeteilt werden.
AUTOR
live-config wurde von Daniel Baumann <daniel@debian.org> geschrieben.