Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

intro(2)

fmtmsg(3C)

gettext(3I)

setlocale(3C)

strerror(3C)

perror(3C)

NAME

perror, errno − print system error messages

SYNOPSIS

#include <stdio.h>
void perror(const char ∗s);

#include <errno.h>
int errno;

MT-LEVEL

MT-Safe

DESCRIPTION

perror() produces a message on the standard error output (file descriptor 2), 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 newline.  (However, if s is a null pointer or points to a null string, the colon is not printed.)  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. 

SEE ALSO

intro(2), fmtmsg(3C), gettext(3I), setlocale(3C), strerror(3C)

NOTES

If the application is linked with −lintl, then messages printed from this function are in the native language specified by the LC_MESSAGES locale category; see setlocale(3C). 

SunOS 5.5/SPARC  —  Last change: 22 Jan 1993

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