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

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

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

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







10/89                                                                    Page 1