75 lines
1.5 KiB
Groff
75 lines
1.5 KiB
Groff
.Dd October 6, 2015
|
|
.Dt UPDATE-INITRD 8
|
|
.Os
|
|
.Sh NAME
|
|
.Nm update-initrd
|
|
.Nd generate initialization ramdisk
|
|
.Sh SYNOPSIS
|
|
.Nm update-initrd
|
|
.Op Fl \-sysroot Ns "=" Ns Ar sysroot
|
|
.Sh DESCRIPTION
|
|
.Nm update-initrd
|
|
generates the
|
|
.Pa /boot/sortix.initrd
|
|
.Xr initrd 7
|
|
containing a minimal system that searches for the root filesystem and chain
|
|
boots it as described in
|
|
.Xr initrd 7
|
|
and
|
|
.Xr init 8 .
|
|
It contains an init system, fsck, filesystem drivers and configuration.
|
|
.Pp
|
|
The produced minimal system contains copies of
|
|
.Xr fstab 5 ,
|
|
.Xr extfs 8 ,
|
|
.Xr fsck.ext2 8 ,
|
|
and
|
|
.Xr init 8 .
|
|
If any of those files are updated then the
|
|
.Xr initrd 7
|
|
should be regenerated by invoking
|
|
.Nm .
|
|
.Pp
|
|
.Nm
|
|
is aware of
|
|
.Xr sysmerge 8
|
|
pending upgrades and will instead invoke the new
|
|
.Nm
|
|
in
|
|
.Pa /sysmerge
|
|
if an upgrade is pending.
|
|
.Nm
|
|
is written as a script so the initrd of the new system can produced even
|
|
across incompatible ABI changes.
|
|
.Pp
|
|
The options are as follows:
|
|
.Bl -tag -width "12345678"
|
|
.It Fl \-sysroot Ns "=" Ns Ar sysroot
|
|
Rather than generating an
|
|
.Xr initrd 7
|
|
for the root filesystem, locate files in the
|
|
.Ar sysroot
|
|
directory instead and store the result as
|
|
.Ar sysroot Ns Pa /boot/sortix.initrd .
|
|
.El
|
|
.Sh FILES
|
|
.Bl -tag -width "/sbin/fsck.ext2" -compact
|
|
.It Pa /etc/fstab
|
|
.It Pa /sbin/extfs
|
|
.It Pa /sbin/fsck.ext2
|
|
.It Pa /sbin/init
|
|
.El
|
|
.Sh EXIT STATUS
|
|
.Nm
|
|
will exit 0 on success and non-zero otherwise.
|
|
.Sh SEE ALSO
|
|
.Xr fstab 5 ,
|
|
.Xr initrd 7 ,
|
|
.Xr disked 8 ,
|
|
.Xr extfs 8 ,
|
|
.Xr init 8 ,
|
|
.Xr initrdfs 8 ,
|
|
.Xr mkinitrd 8 ,
|
|
.Xr sysmerge 8 ,
|
|
.Xr update-grub 8
|