Oracle^® OpenBoot 4.x Administration Guide

Edits the NVRAMRC script to create a persistent device alias, as follows:

Creates this command line in the NVRAMRC script:

devalias alias-name device-specifier

If the NVRAMRC script already contains a devalias line with the same alias name, deletes that entry and replaces it with the new entry at the same location in the NVRAMRC script. Otherwise, places the new entry at the beginning of the script.

If there is insufficient space in the NVRAMRC script for the new devalias command, displays a message to that effect and aborts without modifying the script.

If the NVRAMRC script was successfully modified, executes the new devalias command immediately, creating a new memory-resident alias.

If the NVRAMRC script is currently being edited (that is, if nvedit has been executed, but has not been completed with either nvstore or nvquit), aborts with an error message before taking any other action.

If the NVRAMRC script was successfully modified, but use-nvramrc? is false, sets use-nvramrc? to true.

Syntax:

ok nvalias alias-name /full/pathname <eol>

Creates nonvolatile device alias, and edits the NVRAMRC script.

Performs the same function as nvalias, except that the parameters are stack strings. The alias name is specified by name string. The device specifier is specified by dev-string.

Used as: ok " new-alias" " device-specifier" $nvalias

Enters the NVRAMRC script editor (exits with ^c).

nvedit operates on a temporary buffer. If data remains in the temporary buffer from a previous nvedit command, editing resumes with those previous contents. If not, nvedit reads the contents of the NVRAMRC script into the temporary buffer and begins editing the temporary buffer.

Editing continues until ^c is typed, at which point editing ceases and normal operation of the command interpreter is resumed. The contents of the temporary buffer are not automatically saved to the NVRAMRC script. The nvstore command must be executed afterwards to save the buffer into the NVRAMRC script.

The intra-line editing keystrokes are used within the NVRAMRC script editor with some additions.

Discards the contents of nvedit temporary buffer.

Prompts for confirmation of the user’s intent to carry out this function. If confirmation is obtained, discards the nvedit temporary buffer. Otherwise, takes no further action.

Attempts to recover lost script contents.

Attempts to recover the contents of the NVRAMRC script if it has been lost as a result of the execution of set-default or set-defaults. Enters the script editor as with the nvedit command. In order for nvrecover to succeed, nvedit must not have been executed between the time that the script contents were lost and the time that nvrecover is executed.

Executes the contents of the temporary buffer.

Copies the contents of nvedit temporary buffer into the NVRAMRC script.

The nvedit temporary buffer is then cleared. Used after nvedit to save the results of an editing session into the NVRAMRC script.

Deletes nonvolatile device alias from the NVRAMRC script.

If the NVRAMRC script contains a devalias command line with the same name as alias-name, deletes that command line from the script. Otherwise, leaves the script unchanged. If the script is currently being edited (that is, nvedit has been executed, but has not been completed with either nvstore or nvquit), aborts with an error message before taking any other action.

Used as: ok nvunalias alias-name

Deletes nonvolatile device alias from the NVRAMRC script.

Performs the same function as nvunalias, except that the alias name is specified by name-string.

Used as: ok " alias-name" $nvunalias