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

Technical Reference: Communications, Volume 1

key_decryptsession Subroutine


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


C Library (libc.a)


#include <rpc/rpc.h>

key_decryptsession ( remotename, deskey)
char *remotename;
des_block *deskey;


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

This subroutine is the inverse of the key_encryptsession subroutine.


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_encryptsession subroutine.

The keylogin command.

The keyserv daemon.

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 ]