nlsgetcall(3N)                                        nlsgetcall(3N)


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

       SYNOPSIS
             cc [options] file -lnls -lnsl
             #include <listen.h>
             #include <sys/xti>
             struct t_call *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
             structure 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.so
             /usr/lib/libnls.a

          Return Values
             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 appropriate
             netbuf structure.

       REFERENCES
             getenv(3C), nlsadmin(1M), t_alloc(3N), t_connect(3N),
             t_error(3N), t_free(3N)

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




                           Copyright 1994 Novell, Inc.               Page 1

      nlsgetcall(3N)                                        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.

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









































                          Copyright 1994 Novell, Inc.               Page 2