[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Communications Technical Reference, Volume 1

authunix_create Subroutine

Purpose

Creates an authentication handle with operating system permissions.

Library

C Library (libc.a)

Syntax

#include <rpc/rpc.h>
AUTH *authunix_create (host, uid, gid, len, aupgids)
char *host;
int uid, gid;
int len, *aupgids; 

Description

The authunix_create subroutine creates and returns a Remote Procedure Call (RPC) authentication handle with operating system permissions.

Parameters

host Points to the name of the machine on which the permissions were created.
uid Specifies the caller's effective user ID (UID).
gid Specifies the caller's effective group ID (GID).
len Specifies the length of the groups array.
aupgids Points to the counted array of groups to which the user belongs.

Return Values

This subroutine returns an RPC authentication handle.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The authnone_create subroutine, authunix_create_default subroutine, svcerr_auth subroutine.

The auth_destroy macro.

Remote Procedure Call (RPC) Overview for Programming in AIX Version 4.3 Communications Programming Concepts.


[ Previous | Next | Contents | Glossary | Home | Search ]