RPC\_CLNT\_AUTH(3) Library Functions Manual RPC\_CLNT\_AUTH(3)

# [NAME](#NAME)

`auth_destroy`, `authnone_create`, `authsys_create`, `authsys_create_default` — library routines for client side remote procedure call authentication

# [SYNOPSIS](#SYNOPSIS)

`#include <rpc/rpc.h>`

`void`  
`auth_destroy`(`AUTH *auth`);

`AUTH *`  
`authnone_create`(`void`);

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

`AUTH *`  
`authsys_create_default`(`void`);

# [DESCRIPTION](#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 discussed here.

# [Routines](#Routines)

[`auth_destroy`](#auth_destroy)()

A function 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`().

[`authnone_create`](#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.

[`authsys_create`](#authsys_create)()

Create and return an RPC authentication handle that contains `AUTH_SYS` authentication information. The `host` argument 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`](#authsys_create_default)()

Call `authsys_create`() with the appropriate arguments.

# [AVAILABILITY](#AVAILABILITY)

These functions are part of libtirpc.

# [SEE ALSO](#SEE_ALSO)

[rpc(3)](/man/os/libtirpc-nokrb/rpc.3), [rpc\_clnt\_calls(3)](/man/os/libtirpc-nokrb/rpc_clnt_calls.3), [rpc\_clnt\_create(3)](/man/os/libtirpc-nokrb/rpc_clnt_create.3)

May 7, 1993 Linux 4.19.0-gvisor

---

Document: rpc_clnt_auth(3t) from libtirpc-nokrb 1.3.8-r0 (Chainguard OS)
Source: https://downloads.sourceforge.net/project/libtirpc/libtirpc/1.3.8/libtirpc-1.3.8.tar.bz2