NLSGETCALL(3N) (Networking Support Utilities) NLSGETCALL(3N)
NAME
nlsgetcall - get client's data passed via the listener.
SYNOPSIS
#include <sys/tiuser.h>
struct tcall *nlsgetcall(fd);
int fd;
DESCRIPTION
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(3N).
The t_call structure returned by nlsgetcall can be released
using t_free(3N).
nlsgetcall returns the address of an allocated t_call
structure or NULL if a t_call structure cannot be allocated.
If the t_alloc succeeds, undefined environment variables are
indicated by a negative len field in 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.
WARNING
The len 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.
SEE ALSO
nlsadmin(1), getenv(3), t_connect(3N), t_alloc(3N),
t_free(3N), t_error(3N).
DIAGNOSTICS
A NULL pointer is returned if a t_call structure cannot be
allocated by t_alloc. t_errno can be inspected for further
error information. Undefined environment variables are
indicated by a negative length field (len) in the
appropriate netbuf structure.
Page 1 May 1989
NLSGETCALL(3N) (Networking Support Utilities) NLSGETCALL(3N)
CAVEATS
The listener process limits the amount of user data (udata)
and options data (opt) to 128 bytes each. Address data addr
is limited to 64 bytes. If the original data was longer, no
indication of overflow is given.
FILES
/usr/lib/libnsl_s.a
NOTES
Server processes must call t_sync(3N) before calling this
routine.
Page 2 May 1989