Networking Services Library Functions         rpcclntauth(3NSL)



NAME
     rpcclntauth,        authdestroy,         authnonecreate,
     authsyscreate,  authsyscreatedefault  -  library routines
     for client side remote procedure call authentication

SYNOPSIS
     void authdestroy(AUTH *auth);


     AUTH *authnonecreate    (void)


     AUTH *authsyscreate(const cha r*host,  const uidt uid, const gidt gid,
          const int len, const gidt *aupgids);


     AUTH *authsyscreatedefault(void)


DESCRIPTION
     These routines are part of the RPC  library  that  allows  C
     language  programs to make procedure calls on other machines
     across the network, with desired authentication.


     These routines are normally called after creating the CLIENT
     handle.  The clauth field of the CLIENT structure should be
     initialized by the AUTH structure returned by  some  of  the
     following  routines. The client's authentication information
     is passed to the server when the RPC call is made.


     Only the NUL and the SYS style of  authentication  is  dis-
     cussed  here. For the DES style authentication, please refer
     to securerpc(3NSL).


     The NUL and SYS style of authentication are  safe  in  mul-
     tithreaded  applications. For the MT-level of the DES style,
     see its pages.

  Routines
     The following routines require that the  header  
     be  included  (see  rpc(3NSL) for the definition of the AUTH
     data structure).

       #include 



     authdestroy()            A function macro that destroys the
                               authentication         information



SunOS 5.11          Last change: 14 Jan 2002                    1






Networking Services Library Functions         rpcclntauth(3NSL)



                               associated with auth.  Destruction
                               usually  involves  deallocation of
                               private data structures.  The  use
                               of auth is undefined after calling
                               authdestroy().


     authnonecreate()         Create and return an RPC authenti-
                               cation  handle  that passes nonus-
                               able  authentication   information
                               with  each  remote procedure call.
                               This is the default authentication
                               used by RPC.


     authsyscreate()          Create and return an RPC authenti-
                               cation    handle   that   contains
                               AUTHSYS  authentication  informa-
                               tion.  The  parameter  host is the
                               name of the machine on  which  the
                               information  was  created;  uid is
                               the user's user  ID;  gid  is  the
                               user's  current  group ID; len and
                               aupgids refer to a counted  array
                               of   groups   to  which  the  user
                               belongs.


     authsyscreatedefault    Call  authsyscreate()  with   the
                               appropriate parameters.


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     rpc(3NSL),   rpcclntcalls(3NSL),    rpcclntcreate(3NSL),
     securerpc(3NSL), attributes(5)







SunOS 5.11          Last change: 14 Jan 2002                    2