Manual Pages for UNIX Operating System command usage for man auth_destroy

Networking Services Library Functions         rpc_clnt_auth(3NSL)



NAME
     rpc_clnt_auth,        auth_destroy,         authnone_create,
     authsys_create,  authsys_create_default  -  library routines
     for client side remote procedure call authentication

SYNOPSIS
     void auth_destroy(AUTH *auth);


     AUTH *authnone_create    (void)


     AUTH *authsys_create(const cha r*host,  const uid_t uid, const gid_t gid,
          const int len, const gid_t *aup_gids);


     AUTH *authsys_create_default(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 cl_auth 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 NULL and the SYS style of  authentication  is  dis-
     cussed  here. For the DES style authentication, please refer
     to secure_rpc(3NSL).


     The NULL 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 



     auth_destroy()            A function macro that destroys the
                               authentication         information



SunOS 5.11          Last change: 14 Jan 2002                    1






Networking Services Library Functions         rpc_clnt_auth(3NSL)



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


     authnone_create()         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.


     authsys_create()          Create and return an RPC authenti-
                               cation    handle   that   contains
                               AUTH_SYS  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
                               aup_gids refer to a counted  array
                               of   groups   to  which  the  user
                               belongs.


     authsys_create_default    Call  authsys_create()  with   the
                               appropriate parameters.


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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     rpc(3NSL),   rpc_clnt_calls(3NSL),    rpc_clnt_create(3NSL),
     secure_rpc(3NSL), attributes(5)







SunOS 5.11          Last change: 14 Jan 2002                    2