C H A P T E R 4 - kixnrfs Messages

C H A P T E R 4

kixnrfs Messages

This chapter describes the messages generated by kixnrfs, the Sun MTP Native Recovery File System (NRFS) configuration utility. It also describes the system error messages that appear when an operating system problem has occurred.

`kixnrfs` Error Messages

The messages described in this section are generated by the kixnrfs utility.

Blocks exceed the limit. $KIXSYS

Description: An attempt was made to define a region that will exceed the total number of blocks available. The $KIXSYS variable is replaced with the -k value of the offending command.

Solution: Correct the error and retry the command.

Blocks overlap other regions. $KIXSYS

Description: An attempt was made to create or append a region that overlaps a previously defined region. The $KIXSYS variable is replaced with the -k value of the offending command.

Solution: Correct the error and retry the command.

Device devname blocks offset is not a valid NRFS directory.

Description: An incorrect value for the -z offset option was specified. The -z option specifies the location of the NRFS directory. If this value is incorrect, the directory is not found and the program aborts.

Solution: This error should not occur. The -z option is no longer valid on the kixnrfs command.

Duplicate entries found in NRFS directories. $KIXSYS

Description: Two or more NRFS regions were defined for the same value of the $KIXSYS variable. The value of $KIXSYS in the error message displays the duplicate entry.

Solution: Correct the error and retry the command.

Illegal options.

Description: An illegal option was entered on the command line. The only legal options are -a, -c, -d, and -r.

Solution: Correct the error and retry the command.

"-k kixsys" is not in the NRFS directory.

Description: An unsupported value for the -k option was specified when either the -d or -r options are used. The value for the -k option must correspond to an existing NRFS directory entry.

Solution: Correct the error and retry the command.

-l parameter is not required, ignored.

Description: The -l parameter was included with the -d or -r options. The program continues operation, ignoring the -l information.

Solution: None required.

-n is a required parameter for the -c option.

Description: This message displays when an attempt is made to use the -c option, without specifying a value for the -n parameter. This parameter is required to correctly configure the NRFS.

Solution: Correct the error and retry the command.

- s parameter is not required, ignored.

Description: The -s parameter was included with the -d or -r options. The program continues operation, ignoring the -s information.

Solution: None required.

The -a, -c, -d, and -r options are mutually exclusive.

Description: More than one option was used on the same command line.

Solution: Split the command into option groups and execute the kixnrfs command once for each different option.

The -k, -s, and -l parameters must be used together.

Description: An attempt was made to use either the -c or -a options, without completely specifying the -k, -s, and -l parameters for an Sun MTP application. The -s and -l parameters are only required when the NRFS is being created or appended.

Solution: Specify the -k, -s, and -l parameters for each Sun MTP application that is to be supported.

Warning: Device devname has been used for NRFS.Do you really want to re-configure NRFS? Y/N =

Description: The -c option was specified with a device (devname) and -n parameter that correspond to a previously defined NRFS.

Solution: Type Y to the question to allow the program to execute, thereby reconfiguring the NRFS on devname. Type N to abort the program.

`kixnrfs` System Messages

The following messages are system error messages, and appear when a problem has occurred within the UNIX system. In most cases, these errors are caused by an incorrect device name, or the specified device is not mounted.

Close [read | write] failed, devname= devname, errno= errorno.
lseek failed, devname= devname, errno= errorno.
Open [read | write] failed, devname= devname, errno= errorno.
Read failed, devname= devname, errno= errorno.
Write failed, devname= devname, errno= errorno.

Description: If any of these messages appear and the cause is not related to an incorrect device name or an unmounted device, the problem is related to the UNIX system.

Solution: Report the problem to your system administrator.

Copyright © 2004, Sun Microsystems, Inc. All rights reserved.