X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;ds=sidebyside;f=inc%2FFSecCryptoDesCipher.h;h=e99b82e529fd312a20504039bbfba4c78d8b877b;hb=07a771d39ebf4c7f26a04aeb3e06f9d7eb1c6dc2;hp=dc6ef6499f17934c3ad18eb4f3fa646406856e17;hpb=27f1388665067f69d5eb64e0cae6bb5f4250beec;p=platform%2Fframework%2Fnative%2Fappfw.git diff --git a/inc/FSecCryptoDesCipher.h b/inc/FSecCryptoDesCipher.h index dc6ef64..e99b82e 100644 --- a/inc/FSecCryptoDesCipher.h +++ b/inc/FSecCryptoDesCipher.h @@ -36,11 +36,11 @@ class _SymmetricCipher; * @class DesCipher * @brief This class provides methods for encryption and decryption using the Data Encryption Standard (DES) method. * - * @since 2.0 + * @since 2.0 * * The %DesCipher class provides a symmetric cipher using the Data Encryption Standard (DES) method. - * Sets appropriate values for the requested mode/key bit/padding scheme and cipher operation mode - * (CIPHER_ENCRYPT or CIPHER_DECRYPT) parameters. @n + * This class allows to set appropriate values for the requested mode/key bit/padding scheme and cipher operation mode + * (::CIPHER_ENCRYPT or ::CIPHER_DECRYPT) parameters. @n * * For more information on the class features, see Ciphers. * @@ -75,20 +75,23 @@ public: * @since 2.0 * * @return An error code - * @param[in] transformation The name of the requested mode/key bit/padding scheme @n + * @param[in] transformation The requested mode/key bit/padding scheme @n * For example, "CBC/NOPADDING" or "CBC/PKCS7PADDING". * @param[in] opMode The cipher operation mode @n * The valid values for %DesCipher are @c CIPHER_ENCRYPT and @c CIPHER_DECRYPT. * @exception E_SUCCESS The method is successful. - * @exception E_OUT_OF_MEMORY The memory is insufficient. - * @exception E_INVALID_ARG A specified input parameter is invalid, or the specified @c opMode does not contain a valid value for the cipher operation. + * @exception E_OUT_OF_MEMORY The memory is insufficient. + * @exception E_INVALID_ARG Either of the following conditions has occurred: + * - A specified input parameter is invalid. + * - The specified @c opMode does not contain a valid value for the cipher operation. * @remarks If @c opMode is not matching the actual operation, the result of the operation is @c null and an exception is returned. @n - * For example, if @c opMode is set to @c CIPHER_ENCRYPT, @c CIPHER_WRAP, or @c CIPHER_UNWRAP and the DecryptN() method is used, then the result obtained is @c null and an exception is returned. + * For example, if @c opMode is set to @c CIPHER_ENCRYPT, @c CIPHER_WRAP, or @c CIPHER_UNWRAP and the DecryptN() + * method is used, then the result obtained is @c null and an exception is returned. */ virtual result Construct(const Tizen::Base::String& transformation, enum CipherOperation opMode); /** - * Sets a symmetric key for encryption or decryption. + * Sets the symmetric key for encryption or decryption. * * @since 2.0 * @@ -117,21 +120,21 @@ public: * Encrypts the data (single-part). * * @since 2.0 - * + * @pre Before calling this method, set a secret key and an initial vector using SetKey() and SetInitialVector(). * @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n * else @c null if an error occurs * @param[in] input An instance of Tizen::Base::ByteBuffer * @exception E_SUCCESS The method is successful. - * @exception E_INVALID_ARG The specified instance of Tizen::Base::ByteBuffer is invalid or empty. + * @exception E_INVALID_ARG The specified Tizen::Base::ByteBuffer instance is invalid or empty. * @exception E_OUT_OF_MEMORY The memory is insufficient. * @exception E_KEY_NOT_FOUND The specified key is not found. * @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid. * @exception E_OVERFLOW This operation has caused the memory to overflow. - * @exception E_SYSTEM A system error has occurred. @n - * The method has failed to operate with the openssl library, or - * the Tizen::Base::ByteBuffer operation has failed. + * @exception E_SYSTEM Either of the following conditions has occurred: + * - A system error has occurred. + * - The method has failed to operate with the OpenSSL library. + * - The Tizen::Base::ByteBuffer operation has failed. * @remarks The specific error code can be accessed using the GetLastResult() method. - * @remarks A secret key and an initial vector are set before calling this method. */ virtual Tizen::Base::ByteBuffer* EncryptN(const Tizen::Base::ByteBuffer& input); @@ -139,42 +142,42 @@ public: * Decrypts the data (single-part). * * @since 2.0 - * + * @pre Before calling this method, set a secret key and an initial vector using SetKey() and SetInitialVector(). * @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n * else @c null if an error occurs - * @param[in] input An instance of Tizen::Base::ByteBuffer + * @param[in] input An instance of Tizen::Base::ByteBuffer * @exception E_SUCCESS The method is successful. - * @exception E_INVALID_ARG The specified instance of Tizen::Base::ByteBuffer is invalid or empty. + * @exception E_INVALID_ARG The specified Tizen::Base::ByteBuffer instance is invalid or empty. * @exception E_OUT_OF_MEMORY The memory is insufficient. * @exception E_KEY_NOT_FOUND The specified key is not found. * @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid. * @exception E_OVERFLOW This operation has caused the memory to overflow. - * @exception E_SYSTEM A system error has occurred. @n - * The method has failed to operate with the openssl library, or - * the Tizen::Base::ByteBuffer operation has failed. - * @remarks The specific error code can be accessed using the GetLastResult() method. - * @remarks A secret key and an initial vector are set before calling this method. + * @exception E_SYSTEM Either of the following conditions has occurred: + * - A system error has occurred. + * - The method has failed to operate with the OpenSSL library. + * - The Tizen::Base::ByteBuffer operation has failed. + * @remarks The specific error code can be accessed using the GetLastResult() method. */ virtual Tizen::Base::ByteBuffer* DecryptN(const Tizen::Base::ByteBuffer& input); /** - * Initializes a multiple-part encryption or decryption operation. - * - * @since 2.0 + * Initializes the instance of %DesCipher for the multiple-part encryption or decryption. * + * @since 2.0 + * @pre Before calling this method, set a secret key and an initial vector using SetKey() and SetInitialVector(). * @return An error code * @exception E_SUCCESS The method is successful. * @exception E_OUT_OF_MEMORY The memory is insufficient. * @exception E_KEY_NOT_FOUND The specified key is not found. * @exception E_INVALID_OPERATION The specified cipher operation mode for this method is invalid. - * @exception E_SYSTEM A system error has occurred. @n - * The method has failed to operate with the openssl library. - * @remarks A secret key and an initial vector are set before calling this method. + * @exception E_SYSTEM Either of the following conditions has occurred: + * - A system error has occurred. + * - The method has failed to operate with the openssl library. */ virtual result Initialize(void); /** - * Updates a multiple-part encryption or decryption operation. + * Updates the multiple-part encryption or decryption operation. * * @since 2.0 * @@ -184,16 +187,17 @@ public: * @exception E_SUCCESS The method is successful. * @exception E_OUT_OF_MEMORY The memory is insufficient. * @exception E_OVERFLOW This operation has caused the memory to overflow. - * @exception E_INVALID_ARG The specified instance of Tizen::Base::ByteBuffer is invalid or empty. - * @exception E_SYSTEM A system error has occurred. @n - * The method has failed to operate with the openssl library, or - * the Tizen::Base::ByteBuffer operation has failed. + * @exception E_INVALID_ARG The specified Tizen::Base::ByteBuffer instance is invalid or empty. + * @exception E_SYSTEM Either of the following conditions has occurred: + * - A system error has occurred. + * - The method has failed to operate with the OpenSSL library. + * - The Tizen::Base::ByteBuffer operation has failed. * @remarks The specific error code can be accessed using the GetLastResult() method. */ virtual Tizen::Base::ByteBuffer* UpdateN(const Tizen::Base::ByteBuffer& input); /** - * Finalizes a multiple-part encryption or decryption operation. + * Finalizes the multiple-part encryption or decryption operation. * * @since 2.0 * @@ -202,9 +206,10 @@ public: * @exception E_SUCCESS The method is successful. * @exception E_OUT_OF_MEMORY The memory is insufficient. * @exception E_OVERFLOW This operation has caused the memory to overflow. - * @exception E_SYSTEM A system error has occurred. @n - * The method has failed to operate with the openssl library, or - * the Tizen::Base::ByteBuffer operation has failed. + * @exception E_SYSTEM Either of the following conditions has occurred: + * - A system error has occurred + * - The method has failed to operate with the OpenSSL library. + * - The Tizen::Base::ByteBuffer operation has failed. * @remarks The specific error code can be accessed using the GetLastResult() method. */ virtual Tizen::Base::ByteBuffer* FinalizeN(void); @@ -217,9 +222,10 @@ public: * @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n * else @c null if an error occurs * @param[in] secretKey The secret key to wrap - * @remarks This operation is not supported in the %DesCipher class. - * Therefore, this method always returns @c null. - * @remarks The @c E_UNSUPPORTED_ALGORITHM exception is returned using the GetLastResult() method. + * @remarks + * - This operation is not supported in the %DesCipher class. + * Therefore, this method always returns @c null. + * - The @c E_UNSUPPORTED_ALGORITHM exception is returned using the GetLastResult() method. */ virtual Tizen::Base::ByteBuffer* WrapN(const Tizen::Base::ByteBuffer& secretKey); @@ -231,9 +237,10 @@ public: * @return A pointer to the Tizen::Base::ByteBuffer class that contains the output, @n * else @c null if an error occurs * @param[in] wrappedKey The wrapped key to unwrap - * @remarks This operation is not supported in the %DesCipher class. - * Therefore, this method always returns @c null. - * @remarks The @c E_UNSUPPORTED_ALGORITHM exception is returned using the GetLastResult() method. + * @remarks + * - This operation is not supported in the %DesCipher class. + * Therefore, this method always returns @c null. + * - The @c E_UNSUPPORTED_ALGORITHM exception is returned using the GetLastResult() method. */ virtual Tizen::Base::ByteBuffer* UnwrapN(const Tizen::Base::ByteBuffer& wrappedKey);