*** UNIX MANUAL PAGE BROWSER ***

get_num_crypts(3) Library Functions Manual get_num_crypts(3) NAME get_num_crypts, get_crypt_name - determine the encryption types avail- able (Enhanced Security) LIBRARY Security Library (libsecurity.so) SYNOPSIS #include <prot.h> int get_num_crypts(void); const char *get_crypt_name( int cryptnum); PARAMETERS cryptnum 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 al- lowable encryption algorithms for ENHANCED security. 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 al- gorithm, or a NULL pointer if the given index is out of range. 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. RELATED INFORMATION getespwent(3), getesdfent(3), dispcrypt(3), dxaccounts(8X) Security delim off get_num_crypts(3)