nlsrequest(3)                       CLIX                       nlsrequest(3)



  NAME

    nlsrequest - Formats and sends the listener service request message

  LIBRARY

    Intergraph Device Library (libix.a)

  SYNOPSIS

    #include <listen.h>

    int nlsrequest(
      int fd ,
      char *service_code );

    extern int _nlslog ;
    extern t_errno ;
    extern char *_nlsrmsg; ;

  DESCRIPTION

    Given a virtual circuit to a listener process (fd) and a service code of a
    server process, nlsrequest() formats and sends a service request message
    to the remote listener process requesting that it start the given service.
    The nlsrequest function waits for the remote listener process to return a
    service request response message, which is made available to the caller in
    the static, null terminated data buffer pointed to by _nlsrmsg.  The
    service request response message includes a success or failure code and a
    text message.  The entire message is displayable.

  FILES

    /usr/lib/libnls.a

    /usr/lib/libslan.a

    /usr/lib/libnsl_s.a

  RETURN VALUES

    The success or failure code is the integer return code from nlsrequest.
    Zero indicates success, other negative values indicate nlsrequest()
    failures as follows:

    -1   Error encountered by nlsrequest, see t_errno.

    Positive values are error return codes from the listener process.
    Mnemonics for these codes are defined in listen.h.

    2   Request message not interpretable.



  2/94 - Intergraph Corporation                                              1

  nlsrequest(3)                       CLIX                       nlsrequest(3)



    3   Request service code unknown.

    4   Service code known, but currently disabled.

    If non-null, _nlsrmsg contains a pointer to a static, null terminated
    character buffer containing the service request response message.  Note
    that both _nlsrmsg and the data buffer are overwritten by each call to
    nlsrequest().

    If _nlslog is nonzero, nlsrequest displays error messages on stderr.
    Initially, _nlslog is zero.

  CAUTIONS

    The nlsrequest() function cannot always be certain that the remote server
    process has been successfully started.  In this case, nlsrequest() returns
    with no indication of an error and the caller will receive notification of
    a disconnect event with a T_LOOK error before or during the first t_snd or
    t_rcv call.

  RELATED INFORMATION

    Commands:  nlsadmin(1)

    Functions:  t_error(3)





























  2                                              Intergraph Corporation - 2/94