HPlogo HP-UX Reference Volume 4 of 5 > t

t_strerror(3)

» 

Technical documentation

Complete book in PDF

 » Table of Contents

 » Index

NAME

t_strerror() — produce an error message string

SYNOPSIS

#include <xti.h> /* for X/OPEN Transport Interface - XTI */ int *t_strerror (errnum); int errnum; struct info *info;

DESCRIPTION

The t_strerror() function maps the error number in errnum that corresponds to an XTI error to a language-dependent error message string and returns a pointer to the string. The string pointed to will not be modified by the program, but may be overwritten by a subsequent call to the t_strerror() function. The string is not terminated by a newline character. The language for error message strings written by t_strerror() is implementation-defined. If it is English, the error message string describing the value in t_errno is identical to the comments following the t_errno defined in <xti.h>. If an error code is unknown, and the language is English, t_strerror() returns the string:

"error: error unknown"

where error is the error number supplied as input. In other languages, an equivalent text is provided.

Thread-Safeness

The t_strerror() function is safe to be called by multithreaded applications, and it is thread-safe for both POSIX Threads and DCE User Threads. It has a cancellation point. It is neither async-cancel safe nor async-signal safe. Finally, it is not fork-safe.

Valid Status

All - apart from T_UNINIT

RETURN VALUE

The function t_strerror() returns a pointer to the generated message string.

SEE ALSO

t_error(3).

© Hewlett-Packard Development Company, L.P.