*** UNIX MANUAL PAGE BROWSER ***

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] FLAGS 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 spec- ified 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 flag only updates the in-memory copy of console environment variables. The save process could take a long time on some platforms, so it is recom- mended 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 flag is used, consvar does not convert between the Digital UNIX names for these de- vices, but accepts and displays the raw values. The same goes for in- teger values which are converted between strings and hexadecimal val- ues. DESCRIPTION Use the consvar command to get, set, list, and save console environ- ment variables available on SRM system firmware. Some firmware ver- sions 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 opera- tions are disabled. By default, consvar accepts and displays device values with Digital UNIX device names, or their device special file names. The raw console bootstrings can be used by providing the -nc flag. For information regarding the console environment variables, please refer to the Alpha System Reference Manual. 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 To set the value of boot_dev, enter one of the following commands: % consvar -s boot_dev rz1 % consvar -s boot_dev /dev/rz1a % consvar -s boot_dev tu0 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 flag. 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 con- sole variable support by entering: % consvar -v -d RETURN VALUES 0 - Success 1 - Failure FILES Specifies the command path. Exception database. RELATED INFORMATION Commands: getsysinfo(2), setsysinfo(2). delim off consvar(8)