icon Top 9 categories map      RocketAware > man pages >


Tips: Browse or Search all pages for efficient awareness of more than 6000 of the most popular reusable and open source applications, functions, libraries, and FAQs.

The "RKT couplings" below include links to source code, updates, additional information, advice, FAQs, and overviews.


Search all pages


By activity
Professions, Sciences, Humanities, Business, ...

User Interface
Text-based, GUI, Audio, Video, Keyboards, Mouse, Images,...

Text Strings
Conversions, tests, processing, manipulation,...

Integer, Floating point, Matrix, Statistics, Boolean, ...

Algorithms, Memory, Process control, Debugging, ...

Stored Data
Data storage, Integrity, Encryption, Compression, ...

Networks, protocols, Interprocess, Remote, Client Server, ...

Hard World
Timing, Calendar and Clock, Audio, Video, Printer, Controls...

File System
Management, Filtering, File & Directory access, Viewers, ...


RocketLink!--> Man page versions: OpenBSD FreeBSD Others

ERR(3)                    OpenBSD Programmer's Manual                   ERR(3)

     err, verr, errx, verrx, warn, vwarn, warnx, vwarnx - formatted error mes-

     #include <err.h>

     err(int eval, const char *fmt, ...);

     verr(int eval, const char *fmt, va_list args);

     errx(int eval, const char *fmt, ...);

     verrx(int eval, const char *fmt, va_list args);

     warn(const char *fmt, ...);

     vwarn(const char *fmt, va_list args);

     warnx(const char *fmt, ...);

     vwarnx(const char *fmt, va_list args);

     The err() and warn() family of functions display a formatted error mes-
     sage on the standard error output.  In all cases, the last component of
     the program name, followed by a colon (`:') character and a space, are
     output.  The text that follows depends on the function being called.  The
     fmt specification (and associated arguments) may be any format allowed by
     printf(3) or a simple string.

     In the case of the err(), verr(), warn(), and vwarn() functions only, the
     error message string affiliated with the current value of the global
     variable errno is output (see strerror(3));  that is, the output is as

           progname: fmt: error message string

     The counterpart functions, errx(), verrx(), warnx(), and vwarnx(), do not
     output the error message string, so the output looks like the following:

           progname: fmt

     In all cases, the output is followed by a newline character.

     The err(), verr(), errx(), and verrx() functions do not return, but exit
     with the value of the argument eval.

     Display the current errno information string and exit:

           if ((p = malloc(size)) == NULL)
                   err(1, NULL);
           if ((fd = open(file_name, O_RDONLY, 0)) == -1)
                   err(1, file_name);

     Display an error message and exit:

           if (tm.tm_hour < START_TIME)
                   errx(1, "too early, wait until %s", start_time_string);

     Warn of an error:

           if ((fd = open(raw_device, O_RDONLY, 0)) == -1)
                   warnx("%s: %s: trying the block device",
                       raw_device, strerror(errno));
           if ((fd = open(block_device, O_RDONLY, 0)) == -1)
                   err(1, "%s", block_device);

     exit(3),  perror(3),  printf(3),  strerror(3)

     The err() and warn() functions first appeared in 4.4BSD.

OpenBSD 2.6                     August 8, 1997                               2

Source: OpenBSD 2.6 man pages. Copyright: Portions are copyrighted by BERKELEY
SOFTWARE DESIGN, INC., The Regents of the University of California, Massachusetts
Institute of Technology, Free Software Foundation, FreeBSD Inc., and others.

(Corrections, notes, and links courtesy of RocketAware.com)

[Detailed Topics]
FreeBSD Sources for err(3) functions
OpenBSD sources for err(3)

[Overview Topics]

Up to: Error Handling and Logging - Handling errors and logging. (syslog, error tables, et al)
Up to: NUL Terminated String processing - NUL terminated string operations (strcpy, strlen, etc)

RocketLink!--> Man page versions: OpenBSD FreeBSD Others

Rapid-Links: Search | About | Comments | Submit Path: RocketAware > man pages > err.3/
RocketAware.com is a service of Mib Software
Copyright 1999, Forrest J. Cavalier III. All Rights Reserved.
We welcome submissions and comments