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 (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.

   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 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.

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

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



   7/91                                                                 Page 1