403 lines
16 KiB
Plaintext
403 lines
16 KiB
Plaintext
$
|
|
$ (C) COPYRIGHT CRAY RESEARCH, INC.
|
|
$ UNPUBLISHED PROPRIETARY INFORMATION.
|
|
$ ALL RIGHTS RESERVED.
|
|
|
|
$ 'errmsg' utility message text file
|
|
$ $msg format:
|
|
$ $msg ERRMSG_MSGCODE message...
|
|
|
|
#ifndef _ERRMSG_H
|
|
#include "errmsg.h"
|
|
#endif /* _ERRMSG.H */
|
|
|
|
$ messages and explanations:
|
|
$ access() call failed
|
|
$msg CMD_ACCESS Cannot access '%s'.
|
|
$nexp CMD_ACCESS
|
|
Cannot access \*Vfile\fP.
|
|
.PP
|
|
The access system call failed to access the \*Vfile\fP.
|
|
The access system call checks a \*Vfile\fP for accessibility.
|
|
.PP
|
|
Inorder to access a \*Vfile\fP, the access system call requires
|
|
search permission to all components of the path prefix for the
|
|
\*Vfile\fP.
|
|
.PP
|
|
For a list of error conditions that will cause the access
|
|
system call to fail, see access(2).
|
|
.ME
|
|
$ ---------------------------------------------------------------------------
|
|
$ fdopen() call failed
|
|
$msg CMD_FDOPEN Cannot open '%s'.
|
|
$nexp CMD_FDOPEN
|
|
Cannot open \*Vfile\fP.
|
|
.PP
|
|
The fdopen function failed.
|
|
The fdopen function associates a stream with the given file descriptor
|
|
\*Vfildes\fP, which was obtained from a successful open, dup, creat, or
|
|
pipe system call.
|
|
.PP
|
|
Opening a file, with the fdopen function, will fail if the
|
|
\*Vtype\fP of the stream does not agree with the \*Vmode\fP of the open
|
|
file associated with the file descriptor.
|
|
.ME
|
|
$ -------------------------------------------------------------------------
|
|
$ fopen() call failed
|
|
$msg CMD_FOPEN Cannot open '%s'.
|
|
$nexp CMD_FOPEN
|
|
Cannot open \*Vfile\fP.
|
|
.PP
|
|
The fopen function failed.
|
|
The fopen function opens the specified \*Vfile\fP and associates
|
|
a stream with it.
|
|
Opening a file with write mode will create the file, if it does not
|
|
exist, or truncate the file to zero length.
|
|
.PP
|
|
Opening a file with read mode fails if the file does not exist or
|
|
the read permission is denied.
|
|
Opening a file with read/write mode fails if
|
|
the \*Vfile\fP exists and write permission is denied or
|
|
the \*Vfile\fP does not exist and the directory in which the
|
|
file is to be created does not permit writing.
|
|
The fopen function requires
|
|
search permission to all components of the path prefix for the
|
|
\*Vfile\fP.
|
|
.PP
|
|
For a list of error conditions that will cause the fopen
|
|
function to fail, see open(2).
|
|
.ME
|
|
$ -------------------------------------------------------------------------
|
|
$ fseek() call failed.
|
|
$msg CMD_FSEEK Cannot reposition file pointer in '%s'.
|
|
$nexp CMD_FSEEK
|
|
Cannot reposition file pointer in \*Vfile\fP.
|
|
.PP
|
|
The fseek function failed.
|
|
The fseek function sets the file pointer of the specified
|
|
\*Vstream\fP to the specified byte \*Voffset\fP.
|
|
.PP
|
|
The fseek function will fail if the resulting position of the
|
|
file pointer is negative.
|
|
The fseek function will also fail if the \*Vstream\fP is
|
|
associated with a terminal.
|
|
.ME
|
|
$ -------------------------------------------------------------------------
|
|
$ open() call failed.
|
|
$msg CMD_OPEN Cannot open '%s'.
|
|
$nexp CMD_OPEN
|
|
Cannot open \*Vfile\fP.
|
|
.PP
|
|
The open system call failed.
|
|
The open system call opens the specified \*Vfile\fP for reading or
|
|
writing. With the O_CREAT flag, the open system call will create
|
|
the specified \*Vfile\fP, if it does not exist; otherwise the flag
|
|
has no effect.
|
|
.PP
|
|
Opening a file with the read mode fails if the file does not exist or
|
|
the read permission is denied.
|
|
Opening a file with the read/write mode fails if
|
|
the \*Vfile\fP exists and write permission is denied or
|
|
the \*Vfile\fP does not exist and the directory in which the
|
|
file is to be created does not permit writing.
|
|
The open system call requires
|
|
search permission to all components of the path prefix for the
|
|
\*Vfile\fP.
|
|
.PP
|
|
For a list of error conditions that will cause the open
|
|
system call to fail, see open(2).
|
|
.ME
|
|
$ -------------------------------------------------------------------------
|
|
$ pclose() call failed
|
|
$msg CMD_PCLOSE Cannot close pipe.
|
|
$nexp CMD_PCLOSE
|
|
Cannot close pipe.
|
|
.PP
|
|
The pclose function failed.
|
|
.PP
|
|
The pclose function closes a pipe stream, that was opened by popen.
|
|
The pclose function waits for the associated child process to
|
|
terminate and returns the exit status of the command.
|
|
Upon successful return, the pclose function returns the termination
|
|
status of the shell that ran the command. Otherwise, pclose returns
|
|
-1 and set errno to indicate the error.
|
|
.ME
|
|
$ -------------------------------------------------------------------------
|
|
$ popen() call failed
|
|
$msg CMD_POPEN Cannot open pipe to '%s'.
|
|
$nexp CMD_POPEN
|
|
Cannot open pipe to \*Vcommand\fP.
|
|
.PP
|
|
The popen function creates a pipe
|
|
between the calling program and the \*Vcommand\fP to be executed.
|
|
The popen function allows the user to open a pipe between a
|
|
process and any other executable file.
|
|
.PP
|
|
The popen function will fail to create a pipe to the specified
|
|
\*Vcommand\fP, if the specified \*Vcommand\fP is not a valid shell
|
|
command line.
|
|
.ME
|
|
$ -------------------------------------------------------------------------
|
|
$ stat() call failed.
|
|
$msg CMD_STAT Cannot obtain file status on '%s'.
|
|
$nexp CMD_STAT
|
|
Cannot obtain file status on \*Vfile\fP.
|
|
.PP
|
|
The stat system call failed.
|
|
The stat system call obtains information about the specified \*Vfile\fP.
|
|
.PP
|
|
The stat system call will fail to obtain information about the
|
|
\*Vfile\fP if search permission is denied for a component of the
|
|
path prefix of \*Vfile\fP.
|
|
.PP
|
|
The stat system call will fail to obtain the information on a
|
|
\*Vfile\fP, if the process is not granted read permission to the
|
|
\*Vfile\fP via the security level and compartments, and the process
|
|
does not have the appropriate privilege.
|
|
.PP
|
|
For a list of error conditions that will cause the stat
|
|
system call to fail, see stat(2).
|
|
.ME
|
|
$ -------------------------------------------------------------------------
|
|
$ system(string) call failed.
|
|
$msg CMD_SYSTEM Execution of command '%s' failed.
|
|
$nexp CMD_SYSTEM
|
|
Execution of command \*Vstring\fP failed.
|
|
.PP
|
|
The system function failed.
|
|
The system function passes the \*Vstring\fP to the host
|
|
environment to be executed by a "command processor" (sh(1)) as input,
|
|
as if \*Vstring\fP had been typed as a command at a terminal.
|
|
.PP
|
|
The system function will fail if the vfork system call or
|
|
exec system call fails.
|
|
.ME
|
|
$ -------------------------------------------------------------------------$
|
|
$ tempnam() call failed
|
|
$msg CMD_TEMPNAM Failed to obtain a name for temporary file.
|
|
$nexp CMD_TEMPNAM
|
|
Failed to obtain a name for temporary file.
|
|
.PP
|
|
The tempnam function failed.
|
|
The tempnam function generates a valid file name that is not
|
|
the same as the name of an existing file and that can safely be used
|
|
for the name of a temporary file.
|
|
.PP
|
|
The tempnam function will fail if it is unable to find an
|
|
accessible directory for the temporary file.
|
|
The tempnam function first tries the directory specified by the
|
|
\*Vdir\fP argument, then the directory \*VP_tmpdir\fP
|
|
as specified in the header file stdio.h, and finally /tmp will be
|
|
tried as a last resort, if the other directories are not accessible.
|
|
If the \*VTMPDIR\fP environment variable is set to an accessible
|
|
directory, then this directory will override the other possible
|
|
directories for the location of the temporary file.
|
|
.ME
|
|
$ -------------------------------------------------------------------------$
|
|
$msg ERRMSG_CATERRUSAGE \n\
|
|
Usage: caterr [-c catfile] [-e] [-Y n,pathname] [-Y c,pathname] \n\
|
|
[-Y m,pathname] [-s [-P cpp_opts]] [msgfile]
|
|
$nexp ERRMSG_CATERRUSAGE
|
|
Usage error
|
|
.PP
|
|
Either an incomplete command line or an unrecognized option was entered
|
|
with the \*Ccaterr\fR utility.
|
|
.PP
|
|
For details about the \*Ccaterr\fR utility and options, and the following
|
|
command line:
|
|
.CS
|
|
man caterr
|
|
.ME
|
|
$ -----------------------------------------------------------------------
|
|
$msg ERRMSG_MACROACCESS Cannot access %s or it is a directory.
|
|
$nexp ERRMSG_MACROACCESS
|
|
Cannot access \*Vfile\fP or it is a directory.
|
|
.PP
|
|
The \*Caccess\fR system call determines the accessibility of the path name |
|
|
pointed to by the path argument.
|
|
The \*Caccess\fR system call requires search permission to all components
|
|
of the path prefix for the path.
|
|
Either the \*Caccess\fR system call failed to access the message macro specified
|
|
by the path or the path specified for the message macro points to a directory.
|
|
.PP
|
|
For a list of error conditions that will cause the \*Caccess\fR system call to fail,
|
|
see access(2).
|
|
.ME
|
|
$ -----------------------------------------------------------------------
|
|
$msg ERRMSG_USMID Encounter USMID line, more text is expected for $msg.
|
|
$nexp ERRMSG_USMID
|
|
Encounter USMID line, more text is expected for $msg.
|
|
.PP
|
|
While expecting more text for the $msg currently being
|
|
processed, \*Ccaterr\fR encounter an USMID line.
|
|
.ME
|
|
$ -----------------------------------------------------------------------
|
|
$msg ERRMSG_NROFFEMPTY Nroff command failed, file '%s' is empty.
|
|
$nexp ERRMSG_NROFFEMPTY
|
|
Nroff command failed, file \*Vfilename\fP is empty.
|
|
.PP
|
|
The output file produced by nroff is of zero length.
|
|
Nroff command failed to format the explanations.
|
|
.ME
|
|
$ -----------------------------------------------------------------------
|
|
$msg ERRMSG_LIBCPP Cannot access '%s'.
|
|
$nexp ERRMSG_LIBCPP
|
|
Cannot access \*Vfile\fP.
|
|
.PP
|
|
The \*Caccess\fR system call failed to access \*Vfile\fP.
|
|
In order to access a \*Vfile\fP, the \*Caccess\fR system call require search
|
|
permission to all components of the path prefix for the \*Vfile\fP.
|
|
.PP
|
|
For a list of error conditions that will cause the \*Caccess\fR system
|
|
call to fail, see access(2).
|
|
.ME
|
|
$ -----------------------------------------------------------------------
|
|
$msg ERRMSG_SYMNAME Cannot process symbolic names.
|
|
$nexp ERRMSG_SYMNAME
|
|
Cannot process symbolic names.
|
|
.PP
|
|
The \*Ccaterr\fR utility calls the C language preprocessor, cpp to
|
|
preprocess symbolic message names into message numbers.
|
|
The system call to process the symbolic names failed.
|
|
.ME
|
|
$ -----------------------------------------------------------------------
|
|
$msg ERRMSG_FOPENTEXTF Cannot open message text file '%s'.
|
|
$nexp ERRMSG_FOPENTEXTF
|
|
Cannot open message text file \*Vmsgfile\fP.
|
|
.PP
|
|
The \*Ccatxt\fR utility cannot open the input message text file you
|
|
have specified. Check the path name again and make sure that you have
|
|
read permission to the file.
|
|
The function call \*Cfopen\fR() failed.
|
|
.ME
|
|
$ -----------------------------------------------------------------------
|
|
$msg ERRMSG_SEEKLAST Cannot fseek to the last byte of file '%s'.
|
|
$nexp ERRMSG_SEEKLAST
|
|
Cannot fseek to the last byte of file \*Vfile\fP.
|
|
.PP
|
|
As part of the message text file processing, trailing blank lines
|
|
produced by nroff are removed.
|
|
An internal error occurred in repositioning the file descriptor
|
|
within the nroff output file.
|
|
The function call \*Cfseek\fR() failed.
|
|
.ME
|
|
$ -----------------------------------------------------------------------
|
|
$msg ERRMSG_SEEKBLANK fseek() error on file '%s'; file contains possibly only blank lines.
|
|
$nexp ERRMSG_SEEKBLANK
|
|
fseek() error on file \*Vfile\fP; file contains possibly only blank lines.
|
|
.PP
|
|
As part of the message text file processing, trailing blank lines
|
|
produced by nroff are removed.
|
|
From the information returned by the function call \*Cfseek\fR, the
|
|
output file produced by nroff contains only blanks lines.
|
|
The function call \*Cfseek\fR() failed.
|
|
.ME
|
|
$ -----------------------------------------------------------------------
|
|
$msg ERRMSG_TRUNCNROFF Error truncating nroff output file '%s'.
|
|
$nexp ERRMSG_TRUNCNROFF
|
|
Error truncating nroff output file \*Vfile\fP.
|
|
.PP
|
|
As part of the message text file processing, trailing blank lines
|
|
produced by nroff are removed.
|
|
An internal error occurred in truncating the nroff output file after
|
|
the blank lines are removed.
|
|
The function call \*Cftruncate\fR() failed.
|
|
.ME
|
|
$ -----------------------------------------------------------------------
|
|
$msg ERRMSG_FOPENPROCF Cannot open the now processed message file '%s'.
|
|
$nexp ERRMSG_FOPENPROCF
|
|
Cannot open the now processed message file \*Vmsgfile\fP.
|
|
.PP
|
|
An internal error occurred in opening the pre-processed message file.
|
|
The function call \*Cfopen\fR() failed.
|
|
.ME
|
|
$ -----------------------------------------------------------------------
|
|
$msg ERRMSG_EXPLAINUSAGE Usage: explain groupcode-msgnumber
|
|
$nexp ERRMSG_EXPLAINUSAGE
|
|
Usage: explain groupcode-msgnumber
|
|
.PP
|
|
Either an incomplete command line or an unrecognized option was entered
|
|
with the \*Cexplain\fR utility.
|
|
.PP
|
|
For details about the \*Cexplain\fR utility, enter the following command line:
|
|
.CS
|
|
man explain
|
|
.ME
|
|
$ -----------------------------------------------------------------------
|
|
$msg ERRMSG_MSGIDENT %s-%s is not a valid message identifier.
|
|
$nexp ERRMSG_MSGIDENT
|
|
\*Vgroupcode\fP-\*Vmsgnumber\fP is not a valid message identifier.
|
|
.PP
|
|
The message identifier specified to the \*Cexplain\fR
|
|
utility \*Vgroupcode\fP-\*Vmsgnumber\fP was not valid.
|
|
.ME
|
|
$ -----------------------------------------------------------------------
|
|
$msg ERRMSG_EXPCATOPEN Cannot open explanation catalog for message group '%s'.
|
|
$nexp ERRMSG_EXPCATOPEN
|
|
Cannot open explanation catalog for message group \*Vgroupcode\fP.
|
|
.PP
|
|
The \*Cexplain\fR utility could not access the explanation catalog
|
|
specified by the group \*Vgroup\fR.
|
|
Check the value of the NLSPATH environment variable if it is set
|
|
to ensure that the path name of the catalog is in the message system
|
|
search path.
|
|
See the \*Ccatopen\fR(3C) man page for a description of the NLSPATH variable.
|
|
The function call \*Ccatopen\fR failed.
|
|
.ME
|
|
$ -----------------------------------------------------------------------
|
|
$msg ERRMSG_NOEXPMSG No explanation available for %s-%s.
|
|
$nexp ERRMSG_NOEXPMSG
|
|
No explanation available for \*Vgroupcode\fP-\*Vmsgnumber\fP.
|
|
.PP
|
|
The \*Cexplain\fR utility could not access the explanation catalog
|
|
specified by the group \*Vgroupcode\fR or the explanation specified by
|
|
message number \*Vmsgnumber\fR was not found.
|
|
Check the value of the NLSPATH environment variable if it is set
|
|
to ensure that the path name of the catalog is in the message system
|
|
search path.
|
|
See the \*Ccatopen\fR(3C) man page for a description of the NLSPATH variable.
|
|
.ME
|
|
$ -----------------------------------------------------------------------
|
|
$msg ERRMSG_NL_MALLOC Cannot open explanation catalog, catopen() unable to allocate memory for internal structures.
|
|
$nexp ERRMSG_NL_MALLOC
|
|
Cannot open explanation catalog, catopen() unable to allocate memory for internal structures.
|
|
.PP
|
|
The \*Cexplain\fR utility cannot open the explanation catalog.
|
|
The library function call catopen() failed.
|
|
.ME
|
|
$ -----------------------------------------------------------------------
|
|
$msg ERRMSG_NL_MAXOPEN Cannot open explanation catalog, too many message catalogs are open.
|
|
$nexp ERRMSG_NL_MAXOPEN
|
|
Cannot open explanation catalog, too many message catalogs are open.
|
|
.PP
|
|
The \*Cexplain\fR utility cannot open the explanation catalog. The per
|
|
program limit NL_MAX_OPEN of open catalogs has been reached.
|
|
NL_MAX_OPENED is defined in /usr/include/nl_types.h.
|
|
.ME
|
|
$ -----------------------------------------------------------------------
|
|
$msg ERRMSG_NL_MAP Cannot open explanation catalog, mmap() cannot map the explanation catalog.
|
|
$nexp ERRMSG_NL_MAP
|
|
Cannot open explanation catalog, mmap() cannot map the explanation catalog.
|
|
.PP
|
|
The \*Cexplain\fR utility cannot open the explanation catalog. The mmap()
|
|
system call could not map the explanation catalog into memory.
|
|
.ME
|
|
$ -----------------------------------------------------------------------
|
|
$msg ERRMSG_NL_HEADER Cannot open explanation catalog, incorrect file header.
|
|
$nexp ERRMSG_NL_HEADER
|
|
Cannot open explanation catalog, incorrect file header.
|
|
.PP
|
|
The \*Cexplain\fR utility cannot open the explanation catalog. The explanation catalog header has incorrect information and could be corrupt.
|
|
$ -----------------------------------------------------------------------
|
|
$msg ERRMSG_NROFF The message file contains $nexp symbols, but '%s' cannot be found.
|
|
$nexp ERRMSG_NROFF
|
|
The message file contains $nexp symbols, but \*Vfile\fP cannot be found.
|
|
.PP
|
|
\*Ccaterr\fR found $nexp symbols in the message file. nroff is needed to
|
|
process these explanations, but could not be found. If the explanations
|
|
do not contain nroff formatting, $exp symbols may be used instead of $nexp
|
|
symbols.
|
|
.ME
|
|
|
|
|