ErrorF(D3nfb)

ErrorF, Error -- issue non-fatal error message for NFB driver

Synopsis

void
ErrorF(
#if NeedVarargsPrototypes
    char * f, ...)
#else
 f, s0, s1, s2, s3, s4, s5, s6, s7, s8, s9) /* limit of ten args */
    char *f;
    char *s0, *s1, *s2, *s3, *s4, *s5, *s6, *s7, *s8, *s9;
#endif

void
Error(str)
    char *str;

Description

ErrorF( ) outputs an error message when an error condition occurs in an NFB driver, similar to the cmn_err( ) kernel function or the printf( ) library routine. Error( ) outputs an error message based on the externally variable errno, similar to the perror( ) library routine.

On SVR5 and SCO OpenServer 5, these error messages are written to to stderr. On AIX 5L, these error messages are written to the /tmp/logfile file.

Arguments

f: format string.
s0...s9: variable number of arguments. Up to ten args can be specified.
str: string containing error information.

Exit codes

None

Usage notes

Use Error( ) and ErrorF( ) for non-fatal errors that occur in NFB drivers. For fatal error conditions, use the FatalError(D3nfb) function instead.

Use ErrorF( ) for error conditions that do not issue an errno. The message should include a driver identifier, as in the following:

   ErrorF("nte: Card says it only has 0.5 meg of memory!\n"

Use Error( ) for non-fatal error conditions that do cause an errno. str should identity the driver and provide any other driver-specific information that should be printed to stderr. The contents of str will be printed, followed by a colon and the errno information. Error( ) is more commonly used in the X server code than in NFB drivers, as in the following:

   if ((fd = open ("/dev/ip", O_RDWR, 0 )) < 0)
       Error (MSGOS(XOS_2,"Getting interface configuration"));

Version applicability

These functions are supported for NFB drivers on all releases of SCO OpenServer 5, SVR5, and AIX 5L.

Platform compatibility notes

On SVR5 and SCO OpenServer 5, the error messages from these functions are written to to stderr; on AIX 5L, the error messages are written to the /tmp/logfile file.

Source files

Routine source: ./common/X11R6/programs/Xserver/os/utils.c
Driver source file: Any driver source file.

References

FatalError(D3nfb)