nlsgetcall(3N)          LIBRARY FUNCTIONS          nlsgetcall(3N)



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

SYNOPSIS
     #include <sys/tiuser.h>

     struct tcall *nlsgetcall (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 struc-
     ture  or NULL if a t_call 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
     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  talloc. t_errno can be inspected for further
     error  information.   Undefined  environment  variables  are
     indicated  by a negative length field (len) in the appropri-
     ate netbuf structure.

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
     /usr/lib/libslan.a
     /usr/lib/libnls.a





                                                                1

nlsgetcall(3N)          LIBRARY FUNCTIONS          nlsgetcall(3N)



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




















































                                                                2