draft/man3/des_crypt.3

   1 .\" @(#)des_crypt.3     2.1 88/08/11 4.0 RPCSRC; from 1.16 88/03/02 SMI;
   2 .\"
   3 .\" Taken from libc4 sources, which say:
   4 .\" Copyright (C) 1993 Eric Young - can be distributed under GPL.
   5 .\"
   6 .\" However, the above header line suggests that this file in fact is
   7 .\" Copyright Sun Microsystems, Inc (and is provided for unrestricted use,
   8 .\" see other Sun RPC sources).
   9 .\"
  10 .\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
  11 .\" can be distributed under GPL.
  12 .\" %%%LICENSE_END
  13 .\"
  14 .\"*******************************************************************
  15 .\"
  16 .\" This file was generated with po4a. Translate the source file.
  17 .\"
  18 .\"*******************************************************************
  19 .\"
  20 .\" Japanese Version Copyright (c) 2004 Yuichi SATO
  21 .\"         all rights reserved.
  22 .\" Translated Fri Jul 23 05:53:35 JST 2004
  23 .\"         by Yuichi SATO <ysato444@yahoo.co.jp>
  24 .\"
  25 .TH DES_CRYPT 3 2007\-05\-18 "" "Linux Programmer's Manual"
  26 .SH 名前
  27 des_crypt, ecb_crypt, cbc_crypt, des_setparity, DES_FAILED \- 高速な DES 暗号化
  28 .SH 書式
  29 .nf
  30 .\" Sun version
  31 .\" .B #include <des_crypt.h>
  32 \fB#include <rpc/des_crypt.h>\fP
  33 .LP
  34 \fBint ecb_crypt(char *\fP\fIkey\fP\fB, char *\fP\fIdata\fP\fB, unsigned \fP\fIdatalen\fP\fB,\fP
  35 \fB              unsigned \fP\fImode\fP\fB);\fP
  36 .LP
  37 \fBint cbc_crypt(char *\fP\fIkey\fP\fB, char *\fP\fIdata\fP\fB, unsigned \fP\fIdatalen\fP\fB,\fP
  38 \fB              unsigned \fP\fImode\fP\fB, char *\fP\fIivec\fP\fB);\fP
  39 .LP
  40 \fBvoid des_setparity(char *\fP\fIkey\fP\fB);\fP
  41 .LP
  42 \fBint DES_FAILED(int \fP\fIstatus\fP\fB);\fP
  43 .fi
  44 .SH 説明
  45 \fBecb_crypt\fP()  と \fBcbc_crypt\fP()  は NBS DES (Data Encryption Standard,
  46 データ暗号化規格) を実装している。 これらのルーチンは \fBcrypt\fP(3)  よりも高速でより一般的な目的に使用できる。
  47 利用可能であれば、これらのルーチンは DES ハードウェアを使用することもできる。 \fBecb_crypt\fP()  は ECB (Electronic
  48 Code Book) モードで暗号化する。 このモードでは (個々の) データのブロックを独立して暗号化する \fBcbc_crypt\fP()  は CBC
  49 (Cipher Block Chaining) モードで暗号化する。 このモードでは連続するブロックを互いに連鎖させて暗号化する。 CBC
  50 はブロックの挿入・削除・置き換えから保護する。 また平文の規則性が暗号文に現れない。
  51 .LP
  52 これらのルーチンの使用法を示す。 第 1 引き数 \fIkey\fP はパリティ付きの 8 バイトの暗号化鍵である。 鍵のパリティを設定するには
  53 \fBdes_setparity\fP()  を使うこと。 DES の場合、鍵のパリティは各バイトの最下位ビットである。 第 2 引き数 \fIdata\fP
  54 は暗号化または復号化されるデータを含む。 第 3 引き数 \fIdatalen\fP は \fIdata\fP のバイト長であり、8 の倍数でなければならない。 第
  55 4 引き数 \fImode\fP はいくつかの値を OR することで作成する。 暗号化の方向 (訳註: 暗号化なのか復号化なのか) を指定するため、
  56 \fBDES_ENCRYPT\fP または \fBDES_DECRYPT\fP を OR する。 暗号化をソフトウェアで行うかハードウェアで行うかを指定するため、
  57 \fBDES_HW\fP または \fBDES_SW\fP を OR する。 \fBDES_HW\fP が指定されていて、かつハードウェアがない場合、
  58 暗号化はソフトウェアで実行されて、ルーチンは \fBDESERR_NOHWDEVICE\fP を返す。 \fBcbc_crypt\fP()  において、引き数
  59 \fIivec\fP はデータブロックを連鎖させる際の 8 バイトの初期化ベクトルである。 この引き数はルーチンから戻るときに次の初期化ベクトルに更新される。
  60 .SH 返り値
  61 .PD 0
  62 .TP  20
  63 \fBDESERR_NONE\fP
  64 エラーなし。
  65 .TP
  66 \fBDESERR_NOHWDEVICE\fP
  67 暗号化は成功したが、要求されたハードウェアの代わりにソフトウェアで実行された。
  68 .TP
  69 \fBDESERR_HWERROR\fP
  70 ハードウェアまたはドライバでエラーが発生した。
  71 .TP
  72 \fBDESERR_BADPARAM\fP
  73 ルーチンへの引き数が不正である。
  74 .PD
  75 .LP
  76 .\" .BR DES_FAILED\c
  77 .\" .BR ( stat )
  78 .\" So far the Sun page
  79 .\" Some additions - aeb
  80 結果の状態 \fIstat\fP を与えたとき、マクロ \fBDES_FAILED(\fP\fIstat\fP\fB)\fP が false になるのは、最初の 2
  81 つだけである。
  82 .SH バージョン
  83 これらのルーチンは libc 4.6.27 以降と glibc 2.1 以降に存在する。
  84 .SH 準拠
  85 4.3BSD. POSIX.1\-2001 にはない。
  86 .SH 関連項目
  87 \fBdes\fP(1), \fBcrypt\fP(3), \fBxcrypt\fP(3)
  88 .SH この文書について
  89 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
  90 である。プロジェクトの説明とバグ報告に関する情報は
  91 http://www.kernel.org/doc/man\-pages/ に書かれている。