Ubuntu Manpage: live-config - System Konfiguration Skripte

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.

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.

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.