NAME    [Toc]    [Back]

       consvar  -  Manipulate system firmware console environment
       variables

SYNOPSIS    [Toc]    [Back]

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

OPTIONS    [Toc]    [Back]

       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 variables
       supported by this platform that are not disabled.  This is
       similar  to the show SRM console command.  Save the values
       of all environment variables to non-volatile storage. Setting
  a  variable  with the -s option only updates the inmemory
 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.   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    [Toc]    [Back]

       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    [Toc]    [Back]

       Success.  Failure.

EXAMPLES    [Toc]    [Back]

       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 disabled 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    [Toc]    [Back]

       Specifies the command path.  Exception database.

SEE ALSO    [Toc]    [Back]

       Functions: getsysinfo(2), setsysinfo(2)



                                                       consvar(8)