authunix_create(3)                  CLIX                  authunix_create(3)



  NAME

    authunix_create, authnone_create, authunix_create_default, auth_destroy -
    Remote procedure call functions

  LIBRARY

    Berkeley Software Distribution Library (libbsd.a)

  SYNOPSIS

    AUTH *authunix_create(
      char *host ,
      int uid ,
      int gid ,
      int len ,
      int *aup_gids );

    AUTH *authnone_create(
      void );

    AUTH *authunix_create_default(
      void );

    #include <rpc/rpc.h>

    void auth_destroy(
      AUTH *auth );

  PARAMETERS

    host       Points to the name of the machine on which UNIX authentication
               information is created.

    uid        Specifies the user ID.

    gid        Specifies the user's current group ID.

    len        Specifies the number of groups to which the user belongs.

    aup_gids   Specifies the address of an array for group IDs to which the
               user belongs.

    auth       Specifies the address of an authentication handle.

  DESCRIPTION

    The authunix_create(), authnone_create(), authunix_create_default(), and
    auth_destroy() functions allow C programs to make procedure calls on other
    machines across the network.  First, the client calls a procedure to send
    a data packet to the server.  Upon receipt of the packet, the server calls



  2/94 - Intergraph Corporation                                              1

  authunix_create(3)                  CLIX                  authunix_create(3)



    a dispatch function to perform the requested service, and then sends back
    a reply.  Finally, the procedure call returns to the client.

    The authunix_create() function creates and returns an RPC authentication
    handle that contains authentication information.

    The authnone_create() function creates and returns an RPC authentication
    handle that passes nonusable authentication information with each remote
    procedure call.  This is the default authentication used by RPC.

    The authunix_create_default() function calls authunix_create() with the
    appropriate parameters.

    The auth_destroy() function is a macro that destroys the authentication
    information associated with auth.  Destruction usually involves
    deallocation of private data structures.  The use of auth is undefined
    after calling auth_destroy().

  RETURN VALUES

    The authnone_create(), authunix_create_default(), and auth_destroy()
    functions return void.  The authunix_create() function returns to the
    client.

  RELATED INFORMATION

    Functions:  xdr_int(3), xdr_bytes(3), xdr_getpos(3), xdr_pointer(3),
    xdrrec_create(3), xdr_array(3), xdr_destroy(3), xdr_free(3),
    xdr_inline(3), xdrmem_create(3), xdr_opaque(3), xdr_union(3),
    xdr_vector(3), xdr_void(3)

    CLIX Programming Guide






















  2                                              Intergraph Corporation - 2/94