NLSGETCALL(3NSL) Networking Services Library Functions NLSGETCALL(3NSL)
nlsgetcall - get client's data passed via the listener
#include <sys/tiuser.h> struct t_call *nlsgetcall
allows server processes started by the listener process to
access the client's t_call
structure, that is, the sndcall
argument of t_connect(3NSL)
structure returned by nlsgetcall()
can be released using t_free(3NSL)
returns the address of an allocated t_call
structure or NULL
if a t_call
structure cannot be allocated. If the t_alloc()
undefined environment variables are indicated by a negative len
the appropriate netbuf
structure. A len
field of zero in the netbuf
structure is valid and means that the original buffer in the listener's t_call
structure was NULL.
A NULL pointer is returned if a t_call
structure cannot be allocated by t_alloc()
can be inspected for further error information.
Undefined environment variables are indicated by a negative length field
) in the appropriate netbuf
for descriptions of the following attributes:
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|MT-Level | Unsafe |
SEE ALSO getenv(3C)
field in the netbuf
structure is defined as being unsigned. In
order to check for error returns, it should first be cast to an int.
The listener process limits the amount of user data (udata
) and options
) to 128 bytes each. Address data addr
is limited to 64 bytes.
If the original data was longer, no indication of overflow is given.
Server processes must call t_sync(3NSL)
before calling this routine.
This interface is unsafe in multithreaded applications. Unsafe
interfaces should be called only from the main thread.
November 14, 2002 NLSGETCALL(3NSL)