IJ03334: UPDATE CRYPT MAN PAGE

APAR status

• Closed as documentation error.

Error description

• The man page for crypt/encrypt mentions that the
  /usr/lib/libdes.a file is needed in order to decrypt
  data. This is incorrect; the /usr/lib/libdes and
  /usr/lib/libdes_64 files from the 'des' fileset on
  the Expansion Pack are what is needed.
  

Local fix

Problem summary

• The Knowledge Center page for
  "crypt, encrypt, or setkey Subroutine" needs correction.  In
  particular, the EdFlag item description under Parameters needs
  to be modified in addition to the description for the ENOSYS
  error code.
  
  Each of these incorrectly list a dependency on
  /usr/lib/libdes.a when the dependency on decryption is
  actually the des fileset and files /usr/lib/libdes and
  /usr/lib/libdes_64.
  

Problem conclusion

• The Knowledge Center page for "crypt, encrypt, or setkey
  Subroutine" will be corrected.  In particular, the EdFlag
  item description under Parameters will be modified in
  addition to the description for the ENOSYS error code.
  
  https://www.ibm.com/support/knowledgecenter/en/
  ssw_aix_71/com.ibm.aix.basetrf1/crypt.htm
  
  Changes need to be made for the same sections under
  AIX 6.1, 7.1, and 7.2.
  
  The EdFlag item description should be changed to:
  
  EdFlag    Determines whether the subroutine encrypts or
            decrypts the data. If this parameter is 0, the data
            is encrypted. If this is a nonzero value, the data is
            decrypted. If neither of the /usr/lib/libdes or
            /usr/lib/libdes_64 files exist and the EdFlag
            parameter is set to nonzero, the encrypt subroutine
            returns the ENOSYS error code. Note: the
            /usr/lib/libdes and /usr/lib/libdes_64 files are part
            of the des fileset, which is located on the AIX
            Expansion Pack.
  
  
  Under the Error Codes section, the ENOSYS item
  description should be changed to:
  
  ENOSYS    The encrypt subroutine was called with the EdFlag
            parameter which was set to a nonzero value. Also,
            neither of the /usr/lib/libdes or /usr/lib/libdes_64
            files exist. Note: the /usr/lib/libdes and
            /usr/lib/libdes_64 files are part of the des fileset,
            which is located on the AIX Expansion Pack.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels