rpc_mgmt_is_server_listening- tells whether a server is listening for remote procedure calls
boolean32 rpc_mgmt_is_server_listening( rpc_binding_handle_t binding, unsigned32 *status);
- Specifies a server binding handle. To determine if a remote server is listening for remote procedure calls, the application specifies a server binding handle for that server. To determine if the application itself is listening for remote procedure calls, the application specifies NULL.
- Returns the status code from this routine. The status code indicates whether the routine completed successfully, or if not, why not.
Possible status codes and their meanings include:
Not authorised for operation.
Binding lacks both an object UUID and an endpoint.
In addition to the above values, status can return the value of status from an application-defined authorisation function. The prototype for such a function is defined in the authorization_fn argument description in
The rpc_mgmt_is_server_listening() routine determines whether the server specified in the binding argument is listening for remote procedure calls.
This routine returns a value of TRUE if the server has called the rpc_server_listen() routine.
Returns one of the Boolean values TRUE or FALSE.
The following table gives the interpretation of each possible combination of return value and status value.
Value Returned Status Code Explanation TRUE rpc_s_ok The specified server is listening for remote procedure calls. FALSE rpc_s_ok or
The specified server is not listening for remote procedure calls, or the server could not be reached. FALSE rpc_s_mgmt_op_disallowed Not authorised for operation.
Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.