nlsrequest man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

NLSREQUEST(3NSL)					      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 nlsre‐
       quest().	 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().

       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.

				 Nov 14, 2002		      NLSREQUEST(3NSL)
[top]

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net