hpux man page for rpc_gss_set_svc_name

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

DESCRIPTION
       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 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 file, or by using

       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

       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 and before These functions should not be
       called by a multithreaded application that supports asynchronous cancellation or asynchronous signals.

RETURN VALUE
       returns if it is successful; otherwise, use to get the error associated with the failure.

FILES
       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).

															  rpc_gss_set_svc_name(3N)