VMS Help TCPIP Services, Programming Interfaces, RPC Client Routines, authunix_create  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    Creates and returns an RPC authentication handle that contains
    UNIX-style authentication information.
    Format
      #include  <rpc/rpc.h>
      AUTH  *authunix_create(char *host, int uid, int gid, int len,
            int *aup_gids );

1 - Arguments

 host
    Pointer to the name of the host on which the information was
    created. This is usually the name of the system running the
    client process.
 uid
    The user's user identification.
 gid
    The user's current group.
 len
    The number of elements in aup_gids array.
                                   NOTE
       This parameter is ignored by the product's RPC
       implementation.
 aup_gids
    A pointer to an array of groups to which the user belongs.
                                   NOTE
       This parameter is ignored by the product's RPC
       implementation.

2 - Description

    Implements UNIX-style authentication parameters. The client uses
    no encryption for its credentials and only sends null verifiers.
    The server sends back null verifiers or optionally a verifier
    that suggests a new shorthand for the credentials.

3 - Return Values

    AUTH *             Authentication handle containing the pertinent
                       information.
    NULL               Indicates allocation of AUTH handle failed.