Mkinitcpio: Unterschied zwischen den Versionen

Aus wiki.archlinux.de
← Zum vorherigen Versionsunterschied
Tuxnix (Diskussion | Beiträge)
1.687 Bearbeitungen
Hook micrcode ergänzt
 
(15 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{SEITENTITEL:mkinitcpio}}{{righttoc}}{{Unvollständig}}
{{SEITENTITEL:mkinitcpio}}{{righttoc}}
= Einleitung =
 
'''mkinitcpio''' ist die nächste Generation der '''initramfs'''-Erstellung. Es hat viele Vorteile gegenüber den alten Skripten '''mkinitrd''' und '''mkinitramfs'''.
'''mkinitcpio''' ist die nächste Generation der '''initramfs'''-Erstellung. Es hat viele Vorteile gegenüber den alten Skripten '''mkinitrd''' und '''mkinitramfs'''.


Zeile 10: Zeile 10:
* Mit dem '''mkinitcpio'''-Skript ist es möglich, das Image in den Kernel zu integrieren.
* Mit dem '''mkinitcpio'''-Skript ist es möglich, das Image in den Kernel zu integrieren.


'''mkinitcpio''' wurde von '''phrakture''' und '''tpowa''' mit einiger Hilfe von der Community entwickelt.
'''mkinitcpio''' wurde von '''phrakture''' und '''tpowa''' mit Hilfe aus der Community entwickelt.
 
{{installation|paket=mkinitcpio|repo=core}}
 
mkinitcpio ist Bestandteil jeder Arch Linux Installation.
 
== Konfiguration ==
 
Die Konfigurationsdatei lautet {{ic|/etc/mkinitcpio.conf}}.
 
=== MODULES ===
 
Mit dem MODULES-Eintrag können Module explizit dem Image hinzugefügt werden.


= Installation von mkinitcpio =
Beispiel: Bei Verwendung des nouveau Treiber wird bereits die Konsole beim Starten diesen verwenden.
== Aus dem current Repository ==
Das '''mkinitcpio''' Script ist im core Repository verfügbar. Du kannst es mit [[pacman]] installieren:
# pacman -S mkinitcpio


== Aus dem svn ==
MODULES=(nouveau)
Die aktuelle Entwickler-Version von '''mkinitcpio''' kannst Du aus  phraktures svn Repository laden:
# svn co http://phraktured.net/initramfs
Die neuesten Scripte befinden sich nun im '''initramfs/mkinitcpio''' Verzeichnis.


= Aktivierung für Kernel ab 2.6.17 =
=== BINARIES und FILES ===
Es werden zwei Images während der Installation des Kernels erstellt:


- '''kernel26'''
Mit diesen Optionen können Dateien dem Abbild hinzugefügt werden. Der einzige Unterschied zwischen BINARIES und FILES ist, dass BINARIES die Bibliotheken nach Abhängigkeiten durchsucht, während FILES nur Dateien hinzufügt.
/boot/kernel26.img --> enhält nur die automatisch erkannten Module
/boot/kernel26-fallback.img --> enthält alle Module
- '''kernel26beyond'''
/boot/kernel26beyond.img --> enhält nur die automatisch erkannten Module
/boot/kernel26beyond-fallback.img --> enthält alle Module
Ändere Deine Bootloader-Konfiguration Deinen Bedürfnissen entsprechend.
Achtung: '''lvm2''', '''raid''' and '''encrypt''' werden standardmäßig '''nicht''' aktiviert! Zur Konfiguration dieser System lese bitte die entsprechenden Anleitungen im Wiki.


= Anpassung der Konfigurations-Dateien =
=== HOOKS ===
== '''Änderung des Haupt-Abbildes''' ==
Um die Standard-Einstellungen des Haupt-Abbild zu ändern, nutze folgende Datei:


/etc/mkinitcpio.conf
Dies ist der wichtigste Teil der mkinitcpio Konfiguration. Diese Zeile enthält alle HOOKS, welche während der Imageerstellung oder zur Laufzeit ausgeführt werden. Hierbei muss die Reihenfolge beachtet werden:


mkinitcpio benutzt standardmäßig diese Datei.
HOOKS=(foo1 foo2 bar1 bar2)


== '''Änderung des Rettungs-Abbild''' ==
Am besten man prüft anhand des eigenen Systems, welche HOOKS aktuell verfügbar sind. Zusätzlich wird angezeigt, welche als veraltet gelten, und welche zukünftig verwendet werden sollen.
Um die Standard-Einstellungen des Rettungs-Abbild zu ändern, nutze folgende Dateien:
kernel26 --> '/boot/mkinitcpio-kernel26.conf'
kernel26beyond --> '/boot/mkinitcpio-kernel26beyond.conf
und füge die Dateien der Zeile '''NoUpgrade =''' der '/etc/pacman.conf' hinzu. Dies ist nur bei speziellen Konfigurationen mit lvm oder raid nötig.


== Konfiguration der HOOKS ==
mkinitcpio -L
Dies ist der wichtigste Teil der mkinitcpio Konfiguration. Die HOOKS Zeile enthält alle hooks die während der Abbild-Erstellung oder zur Laufzeit ausgeführt werden. Hierbei wird die Reihenfolge beachtet:


HOOKS="foo1 foo2 foo3 bar1 bar2"
Für jeden gelisteten HOOK gibt es eine Zusatzinfo.


=== Verfügbare Hooks ===
mkinitcpio -H base
 
