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

key_encryptsession Subroutine

Purpose

Encrypts a server network name and a Data Encryption Standard (DES) key.

Library

C Library (libc.a)

Syntax

#include <rpc/rpc.h>
key_encryptsession (remotename, deskey)
char *remotename;
des_block *deskey;

Description

The key_encryptsession subroutine interfaces to the keyserv daemon, which is associated with the secure authentication system known as DES. This subroutine encrypts a server network name and a DES key. To do so, the routine uses the public key of the server and the secret key associated with the effective user number (UID) of the calling process. System commands such as keylogin and the Remote Procedure Call (RPC) library are the main clients. User programs rarely need to call this subroutine.

This subroutine is the inverse of the key_decryptsession subroutine.

Parameters

remotename Points to the remote host name.
deskey Points to the des_block structure.

Return Values

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

Implementation Specifics

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

Related Information

The key_decryptsession subroutine.

The keylogin command.

The keyserv daemon.

List of RPC Programming References.

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


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