nlsgetcall(3N)                                               nlsgetcall(3N)

NAME
     nlsgetcall - get client's data passed via the listener

SYNOPSIS
     cc [flag ...] file ... -lnls [library ...]

     #include <listen.h>

     struct tcall *nlsgetcall(int fd);

DESCRIPTION
     nlsgetcall allows server processes started by the listener process to
     access the client's tcall structure, that is, the sndcall argument of
     tconnect(3N).

     The tcall structure returned by nlsgetcall can be released using
     tfree(3N).

     nlsgetcall returns the address of an allocated tcall structure or
     NULL if a tcall structure cannot be allocated. If the talloc
     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 tcall 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.

     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.

DIAGNOSTICS
     A NULL pointer is returned if a tcall structure cannot be allocated
     by talloc. terrno can be inspected for further error information.
     Undefined environment variables are indicated by a negative length
     field (len) in the appropriate netbuf structure.

NOTES
     Server processes must call tsync(3N) before calling this routine.

FILES
     /usr/lib/libnsl.so

     /usr/lib/libnls.a

SEE ALSO
     nlsadmin(1M), getenv(3C), tconnect(3N), talloc(3N), tfree(3N),
     terror(3N).




Page 1                       Reliant UNIX 5.44                Printed 11/98