f2d50bbf9c
This change implements a dependency tracking daemon(7) system in init with overridable init(5) configuration, parallel startup, readiness signaling, rotating logs, reliable stopping, and handling of leaked processes. The /etc/init/target file is replaced by the new /etc/init/default per the new init(5) format. The old configuration is migrated upon upgrade using an upgrade hook. extfs(8) now signals readiness using READYFD for fast mounting. Filesystems that fail to be repaired are now mounted read-only. The mounting and filesystem checking code is synchronized with sysinstall. The duplicated array_add utility function now protects against overflows. tix-iso-bootconfig(8) gains the --init-target option. tix-iso-liveconfig(8) gains the --daemons option.
102 lines
2.9 KiB
Groff
102 lines
2.9 KiB
Groff
.Dd February 4, 2018
|
|
.Dt TIX-ISO-LIVECONFIG 8
|
|
.Os
|
|
.Sh NAME
|
|
.Nm tix-iso-liveconfig
|
|
.Nd generate additional live environment configuration for Sortix .iso releases
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl \-daemons Ns = Ns Ar daemons
|
|
.Op Fl \-hostname Ns = Ns Ar hostname
|
|
.Op Fl \-kblayout Ns = Ns Ar kblayout
|
|
.Op Fl \-videomode Ns = Ns Ar videomode
|
|
.Ar output-directory
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
generates additional live environment configuration for Sortix .iso releases
|
|
that can be overlaid onto the live environment filesystem by making an archive
|
|
of it and loading it as an initrd in the .iso bootloader configuration.
|
|
An release .iso can be modified to contain this additional live environment
|
|
configuration by using
|
|
.Xr tix-iso-bootconfig 8
|
|
to add an initrd of it in the additional bootloader configuration, and then
|
|
using
|
|
.Xr tix-iso-add 8
|
|
to add the additional bootloader configuration to the release .iso.
|
|
.Pp
|
|
.Nm
|
|
creates the
|
|
.Ar output-directory
|
|
directory if it doesn't already exist and populates it with the requested
|
|
additional configuration for the live environment.
|
|
By default, it doesn't make any directories or files inside the
|
|
.Ar output-directory
|
|
directory.
|
|
.Pp
|
|
This script is designed to be convenient when modifying a Sortix release .iso as
|
|
part of the
|
|
.Xr release-iso-modification 7
|
|
procedure.
|
|
The user is free to take all its actions themselves if it doesn't meet their
|
|
needs, or to make changes to the output after running the script.
|
|
These configuration changes apply only to the live environment, not to any
|
|
installations made from inside it.
|
|
.Pp
|
|
The options are as follows:
|
|
.Bl -tag -width "12345678"
|
|
.It Fl \-daemons Ns = Ns Ar daemons
|
|
Configures the
|
|
.Sy local
|
|
daemon to optionally depend on each of the
|
|
.Ar daemons
|
|
in
|
|
.Pa output-directory/etc/init/local .
|
|
(See
|
|
.Xr init 5 )
|
|
.It Fl \-hostname Ns = Ns Ar hostname
|
|
Set the live environment's hostname by writing
|
|
.Ar hostname
|
|
to
|
|
.Pa output-directory/etc/hostname .
|
|
(See
|
|
.Xr hostname 5 )
|
|
.It Fl \-kblayout Ns = Ns Ar kblayout
|
|
Set the live environment's keyboard layout by writing
|
|
.Ar kblayout
|
|
to
|
|
.Pa output-directory/etc/kblayout .
|
|
(See
|
|
.Xr kblayout 5 )
|
|
.It Fl \-videomode Ns = Ns Ar videomode
|
|
Set the live environment's graphics resolution by writing
|
|
.Ar videomode
|
|
to
|
|
.Pa output-directory/etc/videomode .
|
|
(See
|
|
.Xr videomode 5 )
|
|
.El
|
|
.Sh EXIT STATUS
|
|
.Nm
|
|
will exit 0 on success and non-zero otherwise.
|
|
.Sh EXAMPLES
|
|
This section contains examples of how one can modify a release .iso.
|
|
.Ss Hostname, Keyboard Layout, and Graphics Resolution
|
|
To customize the live environment of a release with a custom hostname, custom
|
|
keyboard layout, and custom graphics resolution:
|
|
.Bd -literal
|
|
tix-iso-liveconfig \\
|
|
--hostname=dragon \\
|
|
--kblayout=dk \\
|
|
--videomode=1920x1080x32 \\
|
|
liveconfig
|
|
tix-iso-bootconfig --liveconfig=liveconfig bootconfig
|
|
tix-iso-add sortix.iso bootconfig
|
|
.Ed
|
|
.Sh SEE ALSO
|
|
.Xr xorriso 1 ,
|
|
.Xr hostname 5 ,
|
|
.Xr kblayout 5 ,
|
|
.Xr videomode 5 ,
|
|
.Xr release-iso-modification 7 ,
|
|
.Xr tix-iso-add 8 ,
|
|
.Xr tix-iso-bootconfig 8
|