SYSGEN(1M) (Essential Utilities) SYSGEN(1M)
NAME
sysgen - configure and generate the operating system
SYNOPSIS
Interactive:
sysgen [-lpath] [configuration]
sysgen [-lpath] -d [collection]
Non-interactive:
sysgen [-lpath] -gbi [configuration]
sysgen [-lpath] [-s|Dcollection] ... [-ccomment]
[configuration] ...
DESCRIPTION
sysgen is used to select and make modifications to the
system configuration and to create and install an operating
system based on the specified configuration. System
configuration modifications may be software changes (i.e.,
tuning the operating system), hardware changes (e.g.,
upgrades, adding or removing peripherals), or the selection
of one configuration from a list of two or more distinct
configurations available for the system (e.g., selecting
either a configuration with or without network services).
sysgen operates in both interactive and non-interactive
modes.
Interactive
If no options are specified on the command line, sysgen
displays the configuration screen and permits interactive
modification and creation of system configurations.
If a configuration or collection name is specified on the
command line, sysgen will display the collection or item
screen associated with the specified name.
The following options can be used in the interactive mode.
-l Specify a path to the sysgen library where
configuration and description information is
Page 1 May 1989
SYSGEN(1M) (Essential Utilities) SYSGEN(1M)
located. This option permits the user to override
the default value which is specified in the sh(1)
environment variable, SGLIB. If this variable is
not defined, the sysgen library path defaults to
/usr/src/uts/mot/sysgen.
-d Display the collection screen to permit interactive
modification and creation of sysgen description
information.
When exiting from an interactive sysgen session, the
following prompt is displayed for each configuration or
collection that has been modified.
Save changes to keyword? [y/n]
Type n (no) to discard modifications. Type y (yes) to save
modifications made during sysgen execution. After saving
changes to the current configuration (i.e., the
configuration with the -> cursor in the leftmost column),
the following prompt appears:
Update system configuration files? [y/n]
The system configuration files are data files generated by
sysgen prior to generating a new operating system. Whenever
the current configuration is changed (by modifying the
configuration information or by selecting a different
configuration), the system configuration files must be
regenerated to reflect the change. Type n to prevent an
update to the system configuration files and to exit sysgen.
Type y to cause the system configuration files to reflect
the new current configuration. Then the following prompt
appears:
Rebuild the operating system? [y/n]
Type n to prevent rebuilding of the operating system and to
exit sysgen. Type y to recreate the operating system. Next
the following prompt appears:
Page 2 May 1989
SYSGEN(1M) (Essential Utilities) SYSGEN(1M)
Install the new operating system to be used on the next
reboot? [y/n]
Type n to prevent an update to the operating system. Type y
to cause the operating system which was created last to be
installed on the next system reboot.
Non-interactive
Non-interactive sysgen processing accepts the following
options.
-g Generate the system configuration files based on the
current configuration which may be specified on the
command line.
-b Rebuild the operating system.
-i Install the operating system for use on the next
reboot.
-s Enable a collection in the current configuration
(i.e., the configuration specified on the sysgen
command line or the last configuration selected for
the system) and then generate the system
configuration files, rebuild the operating system,
and install it for use on the next reboot.
-D Disable a collection.
-c Change comment associated with the configuration
specified.
The -g, -b, and -i options are executed in that order but
may be specified in any order on the command line.
Page 3 May 1989
SYSGEN(1M) (Essential Utilities) SYSGEN(1M)
SCREENS
sysgen screens appear in a hierarchy:
configuration screen
collection screen
item screen
data screen
See Procedure 6.1 in the System Administrator's Guide for
screen examples.
Invoking sysgen with no options causes the configuration
screen to be displayed listing the various configurations
available for the system. Each line represents one
configuration and consists of two fields:
description keyword
The description shows the configuration associated with the
line; the keyword uniquely identifies the configuration
within sysgen. When specifying a configuration argument on
the sysgen command line (-g, -s, or no option), use the
configuration's keyword to identify the configuration. When
the configuration screen is displayed, the -> symbol points
to the current configuration.
Each configuration represented on the configuration screen
has a collection screen associated with it. To display a
collection screen, move the -> symbol to the line with the
desired configuration and type o. Each line on the
collection screen represents a collection of sysgen
descriptions and consists of two fields:
description keyword
The description specifies the collection's contents. The
keyword uniquely identifies the collection within sysgen.
When specifying a collection argument on the sysgen command
line (-d or -s option), use the collection's keyword. An
asterisk (*) in the leftmost column of a given line of the
Page 4 May 1989
SYSGEN(1M) (Essential Utilities) SYSGEN(1M)
collection screen (except with the -d option) indicates that
one or more items in the collection have been enabled for
the configuration. When a description item is enabled, the
information it contains is used to create a new operating
system.
Each collection found on the collection screen has an item
screen associated with it. To display the item screen, move
the -> symbol to the line with the desired collection and
type o. Each line of the item screen represents an item of
configuration information. There are three fields on each
item screen line:
description keyword type
The description characterizes the item; the keyword is the
item identifier, and type specifies the kind of information
associated with the item. The following item types are
defined within sysgen:
Driver Block/character device driver description.
Filesystem File system handler description.
Device Specific device or file system description.
System Devices Specification of the logical devices which
are used for necessary system functions.
Parameter Tunable parameter specification.
Processor Micro-processor identification declaration.
Non-Unique Driver
If enabled, this item forces the correct
linking of a non-table driven driver, such as
those for the clock, console, and MMU.
Probe Describe how specific register locations are
to be accessed and/or initialized on system
Page 5 May 1989
SYSGEN(1M) (Essential Utilities) SYSGEN(1M)
initialization.
Alien Handler Specify the presence of a non-C-language
exception handler.
Multiple Handler
Define multiple handlers which are associated
with a single exception.
Memory Config Portray system memory so that the system may
properly initialize and allocate memory at
system startup.
Include Generate #include directive in conf.c.
COMMANDS
This section describes user commands available when sysgen
is in interactive mode. If a command is inappropriate for a
given field or screen, sysgen indicates an error condition
by screen-flashing, bell-ringing, and/or an error message at
the bottom of the screen.
All field-oriented commands apply to the active field
displaying the -> symbol. To change the active field to a
different location on the screen, press the right-, left-,
up-, or down-arrow key, if present. The following keys can
also be used:
h Move left one field.
j Move down one line.
k Move up one line.
l (letter el) Move right one field.
Other command keys include:
H Move to the top, leftmost field.
Page 6 May 1989
SYSGEN(1M) (Essential Utilities) SYSGEN(1M)
M Move to the center, leftmost field.
L Move to the bottom, leftmost field.
<^u> Scroll up half a screen.
<^d> Scroll down half a screen.
<^f> Move forward a screen.
<^b> Move backward a screen.
<^l> (letter el) Erase and redraw the screen.
Once the -> symbol is pointing to the appropriate line or
field, type c to change the information associated with that
line or field.
c Change the active field.
If the field is part of an enable/disable list, typing c
causes the status of the current line to be toggled; i.e.,
if the line was previously enabled (displaying * at the
beginning of the line), the line is disabled and the *
disappears or vice versa. If this is a data field, typing c
causes the active field to be displayed in inverse video.
To modify the data field value, type characters appropriate
to the field: numeric characters in a numeric data field;
numeric and alphabetic characters a through f and A through
F in hexadecimal fields; any displayable characters in text
fields. Use <^h> to delete the character underneath the
cursor in a data field. Press <CR> to terminate data field
entry.
The following keys are used to open/close sysgen screens:
o Open the current field to display a new screen of
information associated with this field value. If
sysgen indicates an error condition, there is no
information associated with this field which can be
Page 7 May 1989
SYSGEN(1M) (Essential Utilities) SYSGEN(1M)
displayed.
q Close the current screen and return to the previously
opened screen.
The following command keys are appropriate for the
configuration, collection, or item screen.
a Add a new entry to this screen.
D Duplicate the entry indicated by the -> symbol.
d Delete the entry indicated by the -> symbol.
FILES
/usr/src/uts/mot/sysgen - sysgen library
/etc/sysgen - front end sh(1) procedure
SEE ALSO
config(1M).
master(4), dfile(4) in the Programmer's Reference Manual.
Page 8 May 1989