Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

intro(2)

psignal(3)

PERROR(3)  —  C LIBRARY FUNCTIONS

NAME

perror, sys_errlist, sys_nerr, errno − system error messages

SYNOPSIS

perror(s)
char ∗s;

int sys_nerr;
char ∗sys_errlist[];

int errno;

DESCRIPTION

perror produces a short error message on the standard error describing the last error encountered during a call to a system or library function.  The argument string s is printed first, then a colon and a blank, then the message and a new-line.  To be of most use, the argument string should include the name of the program that incurred the error.  The error number is taken from the external variable errno (see intro(2)), which is set when errors occur but not cleared when non-erroneous calls are made.

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 newline.  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)

Sun Release 3.2  —  Last change: 15 April 1986

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