osf1 man page for consvar

consvar(8)						      System Manager's Manual							consvar(8)

NAME
       consvar - Manipulate system firmware console environment variables

SYNOPSIS
       /sbin/consvar [-v] [-nc] -g  -s	-l  -a	-d  [variable] [value]

OPTIONS
       Verbose mode.  Prints out the system IDs used by firmware, the current firmware revision, and information about the process.  Get the value
       of the specified console environment variable.  Set the value of the specified console environment variable.  List the values of all  vari-
       ables  supported by this platform that are not disabled.  This is similar to the show SRM console command.  Save the values of all environ-
       ment variables to non-volatile storage. Setting a variable with the -s option only updates the in-memory copy of console environment  vari-
       ables.	The  save process could take a long time on some platforms, so it is recommended that the variables are saved after all set opera-
       tions have been performed.  List the system and exception database information.	Do not perform value conversion.  Variables  that  contain
       device  information  have an underlying console bootstring format.  If this option is used, consvar does not convert between the Tru64 UNIX
       names for these devices, but accepts and displays the raw values.  The same goes for integer values which are converted between strings and
       hexadecimal values.

DESCRIPTION
       Use the consvar command to get, set, list, and save console environment variables available on SRM system firmware.  Some firmware versions
       on some platforms do not comply with the Alpha SRM when dealing with certain variables, or operations.  To ensure UNIX  functionality  with
       such firmware, an exception database is consulted and these operations are disabled. By default, consvar accepts and displays device values
       with Tru64 UNIX device names, or their device special file names. The raw console bootstrings can be used by providing the -nc option.  For
       information regarding the console environment variables, please refer to the Alpha System Reference Manual.

RETURN VALUES
       Success.  Failure.

EXAMPLES
       To show the values of all available console variables, enter: % consvar -l To get the value of the booted_dev variable, enter: % consvar -g
       booted_dev

	      A message similar to the following will be displayed: booted_dev = disk0 To set the value of boot_dev, enter the device name of  the
	      required boot device: % consvar -s boot_dev disk0

	      To  save the values of the variables across system resets, enter: % consvar -a If an operation fails, you can find out if it is dis-
	      abled by using the -v option.  For example, to see if the bootdef_dev variable is disabled, enter: % consvar -v -g  bootdef_dev  The
	      exception  database  can	be  printed  out  along  with the status of the current platform's console variable support by entering: %
	      consvar -v -d

FILES
       Specifies the command path.  Exception database.

SEE ALSO
       Functions: getsysinfo(2), setsysinfo(2)

																	consvar(8)