NAME    [Toc]    [Back]

       get_num_crypts,  get_crypt_name - determine the encryption
       types available (Enhanced Security)

SYNOPSIS    [Toc]    [Back]

       #include <prot.h>

       int get_num_crypts(
               void const char *get_crypt_name(
               int cryptnum );

LIBRARY    [Toc]    [Back]

       Security Library (libsecurity.so)

PARAMETERS    [Toc]    [Back]

       The encryption algorithm for  which  the  name  is  to  be
       returned.

DESCRIPTION    [Toc]    [Back]

       The   get_num_crypts()  function  returns  the  number  of
       encryption algorithms 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 containing the name of  the  encryption  algorithm
       with  the  index  value  given  in the cryptnum parameter.
       Other calls to get_crypt_name() could overwrite the stored
       name,  so applications should copy the names this function
       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    [Toc]    [Back]

       In  order  to  quickstart  a  program, the program must be
       linked as follows: -lsecurity -ldb -laud -lm

       See the shared  library  discussion  in  the  Programmer's
       Guide  for  more information about using the quickstarting
       feature.

RETURN VALUES    [Toc]    [Back]

       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 ALSO    [Toc]    [Back]

       getespwent(3), getesdfent(3), dispcrypt(3), dxaccounts(8)

       Security



                                                get_num_crypts(3)