NLSGETCALL(3N)       INTERACTIVE UNIX System       NLSGETCALL(3N)



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

          SYNOPSIS
                #include <sys/tiuser.h>

               struct t_call *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 struc-
               ture 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.

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

          SEE ALSO
               getenv(3), t_connect(3N), t_alloc(3N), t_free(3N),
               t_error(3N).
               nlsadmin(1) in the INTERACTIVE UNIX System User's/System
               Administrator's Reference Manual.

          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 appropri-
               ate netbuf structure.

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

          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.

          CAVEATS


          Rev. Networking Support Utilities                          Page 1

          NLSGETCALL(3N)       INTERACTIVE UNIX System       NLSGETCALL(3N)



               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.



















































          Rev. Networking Support Utilities                          Page 2