nlsgetcall(3)                       CLIX                       nlsgetcall(3)



  NAME

    nlsgetcall - Allows client data to be passed with the listener

  LIBRARY

    Intergraph Device Library (libix.a)

  SYNOPSIS

    #include <sys/tiuser.h>

    struct t_call *nlsgetcall(
      int fd );

  PARAMETERS

    fd   An integer representing a file descriptor

  DESCRIPTION

    The nlsgetcall() function allows server processes started by the listener
    process to access the client's t_call structure.

    The t_call structure returned by nlsgetcall() can be released using
    t_free(3).

    The nlsgetcall() function returns the address of an allocated t_call
    structure or NULL if a t_call structure cannot be allocated.  If the
    allocation (t_alloc) is successful, undefined environment variables will
    be indicated by a negative length field (len 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

    <libnsl_s.a>

    <libslan.a>

    <libnls.a>

  NOTES

    Server processes must call t_sync() before calling this function.

  CAUTIONS

    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.




  2/94 - Intergraph Corporation                                              1

  nlsgetcall(3)                       CLIX                       nlsgetcall(3)



    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.

  RETURN VALUES

    A NULL pointer is returned if a t_call structure cannot be allocated by
    t_alloc().  Undefined environment variables are indicated by a negative
    length field (len) in the appropriate netbuf structure.

  ERRORS

    Refer to the t_errno structure for further error information.

  RELATED INFORMATION

    Functions: nlsadmin(), getenv(3), t_connect(3), t_alloc(3), t_free(3),
    t_error(3)




































  2                                              Intergraph Corporation - 2/94