Guardian Native C Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

gfileno(3) Guardian Native C Library Calls Reference Manual
NAME
gfileno - Maps a stream pointer to a Guardian file number
LIBRARY
G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL
G-series native OSS processes: /G/system/sysnn/zcrtlsrl
H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll
SYNOPSIS
#include <stdio.h>
int gfileno(
FILE *stream);
PARAMETERS
stream Specifies the open stream.
DESCRIPTION
The gfileno() function returns the Guardian file number of a stream.
This function replaces calls to the fileno() and fdtogfn() functions to obtain the Guardian file
number corresponding to a file stream or file descriptor.
NOTES
The gfileno() can be called only by native processes. TNS and accelerated processes can call the
fileno( ) and fdtogfn() functions instead.
RETURN VALUES
Upon successful completion, the gfileno() function returns the Guardian file number associated
with the stream parameter. If the function is not successful, -1 is returned and errno is set.
ERRORS
If the following condition occurs, the gfileno() function sets errno to the corresponding value:
[EINVAL] The stream is an invalid Guardian stream.
STANDARDS CONFORMANCE
The gfileno() function is an HP extension to the XPG4 Version 2 specification.
3−76 Hewlett-Packard Company 527192-018