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

OSS Library Calls (g - h) getservbyport_r(3)
NAME
getservbyport_r - Gets a network service entry by port number (reentrant)
LIBRARY
G-series native OSS processes: /G/system/sysnn/zsptsrl
32-bit H-series and J-series OSS processes that do not use the Standard POSIX Thread library: |
/G/system/zdllnnn/zinetdll |
64-bit H-series and J-series OSS processes that do not use the Standard POSIX Thread library: |
/G/system/zdllnnn/yinetdll |
H-series and J-series OSS processes that use the Standard POSIX Thread library:
/G/system/zdllnnn/zsptdll
(See NOTES)
SYNOPSIS
[#include <sys/socket.h>]
#include <netdb.h>
[#include <spthread.h>] /* Required if using Standard POSIX Threads Library */
struct servent *getservbyport_r (
int port,
const char *proto,
struct servent *ret,
char *buffer,
int buflen);
PARAMETERS
port Specifies the port number for the service, in network-byte order.
proto Specifies the protocol name to use when contacting the service.
ret Points to a servent structure allocated by the caller.
buffer Points to the buffer supplied by the caller and used as a storage space for
returned data.
buflen Specifies the size of the buffer passed in bytes. For H06.21 and later H-series
RVUs and J06.10 and later J-series RVUs, HP recommends that this buffer be at
least equal to the size of the servent_data structure.
DESCRIPTION
The getservbyport_r( ) function is the reentrant version of the getservbyport() function and
performs the same function. However, the getservbyport_r( ) function uses buffers supplied by
the caller to store returned results.
The ret parameter must be a pointer to a struct servent structure allocated by the caller. On suc-
cessful completion, the function returns the protocol entry in this structure. The buffer parameter
must be a pointer to a buffer supplied by the caller. This buffer is used as storage space for the
host data. All of the pointers within the returned struct servent ret point to data stored within
this buffer. The buffer must be large enough to hold all of the data associated with the host entry.
For H06.21 and later H-series RVUs and J06.10 and later J-series RVUs, HP recommends that
the size of the buffer, indicated by the buflen parameter, be equal or greater than the size of the
servent_data structure.
If multiple threads interleave calls to getservbyname_r( ), getservbyport_r( ), getservent_r( )
and their base versions, the threads enumerate disjoint subsets of the services database.
527187-017 Hewlett-Packard Company 3−141