Manualshelf

rpc_gss_set_svc_name.3n (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages
12
r
rpc_gss_set_svc_name(3N) rpc_gss_set_svc_name(3N)
NAME
rpc_gss_set_svc_name() - send a principal name to a server
SYNOPSIS
#include <rpc/rpcsec_gss.h>
bool_t rpc_gss_set_svc_name(
char *principal ,
char *mechanism ,
u_int req_time ,
u_int program ,
u_int version );
DESCRIPTION
rpc_gss_set_svc_name()
sets the name of a principal the server is to represent. If a server is going
to act as more than one principal, this procedure can be invoked for every such principal.
PARAMETERS
Information on
RPCSEC_GSS data types for parameters may be found on the rpcsec_gss (3N) manpage.
principal An ASCII string representing the server’s principal name, given in the form of service@host .
mech An ASCII string representing the security mechanism in use. Valid strings may be found in
the
/etc/gss/mech file, or by using
rpc_gss_get_mechanisms().
req_time The time, in seconds, for which a credential should be valid. Note that the req_time is a hint
to the underlying mechanism. The actual time that the credential will remain valid is
mechanism dependent. In the case of kerberos the actual time will be
GSS_C_INDEFINITE.
program The RPC program number for this service.
version The RPC version number for this service.
MULTITHREAD USAGE
Thread Safe: Yes
Cancel Safe: Yes
Fork Safe: No
Async-cancel Safe: No
Async-signal Safe: No
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 VALUE
rpc_gss_set_svc_name() returns TRUE if it is successful; otherwise, use
rpc_gss_get_error() to get the error associated with the failure.
FILES
/etc/gss/mech File containing valid security mechanisms
SEE ALSO
rpc(3N), rpc_gss_get_mechanisms(3N), rpc_gss_get_principal_name(3N), rpcsec_gss(3N), mech(4).
ONC+ Developer’s Guide
Network Working Group RFC 2078
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (2 pages)