nlsrequest(3N)          LIBRARY FUNCTIONS          nlsrequest(3N)



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

SYNOPSIS
     #include <listen.h>

     int nlsrequest (int fd, char *service_code);

     extern int _nlslog, 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  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.

     Postive values are error return codes from the listener pro-
     cess.  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.





                                                                1

nlsrequest(3N)          LIBRARY FUNCTIONS          nlsrequest(3N)



     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.














































                                                                2