nlsgetcall(3N)                 DG/UX R4.11MU05                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.

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

FILES
       /usr/lib/libnls.a

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

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


Licensed material--property of copyright holder(s)