unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



consvar(8)							   consvar(8)



NAME

  consvar - Manipulate system firmware console environment variables

SYNOPSIS

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

OPTIONS

  -v  Verbose mode.  Prints out	the system IDs used by firmware, the current
      firmware revision, and information about the process.

  -g variable
      Get the value of the specified console environment variable.

  -s variable value
      Set the value of the specified console environment variable.

  -l  List the values of all variables supported by this platform that are
      not disabled.  This is similar to	the show SRM console command.

  -a  Save the values of all environment variables to non-volatile storage.
      Setting a	variable with the -s option only updates the in-memory copy
      of console environment variables.	 The save process could	take a long
      time on some platforms, so it is recommended that	the variables are
      saved after all set operations have been performed.

  -d  List the system and exception database information.

  -nc Do not perform value conversion.	Variables that contain device infor-
      mation 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 vari-
  ables, 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

  0 (Zero)
      Success.

  1   Failure.

EXAMPLES

   1.  To show the values of all available console variables, enter:
	    % consvar -l

   2.  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

   3.  To set the value	of boot_dev, enter the device name of the required
       boot device:
	    % consvar -s boot_dev disk0


   4.  To save the values of the variables across system resets, enter:
	    % consvar -a

   5.  If an operation fails, you can find out if it is	disabled by using the
       -v option.  For example,	to see if the bootdef_dev variable is dis-
       abled, enter:
	    % consvar -v -g bootdef_dev

   6.  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

  /sbin/consvar
      Specifies	the command path.

  //etc/fwevdb
      Exception	database.

SEE ALSO

  Functions: getsysinfo(2), setsysinfo(2)