BRAND.4TH(7) Standards, Environments, and Macros BRAND.4TH(7)

NAME


brand.4th - loader ASCII art boot module

DESCRIPTION


The file that goes by the name of brand.4th is a set of commands designed
to draw the ASCII art illumos brand above the boot loader menu. The
commands of brand.4th by themselves are not enough for most uses. Please
refer to the examples below for the most common situations, and to
loader(7) for additional commands.

Before using any of the commands provided in brand.4th, it must be included
through the command:

include brand.4th

This line is present in the default /boot/forth/menu.rc file, so it is not
needed (and should not be re-issued) in a normal setup.

The commands provided by it are:

draw-brand Draws the illumos brand.

The brand that is drawn is configured by
setting the loader_brand variable in
loader.conf(5) to one of "illumos" (the
default) or "none".

The position of the logo can be configured by
setting the loader_brand_x and loader_brand_y
variables in loader.conf(5). The default
values are 2 (x) and 1 (y).

The environment variables that effect its behavior are:

loader_brand
Selects the desired brand in the beastie boot menu.
Possible values are: "illumos" (default) or "none".

loader_brand_x
Sets the desired column position of the brand. Default is
2.

loader_brand_y
Sets the desired row position of the brand. Default is 1.

FILES


/boot/loader The loader(7).
/boot/forth/brand.4th brand.4th itself.
/boot/loader.rc loader(7) bootstrapping script.

EXAMPLES


Set illumos brand in loader.conf(5):

loader_brand="illumos"

SEE ALSO


loader.conf(5), loader(7)

illumos July 20, 2018 illumos