setboot(1M)

NAME

setboot − display and modify variables in the stable storage

SYNOPSIS

/usr/sbin/setboot

/usr/sbin/setboot [-p primary_path] [-a alternate_path] [-s on|off] [-b on|off]

DESCRIPTION

The setboot command sets the appropriate variable in the stable storage to the setboot arguments.

If no options are specified, setboot displays the current values of variables in the stable storage.

Only the superuser can write to the stable storage.

Options

The setboot command supports the following options:

-p primary_path Set the primary boot path variable to primary_path.

-a alternate_path Set the alternate boot path variable to alternate_path.

-s on|off Enable or disable the autosearch sequence.

-b on|off Enable or disable the autoboot sequence.

RETURN VALUE

The setboot command returns 0 upon successful completion or 1 if the command failed.

ERRORS

The following conditions cause errors:

Invalid option specified.

/dev/kepd file not found.

Incorrect arguments.

Must be superuser to write to the stable storage.

Boot path not in correct format.

Stable storage read/write failure.

EXAMPLES

Set the primary path to 2/4.1.0 and enable the autoboot sequence:

setboot -p 2/4.1.0 -b on

WARNINGS

The setboot command fails under the following circumstances:

• The number of writes to the stable storage exceeds the number allowed by the architecture implementation.

• Hardware failure.

• The implementation does not have memory for the alternate boot path, in which case, this variable is neither readable nor writable.

AUTHOR

setboot was developed by HP.

FILES

/dev/kepd Special device file used by the setboot command.

Museum