diff options
Diffstat (limited to 'plugins/Kuzne4ikCrypt/src/GOST/28147_14.h')
| -rw-r--r-- | plugins/Kuzne4ikCrypt/src/GOST/28147_14.h | 190 |
1 files changed, 95 insertions, 95 deletions
diff --git a/plugins/Kuzne4ikCrypt/src/GOST/28147_14.h b/plugins/Kuzne4ikCrypt/src/GOST/28147_14.h index fa6e08cbb2..e6a2a5c6f3 100644 --- a/plugins/Kuzne4ikCrypt/src/GOST/28147_14.h +++ b/plugins/Kuzne4ikCrypt/src/GOST/28147_14.h @@ -1,5 +1,5 @@ /** @file
- * @brief ""
+ * @brief Объявление функций реализующих преобразования из алгоритма "Кузнечик"
*
* @copyright InfoTeCS. All rights reserved.
*/
@@ -15,153 +15,153 @@ extern "C" {
#endif
-/** @brief X
+/** @brief Преобразование X
*
- * @param[in] a
- * @param[in] b
- * @param[out] outdata
- * @param[in] print
- * @return 0
- * @return -1
+ * @param[in] a входной параметр преобразования
+ * @param[in] b входной параметр преобразования
+ * @param[out] outdata результат параметр преобразования
+ * @param[in] print функция логирования
+ * @return 0 если все преобразование прошло успешно
+ * @return -1 если произошла ошибка
*/
int funcX(unsigned char* a, unsigned char* b, unsigned char* outdata);
-/** @brief S
+/** @brief Преобразование S
*
- * @param[in] indata
- * @param[out] outdata
- * @param[in] print
- * @return 0
- * @return -1
+ * @param[in] indata входной параметр преобразования
+ * @param[out] outdata результат параметр преобразования
+ * @param[in] print функция логирования
+ * @return 0 если все преобразование прошло успешно
+ * @return -1 если произошла ошибка
*/
int funcS(unsigned char* indata, unsigned char* outdata);
-/** @brief S
+/** @brief Преобразование обратное к преобразованию S
*
- * @param[in] indata
- * @param[out] outdata
- * @param[in] print
- * @return 0
- * @return -1
+ * @param[in] indata входной параметр преобразования
+ * @param[out] outdata результат параметр преобразования
+ * @param[in] print функция логирования
+ * @return 0 если все преобразование прошло успешно
+ * @return -1 если произошла ошибка
*/
int funcReverseS(unsigned char* indata, unsigned char* outdata);
-/** @brief R
+/** @brief Преобразование R
*
- * @param[in] indata
- * @param[out] outdata
- * @param[in] print
- * @return 0
- * @return -1
+ * @param[in] indata входной параметр преобразования
+ * @param[out] outdata результат параметр преобразования
+ * @param[in] print функция логирования
+ * @return 0 если все преобразование прошло успешно
+ * @return -1 если произошла ошибка
*/
int funcR(unsigned char* indata, unsigned char* outdata);
-/** @brief R
+/** @brief Преобразование обратное к преобразованию R
*
- * @param[in] indata
- * @param[out] outdata
- * @param[in] print
- * @return 0
- * @return -1
+ * @param[in] indata входной параметр преобразования
+ * @param[out] outdata результат параметр преобразования
+ * @param[in] print функция логирования
+ * @return 0 если все преобразование прошло успешно
+ * @return -1 если произошла ошибка
*/
int funcReverseR(unsigned char* indata, unsigned char* outdata);
-/** @brief L
+/** @brief Преобразование L
*
- * @param[in] indata
- * @param[out] outdata
- * @param[in] print
- * @return 0
- * @return -1
+ * @param[in] indata входной параметр преобразования
+ * @param[out] outdata результат параметр преобразования
+ * @param[in] print функция логирования
+ * @return 0 если все преобразование прошло успешно
+ * @return -1 если произошла ошибка
*/
int funcL(unsigned char* indata, unsigned char* outdata);
-/** @brief L
+/** @brief Преобразование обратное к преобразованию L
*
- * @param[in] indata
- * @param[out] outdata
- * @param[in] print
- * @return 0
- * @return -1
+ * @param[in] indata входной параметр преобразования
+ * @param[out] outdata результат параметр преобразования
+ * @param[in] print функция логирования
+ * @return 0 если все преобразование прошло успешно
+ * @return -1 если произошла ошибка
*/
int funcReverseL(unsigned char* indata, unsigned char* outdata);
-/** @brief LSX
+/** @brief Преобразование LSX
*
- * @param[in] a
- * @param[in] b
- * @param[out] outdata
- * @param[in] print
- * @return 0
- * @return -1
+ * @param[in] a входной параметр преобразования
+ * @param[in] b входной параметр преобразования
+ * @param[out] outdata результат параметр преобразования
+ * @param[in] print функция логирования
+ * @return 0 если все преобразование прошло успешно
+ * @return -1 если произошла ошибка
*/
int funcLSX(unsigned char* a, unsigned char* b, unsigned char* outdata);
-/** @brief LSX
+/** @brief Преобразование обратное к преобразованию LSX
*
- * @param[in] a
- * @param[in] b
- * @param[out] outdata
- * @param[in] print
- * @return 0
- * @return -1
+ * @param[in] a входной параметр преобразования
+ * @param[in] b входной параметр преобразования
+ * @param[out] outdata результат параметр преобразования
+ * @param[in] print функция логирования
+ * @return 0 если все преобразование прошло успешно
+ * @return -1 если произошла ошибка
*/
int funcReverseLSX(unsigned char* a, unsigned char* b, unsigned char* outdata);
-/** @brief F
+/** @brief Преобразование F
*
- * @param[in] inputKey
- * @param[in] inputKeySecond
- * @param[in] iterationConst
- * @param[out] outputKey
- * @param[out] outputKeySecond
- * @param[in] print
- * @return 0
- * @return -1
+ * @param[in] inputKey Первый ключ из пары ключей полученной в предедущей итерации
+ * @param[in] inputKeySecond Второй ключ из пары ключей полученной в предедущей итерации
+ * @param[in] iterationConst Итерационная константа
+ * @param[out] outputKey Первый ключ
+ * @param[out] outputKeySecond Второй ключ
+ * @param[in] print функция логирования
+ * @return 0 если все преобразование прошло успешно
+ * @return -1 если произошла ошибка
*/
int funcF(unsigned char* inputKey, unsigned char* inputKeySecond, unsigned char* iterationConst, unsigned char* outputKey, unsigned char* outputKeySecond);
-/** @brief
+/** @brief Вычисление итерационной константы С
*
- * @param[in] number
- * @param[out] output
- * @param[in] print
- * @return 0
- * @return -1
+ * @param[in] number номер константы
+ * @param[out] output итерационная константа
+ * @param[in] print функция логирования
+ * @return 0 если все преобразование прошло успешно
+ * @return -1 если произошла ошибка
*/
int funcC(unsigned char number, unsigned char* outputW);
-/** @brief
+/** @brief Развертка ключа
*
- * @param[in] masterKey
- * @param[out] keys
- * @param[in] print
- * @return 0
- * @return -1
+ * @param[in] masterKey Мастер ключ
+ * @param[out] keys массив развернутых ключей
+ * @param[in] print функция логирования
+ * @return 0 если все преобразование прошло успешно
+ * @return -1 если произошла ошибка
*/
int ExpandKey(unsigned char* masterKey, unsigned char* keys);
-/** @brief
+/** @brief Выполнение зашифрования блока
*
- * @param[in] plainText
- * @param[out] chipherText
- * @param[in] keys
- * @param[in] print
- * @param[in] print_uint
- * @return 0
- * @return -1
+ * @param[in] plainText Исходный блок
+ * @param[out] chipherText Зашифрованный блок
+ * @param[in] keys Развернутые ключи
+ * @param[in] print функция логирования
+ * @param[in] print_uint функция логирования
+ * @return 0 если все преобразование прошло успешно
+ * @return -1 если произошла ошибка
*/
int Encrypt_14(unsigned char* plainText, unsigned char* chipherText, unsigned char* keys);
-/** @brief
+/** @brief Выполение расшифрования блока
*
- * @param[in] chipherText
- * @param[out] plainText
- * @param[in] keys
- * @param[in] print
- * @param[in] print_uint
- * @return 0
- * @return -1
+ * @param[in] chipherText Зашифрованный блок
+ * @param[out] plainText Расшифрованный блок
+ * @param[in] keys Развернутые ключи
+ * @param[in] print функция логирования
+ * @param[in] print_uint функция логирования
+ * @return 0 если все преобразование прошло успешно
+ * @return -1 если произошла ошибка
*/
int Decrypt_14(unsigned char* chipherText, unsigned char* plainText, unsigned char* keys);
|