rpc_gss_set_svc_name(3) [freebsd man page]
RPC_GSS_SET_SVC_NAME(3) BSD Library Functions Manual RPC_GSS_SET_SVC_NAME(3) NAME
rpc_gss_set_svc_name -- Associate a GSS-API service principal with an RPC service LIBRARY
RPC GSS-API Authentication Library (librpcsec_gss, -lrpcsec_gss) SYNOPSIS
#include <rpc/rpcsec_gss.h> bool_t rpc_gss_set_svc_name(const char *principal, const char *mechanism, u_int req_time, u_int program, u_int version); DESCRIPTION
This function registers a service principal which will be used to authenticate RPCSEC_GSS security contexts for a given RPC program and ver- sion. PARAMETERS
principal A string representing the service principal in the form "service@hostname" mechanism The name of the security mechanism req_time The time in seconds that the service credentials should remain valid. See gss_acquire_cred(3) for more details. principal. program RPC program number for this service version RPC program version for this service RETURN VALUES
Returns TRUE if the service principal was registered or FALSE otherwise. SEE ALSO
gss_acquire_cred(3), gssapi(3), rpc(3), rpcset_gss(3) HISTORY
The rpc_gss_set_svc_name function first appeared in FreeBSD 8.0. AUTHORS
This manual page was written by Doug Rabson <dfr@FreeBSD.org>. BSD
January 26, 2010 BSD
Check Out this Related Man Page
rpc_gss_set_svc_name(3NSL) Networking Services Library Functions rpc_gss_set_svc_name(3NSL) 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(3NSL) man page. 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 mech- anism. 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. RETURN VALUES
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 ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+ |Availability |SUNWrsg (32-bit) | +-----------------------------+-----------------------------+ | |SUNWrsgx (64-bit) | +-----------------------------+-----------------------------+ SEE ALSO
rpc(3NSL), rpc_gss_get_mechanisms(3NSL), rpc_gss_get_principal_name(3NSL), rpcsec_gss(3NSL), mech(4), attributes(5) ONC+ Developer's Guide Linn, J. RFC 2078, Generic Security Service Application Program Interface, Version 2. Network Working Group. January 1997. SunOS 5.10 5 Feb 2002 rpc_gss_set_svc_name(3NSL)