NLSREQUEST(3N) (Networking Support Utilities) NLSREQUEST(3N)
NAME
nlsrequest - format and send listener service request
message
SYNOPSIS
#include <listen.h>
int nlsrequest(fd, servicecode);
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/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
process. Mnemonics for these codes are defined in listen.h.
Page 1 May 1989
NLSREQUEST(3N) (Networking Support Utilities) NLSREQUEST(3N)
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.
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 t_snd or t_rcv call.
Page 2 May 1989