.\" -*- coding: UTF-8 -*-
'\" t
.\" @(#)des_crypt.3	2.1 88/08/11 4.0 RPCSRC; from 1.16 88/03/02 SMI;
.\"
.\" Taken from libc4 sources, which say:
.\" Copyright (C) 1993 Eric Young - can be distributed under GPL.
.\"
.\" However, the above header line suggests that this file in fact is
.\" Copyright Sun Microsystems, Inc (and is provided for unrestricted use,
.\" see other Sun RPC sources).
.\"
.\" SPDX-License-Identifier: GPL-1.0-or-later
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH des_crypt 3 "2 мая 2024 г." "Справочные страницы Linux 6.9.1" 
.SH ИМЯ
des_crypt, ecb_crypt, cbc_crypt, des_setparity, DES_FAILED \- быстрое
шифрование DES
.SH БИБЛИОТЕКА
Стандартная библиотека языка C (\fIlibc\fP, \fI\-lc\fP)
.SH СИНТАКСИС
.nf
.\" Sun version
.\" .B #include <des_crypt.h>
\fB#include <rpc/des_crypt.h>\fP
.P
\fB[[deprecated]] int ecb_crypt(char *\fP\fIkey\fP\fB, char \fP\fIdata\fP\fB[.\fP\fIdatalen\fP\fB],\fP
\fB                             unsigned int \fP\fIdatalen\fP\fB, unsigned int \fP\fImode\fP\fB);\fP
\fB[[deprecated]] int cbc_crypt(char *\fP\fIkey\fP\fB, char \fP\fIdata\fP\fB[.\fP\fIdatalen\fP\fB],\fP
\fB                             unsigned int \fP\fIdatalen\fP\fB, unsigned int \fP\fImode\fP\fB,\fP
\fB                             char *\fP\fIivec\fP\fB);\fP
.P
\fB[[deprecated]] void des_setparity(char *\fP\fIkey\fP\fB);\fP
.P
\fB[[deprecated]] int DES_FAILED(int \fP\fIstatus\fP\fB);\fP
.fi
.SH ОПИСАНИЕ
\fBecb_crypt\fP()  and \fBcbc_crypt\fP()  implement the NBS DES (Data Encryption
Standard).  These routines are faster and more general purpose than
\fBcrypt\fP(3).  They also are able to utilize DES hardware if it is
available.  \fBecb_crypt\fP()  encrypts in ECB (Electronic Code Book)  mode,
which encrypts blocks of data independently.  \fBcbc_crypt\fP()  encrypts in
CBC (Cipher Block Chaining)  mode, which chains together successive blocks.
CBC mode protects against insertions, deletions, and substitutions of
blocks.  Also, regularities in the clear text will not appear in the cipher
text.
.P
Рассмотрим применение этих функций. Первый параметр, \fIkey\fP, является
8\-байтным ключом шифрования с чётностью. Для установки чётности ключа,
которая для DES находится в младшем бите каждого байта, используйте
\fBdes_setparity\fP. Второй параметр, \fIdata\fP, содержит данные для шифрования
или расшифровки. Третий параметр, \fIdatalen\fP, задаёт длину блока данных
\fIdata\fP в байтах, длина должна быть кратна 8. Четвертый параметр, \fImode\fP,
формируется через логическое сложение (OR) нескольких вещей. Чтобы указать
тип операции добавляется либо \fBDES_ENCRYPT\fP, либо \fBDES_DECRYPT\fP. Чтобы
применить программное шифрование или использовать специальное оборудование,
добавляется либо \fBDES_HW\fP, либо \fBDES_SW\fP. Если указано \fBDES_HW\fP и
оборудование не обнаружено, то шифрование выполняется в программном режиме,
а функция возвращает \fBDESERR_NOHWDEVICE\fP. В \fBcbc_crypt\fP() параметр \fIivec\fP
используется как 8\-байтовый вектор инициализации для шифрования цепочек. Он
обновляется на следующий вектор инициализации при возврате.
.SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ"
.TP 
\fBDESERR_NONE\fP
Нет ошибок.
.TP 
\fBDESERR_NOHWDEVICE\fP
Шифрование выполнено, но использовался программный метод, так как не было
обнаружено запрошенное оборудование шифрования.
.TP 
\fBDESERR_HWERROR\fP
Ошибка в оборудовании или драйвере.
.TP 
\fBDESERR_BADPARAM\fP
Некорректный параметр функции.
.P
.\" .BR DES_FAILED
.\" .BR ( stat )
.\" So far the Sun page
.\" Some additions - aeb
Указывая итоговое состояние \fIstat\fP, значение макроса
\fBDES_FAILED(\fP\fIstat\fP\fB)\fP будет ложно только для первых двух состояний.
.SH АТРИБУТЫ
Описание терминов данного раздела смотрите в \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Интерфейс	Атрибут	Значение
T{
.na
.nh
\fBecb_crypt\fP(),
\fBcbc_crypt\fP(),
\fBdes_setparity\fP()
T}	Безвредность в нитях	MT\-Safe
.TE
.SH СТАНДАРТЫ
None.
.SH ИСТОРИЯ
4.3BSD.  glibc 2.1.  Removed in glibc 2.28.
.P
Because they employ the DES block cipher, which is no longer considered
secure, these functions were removed.  Applications should switch to a
modern cryptography library, such as \fBlibgcrypt\fP.
.SH "СМОТРИТЕ ТАКЖЕ"
\fBdes\fP(1), \fBcrypt\fP(3), \fBxcrypt\fP(3)
.PP
.SH ПЕРЕВОД
Русский перевод этой страницы руководства разработал(и)
Yuri Kozlov <yuray@komyakino.ru>
и
Иван Павлов <pavia00@gmail.com>
.
.PP
Этот перевод является свободной программной документацией; он распространяется
на условиях общедоступной лицензии GNU (GNU General Public License - GPL,
.UR https://www.gnu.org/licenses/gpl-3.0.html
.UE
версии 3 или более поздней) в отношении
авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.
.PP
Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста,
сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу
.MT <debian-l10n-russian@lists.debian.org>
списка рассылки русских переводчиков
.ME .