nlsrequest(3nsl) [opensolaris man page]

nlsrequest(3NSL)				       Networking Services Library Functions					  nlsrequest(3NSL)

NAME

       nlsrequest - format and send listener service request message

SYNOPSIS

       #include <listen.h>
       int nlsrequest(int fildes, char *service_code);
       extern int _nlslogt_errno;
       extern char *_nlsrmsg;

DESCRIPTION

       Given  a  virtual  circuit to a listener process (fildes) 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.

RETURN VALUES

       The  success  or  failure code is the integer return code from nlsrequest(). Zero indicates success, other negative  values indicate nlsre-
       quest() 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.

FILES

       /usr/lib/libnls.so.1    shared object

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       nlsadmin(1M), t_error(3NSL), t_snd(3NSL), t_rcv(3NSL), attributes(5)

WARNINGS

       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 by way of a T_LOOK error before or during the
       first t_snd() or t_rcv() call.

NOTES

       These interfaces are unsafe in multithreaded applications.  Unsafe interfaces should be called only from the main thread.

SunOS 5.11							    14 Nov 2002 						  nlsrequest(3NSL)

Check Out this Related Man Page

nlsgetcall(3NSL)				       Networking Services Library Functions					  nlsgetcall(3NSL)

NAME

       nlsgetcall - get client's data passed via the listener

SYNOPSIS

       #include <sys/tiuser.h>

       struct t_call *nlsgetcall(int fildes);

DESCRIPTION

       nlsgetcall() allows server processes started by the listener process to access the client's t_call structure, that is, the sndcall argument
       of t_connect(3NSL).

       The t_call structure returned by nlsgetcall() can be released using t_free(3NSL).

       nlsgetcall() returns the address of an allocated t_call structure or NULL if a t_call structure cannot be allocated. If the t_alloc()  suc-
       ceeds,  undefined environment variables are indicated by a negative len field in the appropriate netbuf structure.   A len field of zero in
       the netbuf structure is valid and means that the original buffer in the listener's t_call structure was NULL.

RETURN VALUES

       A NULL pointer is returned if a t_call structure cannot be allocated by t_alloc(). t_errno can be inspected for further error  information.
       Undefined environment variables are indicated by a negative length field (len) in the appropriate netbuf structure.

FILES

       /usr/lib/libnls.so.1    shared object

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       nlsadmin(1M), getenv(3C), t_alloc(3NSL), t_connect(3NSL), t_error(3NSL), t_free(3NSL), t_sync(3NSL), attributes(5)

WARNINGS

       The len field in the netbuf structure is defined as being unsigned. In order to check for error returns, it should first be cast to an int.

       The  listener process limits the amount of user data (udata) and options data (opt) to 128 bytes each.	Address data addr is limited to 64
       bytes. If the original data was longer,	no indication of overflow is given.

NOTES

       Server processes must call t_sync(3NSL) before calling this routine.

       This interface is unsafe in multithreaded applications.	Unsafe interfaces should be called only from the main thread.

SunOS 5.10							    14 Nov 2002 						  nlsgetcall(3NSL)

Linux and UNIX Man Pages

nlsrequest(3nsl) [opensolaris man page]

Check Out this Related Man Page