nlsgetcall(3N)          NETWORK 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 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 struc-
     ture  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 appropri-
     ate netbuf structure.

FILES
     /usr/lib/libnsls.a
     /usr/lib/libslan.a
     /usr/lib/libnls.a

SEE ALSO
     nlsadmin(1),    getenv(3),    t_connect(3N),    t_alloc(3N),
     t_free(3N), t_error(3N).

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



            Last change: Networking Support Utilities           1