NLSREQUEST(3N-SVR4) RISC/os Reference Manual  NLSREQUEST(3N-SVR4)



NAME
     nlsrequest - format and send listener service request mes-
          sage

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 pro-
     cess 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/libnsl_s.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.




                        Printed 11/19/92                   Page 1

NLSREQUEST(3N-SVR4) RISC/os Reference Manual  NLSREQUEST(3N-SVR4)



     If _nlslog is non-zero, nlsrequest prints error messages on
     stderr.  Initially, _nlslog is zero.

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














































 Page 2                 Printed 11/19/92