MKINITCPIO(8) mkinitcpio MKINITCPIO(8) (NAME) mkinitcpio - (ramdisk) (SYNOPSIS) mkinitcpio [options] (DESCRIPTION) (initial ramdisk) . ( early userspace) init . RAID . mkinitcpio . (OPTIONS) -A, --addhooks hooks hooks () . . . . -c, --config config config . : /etc/mkinitcpio.conf. (drop-in) /etc/mkinitcpio.conf.d . -d, --generatedir directory directory initramfs . ramfs /run/initramfs/ . -D, --hookdir directory directory . -I, --include path files directories . . . : source:destination:mode. . . . -g, --generate filename CPIO filename. : no . -H, --hookhelp hookname hookname. -h, --help . -k, --kernel kernelversion kernelversion . ( x86 ) none . . -L, --listhooks . -M, --automods . mkinitcpio . . -n, --nocolor . --nopost (post hooks). -U, --uki filename (unified kernel image) filename. CPIO UEFI . initramfs cmdline . . : no. . -P, --allpresets /etc/mkinitcpio.d. -p . -p, --preset preset () initramfs preset . /etc/mkinitcpio.d ( .preset) . . -R, --remove () initramfs () . -P|--allpresets . -p|--presets -P|--allpresets . -r, --moduleroot root / . -S, --skiphooks hooks hooks () . . . -s, --save . : no . . -t, --builddir tmpdir tmpdir /tmp. tmpdir . TMPDIR . -V, --version . -v, --verbose ( ). . -z, --compress compress compress. (OPTIONS FOR UNIFIED KERNEL IMAGE) --cmdline filename . *.conf . /etc/kernel/cmdline /usr/lib/kernel/cmdline /etc/cmdline.d/*.conf /proc/cmdline . --no-cmdline . . --cmdline . --splash filename UEFI (bitmap) . --uefistub filename UEFI stub . ukify . : stub systemd-boot gummiboot. --ukiconfig filename ukify. /etc/kernel/uki.conf /usr/lib/kernel/uki.conf . ukify . --no-ukify ukify UKI . . --kernelimage filename . : /lib/modules/${KERNELVERSION}/vmlinuz /lib/modules/${KERNELVERSION}/vmlinux /boot/vmlinuz-${KERNELVERSION} /boot/vmlinux-${KERNELVERSION} /boot/vmlinuz-linux /boot/vmlinux-linux. --osrelease filename os-release . : /etc/os-release /usr/lib/os-release. (ABOUT PRESETS) (preset) . -p . .preset /etc/mkinitcpio.d /etc/mkinitcpio.d/linux.preset linux. . mkinitcpio (source) . mkinitcpio . . PRESETS . . PRESET=('custom') custom_image='/boot/custom.img' . _kver ( ALL_kver -- ) ( -k mkinitcpio). _config ( ALL_config -- ) ( -c mkinitcpio). _uki ( _uki _image ) ( -U mkinitcpio). _image ( _uki _image ) ( -g mkinitcpio). _cmdline ( ALL_cmdline ) ( --cmdline mkinitcpio). . _splash ( ALL_splash ) ( --splash mkinitcpio). . _kerneldest ( ALL_kerneldest ) . ( /boot) . KERNELDESTINATION . _options mkinitcpio . mkinitcpio ( ) ( -S hook ). (ABOUT INSTALL HOOKS) bash mkinitcpio (source) . . add_module modname modname . . add_binary binary [ destination ] [ mode ] . binary . ELF . . initramfs (mode) . binary . add_file path [ destination ] [ mode ] . . initramfs . path . add_file_early path [ destination ] [ mode ] . add_file . add_dir path . add_dir_early path . add_dir . add_full_dir directory [ glob ] [ strip_prefix ] add_file add_dir add_symlink . . glob . strip_prefix strip_prefix ( initramfs) . rootfs- overlay . add_symlink path [ link-target ] path link-target . link-target readlink(1) . . add_all_modules [ -f filter ] pattern (autodetect) . pattern . -f . add_checked_modules [ -f filter ] pattern add_all_modules autodetect . autodetect add_all_modules . add_runscript scriptname busybox ash . . add_udev_rule rule-file udev . . ( udev) . add_all_modules_from_symbol symbol paths paths symbol . add_checked_modules_from_symbol symbol paths add_all_modules_from_symbol autodetect . autodetect add_all_modules_from_symbol . add_initcpio_binary binary [ destination ] [ mode ] add_binary /usr/lib/initcpio . (hardcoding) . CPIO (ABOUT EARLY CPIO) mkinitcpio CPIO (early CPIO) . CPIO CPIO . ACPI . $EARLYROOT . (ABOUT RUNTIME HOOKS) add_runscript . . . HOOKS . run_earlyhook API . . run_hook . LVM . run_latehook . . run_cleanuphook . run_earlyhook . run_emergencyhook ( ) . . getarg argument [ default ] cmdline . argument . argument y . argument default . default . (ABOUT POST HOOKS) . kernel-install(8) mkinitcpio . . : mkinitcpio -k none -k version . : KERNELVERSION . KERNELDESTINATION . mkinitcpio -k /boot/* . . (EARLY INIT ENVIRONMENT) mkinitcpio : break[=] mkinitcpio . : premount . postmount . disablehooks=hooklist . earlymodules=modulelist . . quiet mkinitcpio . . ro (readonly) . . rw / (readwrite) . initramfs fsck . root=rootdevice init . mkinitcpio /dev/sda2 udev /dev/disk/by-label/CorsairF80-root. LABEL UUID LABEL=CorsairF80-root. util-linux 2.22 PARTUUID PARTLABEL . major/minor . rootdelay[=seconds] ( ) mkinitcpio . 10 . . rootflags=flaglist mount(8) . . rootfstype=fstype . mount(8) . rd.debug (xtrace) . rd.log rd.log=console . rd.log[=] . . (|) (OR) . quiet . kmsg|console . rd.log . console /dev/console . file /run/initramfs/init.log . kmsg /dev/kmsg ( 3.5) . /dev/kmsg (no-op) . all . mkinitcpio . . (REPRODUCIBILITY) mkinitcpio initramfs . mkinitcpio . initramfs 1970-01-01 . ( gzip xz) . lzop . . (FILES) /etc/mkinitcpio.conf mkinitcpio. /etc/mkinitcpio.conf.d (drop-in). /etc/mkinitcpio.d mkinitcpio. /etc/initcpio/install, /usr/lib/initcpio/install . /etc/initcpio/hooks, /usr/lib/initcpio/hooks . /etc/initcpio/post, /usr/lib/initcpio/post . (EXAMPLES) mkinitcpio (dry- run). . -g . mkinitcpio -p linux linux. mkinitcpio -g /boot/initramfs-linux.img -k /boot/vmlinuz-linux /boot/vmlinuz-linux. /boot/initramfs-linux.img . mkinitcpio -U /efi/EFI/Linux/systemd-linux.efi . /efi/EFI/Linux/systemd-linux.efi . mkinitcpio -U /efi/EFI/Linux/systemd-linux.efi --splash /usr/share/systemd/bootctl/splash-arch.bmp . . (SEE ALSO) mkinitcpio: initrd(4), lsinitcpio(1), mkinitcpio.conf(5), bootparam(7) (BUGS) . . (AUTHORS) mkinitcpio Arch Linux . AUTHORS . (COPYRIGHT) mkinitcpio. GPL-2.0-only. mkinitcpio 41.1 2026-08-11 MKINITCPIO(8)