.\" Copyright Sun Microsystems, Inc (and is provided for unrestricted use,
.\" see other Sun RPC sources).
.\"
-.\" Japanese Version Copyright (c) 2004 Yuichi SATO
-.\" all rights reserved.
-.\" Translated Fri Jul 23 05:53:35 JST 2004
-.\" by Yuichi SATO <ysato444@yahoo.co.jp>
+.\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
+.\" can be distributed under GPL.
+.\" %%%LICENSE_END
.\"
-.TH DES_CRYPT 3 2007-05-18 "" "Linux Programmer's Manual"
-.\"O .SH NAME
-.SH ̾Á°
-.\"O des_crypt, ecb_crypt, cbc_crypt, des_setparity, DES_FAILED \- fast
-.\"O DES encryption
-des_crypt, ecb_crypt, cbc_crypt, des_setparity, DES_FAILED \- ¹â®¤Ê DES °Å¹æ²½
-.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH DES_CRYPT 3 2007\-05\-18 "" "Linux Programmer's Manual"
+.SH 名前
+des_crypt, ecb_crypt, cbc_crypt, des_setparity, DES_FAILED \- 高速な DES 暗号化
+.SH 書式
.nf
-.\"O .\" Sun version
-.\" Sun ¤Î¾ì¹ç¤Ï
+.\" Sun version
.\" .B #include <des_crypt.h>
-.B #include <rpc/des_crypt.h>
+\fB#include <rpc/des_crypt.h>\fP
.LP
-.BI "int ecb_crypt(char *" key ", char *" data ", unsigned " datalen ,
-.BI " unsigned " mode );
+\fBint ecb_crypt(char *\fP\fIkey\fP\fB, char *\fP\fIdata\fP\fB, unsigned \fP\fIdatalen\fP\fB,\fP
+\fB unsigned \fP\fImode\fP\fB);\fP
.LP
-.BI "int cbc_crypt(char *" key ", char *" data ", unsigned " datalen ,
-.BI " unsigned " mode ", char *" ivec );
+\fBint cbc_crypt(char *\fP\fIkey\fP\fB, char *\fP\fIdata\fP\fB, unsigned \fP\fIdatalen\fP\fB,\fP
+\fB unsigned \fP\fImode\fP\fB, char *\fP\fIivec\fP\fB);\fP
.LP
-.BI "void des_setparity(char *" key );
+\fBvoid des_setparity(char *\fP\fIkey\fP\fB);\fP
.LP
-.BI "int DES_FAILED(int " status );
+\fBint DES_FAILED(int \fP\fIstatus\fP\fB);\fP
.fi
-.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
-.\"O .BR ecb_crypt ()
-.\"O and
-.\"O .BR cbc_crypt ()
-.\"O implement the
-.\"O NBS
-.\"O DES
-.\"O (Data Encryption Standard).
-.BR ecb_crypt ()
-¤È
-.BR cbc_crypt ()
-¤Ï
-NBS
-DES
-(Data Encryption Standard, ¥Ç¡¼¥¿°Å¹æ²½µ¬³Ê) ¤ò¼ÂÁõ¤·¤Æ¤¤¤ë¡£
-.\"O These routines are faster and more general purpose than
-.\"O .BR crypt (3).
-¤³¤ì¤é¤Î¥ë¡¼¥Á¥ó¤Ï
-.BR crypt (3)
-¤è¤ê¤â¹â®¤Ç¤è¤ê°ìÈÌŪ¤ÊÌÜŪ¤Ë»ÈÍѤǤ¤ë¡£
-.\"O They also are able to utilize
-.\"O DES
-.\"O hardware if it is available.
-ÍøÍѲÄǽ¤Ç¤¢¤ì¤Ð¡¢¤³¤ì¤é¤Î¥ë¡¼¥Á¥ó¤Ï
-DES
-¥Ï¡¼¥É¥¦¥§¥¢¤ò»ÈÍѤ¹¤ë¤³¤È¤â¤Ç¤¤ë¡£
-.\"O .BR ecb_crypt ()
-.\"O encrypts in
-.\"O ECB
-.\"O (Electronic Code Book)
-.\"O mode, which encrypts blocks of data independently.
-.BR ecb_crypt ()
-¤Ï
-ECB
-(Electronic Code Book) ¥â¡¼¥É¤Ç°Å¹æ²½¤¹¤ë¡£
-¤³¤Î¥â¡¼¥É¤Ç¤Ï (¸Ä¡¹¤Î) ¥Ç¡¼¥¿¤Î¥Ö¥í¥Ã¥¯¤òÆÈΩ¤·¤Æ°Å¹æ²½¤¹¤ë
-.\"O .BR cbc_crypt ()
-.\"O encrypts in
-.\"O CBC
-.\"O (Cipher Block Chaining)
-.\"O mode, which chains together
-.\"O successive blocks.
-.BR cbc_crypt ()
-¤Ï
-CBC
-(Cipher Block Chaining) ¥â¡¼¥É¤Ç°Å¹æ²½¤¹¤ë¡£
-¤³¤Î¥â¡¼¥É¤Ç¤ÏϢ³¤¹¤ë¥Ö¥í¥Ã¥¯¤ò¸ß¤¤¤ËÏ¢º¿¤µ¤»¤Æ°Å¹æ²½¤¹¤ë¡£
-.\"O CBC
-.\"O mode protects against insertions, deletions and
-.\"O substitutions of blocks.
-.\"O Also, regularities in the clear text will
-.\"O not appear in the cipher text.
-CBC
-¤Ï¥Ö¥í¥Ã¥¯¤ÎÁÞÆþ¡¦ºï½ü¡¦ÃÖ¤´¹¤¨¤«¤éÊݸ¤ë¡£
-¤Þ¤¿Ê¿Ê¸¤Îµ¬Â§À¤¬°Å¹æʸ¤Ë¸½¤ì¤Ê¤¤¡£
+.SH 説明
+\fBecb_crypt\fP() と \fBcbc_crypt\fP() は NBS DES (Data Encryption Standard,
+データ暗号化規格) を実装している。 これらのルーチンは \fBcrypt\fP(3) よりも高速でより一般的な目的に使用できる。
+利用可能であれば、これらのルーチンは DES ハードウェアを使用することもできる。 \fBecb_crypt\fP() は ECB (Electronic
+Code Book) モードで暗号化する。 このモードでは (個々の) データのブロックを独立して暗号化する \fBcbc_crypt\fP() は CBC
+(Cipher Block Chaining) モードで暗号化する。 このモードでは連続するブロックを互いに連鎖させて暗号化する。 CBC
+はブロックの挿入・削除・置き換えから保護する。 また平文の規則性が暗号文に現れない。
.LP
-.\"O Here is how to use these routines.
-.\"O The first argument,
-.\"O .IR key ,
-.\"O is the 8-byte encryption key with parity.
-¤³¤ì¤é¤Î¥ë¡¼¥Á¥ó¤Î»ÈÍÑË¡¤ò¼¨¤¹¡£
-Âè 1 °ú¤¿ô
-.I key
-¤Ï¥Ñ¥ê¥Æ¥£ÉÕ¤¤Î 8 ¥Ð¥¤¥È¤Î°Å¹æ²½¸°¤Ç¤¢¤ë¡£
-.\"O To set the key's parity, which for
-.\"O DES
-.\"O is in the low bit of each byte, use
-.\"O .BR des_setparity ().
-¸°¤Î¥Ñ¥ê¥Æ¥£¤òÀßÄꤹ¤ë¤Ë¤Ï
-.BR des_setparity ()
-¤ò»È¤¦¤³¤È¡£
-DES
-¤Î¾ì¹ç¡¢¸°¤Î¥Ñ¥ê¥Æ¥£¤Ï³Æ¥Ð¥¤¥È¤ÎºÇ²¼°Ì¥Ó¥Ã¥È¤Ç¤¢¤ë¡£
-.\"O The second argument,
-.\"O .IR data ,
-.\"O contains the data to be encrypted or decrypted.
-Âè 2 °ú¤¿ô
-.I data
-¤Ï°Å¹æ²½¤Þ¤¿¤ÏÉü¹æ²½¤µ¤ì¤ë¥Ç¡¼¥¿¤ò´Þ¤à¡£
-.\"O The
-.\"O third argument,
-.\"O .IR datalen ,
-.\"O is the length in bytes of
-.\"O .IR data ,
-.\"O which must be a multiple of 8.
-Âè 3 °ú¤¿ô
-.I datalen
-¤Ï
-.I data
-¤Î¥Ð¥¤¥ÈŤǤ¢¤ê¡¢8 ¤ÎÇÜ¿ô¤Ç¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
-.\"O The fourth argument,
-.\"O .IR mode ,
-.\"O is formed by ORing together some things.
-Âè 4 °ú¤¿ô
-.I mode
-¤Ï¤¤¤¯¤Ä¤«¤ÎÃͤò OR ¤¹¤ë¤³¤È¤ÇºîÀ®¤¹¤ë¡£
-.\"O For the encryption direction OR in either
-.\"O .BR DES_ENCRYPT
-.\"O or
-.\"O .BR DES_DECRYPT .
-°Å¹æ²½¤ÎÊý¸þ (ÌõÃð: °Å¹æ²½¤Ê¤Î¤«Éü¹æ²½¤Ê¤Î¤«) ¤ò»ØÄꤹ¤ë¤¿¤á¡¢
-.BR DES_ENCRYPT
-¤Þ¤¿¤Ï
-.BR DES_DECRYPT
-¤ò OR ¤¹¤ë¡£
-.\"O For software versus hardware
-.\"O encryption, OR in either
-.\"O .BR DES_HW
-.\"O or
-.\"O .BR DES_SW .
-°Å¹æ²½¤ò¥½¥Õ¥È¥¦¥§¥¢¤Ç¹Ô¤¦¤«¥Ï¡¼¥É¥¦¥§¥¢¤Ç¹Ô¤¦¤«¤ò»ØÄꤹ¤ë¤¿¤á¡¢
-.BR DES_HW
-¤Þ¤¿¤Ï
-.BR DES_SW
-¤ò OR ¤¹¤ë¡£
-.\"O If
-.\"O .BR DES_HW
-.\"O is specified, and there is no hardware, then the encryption is performed
-.\"O in software and the routine returns
-.\"O .BR DESERR_NOHWDEVICE .
-.BR DES_HW
-¤¬»ØÄꤵ¤ì¤Æ¤¤¤Æ¡¢¤«¤Ä¥Ï¡¼¥É¥¦¥§¥¢¤¬¤Ê¤¤¾ì¹ç¡¢
-°Å¹æ²½¤Ï¥½¥Õ¥È¥¦¥§¥¢¤Ç¼Â¹Ô¤µ¤ì¤Æ¡¢¥ë¡¼¥Á¥ó¤Ï
-.BR DESERR_NOHWDEVICE
-¤òÊÖ¤¹¡£
-.\"O For
-.\"O .BR cbc_crypt (),
-.\"O the argument
-.\"O .I ivec
-.\"O is the 8-byte initialization
-.\"O vector for the chaining.
-.\"O It is updated to the next initialization
-.\"O vector upon return.
-.BR cbc_crypt ()
-¤Ë¤ª¤¤¤Æ¡¢°ú¤¿ô
-.I ivec
-¤Ï¥Ç¡¼¥¿¥Ö¥í¥Ã¥¯¤òÏ¢º¿¤µ¤»¤ëºÝ¤Î 8 ¥Ð¥¤¥È¤Î½é´ü²½¥Ù¥¯¥È¥ë¤Ç¤¢¤ë¡£
-¤³¤Î°ú¤¿ô¤Ï¥ë¡¼¥Á¥ó¤«¤éÌá¤ë¤È¤¤Ë¼¡¤Î½é´ü²½¥Ù¥¯¥È¥ë¤Ë¹¹¿·¤µ¤ì¤ë¡£
-.\"O .SH RETURN VALUE
-.SH ÊÖ¤êÃÍ
+これらのルーチンの使用法を示す。 第 1 引き数 \fIkey\fP はパリティ付きの 8 バイトの暗号化鍵である。 鍵のパリティを設定するには
+\fBdes_setparity\fP() を使うこと。 DES の場合、鍵のパリティは各バイトの最下位ビットである。 第 2 引き数 \fIdata\fP
+は暗号化または復号化されるデータを含む。 第 3 引き数 \fIdatalen\fP は \fIdata\fP のバイト長であり、8 の倍数でなければならない。 第
+4 引き数 \fImode\fP はいくつかの値を OR することで作成する。 暗号化の方向 (訳註: 暗号化なのか復号化なのか) を指定するため、
+\fBDES_ENCRYPT\fP または \fBDES_DECRYPT\fP を OR する。 暗号化をソフトウェアで行うかハードウェアで行うかを指定するため、
+\fBDES_HW\fP または \fBDES_SW\fP を OR する。 \fBDES_HW\fP が指定されていて、かつハードウェアがない場合、
+暗号化はソフトウェアで実行されて、ルーチンは \fBDESERR_NOHWDEVICE\fP を返す。 \fBcbc_crypt\fP() において、引き数
+\fIivec\fP はデータブロックを連鎖させる際の 8 バイトの初期化ベクトルである。 この引き数はルーチンから戻るときに次の初期化ベクトルに更新される。
+.SH 返り値
.PD 0
-.TP 20
-.\"O .BR DESERR_NONE
-.B DESERR_NONE
-.\"O No error.
-¥¨¥é¡¼¤Ê¤·¡£
-.TP
-.\"O .BR DESERR_NOHWDEVICE
-.B DESERR_NOHWDEVICE
-.\"O Encryption succeeded, but done in software instead of the requested hardware.
-°Å¹æ²½¤ÏÀ®¸ù¤·¤¿¤¬¡¢Í׵ᤵ¤ì¤¿¥Ï¡¼¥É¥¦¥§¥¢¤ÎÂå¤ï¤ê¤Ë¥½¥Õ¥È¥¦¥§¥¢¤Ç¼Â¹Ô¤µ¤ì¤¿¡£
-.TP
-.\"O .BR DESERR_HWERROR
-.B DESERR_HWERROR
-.\"O An error occurred in the hardware or driver.
-¥Ï¡¼¥É¥¦¥§¥¢¤Þ¤¿¤Ï¥É¥é¥¤¥Ð¤Ç¥¨¥é¡¼¤¬È¯À¸¤·¤¿¡£
-.TP
-.\"O .BR DESERR_BADPARAM
-.B DESERR_BADPARAM
-.\"O Bad argument to routine.
-¥ë¡¼¥Á¥ó¤Ø¤Î°ú¤¿ô¤¬ÉÔÀµ¤Ç¤¢¤ë¡£
+.TP 20
+\fBDESERR_NONE\fP
+エラーなし。
+.TP
+\fBDESERR_NOHWDEVICE\fP
+暗号化は成功したが、要求されたハードウェアの代わりにソフトウェアで実行された。
+.TP
+\fBDESERR_HWERROR\fP
+ハードウェアまたはドライバでエラーが発生した。
+.TP
+\fBDESERR_BADPARAM\fP
+ルーチンへの引き数が不正である。
.PD
.LP
-.\"O Given a result status
-.\"O .IR stat ,
-.\"O the macro
-.\"O .\" .BR DES_FAILED\c
-.\"O .\" .BR ( stat )
-.\"O .BI DES_FAILED( stat )
-.\"O is false only for the first two statuses.
-·ë²Ì¤Î¾õÂÖ
-.I stat
-¤òÍ¿¤¨¤¿¤È¤¡¢¥Þ¥¯¥í
.\" .BR DES_FAILED\c
.\" .BR ( stat )
-.BI DES_FAILED( stat )
-¤¬ false ¤Ë¤Ê¤ë¤Î¤Ï¡¢ºÇ½é¤Î 2 ¤Ä¤À¤±¤Ç¤¢¤ë¡£
-.\"O .\" So far the Sun page
-.\"O .\" Some additions - aeb
-.\" ¤³¤³¤Þ¤Ç¤¬ Sun ¤Î man ¥Ú¡¼¥¸¤Ç¤¢¤ë¡£
-.\" aeb ¤¬¤¤¤¯¤Ä¤«Äɲäò¹Ô¤Ã¤¿¡£
-.\"O .SH VERSIONS
-.SH ¥Ð¡¼¥¸¥ç¥ó
-.\"O These routines are present in libc 4.6.27 and later, and in
-.\"O glibc 2.1 and later.
-¤³¤ì¤é¤Î¥ë¡¼¥Á¥ó¤Ï libc 4.6.27 °Ê¹ß¤È glibc 2.1 °Ê¹ß¤Ë¸ºß¤¹¤ë¡£
-.\"O .SH "CONFORMING TO"
-.SH ½àµò
-.\"O 4.3BSD.
-.\"O Not in POSIX.1-2001.
-4.3BSD. POSIX.1-2001 ¤Ë¤Ï¤Ê¤¤¡£
-.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
-.BR des (1),
-.BR crypt (3),
-.BR xcrypt (3)
+.\" So far the Sun page
+.\" Some additions - aeb
+結果の状態 \fIstat\fP を与えたとき、マクロ \fBDES_FAILED(\fP\fIstat\fP\fB)\fP が false になるのは、最初の 2
+つだけである。
+.SH バージョン
+これらのルーチンは libc 4.6.27 以降と glibc 2.1 以降に存在する。
+.SH 準拠
+4.3BSD. POSIX.1\-2001 にはない。
+.SH 関連項目
+\fBdes\fP(1), \fBcrypt\fP(3), \fBxcrypt\fP(3)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
