get_num_crypts(3)get_num_crypts(3)NAME
get_num_crypts, get_crypt_name - determine the encryption types avail‐
able (Enhanced Security)
SYNOPSIS
#include <prot.h>
int get_num_crypts(
void const char *get_crypt_name(
int cryptnum );
LIBRARY
Security Library (libsecurity.so)
PARAMETERS
The encryption algorithm for which the name is to be returned.
DESCRIPTION
The get_num_crypts() function returns the number of encryption algo‐
rithms which the current system supports. This value is non-negative,
and at least four.
The get_crypt_name() function returns a pointer to static storage con‐
taining the name of the encryption algorithm with the index value given
in the cryptnum parameter. Other calls to get_crypt_name() could over‐
write the stored name, so applications should copy the names this func‐
tion returns if there is a chance that other parts of the application
might also call this function. This function returns NULL if the given
algorithm index is negative or if it is not less than the return value
of get_num_crypts(). Algorithm indexes are most commonly obtained from
the fd_oldcrypt and fd_newcrypt fields of an extended profile entry.
The dxaccounts system management GUI uses the get_num_crypts() and
get_crypt_name() functions to determine how to display the menu of
allowable encryption algorithms for ENHANCED security.
NOTES
In order to quickstart a program, the program must be linked as fol‐
lows: -lsecurity -ldb -laud -lm
See the shared library discussion in the Programmer's Guide for more
information about using the quickstarting feature.
RETURN VALUES
The get_num_crypts() function returns a non-negative value which is at
least four.
The get_crypt_name() function returns a name for a known encryption
algorithm, or a NULL pointer if the given index is out of range.
SEE ALSOgetespwent(3), getesdfent(3), dispcrypt(3), dxaccounts(8)
Security
get_num_crypts(3)