==== Verfügbare HOOKS ====
{| border="2" cellspacing="0" cellpadding="4" rules="all" style="margin:1em 1em 1em 0; border-style:solid; border-width:1px; border-collapse:collapse; empty-cells:show"
{| border="2" cellspacing="0" cellpadding="4" rules="all" style="margin:1em 1em 1em 0; border-style:solid; border-width:1px; border-collapse:collapse; empty-cells:show"
|-
|-
! Hook || Installation || Laufzeit
! Hook || Information
|-
| '''base''' || This hook provides crucial runtime necessities for booting. DO NOT remove this hook unless you know what you're doing.
|-
| '''udev''' || This hook will use udev to create your root device node and detect the needed modules for your root device. It is also required for firmware loading in initramfs. It is recommended to use this hook.
|-
|-
| '''base''' || Richtet alle Basisverzeichnisse ein und installiert die Kklibctools und Bibliotheken. Füge diesen Hook immer hinzu, außer du weisst was du tust. ||
|'''microcode''' || This hook adds early microcode update files for Intel and AMD processors. If /boot/amd-ucode.img or /boot/intel-ucode.img exist, they are included in the initcpio. If not, the individual microcode files in /lib/firmware/ are included if they exist. If the autodetect hook runs before this hook, it will only add early microcode update files for the processor of the system the image is built on.
|-
|-
| '''udev''' || Fügt '''udev''' zum Abbild hinzu || '''Udev''' wird genutzt um das Rootgerät zu erkennen und es ermittelt alle benötigten Module für das Rootgerät. Da es die Sache vereinfacht, wird die Nutzung des '''Udev''' Hook empfohlen.
| '''systemd''' || This will install a basic systemd setup in your initramfs, and is meant to replace the 'base', 'usr', 'udev' and 'timestamp' hooks. Other hooks with runtime components will need to be ported, and will not work as intended. You also may wish to still include the 'base' hook (before this hook) to ensure that a rescue shell exists on your initramfs.  
|-
|-
| '''modload''' || || Eine Alternative zu Udev die sehr viel langsamer ist. Dieser Hook ist veraltet, nutze deshalb Udev.
| '''modconf''' || This hook installs modprobe configuration files from /etc/modprobe.d and /usr/lib/modprobe.d.  
|-
|-
| '''autodetect''' || Verkleinert dein Initramfs indem es die nötigen Module erkennt. Sei sicher, dass die eingetragenen Module richtig sind und keins vergessen wurde. Dieser Hook muss vor den anderen Subsystemhooks laufen um die Autoerkennung nutzen zu können. Alle Hooks vor '''autodetect''' werden voll installiert. ||
| '''usr''' || This provides a support for mounting /usr via a late running hook. No configuration is needed, as the mount options will be pulled directly from the fstab on the real root device.  
|-
|-
| '''ide''' || Fügt die IDE-Module zum Abbild hinzu. Nutze diesen Hook wenn die Rootpartition auf einer IDEfestplatte ist. Nutze auch den '''autodetect''' Hook wenn du die Größe deines Abbildes verringern willst. || Lädt die IDE-Module. Du brauchst den '''udev''' oder '''modload''' Hook wenn du die Module nicht manuell angibst.
| '''autodetect''' || This hook shrinks your initramfs to a smaller size by autodetecting the needed modules. Be sure to verify included modules are correct and none are missing. This hook must be run before other subsystem hooks in order to take advantage of auto-detection. Any hooks placed before 'autodetect' will be installed in full.  
|-
|-
| '''sata''' || Fügt die Sata-Module zum Abbild hinzu. Nutze '''sata''' wenn die Rootpartition auf einer Satafestplatte liegt. Nutze auch den '''autodetect''' Hook wenn du die Größe deines Abbildes verringern willst. || Lädt die Sata-Module. Du benötigst den '''udev''' oder '''modload''' Hook solange du nicht die Module manuell angibst.
| '''sata''' || This hook is deprecated in favor of 'block'  
|-
|-
| '''scsi''' || Fügt die SCSI Module zum Abbild hinzu. Nutze dies wenn deine Rootpartition auf einer SCSI-Platte ist. Nutze außerdem den '''autodetect''' Hook wenn du die Größe deines Abbildes verringern willst. || Lädt SCSI-Module. Du brauchst den '''udev''' oder '''modload''' Hook solange du nicht die nötigen Module manuell angibst.
| '''scsi''' || This hook is deprecated in favor of 'block'  
|-
|-
| '''usb''' || Fügt die Usb-Module zum Abbild hinzu. Nutze dies wenn deine Rootpartition auf einer Usb-Platte liegt. || Lädt die Usbmodule. Du brauchst den '''udev''' oder '''modload''' Hook solange du nicht die nötigen Module manuell angibst.
| '''usb''' || This hook is deprecated in favor of 'block'  
|-
|-
| '''usbinput''' || Fügt Usb HID Module zum Abbild hinzu. Nutze dies, wenn du deine Usbtastatur hast und diese früh benötigst (zum Beispiel zur Passworteingabe oder für den Failsafemodus). || Lädt die Usb HID Module. Du brauchst den '''udev''' oder '''modload''' Hook solange du nicht die nötigen Module manuell angibst.
| '''fw''' || This hook is deprecated in favor of 'block'  
|-
|-
| '''fw''' || Fügt die Firewire Module zum Abbild hinzu. Nutze dies, wenn deine Rootpartition auf einem Firewirespeichermedium installiert ist. || Lädt die FW Module. Du brauchst den '''udev''' oder '''modload''' Hook solange du nicht die nötigen Module manuell angibst.
| '''block''' || This hook loads the necessary modules for most block devices using pata, sata, scsi, firewire, usb, or mmc. Detection will take place at runtime. To minimize the modules in the image, add the autodetect hook too.  
|-
|-
| '''net''' || Fügt die notwendigen Module für Netzwerkgeräte hinzu. Für pcmcia Netzwerkgeräte füge auch den '''pcmcia''' Hook hinzu. ||  Lädt die Netzwerkmodule. Du brauchst den '''udev''' oder '''modload''' Hook solange du nicht die nötigen Module manuell angibst. Siehe [[#Kernelzeile_anpassen|Kernelzeile anpassen]] für weitere Informationen.
| '''usbinput''' || This hook is deprecated in favor of 'keyboard'  
|-
|-
| '''pcmcia''' || Fügt die Module für pcmcia zum Abbild hinzu. Du musst pcmciautils installiert haben um dies zu nutzen.|| Lädt die pcmcia Module. Du brauchst den '''udev''' oder '''modload''' Hook solange du nicht die nötigen Module manuell angibst.
| '''keyboard''' || This hook loads the necessary modules for keyboard devices. As a side-effect modules for some non-keyboard input devices might be added to, but this should not be relied on. Detection will take place at runtime. To minimize the modules in the image, add the autodetect hook too.  
|-
|-
| '''dsdt''' || Lädt ein angepasstes acpi dsdt file während dem Boot. Speichere deine modifizierte  dsdt Datei dort: /lib/initcpio/custom.dsdt || Die modifizierte dsdt Datei wird automatisch vom Kernel benutzt wenn es im Initramfs vorhanden ist.
| '''filesystems''' || This hook adds filesystems modules to the image. If you would like to minimize the modules installed in the image, add the autodetect hook too.  
|-
|-
| '''filesystems''' || Das bindet notwendige Dateisystemmodule ins Abbild ein. Dieser Hook ist notwendig wenn du in der Lage sein willst zu booten. || Dies wird die Dateisystemtypen zur Laufzeit erkennen, lädt die Module und leitet es an kinit weiter.
| '''lvm2''' || This hook enables LVM2 volumes in initramfs. Do pacman -S lvm2 before.  
Anmerkung: es wird nicht reiser4 erkennen, das Module muss über die Modulliste geladen werden.
|-
|-
| '''lvm2''' || Fügt das Device Mapper Kernelmodul und das LVMtool zum Abbild hinzu. Du musst das lvm2 Paket installiert haben um es zu nutzen. || Aktiviert alle lvm2 Gerätegruppen. Das ist notwendig wenn das Rootdateisystem auf einem lvm ist.
| '''sd-lvm2''' || This hook enables LVM2 volumes in systemd-based initramfs. Do pacman -S lvm2 before.  
|-
|-
| '''mdadm''' || Fügt das Modul und mdassamble für Raids hinzu. Du musst mdadm installiert haben um das Nutzen zu können. -- Enthält einen effektiveren Lademechanismus und ersetzt deswegen den Hook '''raid''' (ab Kernel 2.6.29). || Lädt die nötigen Module für Software Raid Geräte und bindet sie ein.  Die direkte Verwendung der Einstellungen der Datei /etc/mdadm.conf bewirkt, dass nur noch das root-Device in der Kernelzeile angegeben zu werden braucht. Siehe [[#Kernelzeile_anpassen|Kernelzeile anpassen]] für weitere Informationen.
| '''mdadm''' || This hook loads the necessary modules for any raid root device, and assembles the raid device when run. If arrays are defined in /etc/mdadm.conf, the file will be used instead of command line assembling. Do pacman -S mdadm before. Please see mkinitcpio -H mdadm
|-
|-
| '''raid''' || Fügt das Modul und mdassamble für Raids hinzu. Du musst mdadm installiert haben um das Nutzen zu können.|| Lädt die nötigen Module für Software Raid Geräte und bindet sie ein.  Siehe [[#Kernelzeile_anpassen|Kernelzeile anpassen]] für weitere Informationen.
| '''dmraid''' || This hook loads the necessary modules for a dmraid root device. Do pacman -S dmraid before.  
|-
|-
| '''encrypt''' || Fügt das dm-crypt Kernelmodul und das Cryptsetuptool zum Image hinzu. Du musst das Cryptsetup Paket installiert haben. || Erkennt und entschlüsselt Rootpartitionen. Siehe [[#Kernelzeile_anpassen|Kernelzeile anpassen]] für weitere Informationen.
| '''encrypt''' || This hook allows for an encrypted root device. Users should specify the device to be unlocked using 'cryptdevice=device:dmname' on the kernel command line, where 'device' is the path to the raw device, and 'dmname' is the name given to the device after unlocking, and will be available as /dev/mapper/dmname. Do pacman -S cryptsetup before. Please see mkinitcpio -H encrypt
|-
|-
| '''resume''' || || Nötig um aus dem "suspend to disk" aufzuwachen. Arbeitet mit swsusp und [[Suspend to Disk|suspend2]]. Siehe [[#Kernelzeile_anpassen|Kernelzeile anpassen]] für weitere Informationen.
| '''sd-encrypt''' || This hook allows for an encrypted root device. Users should specify the device to be unlocked using 'cryptdevice=device:dmname' on the kernel command line, where 'device' is the path to the raw device, and 'dmname' is the name given to the device after unlocking, and will be available as /dev/mapper/dmname. Do pacman -S cryptsetup before. Please see mkinitcpio -H sd-encrypt
|-
|-
| '''firmware''' || Fügt die Dateien aus /lib/firmware hinzu. || Lädt die Firmware. Um die Firmware zu laden wird der '''udev''' Hook benötigt.  
| '''resume''' || This hook initializes support for resuming from Disk. Supports swsusp and suspend2.  
|-
|-
| '''keymap''' || Liest die Keymap und die Konsolenfont aus der rc.conf. || Lädt die spezifische Keymap und Konsolenfont aus der rc.conf.
| '''fschk''' || This hook provides fsck and filesystem specific helpers to perform an fsck operation on the root device prior to mounting. If the autodetect hook is used, only the fsck helper specific to your filesystem will be added to the image. It is highly recommended that if you include this hook that you also include any necessary modules to ensure your keyboard will work in early userspace. Please see mkinitcpio -H fsck
|-
| '''consolefont''' || This hook loads consolefont specified in vconsole.conf during early userspace.  
|-
| '''sd-vconsole''' || This hook adds the keymap(s) and font specified in vconsole.conf to the image and loads them during early userspace.  
|}
|}


=== Beispiele ===
Beispiele:
 
Diese Konfiguration sollte für die meisten Benutzer funktionieren:
Diese Konfiguration sollte für die meisten Benutzer funktionieren:


  HOOKS="base udev autodetect ide scsi sata filesystems"
  HOOKS=(base systemd autodetect modconf block filesystems sd-vconsole fsck)


Möchtest Du das Abbild auf mehr als einer Maschine nutzen, so benutze folgende Konfiguration:
Du kannst verschlüsselte Dateisysteme innerhalb von lvm nutzen:


  HOOKS="base udev ide scsi sata filesystems"
  HOOKS=(base autodetect modconf block lvm2 encrypt filesystems keyboard consolefont fsck)


Du kannst verschlüsselte Dateisystem innerhalb von lvm nutzen:
Du kannst verschlüsselte Dateisysteme innerhalb von lvm nutzen, wenn systemd im Einsatz ist:


  HOOKS="base udev autodetect ide scsi sata lvm2 encrypt filesystems"
  HOOKS=(base systemd autodetect modconf block sd-lvm2 sd-encrypt filesystems sd-vconsole fsck)


== Konfiguration der Module ==
=== COMPRESSION ===
Mit dem MODULES-Eintrag kannst Du Module explizit laden. Falls Du zum Beispiel ein System auf einer Festplatte mit SATA (Serial ATA) Anschluss installiert hast und danach im BIOS die Option AHCI aktivieren möchtest, solltest Du ahci bei MODULES in Verbindung mit sata bei HOOKS eintragen:
# Use this to compress the initramfs image. By default, gzip compression is used. Use 'cat' to create an uncompressed image.
COMPRESSION=(xz)
=== COMPRESSION_OPTIONS ===
# Additional options for the compressor
COMPRESSION_OPTIONS=(-9)


MODULES="ahci"
== Erstellen des Images ==
HOOKS="base udev autodetect sata filesystems"


== Konfigurieren der BINARIES und FILES ==
Erstelle das Image mit folgendem Befehl:
Mit diesen Optionen können Dateien dem Abbild hinzugefügt werden. Der einzige Unterschied zwischen BINARIES und FILES ist, dass BINARIES die Bibliotheken nach Abhängigkeiten durchsucht, während FILES nur Dateien hinzufügt.


Beispiel:
# mkinitcpio -p linux


FILES="/etc/modprobe.d/modprobe.conf"
== Extrahieren des Images ==


BINARIES="/usr/bin/somefile"
Wenn du wissen möchtest, was sich innerhalb des initrd-Abbildes befindet, kann du es auspacken und in den enthaltenen Dateien herumstöbern.


= Erstellen des Images =
Das initrd-Abbild ist ein 'SVR4 CPIO'-Archiv, das durch die Befehle ''find'' und ''bsdcpio'' erstellt wurde und optional durch ein vom Kernel verstandenes Komprimierungsschema komprimiert wurde: genauer gesagt gzip, bzip2, lzma, lzo oder xz.
Erstelle das Image mit folgendem Befehl:


mkinitcpio -g /boot/kernel26.img
mkinitcpio beinhaltet ein Werkzeug namens lsinitcpio, welches die Inhalte des initramfs-Abbildes anzeigt und extrahiert.


Das wird das Image für den aktuell laufenden Kernel erstellen und als '''/boot/kernel26.img''' abspeichern.
Das Anzeigen der Dateien im Abbild geschieht durch:


Wenn das Image für einen anderen, als den aktuell laufenden Kernel erstellt werden soll, füge dem Befehl die Kernelversion hinzu:
# lsinitcpio /boot/initramfs-linux.img


mkinitcpio -g /boot/kernel26.img -k 2.6.16-ARCH
Man kann sich auch eine Auflistung der wichtigen Teile des Abbildes anzeigen lassn:


# lsinitcpio -a /boot/initramfs-linux.img


''Notiz:'' Das Folgende könnte verwirrend wirken. Es ist nur für Leute interessant die Rescue Images erstellen möchten während der Kernel im Einsatz ist. Um Images für jeden Kernel zu erstellen der Momentan nicht läuft, muss die -k Option benutzt werden.
Das Extrahieren aller Dateien in das aktuelle Verzeichnis:


Ein Rescue Image sollte erstellt worden sein, als '''kernel26''' oder '''<kernel26''' installiert wurden aber falls du es neu generieren willst:
# lsinitcpio -x /boot/initramfs-linux.img


mkinitcpio -c /boot/mkinitcpio-kernel26.conf -g /boot/kernel26.img
== Kernelzeile anpassen ==


<kernel26
Einige Optionen müssen in der Kernelzeile angegeben werden. Einige Mkinitcpio Hooks haben spezielle Optionen. Um diese soll es in diesem Abschnitt gehen.
mkinitcpio -c /boot/mkinitcpio-kernel26beyond.conf -g /boot/kernel26beyond.img


Siehe '''mkinitcpio -h''' für mehr Optionen.
Wenn du nicht weißt was die Kernelzeile ist, schau in die Dokumentationen von [[GRUB]] oder [[Syslinux]].


Vergiss nicht einen neuen Bootladereintrag anzulegen. Mach einfach eine Kopie des alten und ändere den Initrd für das neue Image.
=== Failsafe Modus ===


= Kernelzeile anpassen =
Wenn du
Einige Optionen müssen in der Kernelzeile angegeben werden. Einige Mkinitcpio Hooks haben spezielle Optionen. Um diese soll es in diesem Abschnitt gehen.


Wenn du nicht weißt was die Kernelzeile ist, schau in die Dokumentationen von [[Grub]] oder [[Lilo]].
break=y


== Failsafe Modus ==
Wenn du
break=y
zur Kernelzeile hinzufügst, dann stoppt Init nach dem das Setup vollständig ist und du landest in einer ''dash'' shell. Diese kann genutzt werden um sich über den Erfolg des Vorgangs zu versichern. Wenn du dich ausloggst geht der normale Bootvorgang weiter.
zur Kernelzeile hinzufügst, dann stoppt Init nach dem das Setup vollständig ist und du landest in einer ''dash'' shell. Diese kann genutzt werden um sich über den Erfolg des Vorgangs zu versichern. Wenn du dich ausloggst geht der normale Bootvorgang weiter.


== Hooks deaktivieren ==
=== Hooks deaktivieren ===
Du kannst hooks deaktivieren in dem du ''disablehooks'' zur Kernelzeile hinzufügst:
 
Du kannst hooks deaktivieren indem du ''disablehooks'' zur Kernelzeile hinzufügst:


  disablehooks=hook1,hook2,hook2
  disablehooks=hook1,hook2,hook2
Zeile 175: Zeile 173:
  disablehooks=resume
  disablehooks=resume


== Module blacklisten ==
=== Module blacklisten ===
 
Du kannst Module blacklisten indem du ''disablemodules'' zur Kernelzeile hinzufügst:
Du kannst Module blacklisten indem du ''disablemodules'' zur Kernelzeile hinzufügst:


Zeile 183: Zeile 182:


  disablemodules=ata_piix
  disablemodules=ata_piix
'''Diese Funktion ist seit Mkinitcpio 0.5.1 verfügbar'''
== raid nutzen ==
Füge als erstes '''raid''' zur HOOKS-liste in /etc/mkinitcpio.conf hinzu.
'''Kernel Parameter: '''
Definiere alle deine md Arrays mit dem md -parameter: (es reicht nur das Raid array hinzuzufügen von dem gebootet wird)
füge folgendes zur Kernelzeile in grub/menu.lst hinzu:
  Example: md=0,/dev/sda3,/dev/sda4 md=1,/dev/hda1,/dev/hdb1
  Beispie: kernel /vmlinuz26beyond root=/dev/md0 ro md=0,/dev/sda1,/dev/sdb1
Das definiert 2 md Arrays mit persistenten Superblöcken.
'''Setup:'''
  - für alte Raid Arrays ohne persistenten Superblock:
    md=<md device no.>,<raid level>,<chunk size factor>,<fault level>,dev0,dev1
  - für Raid Arrays mit persistentem Superblock:
    md=<md device no.>,dev0,dev1,...,devn
  - für partitionierte Arrays:
    md=d<md device no.>,dev0,dev1,...,devn
'''Parameter:'''
  - <md device no.> = die Zahl der md Geräte:
    0 bedeutet md0, 1 bedeutet md1, ...
  - <raid level> = -1 linear Modus, 0 striped Modus
    andere Modi sind nur mit persistentem Superblock verfügbar
  - <chunk size factor> = (raid-0 and raid-1 only):
    Chunk Größe auf 4k << n setzen.
  - <fault level> = Total ignorieren
  - <dev0-devn>: e.g. /dev/hda1,/dev/hdc1,/dev/sda1,/dev/sdb1
''Aktuelle Änderung:'' Bei Benutzung des neuen Hooks '''mdadm''' (ab Kernel 2.6.29) anstatt von '''raid''' ist die  explizite Angabe der Raidarrays in der Kernelzeile hinfällig -- nur noch das root-Device muss angegeben werden, etwa:
  Beispiel: kernel /vmlinuz26 root=/dev/md0 ro
Die HOOKS-Zeile in der /etc/mkinitcpio.conf sieht dann bspw. so aus, wenn man von einem verschlüsselten Raid-System booten will:
  HOOKS="base udev autodetect mdadm pata scsi encrypt filesystems"
== net nutzen ==
'''Kernel Parameters:'''
'''ip='''
Ein Schnittstellenname kann entweder die kurze Form, das heißt nur der
Name der Schnittstelle (z.B. eth0), oder die lange Form sein.
Die lange Form besteht aus bis zu sieben Elementen, die durch Doppelpunkte getrennt werden:
 
  ip=<client-ip>:<server-ip>:<gw-ip>:<netmask>:<hostname>:<device>:<autoconf>
  nfsaddrs= ist ein Alias von ip= und kann auch benutzt werden
''Erklärung der Parameter:''
  <client-ip>  IP-Adresse des Clients. Wenn dieser Parameter leer ist,
                wird von RARP, BOOTP oder DHCP vergeben.
                Welches Protokoll verwendet wird, hängt vom <autoconf>-Parameter ab.
                Wenn dieser Parameter nicht leer ist, wird autoconf benutzt. 
  <server-ip>  IP-Adresse des NFS-Servers. Falls RARP benutzt wird, um die Adresse des Clients zu ermitteln
                und der Parameter NICHT leer ist, werden nur Antworten des angegebenen Servers akzeptiert.
                Um andere RARP- und NFS-Server zu verwenden, muss der RARP-Server hier angegeben (oder leergelassen werden)
                und  der NFS-Server im 'nfsroot'-Parameter angegeben werden (siehe oben).
                Falls dieser Eintrag leer ist wird die Adresse des Servers verwendet, welcher die RARP/BOOTP/DHCP-Anfrage beantwortet.
  <gw-ip>      IP-Adresse eines Gateways, wenn der Server sich in einem
                anderen Subnetz befindet. Falls dieser Eintrag leer ist wird
                kein Gateway benutzt und es wird angenommen, dass sich der
                Server im lokalen Netzwerk befindet, außer ein Wert wurde durch
                BOOTP/DHCP empfangen.
  <netmask>    Netzmaske für die lokale Netzwerkschnittstelle.
                Falls dieser Wert leer ist wird die Netzmaske von der IP-Adresse
                abgeleitet, es sei denn, BOOTP/DHCP ist dem zuvorgekommen.
  <hostname>    Name des Clients. Falls dieser leer ist, wird die IP-Adresse
                in ASCII-Darstellung verwendet, oder der Wert, der durch BOOTP/DHCP
                erhalten wurde.
  <device>      Name der zu verwendenten Netzwerkschnittstelle.
                Wenn diese nicht angegeben wird, werden alle Netzwerkschnittstellen
                für RARP/BOOTP/DHCP-Anfragen genutzt und diejenige konfiguriert, die die erste Antwort erhält.
                Wenn nur eine Schnittstelle vorhanden ist, kann der Eintrag problemlos leer gelassen werden.
  <autoconf>    Methode zur automatischen Konfiguration. Wenn dieser Eintrag
                'rarp', 'bootp', oder 'dhcp' lautet, wird das entsprechende Protokoll genutzt. 
                Wenn der Wert 'both', 'all' oder leer ist, werden alle Protokolle genutzt. 
                off', 'static' oder 'none' bedeutet, dass keine automatische Konfiguration vorgenommen wird.
''Beispiele:''
  ip=127.0.0.1:::::lo:none  --> Aktivieren der Loopback-Schnittstelle.
  ip=192.168.1.1:::::eth2:none --> statisches Aktivieren der eth2-Schnittstelle
  ip=:::::eth0:dhcp --> DHCP für eth0 aktivieren
'''nfsroot='''
Wenn der Parameter 'nfsroot' NICHT in der Kommandozeile gesetzt wurde, wird der Standard "/tftboot/%s" benutzt.
  nfsroot=[<server-ip>:]<root-dir>[,<nfs-options>]
''Erklärung der Parameter:''
  <server-ip>  Spezifiziert die IP-Adresse des NFS-Servers. Wenn dieses Feld nicht gesetzt wurde,
                wird die Standardadresse verwendet, die durch die 'ip'-Variable gesetzt wurde (siehe oben).
                Eine Nutzungsmöglichkeit dieses Parameters ist z.B., um verschiedene Server für RARP und NFS zu nutzen.
                Normalerweise kann dieses Feld leer gelassen werden.
  <root-dir>    Name des Verzeichnisses auf dem Server, welches als root eingehängt wird.
                Wenn ein %s-Zeichen in der Zeichenkette vorhanden ist, wird es durch die ASCII-Darstellung der IP des Clients ersetzt.
  <nfs-options> Standard NFS-optionen. Alle Optionen werden durch Kommata getrennt.
                Wenn das Optionsfeld nicht angegeben wird, werden folgende
                Standards benutzt:
                        port            = wie beim server portmap daemon angegeben
                        rsize          = 1024
                        wsize          = 1024
                        timeo          = 7
                        retrans        = 3
                        acregmin        = 3
                        acregmax        = 60
                        acdirmin        = 30
                        acdirmax        = 60
                        flags          = hard, nointr, noposix, cto, ac
'''root=/dev/nfs'''
  Wenn der 'nfsroot='-Parameter nicht verwendet wird, muss root=/dev/nfs gesetzt werden, um durch automatisch von einem nfs-root zu booten.
== lvm nutzen ==
Wenn sich die Rootpartition innerhalb einer LVM-Struktur befindet, muss der '''lvm2'''-Hook hinzugefügt werden.
Das Rootpartition muss auf der Kernelkommandozeile  fogendermaßen angegeben werden:
root=/dev/mapper/<volume group name>-<logical volume name>
z.B.
root=/dev/mapper/myvg-root
== root verschlüsseln ==
Wenn die Root-Partition verschlüsselt ist, muss der '''encrypt''-Hook verwendet werden. Dieser muss vor dem '''filesystem'''-Hook und nach dem '''udev'''-Hook stehen. Dann wird das Root-Device auf der Kernel-Kommandozeile angegeben, genauso, als wäre es unverschlüssel, z.B.
root=/dev/sda5
für eine verschlüsselte Partition auf eine Sata- oder Scsi-Platte oder
cryptdevice=/dev/sda5:root root=/dev/mapper/root
für ein verschlüsseltes LVM-Volumen. Das Root-Device wird automatisch zu ''/dev/mapper/root'' geändert.
=== LUKS-Volumen nutzen ===
Wenn LUKS für die Festplattenverschlüsselung eingesetzt wird, ermittelt das Init-Script automatisch die Verschlüsselung, wenn der '''encrypt'''-Hook aktiviert wurde. In diesem Fall wird nach einer Passphrase gefragt und versucht, das Volumen zu öffnen.
=== Veraltete Cryptsetup-Volumen nutzen ===
Wenn ein veraltetes Cryptsetup-Volumen verwendet wird, müssen alle benötigten Cryptsetup-Optionen auf der Kernel-Kommandozeile angegeben werden, um das Volumen zu öffnen. Das Format für die Optionen ist
crypto=hash:cipher:keysize:offset:skip
wodurch Cryptsetups --hash, --cipher, --keysize, --offset und --skip Optionen dargestellt werden. Wenn eine Option ausgelassen wird, werden die Standardvariablen dafür verwendet, so dass die folgende Angabe möglich ist
crypto=::::
wenn das Volumen mit den Standardeinstellungen erstellt wurde.
'''HINWEIS:''' Aus technischen Gründen ist es nicht möglich die Korrektheit der Passphrase von veralteten Cryptsetup-Volumen zu überprüfen. Wenn die Eingabe falsch ist, wird das Einhängen einfach fehlschlagen. Es wird daher empfohlen stattdessen LUKS zu verwenden.
=== loop-aes-Volumen nutzen ===
'''mkinitcpio''' unterstützt derzeit kein loop-aes.
== Suspend to Disk nutzen ==
Wenn "suspend to disk" genutzt werden soll, muss der '''resume'''-Hook benutzt werden.
=== swsusp ===
''TODO''
=== µswsusp ===
µswsusp wird derzeit nicht unterstützt.
=== suspend2 ===
Wenn [[Suspend to Disk|suspend2]] genutzt wird, muss ''resume2'' auf der Kernel-Kommandozeile angegeben werden. Wenn auf Swap geschrieben werden soll, muss
resume2=swap:/dev/hda3
benutzt werden, wobei ''/dev/hda3'' die Swap-Partition ist. Wenn in eine Datei geschrieben werden soll, muss
resume2=file:/dev/hda2:0x123456
benutzt werden, wobei ''/dev/hda2'' die Partition ist, auf der das suspend2-Abbild gespeichert wird (meistens die root-Partition) und ''0x123456'' der
Datei-Offset. Zum Erhalten der exakten Werte wird
echo "/suspend2_file" > /proc/suspend2/filewriter_target
cat /proc/suspend2/resume2
benutzt, wobei /suspend2_file der Pfad zur suspend2-Abbilddatei ist. Das funktioniert natürlich genausogut für LVM_Volumen.
Ebenfalls kann man eine suspend-Datei auf einer verschlüsselten root-Partition mit der Option
resume2=file:/dev/mapper/root:0x123456
nutzen, wo wiederum ''0x123456'' der Offset ist. Die Wiederherstellung von einer verschlüsselten swap-Partition wird nicht unterstützt.
== Beispiele für Bootloader-Konfigurationen ==
Wenn der beyond-Kernel benutzt wird, lauten die Dateinamen jeweils ''kernel26beyond.img'' und ''kernel26beyond-fallback.img'' statt ''kernel26.img'' und ''kernel26-fallback.img''. Desweiteren muss "vmlinuz26" zu "vmlinuz26beyond" geändert werden.
=== GRUB ===
Für diejenigen, die /boot auf einer seperaten Partition benutzen:
# (0) Arch Linux
title Arch Linux
root  (hd0,3)
kernel /vmlinuz26 root=/dev/hda4 vga=791 ro
initrd /kernel26.img
title Arch Linux Fallback
root  (hd0,3)
kernel /vmlinuz26 root=/dev/hda4 vga=791 ro
initrd /kernel26-fallback.img
Für diejenigen, die /boot NICHT auf einer seperaten Partition benutzen:
# (0) Arch Linux
title Arch Linux
root  (hd0,3)
kernel /boot/vmlinuz26 root=/dev/hda4 vga=791 ro
initrd /boot/kernel26.img
title Arch Linux Fallback
root  (hd0,3)
kernel /boot/vmlinuz26 root=/dev/hda4 vga=791 ro
initrd /boot/kernel26-fallback.img
=== LILO ===
Wenn LILO benutzt wird, empfiehlt es sich, ''append="root=/dev/XYZ"'' statt ''root=/dev/XYZ'' zu verwenden. Falls bereits ein globales ''append'' benutzt wird, kann ''addappend'' verwendet werden.
boot=/dev/hdX
default = <Label des Standardimages>
timeout=50
vga=791
lba32
prompt
# für das Image mit automatischer Hardwareerkennung
image=/boot/vmlinuz26
label=ArchLinux
append="root=/dev/hdXY"
initrd=/boot/kernel26.img
read-only
# Image zum Ausweichen, falls das andere nicht funktioniert (wird wahrscheinlich nie genutzt werden)
image=/boot/vmlinuz26
label=ArchLinuxFallBack
append="root=/dev/hdXY"
initrd=/boot/kernel26-fallback.img
read-only
= Fehlerbehandlung =
== piix-ide-Controllers und beyond-Kernel ==
=== Problem (veraltet?) ===
Fall Probleme bei der Erkennung des Festplatte von mkinitcpio auftreten mit Fehlermeldungen wie z.B. "Can't find device dev(0,0)" beim Wechseln zu kinit, dann könnte das an einem Konflikt zwischen den ata_piix- und piix-Treibern iegen. Der beyond-Kernel besitzt einige libata-Patches, die zu Konflikten zwischen ata_piix und piix führen.
=== Lösung ===
Editiere /etc/mkinitcpio.conf dahingehend, dass nur ide, sata oder scsi verwendet wird, abhängig davon. was das System zum Booten benötigt.
{{ÜberFDL||Seite=http://wiki.archlinux.org|Name=ArchLinux.org Wiki|Original=http://wiki.archlinux.org/index.php?title=Configuring_mkinitcpio}}


[[Kategorie:Konfiguration]]
[[Kategorie:Konfiguration]]


 
[[en:mkinitcpio]]
== Extrahieren des Images ==
 
Falls man sich wundert, was sich innerhalb des initrd-Abbildes befindet, kann man es auspacken und in den enthaltenen Dateien herumstöbern.
 
Das initrd-Abbild ist ein 'SVR4 CPIO'-Archiv, das durch die Befehle ''find'' und ''bsdcpio'' erstellt wurde und optional durch ein vom Kernel verstandenes Komprimierungsschema komprimiert wurde: genauer gesagt gzip, bzip2, lzma, lzo oder xz.
 
mkinitcpio beinhaltet eine Werkzeug namens lsinitcpio, welches die Inhalte des initramfs-Abbildes anzeigt und extrahiert.
 
Das Anzeigen der Dateien im Abbild geschieht durch:
 
$ lsinitcpio /boot/initramfs-linux.img
 
Das Extrahieren aller Dateien in das aktuelle Verzeichnis:
 
$ lsinitcpio -x /boot/initramfs-linux.img
 
Man kann sich auch eine besser menschenlesbare Auflistung der wichtigen Teile des Abbildes anzeigen lassn:
 
$ lsinitcpio -a /boot/initramfs-linux.img

Aktuelle Version vom 5. März 2024, 23:49 Uhr

mkinitcpio ist die nächste Generation der initramfs-Erstellung. Es hat viele Vorteile gegenüber den alten Skripten mkinitrd und mkinitramfs.

  • Es nutzt klibc und kinit der Linux-Entwickler, welches eine kleine und leichtgewichtige Basis bereitstellt, um Programme sehr früh im userspace laufen zu lassen.
  • Es kann mittels udev die Hardware zur Laufzeit erkennen, so dass nur die wirklich nötigen Module geladen werden.
  • Die hook-basierenden init-Scripte sind leicht erweiterbar und können auch durch externe Pakete genutzt werden.
  • Es unterstützt bereits lvm2, dm-crypt (legacy und luks volumes), raid, swsusp und suspend2 Fortsetzen und Starten von usb Datenträgern.
  • Viele Funktionen können von der Kernel-Kommandozeile konfiguriert werden ohne das Image neu erstellen zu müssen.
  • Mit dem mkinitcpio-Skript ist es möglich, das Image in den Kernel zu integrieren.

mkinitcpio wurde von phrakture und tpowa mit Hilfe aus der Community entwickelt.

Installation

Das Programm ist als mkinitcpio in core verfügbar, und kann von dort mittels Pacman installiert werden.

pacman -S mkinitcpio

mkinitcpio ist Bestandteil jeder Arch Linux Installation.

Konfiguration

Die Konfigurationsdatei lautet /etc/mkinitcpio.conf.

MODULES

Mit dem MODULES-Eintrag können Module explizit dem Image hinzugefügt werden.

Beispiel: Bei Verwendung des nouveau Treiber wird bereits die Konsole beim Starten diesen verwenden. 

MODULES=(nouveau)

BINARIES und FILES

Mit diesen Optionen können Dateien dem Abbild hinzugefügt werden. Der einzige Unterschied zwischen BINARIES und FILES ist, dass BINARIES die Bibliotheken nach Abhängigkeiten durchsucht, während FILES nur Dateien hinzufügt.

HOOKS

Dies ist der wichtigste Teil der mkinitcpio Konfiguration. Diese Zeile enthält alle HOOKS, welche während der Imageerstellung oder zur Laufzeit ausgeführt werden. Hierbei muss die Reihenfolge beachtet werden: 

HOOKS=(foo1 foo2 bar1 bar2)

Am besten man prüft anhand des eigenen Systems, welche HOOKS aktuell verfügbar sind. Zusätzlich wird angezeigt, welche als veraltet gelten, und welche zukünftig verwendet werden sollen. 

mkinitcpio -L

Für jeden gelisteten HOOK gibt es eine Zusatzinfo. 

mkinitcpio -H base

Verfügbare HOOKS

Hook Information
base This hook provides crucial runtime necessities for booting. DO NOT remove this hook unless you know what you're doing.
udev This hook will use udev to create your root device node and detect the needed modules for your root device. It is also required for firmware loading in initramfs. It is recommended to use this hook.
microcode This hook adds early microcode update files for Intel and AMD processors. If /boot/amd-ucode.img or /boot/intel-ucode.img exist, they are included in the initcpio. If not, the individual microcode files in /lib/firmware/ are included if they exist. If the autodetect hook runs before this hook, it will only add early microcode update files for the processor of the system the image is built on.
systemd This will install a basic systemd setup in your initramfs, and is meant to replace the 'base', 'usr', 'udev' and 'timestamp' hooks. Other hooks with runtime components will need to be ported, and will not work as intended. You also may wish to still include the 'base' hook (before this hook) to ensure that a rescue shell exists on your initramfs.
modconf This hook installs modprobe configuration files from /etc/modprobe.d and /usr/lib/modprobe.d.
usr This provides a support for mounting /usr via a late running hook. No configuration is needed, as the mount options will be pulled directly from the fstab on the real root device.
autodetect This hook shrinks your initramfs to a smaller size by autodetecting the needed modules. Be sure to verify included modules are correct and none are missing. This hook must be run before other subsystem hooks in order to take advantage of auto-detection. Any hooks placed before 'autodetect' will be installed in full.
sata This hook is deprecated in favor of 'block'
scsi This hook is deprecated in favor of 'block'
usb This hook is deprecated in favor of 'block'
fw This hook is deprecated in favor of 'block'
block This hook loads the necessary modules for most block devices using pata, sata, scsi, firewire, usb, or mmc. Detection will take place at runtime. To minimize the modules in the image, add the autodetect hook too.
usbinput This hook is deprecated in favor of 'keyboard'
keyboard This hook loads the necessary modules for keyboard devices. As a side-effect modules for some non-keyboard input devices might be added to, but this should not be relied on. Detection will take place at runtime. To minimize the modules in the image, add the autodetect hook too.
filesystems This hook adds filesystems modules to the image. If you would like to minimize the modules installed in the image, add the autodetect hook too.
lvm2 This hook enables LVM2 volumes in initramfs. Do pacman -S lvm2 before.
sd-lvm2 This hook enables LVM2 volumes in systemd-based initramfs. Do pacman -S lvm2 before.
mdadm This hook loads the necessary modules for any raid root device, and assembles the raid device when run. If arrays are defined in /etc/mdadm.conf, the file will be used instead of command line assembling. Do pacman -S mdadm before. Please see mkinitcpio -H mdadm
dmraid This hook loads the necessary modules for a dmraid root device. Do pacman -S dmraid before.
encrypt This hook allows for an encrypted root device. Users should specify the device to be unlocked using 'cryptdevice=device:dmname' on the kernel command line, where 'device' is the path to the raw device, and 'dmname' is the name given to the device after unlocking, and will be available as /dev/mapper/dmname. Do pacman -S cryptsetup before. Please see mkinitcpio -H encrypt
sd-encrypt This hook allows for an encrypted root device. Users should specify the device to be unlocked using 'cryptdevice=device:dmname' on the kernel command line, where 'device' is the path to the raw device, and 'dmname' is the name given to the device after unlocking, and will be available as /dev/mapper/dmname. Do pacman -S cryptsetup before. Please see mkinitcpio -H sd-encrypt
resume This hook initializes support for resuming from Disk. Supports swsusp and suspend2.
fschk This hook provides fsck and filesystem specific helpers to perform an fsck operation on the root device prior to mounting. If the autodetect hook is used, only the fsck helper specific to your filesystem will be added to the image. It is highly recommended that if you include this hook that you also include any necessary modules to ensure your keyboard will work in early userspace. Please see mkinitcpio -H fsck
consolefont This hook loads consolefont specified in vconsole.conf during early userspace.
sd-vconsole This hook adds the keymap(s) and font specified in vconsole.conf to the image and loads them during early userspace.

Beispiele:

Diese Konfiguration sollte für die meisten Benutzer funktionieren: 

HOOKS=(base systemd autodetect modconf block filesystems sd-vconsole fsck)

Du kannst verschlüsselte Dateisysteme innerhalb von lvm nutzen: 

HOOKS=(base autodetect modconf block lvm2 encrypt filesystems keyboard consolefont fsck)

Du kannst verschlüsselte Dateisysteme innerhalb von lvm nutzen, wenn systemd im Einsatz ist: 

HOOKS=(base systemd autodetect modconf block sd-lvm2 sd-encrypt filesystems sd-vconsole fsck)

COMPRESSION

# Use this to compress the initramfs image. By default, gzip compression is used. Use 'cat' to create an uncompressed image.
COMPRESSION=(xz)

COMPRESSION_OPTIONS

# Additional options for the compressor
COMPRESSION_OPTIONS=(-9)

Erstellen des Images

Erstelle das Image mit folgendem Befehl: 

# mkinitcpio -p linux

Extrahieren des Images

Wenn du wissen möchtest, was sich innerhalb des initrd-Abbildes befindet, kann du es auspacken und in den enthaltenen Dateien herumstöbern.

Das initrd-Abbild ist ein 'SVR4 CPIO'-Archiv, das durch die Befehle find und bsdcpio erstellt wurde und optional durch ein vom Kernel verstandenes Komprimierungsschema komprimiert wurde: genauer gesagt gzip, bzip2, lzma, lzo oder xz.

mkinitcpio beinhaltet ein Werkzeug namens lsinitcpio, welches die Inhalte des initramfs-Abbildes anzeigt und extrahiert.

Das Anzeigen der Dateien im Abbild geschieht durch: 

# lsinitcpio /boot/initramfs-linux.img

Man kann sich auch eine Auflistung der wichtigen Teile des Abbildes anzeigen lassn: 

# lsinitcpio -a /boot/initramfs-linux.img

Das Extrahieren aller Dateien in das aktuelle Verzeichnis: 

# lsinitcpio -x /boot/initramfs-linux.img

Kernelzeile anpassen

Einige Optionen müssen in der Kernelzeile angegeben werden. Einige Mkinitcpio Hooks haben spezielle Optionen. Um diese soll es in diesem Abschnitt gehen.

Wenn du nicht weißt was die Kernelzeile ist, schau in die Dokumentationen von GRUB oder Syslinux.

Failsafe Modus

Wenn du 

break=y

zur Kernelzeile hinzufügst, dann stoppt Init nach dem das Setup vollständig ist und du landest in einer dash shell. Diese kann genutzt werden um sich über den Erfolg des Vorgangs zu versichern. Wenn du dich ausloggst geht der normale Bootvorgang weiter.

Hooks deaktivieren

Du kannst hooks deaktivieren indem du disablehooks zur Kernelzeile hinzufügst: 

disablehooks=hook1,hook2,hook2

zum Beispiel 

disablehooks=resume

Module blacklisten

Du kannst Module blacklisten indem du disablemodules zur Kernelzeile hinzufügst: 

disablemodules=mod1,mod2,mod3

zum Beispiel 

disablemodules=ata_piix
Abgerufen von „https://wiki.archlinux.de/index.php?title=Mkinitcpio&oldid=23999“