Index for Section 3

Alphabetical listing for G

Bottom of page

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

SYNOPSIS
  #include <prot.h>

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

LIBRARY
  Security Library (libsecurity.so)

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

DESCRIPTION
  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
  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
  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
  getespwent(3), getesdfent(3), dispcrypt(3), dxaccounts(8)

  Security

Index for Section 3

Alphabetical listing for G

Top of page