Technical Reference: Communications, Volume 1

authdes_getucred Subroutine

Purpose

Maps a Data Encryption Standard (DES) credential into a UNIX credential.

Syntax

#include <rpc/rpc.h>

authdes_getucred (adc, uid, gid, grouplen, groups) struct authdes_cred * adc; short * uid; short * gid; short * grouplen; int * groups;

The authdes_getucred subroutine interfaces to the secure authentication system known as DES. The server uses this subroutine to convert a DES credential, which is the independent operating system, into a UNIX credential. The authdes_getucred subroutine retrieves necessary information from a cache instead of using the network information service (NIS).

Note: The keyserv daemon must be running for the DES authentication system to work.

Parameters

adc	Points to the DES credential structure.
uid	Specifies the caller's effective user ID (UID).
gid	Specifies the caller's effective group ID (GID).
grouplen	Specifies the group's length.
groups	Points to the group's array.

Return Values

Upon successful completion, this subroutine returns a value of 1. If unsuccessful, it returns a value of 0.

Implementation Specifics

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

Related Information

The keyserv daemon.

List of RPC Programming References.

Network Information Service (NIS) Overview for System Management in AIX 5L Version 5.1 System Management Guide: Communications and Networks.

Remote Procedure Call (RPC) Overview for Programming in AIX 5L Version 5.1 Communications Programming Concepts.