Networking Services Library Functions  rpcgsssetsvcname(3NSL)



NAME
     rpcgsssetsvcname - send a principal name to a server

SYNOPSIS
     #include 

     boolt rpcgsssetsvcname(char *principal, char *mechanism,
          uint reqtime,uint program, uint version);


DESCRIPTION
     rpcgsssetsvcname() 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 RPCSECGS data types for parameters  may  be
     found on the rpcsecgss(3NSL) man page.

     principal    An ASCI string representing the server's prin-
                  cipal name, given in the form of service@host.


     mech         An  ASCI  string  representing  the   security
                  mechanism  in  use.  Valid strings may be found
                  in  the  /etc/gss/mech  file,   or   by   using
                  rpcgssgetmechanisms().


     reqtime     The time, in seconds, for  which  a  credential
                  should  be  valid.  Note that the reqtime 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 GSCINDEFINITE.


     program      The RPC program number for this service.


     version      The RPC version number for this service.


RETURN VALUES
     rpcgsssetsvcname() returns  TRUE if  it  is  successful;
     otherwise, use  rpcgssgeterror() to get the error associ-
     ated with the failure.

FILES
     /etc/gss/mech    File containing valid security mechanisms




SunOS 5.11           Last change: 5 Feb 2002                    1






Networking Services Library Functions  rpcgsssetsvcname(3NSL)



ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     MT-Safe                     
    
     Availability                 SUNWrsg (32-bit)            
    
                                  SUNWrsgx (64-bit)           
    


SEE ALSO
     rpc(3NSL),                     rpcgssgetmechanisms(3NSL),
     rpcgssgetprincipalname(3NSL), rpcsecgss(3NSL), mech(4),
     attributes(5)


     ONC] Developer's Guide


     Linn, J. RFC 2078, Generic Security Service Application Pro-
     gram  Interface,  Version  2. Network Working Group. January
     1997.


























SunOS 5.11           Last change: 5 Feb 2002                    2