authsys_create(3) library routines for client side remote procedure call authentication

Other Alias

auth_destroy, authnone_create, authsys_create_default

SYNOPSIS

In rpc/rpc.h Ft void Fn auth_destroy AUTH *auth Ft AUTH * Fn authnone_create void Ft AUTH * Fn authsys_create const char *host const uid_t uid const gid_t gid const int len const gid_t *aup_gids Ft AUTH * Fn 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 Vt CLIENT handle. The cl_auth field of the Vt CLIENT structure should be initialized by the Vt 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 discussed here.

Routines

Fn auth_destroy
A function macro that destroys the authentication information associated with Fa auth . Destruction usually involves deallocation of private data structures. The use of Fa auth is undefined after calling Fn auth_destroy .
Fn authnone_create
Create and return an RPC authentication handle that passes nonusable authentication information with each remote procedure call. This is the default authentication used by RPC.
Fn authsys_create
Create and return an RPC authentication handle that contains AUTH_SYS authentication information. The Fa host argument is the name of the machine on which the information was created; Fa uid is the user's user ID; Fa gid is the user's current group ID; Fa len and Fa aup_gids refer to a counted array of groups to which the user belongs.
Fn authsys_create_default
Call Fn authsys_create with the appropriate arguments.

AVAILABILITY

These functions are part of libtirpc.