Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

intro(2)

psignal(3)

perror(3)

NAME

perror, sys_errlist, sys_nerr − system error messages

SYNTAX

perror(s)
char *s;

int sys_nerr;
char *sys_errlist[];

DESCRIPTION

The perror subroutine produces a short error message on the standard error file describing the last error encountered during a call to the system from a C program. First the argument string s is printed, then a colon, then the message and a new line.  Most usefully, the argument string is the name of the program which incurred the error.  The error number is taken from the external variable errno which is set when errors occur but not cleared when nonerroneous calls are made.  For further information, see intro(.).

To simplify variant formatting of messages, the vector of message strings sys_errlist is provided; errno can be used as an index in this table to get the message string without the new line.  The sys_nerr is the number of messages provided for in the table; it should be checked because new error codes may be added to the system before they are added to the table. 

SEE ALSO

intro(2), psignal(3)

Subroutines

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026