United States-English |
|
|
HP-UX Reference > Rrpc_gss_set_callback(3N)HP-UX 11i Version 3: February 2007 |
|
NAMErpc_gss_set_callback() — specify callback for context DESCRIPTIONA server may want to specify a callback routine so that it knows when a context gets first used. This user-defined callback may be specified through the rpc_gss_set_callback() routine. The callback routine is invoked the first time a context is used for data exchanges, after the context is established for the specified program and version. The user-defined callback routine should take the following form: bool_t callback( struct svc_req *req, gss_cred_id_t deleg, gss_ctx_id_t gss_context, rpc_gss_lock_t *lock, void **cookie); PARAMETERSrpc_gss_set_callback() takes one argument: a pointer to a rpc_gss_callback_t structure. This structure contains the RPC program and version number as well as a pointer to a user-defined callback() routine. For a description of rpc_gss_callback_t and other RPCSEC_GSS data types, see the rpcsec_gss(3N) manpage. The user-defined callback() routine itself takes the following arguments:
MULTITHREAD USAGE
These functions can be called safely in a multithreaded environment. They may be cancellation points in that they call functions that are cancel points. In a multithreaded environment, these functions are not safe to be called by a child process after fork() and before exec(). These functions should not be called by a multithreaded application that supports asynchronous cancellation or asynchronous signals. RETURN VALUErpc_gss_set_callback() returns TRUE if the use of the context is accepted; FALSE otherwise. WARNINGIf a server does not specify a callback, all incoming contexts will be accepted. Because the GSS-API is not currently exposed, the deleg and gss_context arguments are mentioned for informational purposes only, and the user-defined callback function may choose to do nothing with them. SEE ALSOrpc(3N), rpc_gss_getcred(3N), rpcsec_gss(3N). ONC+ Developer's Guide Network Working Group RFC 2078 |
Printable version | ||
|