Changeset 102297 in vbox for trunk/include

Timestamp:

Nov 24, 2023 4:32:03 PM (13 months ago)

Author:

vboxsync

Message:

IPRT/crypto/shacrypt: Better string length checks for RTCrShaCryptXXXToString(). bugref:10551

File:

• trunk/include/iprt/crypto/shacrypt.h (modified) (2 diffs)

trunk/include/iprt/crypto/shacrypt.h

@@ -81 +81 @@
  * @param   cRounds             Number of rounds used for generating \a pabHash.
  * @param   pszString           Where to store the printable string on success.
- * @param   cbString            Size (in bytes) of \a pszString.
+ * @param   cchString           Size of \a pszString.
+ *                              Should be at least RTSHA256_DIGEST_LEN + 1 bytes.
  *
  * @note    This implements step 22 of SHA-crypt.txt Version: 0.6 2016-8-31.
  */
-RTR3DECL(int) RTCrShaCrypt256ToString(uint8_t abHash[RTSHA256_HASH_SIZE], const char *pszSalt, uint32_t cRounds, char *pszString, size_t cbString);
+RTR3DECL(int) RTCrShaCrypt256ToString(uint8_t abHash[RTSHA256_HASH_SIZE], const char *pszSalt, uint32_t cRounds, char *pszString, size_t cchString);
 
 
@@ -111 +112 @@
  * @param   cRounds             Number of rounds used for generating \a pabHash.
  * @param   pszString           Where to store the printable string on success.
- * @param   cbString            Size (in bytes) of \a pszString.
+ * @param   cchString           Size of \a pszString.
+ *                              Should be at least RTSHA512_DIGEST_LEN + 1 bytes.
  *
  * @note    This implements step 22 of SHA-crypt.txt Version: 0.6 2016-8-31.
  */
-RTR3DECL(int) RTCrShaCrypt512ToString(uint8_t abHash[RTSHA512_HASH_SIZE], const char *pszSalt, uint32_t cRounds, char *pszString, size_t cbString);
+RTR3DECL(int) RTCrShaCrypt512ToString(uint8_t abHash[RTSHA512_HASH_SIZE], const char *pszSalt, uint32_t cRounds, char *pszString, size_t cchString);
 
 /** @} */