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