nlsrequest(3N)    UNIX System V(Networking Support Utilities)    nlsrequest(3N)


NAME
      nlsrequest - format and send listener service request message

SYNOPSIS
      #include <listen.h>

      int nlsrequest (int fd, char *servicecode);

      extern int nlslog, terrno;
      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.  nlsrequest 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 printable.

SEE ALSO
      nlsadmin(1), t_error(3).

FILES
      /usr/lib/libnls.a
      /usr/lib/libslan.a
      /usr/lib/libnsls.a

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

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

           2: Request message not interpretable.
           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 non-zero, nlsrequest prints error messages on stderr.
      Initially, nlslog is zero.




10/89                                                                    Page 1

nlsrequest(3N)    UNIX System V(Networking Support Utilities)    nlsrequest(3N)


NOTES
      nlsrequest 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 via a TLOOK error before or during the first tsnd or
      trcv call.
















































Page 2                                                                    10/89