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

authdes_getucred Subroutine


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


C Library (libc.a)


#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.


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.

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

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

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