wolfssl/doc/dox_comments/header_files/rabbit.h

/*!
    \ingroup Rabbit

    \brief This function encrypts or decrypts a message of any size, storing
    the result in output. It requires that the Rabbit ctx structure be
    initialized with a key and an iv before encryption.

    \return 0 Returned on successfully encrypting/decrypting input
    \return BAD_ALIGN_E Returned if the input message is not 4-byte aligned
    but is required to be by XSTREAM_ALIGN, but NO_WOLFSSL_ALLOC_ALIGN is
    defined
    \return MEMORY_E Returned if there is an error allocating memory to
    align the message, if NO_WOLFSSL_ALLOC_ALIGN is not defined

    \param ctx pointer to the Rabbit structure to use for encryption/decryption
    \param output pointer to the buffer in which to store the processed
    message. Should be at least msglen long
    \param input pointer to the buffer containing the message to process
    \param msglen the length of the message to process

    _Example_
    \code
    int ret;
    Rabbit enc;
    byte key[] = { }; // initialize with 16 byte key
    byte iv[]  = { }; // initialize with 8 byte iv

    wc_RabbitSetKey(&enc, key, iv);

    byte message[] = { }; // initialize with plaintext message
    byte ciphertext[sizeof(message)];

    wc_RabbitProcess(enc, ciphertext, message, sizeof(message));
    \endcode

    \sa wc_RabbitSetKey
*/
WOLFSSL_API int wc_RabbitProcess(Rabbit*, byte*, const byte*, word32);

/*!
    \ingroup Rabbit

    \brief This function initializes a Rabbit context for use with
    encryption or decryption by setting its iv and key.

    \return 0 Returned on successfully setting the key and iv

    \param ctx pointer to the Rabbit structure to initialize
    \param key pointer to the buffer containing the 16 byte key to
    use for encryption/decryption
    \param iv pointer to the buffer containing the 8 byte iv with
    which to initialize the Rabbit structure

    _Example_
    \code
    int ret;
    Rabbit enc;
    byte key[] = { }; // initialize with 16 byte key
    byte iv[]  = { }; // initialize with 8 byte iv

    wc_RabbitSetKey(&enc, key, iv)
    \endcode

    \sa wc_RabbitProcess
*/
WOLFSSL_API int wc_RabbitSetKey(Rabbit*, const byte* key, const byte* iv);