Mkinitcpio (Русский)

From ArchWiki
Jump to navigation Jump to search

Tango-preferences-desktop-locale.pngThis article or section needs to be translated.Tango-preferences-desktop-locale.png

Notes: please use the first argument of the template to provide more detailed indications. (Discuss in Talk:Mkinitcpio (Русский)#)

Template:Article summary start Template:Article summary text Template:Article summary heading Template:I18n entry Template:I18n entry Template:Article summary heading Template:Article summary end

Contents

Введение

mkinitcpio - следующее поколение программ для создания initramfs. У нее есть много преимуществ перед mkinitrd и mkinitramfs.

  • Использует klibc и kinit, разработанные авторами ядра Linux для уменьшения накладных расходов на ранней стадии загрузки.
  • Может использовать udev для определения апаратных средств, что предотвращает загрузки большого количества лишних модулей.
  • Возможность расширять функциональность при помощи специальных обработчиков, которые могут быть включены в другие пакеты.
  • Поддерживает lvm2, dm-crypt, raid, swsusp и suspend2 и загрузку с устройств usb mass storage.
  • Много опций передается прямо из строки аргументов ядра.
  • mkinitcpio позволяет включать образ ram-диска в образ ядра.

mkinitcpio разработан phrakture и tpowa с помощью community.

Установка mkinitcpio

Из текущего репозитория

mkinitcpio находится в репозитории current. Вы можете установить его командой

# pacman -Sy mkinitcpio

Из svn

Последнюю development версию mkinitcpio, можно получить из svn командой

# svn co http://phraktured.net/initramfs

Скрипт находится в директории initramfs/mkinitcpio.

Для ядер >=2.6.17

Будет создано 2 образа во время установки/обновления:

Если вы используете kernel26

/boot/kernel26.img --> образ с необходимыми драйверами для загрузки на этом компьютере
/boot/kernel26-fallback.img --> образ со всем драйверами

Если вы используете kernel26beyond

/boot/kernel26beyond.img --> образ с необходимыми драйверами для загрузки на этом компьютере
/boot/kernel26beyond-fallback.img --> образ со всем драйверами

Настройте свой загрузчик на использование нужного образа.

Предупреждения

Пользователям lvm2, raid и encrypt

Template:WarningBox

Пользователям более одного контроллера дисков

Template:WarningBox

Незагружаемые модули

Template:WarningBox

Редактирование файлов конфигурации

Модификация основного образа

To change the defaults for the main image edit the following file:

/etc/mkinitcpio.conf

mkinitcpio использует этот файл по умолчанию.

Редактирование fallback образа

To change the defaults for the fallback images, edit one of the following files: отредактируйте /boot/mkinitcpio.d/kernel26-fallback.conf и выставьте файл который вы отредактировали в NoUpgrade = в '/etc/pacman.conf'. Это должно быть нормально, если вы не используете специальные настройки вида lvm или raid.

Настройка обработчиков (HOOKS)

Это наиболее важная часть конфигурирования mkinitcpio. The HOOKS line contains the hooks that are executed on image creation and on runtime in the exact order they are executed. The format is like this:

HOOKS="foo1 foo2 foo3 bar1 bar2"

Доступные обработчики

Hook При установке Во время выполнения
base Устанавливает базовые каталоги, klibc и основные библиотеки. Всегда используйте его, за исключением случаев, когда вы действительно знаете, что делаете.
udev Добавляет udev в образ ram-диска Udev автоматически создает файл устройства для корня и загружает необходимые модули для его работы. Рекомендуется ипсользовать.
modload Альтернативный механизм автоопределения, но работает медленнее чем udev. Оставлен для совместимости, используйте udev вместо него.
autodetect Уменьшает размер initramfs пытаясь определить какие модули вам нужны. Проверьте список модулей которые он добавил. Он должен запускаться раньше других подсистем. Все обработчики выполняемые до него будут включать все модули.
ide Добавляет модули IDE. Используйте если ваш корневой раздел на IDE диске. Поставьте autodetect до него, для уменьшения количества модулей Загружает модули IDE. Вам потребуется udev или modload обработчики если вы не указали список модулей явно (см. секцию MODULES ниже).
pata Добавляет IDE модули. Используйте если корневой раздел - IDE диск и вы хотите использовать PATA вместо IDE. Также рекомендуется autodetect Загружает модули. Вам потребуется udev или modload если только вы не указали все в секции MODULES. PATA - новый набор IDE драйверов. При его использовании /dev/hd? меняются на /dev/sd?. См.: http://archlinux.org/news/272/
sata Добавляет SATA модули. Загружает SATA модули.
scsi Добавляет SCSI модули. Загружает SCSI модули.
usb Добавляет USB модули для usb-storage. Загружает USB модули.
usbinput Добавляет USB HID модули. Используйте если нужна USB клавиатура на ранней стадии загрузки (например для ввода пароля в режиме failsafe Загружает модули.
fw Добавляет поддержку Firewire в образ. Нужно для FW mass storage устройств. Загружает FW модули.
net Добавляет модули сетевых устройств. Для pcmcia добавьте соответствующий обработчик. Загружает модули. См. также Изменение строки параметров ядра.
pcmcia Добавляет pcmcia модули. Требует наличия pcmciautils. Загружает модули pcmcia.
dsdt Добавляет пользовательский acpi dsdt файл. Запишите свой файл в /lib/initcpio/custom.dsdt Ваш dsdt файл будет автоматически использован если он присутствует в initramfs.
filesystems Добавляет драйвера файловых систем Определяет файловые системы и загружает модули. ВНИМАНИЕ: это не работает с reiser4, вам придется добавлять драйвер этой ФС вручную.
lvm2 Добавляет поддержку lvm. Требует установленного пакета lvm2 Включает поддержку lvm
raid Добавляет модули для software raid. Требует пакет mdadm. Загружает модули и собирает raid устройства. См. секцию Изменение строки параметров ядра.
encrypt Добавляет dm-crypt модуль и программу cryptsetup. Требует установленный пакет cryptsetup. Определяет и разблокирует зашифрованый корневой раздел. См. секцию Изменение строки параметров ядра.
resume Пытается выполнить пробуждение после "suspend to disk". Работает с swsusp и suspend2. См. также Изменение строки параметров ядра.
firmware Добавляет файлы в /lib/firmware. Загружает firmware.
keymap Добавляет keymap и consolefonts из rc.conf. Загружает указанную раскладку и шрифты.

Примеры

Эта конфигурация будет работать для большинства пользователей:

HOOKS="base udev autodetect ide scsi sata filesystems"

Если вы хотите загружать систему на разных машинах используйте:

HOOKS="base udev ide scsi sata filesystems"

Вы можете использовать зашифрованные тома на lvm2:

HOOKS="base udev autodetect ide scsi sata lvm2 encrypt filesystems"

Изменение переменной MODULES

MODULES содержит список модулей для включения в образ и загрузки. Например это нужно если вы не хотите использовать udev или modload. Тогда можно добавить все нужные модули вручную:

MODULES="piix ide_disk reiserfs"
HOOKS="base autodetect ide filesystems"

NOTE: Если вам нужен reiser4, вы ДОЛЖНЫ добавить его в список модулей.

Настройка BINARIES и FILES

Эти опции добавляют в образ указанные файлы. Разница только в том, что BINARIES проверяет зависимости от библиотек, в то время как FILES просто копирует файлы.

Пример:

FILES="/etc/modprobe.conf"
BINARIES="/usr/bin/somefile"

Создание образа

Пересоздание предопределенного образа / использование предустановок

Если вы хотите перегенерировать образы, используйте команду

# mkinitcpio -p kernel26

Это пример для пакета kernel26, но вы можете выполнить аналогичную команду и для других ядер.

Если вы хотите изменить настройки образов, отредактируйте /etc/mkinitcpio.d/kernel26.preset (для пакета kernel26). Эти .preset файлы также будут использованы при обновлении ядра, не испортите их!

Вручную

Создайте образ командой:

mkinitcpio -g /boot/kernel26.img

Она создаст образ для текущего ядра в файле /boot/kernel26.img, который является образом для ядра из пакета kernel26. Пользователи kernel26beyond должны написать:

mkinitcpio -g /boot/kernel26beyond.img

Если вы хотите сгенерировать образ для ядра, которое в данный момент не загружено, используйте:

mkinitcpio -g /boot/kernel26.img -k 2.6.16-ARCH

Перегенерация fallback-образа

Замечание: Нижеследующий текст предназначен для создания образа для текущего ядра. Для других ядер используйте ключ -k.

Fallback образ должен быть уже создан если вы установили kernel26 или kernel26beyond, но в случае если вы хотите его пересоздать используйте:

mkinitcpio -c /boot/mkinitcpio.d/kernel26-fallback.conf -g /boot/kernel26.img

для beyond ядер

mkinitcpio -c /boot/mkinitcpio.d/kernel26beyond-fallback.conf -g /boot/kernel26beyond.img

См. mkinitcpio -h чтобы увидеть другие опции.

Не забудьте добавить запись в загрузчик. Просто скопируйте старую запись и измените путь к initrd. Будьте аккуратны, всегда имейте провереный вариант загрузки в списке загрузчика. Вы можете использовать mkinitcpio с любыми вариантами ядер (kernel26, kernel26-beyond...).

Изменения строки параметров ядра

Не зависимо от наличия initramfs некоторые опции приходится передавать через строку параметров ядра, как например корневое устройство. Некоторые из обработчиков mkinitcpio имеют специальные опции. Они и обсуждаются в этой главе.

Если вы не знаете, что такое строка параметров ядра, читайте документацию по GRUB или Lilo.

Вход в безотказный режим

Если Вы добавите опицю

break=y

to the kernel command line, init stops after the setup is completed and you are left with a dash shell. This can be used to verify that everything went fine. If you logout, normal boot continues.

Disabling hooks

You can disable a hook at runtime by adding the disablehooks option to the kernel command line like this:

disablehooks=hook1,hook2,hook2

for example

disablehooks=resume

Blacklisting modules

You can blacklist modules by adding the disablemodules option to the kernel command line like this:

disablemodules=mod1,mod2,mod3

for example

disablemodules=ata_piix

Using raid

First add the raid hook to the HOOKS list in /etc/mkinitcpio.conf

Kernel Parameters: Specify your md arrays with: md= parameter: (see below). Note that only adding the raid array you're booting from is enough.

 Example: md=0,/dev/sda3,/dev/sda4 md=1,/dev/hda1,/dev/hdb1

Then add the following to the kernel line in grub/menu.lst:

 Example: md=0,/dev/sda3,/dev/sda4 md=1,/dev/hda1,/dev/hdb1

So that it looks like:

 kernel /vmlinuz26beyond root=/dev/md0 ro md=0,/dev/sda1,/dev/sdb1

This will setup 2 md arrays with persistent superblocks

Setup:

 - for old raid arrays without persistent superblocks:
    md=<md device no.>,<raid level>,<chunk size factor>,<fault level>,dev0,dev1
 - for raid arrays with persistent superblocks:
    md=<md device no.>,dev0,dev1,...,devn
 - for, to assemble a partitionable array:
    md=d<md device no.>,dev0,dev1,...,devn

Parameters:

 - <md device no.> = the number of the md device: 
    0 means md0, 1 means md1, ...
 - <raid level> = -1 linear mode, 0 striped mode
    other modes are only supported with persistent super block
 - <chunk size factor> = (raid-0 and raid-1 only):
    Set  the chunk size as 4k << n.
 - <fault level> = totally ignored
 - <dev0-devn>: e.g. /dev/hda1,/dev/hdc1,/dev/sda1,/dev/sdb1

Using net

Kernel Parameters:

ip=

An interface spec can be either short form, which is just the name of an interface (eth0 or whatever), or long form. The long form consists of up to seven elements, separated by colons:

 ip=<client-ip>:<server-ip>:<gw-ip>:<netmask>:<hostname>:<device>:<autoconf>
 nfsaddrs= is an alias to ip= and can be used too.

Parameter explanation:

 <client-ip>   IP address of the client. If empty, the address will
               either be determined by RARP/BOOTP/DHCP. What protocol
               is used de- pends on the <autoconf> parameter. If this
               parameter is not empty, autoconf will be used.
 
 <server-ip>   IP address of the NFS server. If RARP is used to
               determine the client address and this parameter is NOT
               empty only replies from the specified server are
               accepted. To use different RARP and NFS server,
               specify your RARP server here (or leave it blank), and
               specify your NFS server in the `nfsroot' parameter
               (see above). If this entry is blank the address of the
               server is used which answered the RARP/BOOTP/DHCP
               request.
 
 <gw-ip>       IP address of a gateway if the server is on a different
               subnet. If this entry is empty no gateway is used and the
               server is assumed to be on the local network, unless a
               value has been received by BOOTP/DHCP.
 
 <netmask>     Netmask for local network interface. If this is empty,
               the netmask is derived from the client IP address assuming
               classful addressing, unless overridden in BOOTP/DHCP reply.
 
 <hostname>    Name of the client. If empty, the client IP address is
               used in ASCII notation, or the value received by
               BOOTP/DHCP.
 
 <device>      Name of network device to use. If this is empty, all
               devices are used for RARP/BOOTP/DHCP requests, and the
               first one we receive a reply on is configured. If you
               have only one device, you can safely leave this blank.
 
 <autoconf>	Method to use for autoconfiguration. If this is either
               'rarp', 'bootp', or 'dhcp' the specified protocol is
               used.  If the value is 'both', 'all' or empty, all
               protocols are used.  'off', 'static' or 'none' means
               no autoconfiguration.

Examples:

 ip=127.0.0.1:::::lo:none  --> Enable the loopback interface.
 ip=192.168.1.1:::::eth2:none --> Enable static eth2 interface.
 ip=:::::eth0:dhcp --> Enable dhcp protcol for eth0 configuration.

nfsroot=

If the 'nfsroot' parameter is NOT given on the command line, the default "/tftpboot/%s" will be used.

 nfsroot=[<server-ip>:]<root-dir>[,<nfs-options>]

Parameter explanation:

 <server-ip>   Specifies the IP address of the NFS server. If this field
               is not given, the default address as determined by the
               `ip' variable (see below) is used. One use of this
               parameter is for example to allow using different servers
               for RARP and NFS. Usually you can leave this blank.
 
 <root-dir>    Name of the directory on the server to mount as root. If
               there is a "%s" token in the string, the token will be
               replaced by the ASCII-representation of the client's IP
               address.
 
 <nfs-options> Standard NFS options. All options are separated by commas.
               If the options field is not given, the following defaults
               will be used:
                       port            = as given by server portmap daemon
                       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

 If you don't use nfsroot= parameter you need to set root=/dev/nfs 
 to boot from a nfs root by autoconfiguration.

Using lvm

If your root device is on lvm, you have to add the lvm2 hook. You have to pass your root device on the kernel command line in the format

root=/dev/mapper/<volume group name>-<logical volume name>

for example

root=/dev/mapper/myvg-root

Using encrypted root

If your root volume is encrypted, you need to add the encrypt hook. Then specify your root device on the kernel command line, just as if it was unencrypted.

For an encrypted partition on an sata or scsi disk:

root=/dev/sda5

For an encrypted lvm volume:

root=/dev/mapper/myvg-root

The root device will be automatically changed to /dev/mapper/root.

Using LUKS volumes

If you use LUKS for hard disk encryption, the init script will detect the encryption automatically if the encrypt hook is enabled. It will then ask for a passphrase and try to unlock the volume.

If this fails try to add you filesystem-module to the module list in /etc/mkinitcpio.conf if it's not compiled into your kernel.

Using legacy cryptsetup volumes

If you are using a legacy cryptsetup volume, you have to specify all cryptsetup options necessary to unlock it on the kernel command line. The option format is

crypto=hash:cipher:keysize:offset:skip

representing cryptsetup's --hash, --cipher, --keysize, --offset and --skip options. If you omit an option, cryptsetup's default value is used, so you can just specify

crypto=::::

if you created your volume with the default settings.

NOTE: For technical reasons, it is not possible to verify the correctness of your passphrase with legacy cryptsetup volumes. If you typed it wrong, mounting will simply fail. It is recommended that you use LUKS instead.

Using loop-aes volumes

mkinitcpio does not support loop-aes yet.

Using Suspend to Disk

If you want to use suspend to disk, you have to add the resume hook.

swsusp

TODO

µswsusp

µswsusp is not supported yet.

suspend2

If you are using suspend2, you have to specify the resume2 kernel commandline option. If you are using the swap writer, use

resume2=swap:/dev/hda3

where /dev/hda3 is your swap partition. If you want to use the filewriter, use

resume2=file:/dev/hda2:0x123456

where /dev/hda2 is the partition where the suspend2 image is stored (most likely the root partition) and 0x123456 is the file offset. You can get the exact value with the commands

echo "/suspend2_file" > /proc/suspend2/filewriter_target
cat /proc/suspend2/resume2

where /suspend2_file is the path to your suspend image file. This - of course - works for lvm volumes as well. You can also use a suspend file on an encrypted root partition with the option

resume2=file:/dev/mapper/root:0x123456

where 0x123456 is the offset again. Resuming from an encrypted swap partition is not supported.

Примеры конфигурационных файлов загрузчиков

Если Вы используете beyond kernel, замените имена фалов kernel26.img и kernel26-fallback.img на kernel26beyond.img и kernel26beyond-fallback.img соответственно. Так же замените "vmlinuz26" на "vmlinuz26beyond".

GRUB

Для тех у кого /boot на отдельном разделе диска:

# (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

Для тех у кого /boot не на отдельном разделе диска:

# (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

Если Вы используете загрузчик LILO, то рекомендуется использовать append="root=/dev/XYZ" вместо root=/dev/XYZ. Если у Вас уже есть глобальная опция append, тогда используйте addappend.

boot=/dev/hdX 
default = ArchLinux
timeout=50 
vga=791
lba32
prompt

# для образа автоопределения железа
image=/boot/vmlinuz26
label=ArchLinux
append="root=/dev/hdXY"
initrd=/boot/kernel26.img
read-only

# fallback image если другие образы не работают (Will most prob. never be used)
image=/boot/vmlinuz26
label=ArchLinuxFallBack
append="root=/dev/hdXY"
initrd=/boot/kernel26-fallback.img
read-only

Troubleshooting

piix ide controllers and beyond kernel

Problem

If you are having problems getting mkinitcpio to detect your hard drive giving errors akin to "Can't find device dev(0,0)" when switching to kinit, then this could be because of a conflict that the ata_piix and piix drivers have. The beyond kernel has some libata patches that cause ata_piix to *conflict* with piix.

Solution

Edit /etc/mkinitcpio.conf to only have ide or sata or scsi depending on what your system actually needs to boot.


Getting under the hood

If you are curious about what is inside the initrd image you can extract it and poke at the files inside of it. it is a cpio archive but...

Warning about cpio

using cpio to extract an image is dangerous, as it likes to extract the image to /, rendering your system broken and unbootable. recovery involves reinstalling the packages that own the overwritten files with pacman.static. A list of files can made with bsdtar -t -f kernel26.img

using bsdtar to extract the image

bsdtar is kind enough to extract to the current directory instead of hosing your system.

bsdtar -x -f /boot/kernel26.img