[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Technical Reference: Communications, Volume 1


authdes_create Subroutine

Purpose

Enables the use of Data Encryption Standard (DES) from the client side.

Library

C Library (libc.a)

Syntax

#include <rpc/rpc.h>


AUTH *authdes_create (name, window, syncaddr, ckey)
char * name;
u_int window;
struct sockaddr * syncaddr;
des_block * ckey;

Description

The authdes_create subroutine interfaces to the secure authentication system, known as DES. This subroutine, used from the client side, returns the authentication handle that allows use of the secure authentication system.

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

Parameters


name Specifies the network name (or netname) of the server process owner. The name parameter can be either the host name derived from the host2netname subroutine or the user name derived from the user2netname subroutine.
window Specifies the confirmation of the client credentials, given in seconds. A small value for the window parameter is more secure than a large one. However, choosing too small a value for the window parameter increases the frequency of resynchronizations due to clock drift.
syncaddr Identifies clock synchronization. If the syncaddr parameter has a null value, then the authentication system assumes that the local clock is always in sync with the server's clock. The authentication system will not attempt resynchronizations. However, if an address is supplied, the system uses the address for consulting the remote time service whenever resynchronization is required. This parameter usually contains the address of the RPC server itself.
ckey Specifies the DES key. If the value of the ckey parameter is null, the authentication system generates a random DES key to be used for the encryption of credentials. However, if a DES key is supplied, the supplied key is used.

Return Values

This subroutine returns a pointer to a DES authentication object.

Implementation Specifics

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

Related Information

List of RPC Programming References.

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


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]