nlsrequest(3N)                                               nlsrequest(3N)

NAME
     nlsrequest - format and send listener service request message

SYNOPSIS
     cc [flag ...] file ... -lnls [library ...]

     #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 until it receives a service request
     response message from the listener process. This response 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 readable text message. The entire mes-
     sage is printable.

DIAGNOSTICS
     The success or failure code is the integer return code from nlsre-
     quest. Zero indicates success, other negative values indicate nlsre-
     quest failures as follows:

     -1   Error encountered by nlsrequest, see terror(3N).

     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.








Page 1                       Reliant UNIX 5.44                Printed 11/98

nlsrequest(3N)                                               nlsrequest(3N)

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

FILES
     /usr/lib/libnsl.so

     /usr/lib/libnls.a

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








































Page 2                       Reliant UNIX 5.44                Printed 11/98