NAME¶
quik.conf - Configuration file for PowerMac/Linux disk bootstrap
DESCRIPTION¶
The
/etc/quik.conf file is read by the second-stage bootstrap (see
bootstrap(8)). It allows the user to customize various aspects of the
second-stage bootstrap's behaviour, and to specify various programs (referred
to in the configuration file as
images) which can be booted using just
a shorthand label. (Other programs not listed in the configuration file can
also be booted, but the user must enter the path name for the program rather
than just a shorthand label.)
The configuration file is parsed into tokens separated by white space or the
equals sign. Comments begin with a hash character and continue to the end of
the line. Words containing whitespace or other special characters should be
surrounded by double quotes, or the special characters should be quoted by
preceding them with a backslash.
The configuration file is structured as a list of global options, followed by a
list of images, each of which can have local options. Local options are used
when the corresponding image is booted, and override the global options. Each
image option in the configuration file defines a new image, and options
between that and the next
image option are local options for that
image. Options before the first
image option are global options.
There are two kinds of options: flag options and string options. Flag options
are specified simply by giving the option name. String options are specified
by giving the option name, an equals sign, and the value (as a single token).
Whitespace around the equals sign is ignored.
OPTIONS¶
- device=path
- Specifies the Open Firmware name of the default disk to use if no explicit
device name is given in the image path. If this is not specified, the boot
device (the device from which Open Firmware loaded the first-stage
bootstrap) is used.
partition=partno Specifies which partition to use if no explicit
partition number is given in the image path. If this is not specified, the
default is to use the first bootable partition on the device.
default=label Specifies the default image to boot if no image name
or label is entered by the user or specified via the Open Firmware
boot-file variable.
Label can be either a path name or a
shorthand label. This is a global option only.
timeout=n Specifies the timeout period for the second-stage
bootstrap to wait for the user to type a command line.
N is a decimal
integer specifying the timeout period in units of 0.1 seconds. This is a
global option only.
init-message=string Specifies a string to print out when the
second-stage bootstrap starts. This is a global option only.
message=path Specifies the path name for a file to print out when
the second-stage bootstrap starts, before it prompts the user for a command
line. This is a global option only.
root=string Specifies that the argument
root=string
should be inserted in the arguments to the kernel being booted, before the
arguments specified by the user.
ramdisk=string Specifies that the argument
ramdisk=string should be inserted in the arguments to the kernel
being booted, before the arguments specified by the user.
read-only Specifies that the argument
ro should be inserted in the
arguments to the kernel being booted, before the arguments specified by the
user.
read-write Specifies that the argument
rw should be inserted in
the arguments to the kernel being booted, before the arguments specified by
the user.
append=string Specifies that the argument
string should be
inserted in the arguments to the kernel being booted, before the arguments
specified by the user.
literal=string Specifies that the argument
string followed
by the arguments (if any) specified by the user should be the only arguments
passed to the kernel being booted (thus overriding the
root and similar
options). This is a local option only.
image=path Specifies the path for an program which can be booted.
Options from here until the next
image option are local options for
this program. If the image name begins with a dollar sign ($), the rest of the
image name is taken as a forth command which will be executed by Open
Firmware, instead of loading and running an executable program.
initrd=path Specifies the path for the initrd to be loaded.
label=label Specifies that
label is a shorthand name for
the current image. This is a local option only.
alias=label Specifies that
label is an alternative
shorthand name for the current image. This is a local option only.
pause-after Specifies that the second-stage bootstrap should pause after
loading the program and before transferring control to it. The second-stage
bootstrap pauses by transferring control to Open Firmware; the user can
transfer control back with the
go command (i.e. forth word).
pause-message=string Specifies the message that the second-stage
bootstrap should print after loading the program and before waiting for the
user to press a key. Only useful when the
pause-after option is given.
init-code=string Specifies that the second-stage bootstrap should
call Open Firmware to execute the string given (a series of forth commands)
before printing the boot prompt. This is a global option only.
SEE ALSO¶
bootstrap(8)