Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

OSS Library Calls (s) setkey(3)
NAME
setkey - Sets an encryption or decryption key
LIBRARY
G-series native Guardian processes: $SYSTEM.SYSnn.ZOSSCSRL
G-series native OSS processes: /G/system/sysnn/zosscsrl
H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZOSSCDLL
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zosscdll |
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/yosscdll |
SYNOPSIS
#include <stdlib.h>
void setkey(
const char *key);
PARAMETERS
key Specifies the address of an array of 64 bytes that constitutes the key to use for
encrypting or decrypting data when the encrypt( ) function is called. The bytes
can contain only the numerical values 0 (zero) or 1. If this string is divided into
groups of 8 bytes, the low-order bit in each group is ignored.
The value specified with this parameter becomes a 56-bit key used by the
encryption and decryption algorithm.
DESCRIPTION
The setkey( ) function provides a key to encrypt or decrypt data in conformance with domestic
encryption standards. Programs compiled with this version of the function cannot be exported
from the United States of America.
The key generated by a call to the setkey( ) function is stored in a static data area. Each call to
the setkey( ) function overwrites the data in the static data area used by a previous call.
NOTES
The setkey( ) function can be called only by native processes.
RETURN VALUES
The setkey( ) function does not return a value.
ERRORS
If the call fails, the setkey( ) function does not set errno.
RELATED INFORMATION
Functions: crypt(3), encrypt(3).
STANDARDS CONFORMANCE
The HP implementation of this function does not return errno values.
527187-017 Hewlett-Packard Company 6−33