Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

spt_vfprintf(2) OSS System Calls Reference Manual

NAME

spt_vfprintf - Initiates thread-aware vfprintf( ) function

LIBRARY

G-series native OSS processes: /G/system/sysnn/zsptsrl

H-series OSS processes: /G/system/zdllnnn/zsptdll

SYNOPSIS

#include <spthread.h>

int spt_vfprintf(

FILE *stream,

const char *format,

va_list printarg);

PARAMETERS

See the vfprintf(3) reference page either online or in the Open System Services Library Calls

Reference Manual.

DESCRIPTION

This is a thread-aware version of the vfprintf() function. The ﬁle descriptor underlying the

stream must be nonblocking for this function to be thread-aware.

The following macro maps spt_vfprintf() to vfprintf( ) and has been deﬁned in spthread.h:

#deﬁne vfprintf(stream, format, printarg) \

spt_vfprintf((stream), (format), (printarg))

This macro is available only when SPT_THREAD_AWARE has been deﬁned before including

spthread.h, as follows:

#deﬁne SPT_THREAD_AWARE

RETURN VALUES

See vfprintf(3) reference page. The following also applies:

• The value of errno is never set to [EAGAIN] or [EWOULDBLOCK].

• If the ﬁle descriptor underlying stream becomes invalid (is closed by another thread), -1

is returned with an errno value of [EBADF].

• If a signal is received via he *Lpthread_kill() function and is not blocked, ignored, or

handled, -1 is returned with an errno value of [EINTR].

STANDARDS CONFORMANCE

This function is an extension to the XPG4 Version 2 speciﬁcation. Interfaces documented on this

reference page conform to the following industry standards:

• IEEE Std 1003.1c-1995, POSIX System Application Program Interface

The use of the header ﬁle spthread.h is an HP exception to the POSIX standard.

7−442 Hewlett-Packard Company 527186-023