nlsrequest(3N)                 DG/UX 5.4R3.00                 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.

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.

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

SEE ALSO
       nlsadmin(1M), terror(3N).

WARNING
       nlsrequest cannot always be certain that the remote server process
       has been successfully started.  In this case, nlsrequest returns with



Licensed material--property of copyright holder(s)                         1

nlsrequest(3N)                 DG/UX 5.4R3.00                 nlsrequest(3N)


       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.






















































Licensed material--property of copyright holder(s)                         2