/**
* @class Pkcs05PbKdf2Parameters
- * @brief This class implements the functionalities specified by the Pkcs05 KDF2 scheme. PBKDF2 applies a pseudo random function to derive
- * keys. The length of the derived key is essentially unbounded. However, the maximum effective search space for the derived key may
- * be limited by the structure of the underlying pseudorandom function.
+ * @brief This class implements the functionalities specified by the PKCS05 KDF2 scheme.
*
- * It is defined in ASN.1 as:
+ * @since 2.1
+ *
+ * The %Pkcs05PbKdf2Parameters class implements the functionalities specified by the PKCS05 KDF2 scheme. PBKDF2 applies a pseudo random function to derive
+ * keys. The length of the derived key is essentially unbounded. However, the maximum effective search space for the derived key can
+ * be limited by the structure of the underlying pseudo random function.
*
+ * This is defined in ASN.1 as demonstrated in the following code:
+ * @code
* PBKDF2-params ::= SEQUENCE {
* salt CHOICE {
* specified OCTET STRING,
* keyLength INTEGER (1..MAX) OPTIONAL,
* prf AlgorithmIdentifier {{PBKDF2-PRFs}} DEFAULT
* algid-hmacWithSHA1 }
- * @since 2.1
+ * @endcode
*
*/
virtual ~Pkcs05PbKdf2Parameters(void);
/**
- * Initializes this instance of %Pkcs05PbKdf2Parameters with the encoded Bytebuffer which contain password based @n
- * key derivation function parameters structure(PBKDF2) in ASN.1 DER format.
+ * Initializes this instance of %Pkcs05PbKdf2Parameters with the encoded Tizen::Base::Bytebuffer that contains Password Based Key Derivation Function parameters structure(PBKDF2) in ASN.1 DER format.
*
* @since 2.1
*
* @return An error code
- * @param[in] encodedData DER encoded ByteBuffer of Pkcs05PbKdf2Parameters.
+ * @param[in] encodedData DER encoded Tizen::Base::ByteBuffer of %Pkcs05PbKdf2Parameters
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
*/
result Construct(const Tizen::Base::ByteBuffer& encodedData);
/**
- * Initializes the %Pkcs05PbKdf2Parameters with supplied input parameters values.
+ * Initializes the %Pkcs05PbKdf2Parameters with specified input parameters values.
*
* @since 2.1
*
* @return An error code
- * @param[in] saltBuffer An instance of ByteBuffer, holding salt value.
+ * @param[in] saltBuffer An instance of Tizen::Base::ByteBuffer, holding salt value
* @param[in] iterationCount Integer value holding the positive integer specifying iteration count
- * for generation of password based key.
- * @param[in] derivedKeyLength Positive integer specifying length of password based key to be generated.
+ * for generation of password based key
+ * @param[in] derivedKeyLength Positive integer specifying length of password based key to generate
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
- * @remark In this case when pseudo random function algorithm is not passed then default HMAC-SHA1 will be used.
+ * @remark In this case, when pseudo random function algorithm is not passed, then default HMAC-SHA1 will be used.
*/
result Construct(const Tizen::Base::ByteBuffer& saltBuffer, int iterationCount, int derivedKeyLength = 0);
/**
- * Initializes the %Pkcs05PbKdf2Parameters with supplied input parameters values.
+ * Initializes this %Pkcs05PbKdf2Parameters with supplied input parameters values.
*
* @since 2.1
*
* @return An error code
- * @param[in] saltBuffer An instance of ByteBuffer, holding salt value.
+ * @param[in] saltBuffer An instance of Tizen::Base::ByteBuffer, holding salt value
* @param[in] iterationCount Integer value holding the positive integer specifying iteration count
- * for generation of password based key.
- * @param[in] prf An instance of AlgorithIdentifier, holding the underlying pseudo-random function to use for
- * generation of password based key.
- * @param[in] derivedKeyLength Positive integer specifying length of password based key to be generated.
+ * for generation of password based key
+ * @param[in] prf An instance of AlgorithIdentifier, holding the underlying pseudo random function to use to generate a password based key
+ * @param[in] derivedKeyLength Positive integer specifying length of password based key to generate
* @exception E_SUCCESS The method is successful.
* @exception E_INVALID_ARG The specified input parameter is invalid.
*/
result Construct(const Tizen::Base::ByteBuffer& saltBuffer, int iterationCount, const AlgorithmIdentifier& prf, int derivedKeyLength = 0);
/**
- * Gets the encoded form of the Pkcs05PbKdf2Parameters.
- * It is assumed that each Pkcs05PbKdf2Parameters will have only a single form of encoding example ASN.1 DER.
+ * Gets the encoded form of the %Pkcs05PbKdf2Parameters. @n
+ * It is assumed that each %Pkcs05PbKdf2Parameters will have only a single form of encoding, for example: ASN.1 DER.
*
* @since 2.1
*
- * @return A pointer to the ByteBuffer class that contains the output, @n
- * else @c null if an error occurs.
+ * @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n
+ * else @c null if an error occurs
* @exception E_SUCCESS The method is successful.
* @exception E_SYSTEM The method cannot proceed due to a severe system error.
* @remarks The specific error code can be accessed using the GetLastResult() method.
Tizen::Base::ByteBuffer* GetEncodedDataN(void) const;
/**
- * Get the salt byte buffer.
+ * Gets the salt byte buffer.
*
* @since 2.1
*
- * @return A reference to Salt ByteBuffer Containing the specified salt value.
+ * @return A reference to salt Tizen::Base::ByteBuffer containing the specified salt value
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
const Tizen::Base::ByteBuffer& GetSaltValue(void) const;
/**
- * Get the iteration count.
- * The purpose of this count is to increase the cost of producing keys from a password, thereby also increasing the difficulty of attack.
+ * Gets the iteration count. @n
+ * The purpose of this count is to increase the cost of producing keys from a password, thereby, also increasing the difficulty of attack.
*
* @since 2.1
*
- * @return An integer value containing the iteration count for PBKDF2.
+ * @return An integer value containing the iteration count for PBKDF2
*
*/
int GetIterationCount(void) const;
/**
- * Get the derived key length.
- * This API will return the length of the derived key that will be used for generating the password based key.
+ * Gets the derived key length. @n
+ * The %GetDerivedKeyLength() method returns the length of the derived key that is used to generate the password based key.
*
* @since 2.1
*
- * @return An integer value containing the length of the derived key.
+ * @return An integer value containing the length of the derived key
*
*/
int GetDerivedKeyLength(void) const;
/**
- * Get the reference to the Algorithm Identifier which identifies the underlying pseudo random function.
+ * Gets the reference to the AlgorithmIdentifier that identifies the underlying pseudo random function.
*
* @since 2.1
*
- * @return A reference to AlgorithmIdentifier Containing the algorithm identifier of underlying pseudo random function.
+ * @return A reference to AlgorithmIdentifier containing the algorithm identifier of underlying pseudo random function
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
const AlgorithmIdentifier& GetPrf(void) const;
/**
*
- * Get the pointer to the AlgorithmParameters which identifies the underlying Parameters like PbKdf2,PbEs2,PbMac1.
- * For this class AlgorithmParameters will be of PbKdf2 type.
+ * Gets the pointer to the AlgorithmParameters that identifies the underlying parameters such as PbKdf2,PbEs2,PbMac1. @n
+ * For this class %AlgorithmParameters will be of PbKdf2 type.
*
* @since 2.1
*
- * @return Pointer to IAlgorithmParameters Containing the algorithm identifier of underlying pseudo random function, @n
- * else @c null if an error occurs.
+ * @return Pointer to IAlgorithmParameters containing the algorithm identifier of underlying pseudo random function, @n
+ * else @c null if an error occurs
* @remarks The specific error code can be accessed using the GetLastResult() method.
*/
virtual IAlgorithmParameters* CloneN(void) const;
/**
- * Get the PkcsAlgorithmParameterType value.
+ * Gets the PkcsAlgorithmParameterType value.
*
* @since 2.1
*
- * @return PkcsAlgorithmParameterType holding enum value PKCS_ALGO_PARAM_TYPE_PKCS05_KDF02 for KDF2 Parameters.
+ * @return PkcsAlgorithmParameterType holding enum value @c PKCS_ALGO_PARAM_TYPE_PKCS05_KDF02 for KDF2 Parameters
*/
virtual PkcsAlgorithmParameterType GetType(void) const;