OSDN Git Service

Update README
[linuxjm/LDP_man-pages.git] / draft / man3 / crypt.3
index ec2d9c4..6081d98 100644 (file)
@@ -1,6 +1,7 @@
 .\" Michael Haardt (michael@cantor.informatik.rwth.aachen.de)
 .\"     Sat Sep  3 22:00:30 MET DST 1994
 .\"
+.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
 .\" This is free documentation; you can redistribute it and/or
 .\" modify it under the terms of the GNU General Public License as
 .\" published by the Free Software Foundation; either version 2 of
@@ -17,9 +18,9 @@
 .\" GNU General Public License for more details.
 .\"
 .\" You should have received a copy of the GNU General Public
-.\" License along with this manual; if not, write to the Free
-.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
-.\" USA.
+.\" License along with this manual; if not, see
+.\" <http://www.gnu.org/licenses/>.
+.\" %%%LICENSE_END
 .\"
 .\" Sun Feb 19 21:32:25 1995, faith@cs.unc.edu edited details away
 .\"
 .\" This file was generated with po4a. Translate the source file.
 .\"
 .\"*******************************************************************
-.TH CRYPT 3 2011\-09\-15 "" "Linux Programmer's Manual"
+.\"
+.\" Japanese Version Copyright (c) 1998 Hiroaki Nagoya and MAEHARA Kouichi all rights reserved.
+.\" Translated Sun Sep 27 JST 1998 by Hiroaki Nagoya <nagoya@cc.hit-u.ac.jp> and MAEHARA Kouichi <maeharak@kw.netlaputa.ne.jp>
+.\" Updated 2002-01-19 by Kentaro Shirakata <argrath@ub32.org>
+.\" Updated 2007-01-01 by Kentaro Shirakata <argrath@ub32.org>
+.\" Updated 2008-07-30 by Kentaro Shirakata <argrath@ub32.org>
+.\" Updated 2009-09-28 by Kentaro Shirakata <argrath@ub32.org>
+.\"
+.TH CRYPT 3 2014\-02\-26 "" "Linux Programmer's Manual"
 .SH 名前
 crypt, crypt_r \- パスワードとデータの暗号化
 .SH 書式
@@ -61,14 +70,14 @@ crypt, crypt_r \- パスワードとデータの暗号化
 \fBcrypt\fP()  はパスワード暗号化関数である。 鍵探索のハードウェアによる実装を妨げるように(その他にもいろいろ)  変更した Data
 Encryption Standard アルゴリズムを元にしている。
 .PP
-\fIkey\fP はユーザが入力するパスワードである。
+\fIkey\fP ã\81¯ã\83¦ã\83¼ã\82¶ã\83¼ã\81\8cå\85¥å\8a\9bã\81\99ã\82\8bã\83\91ã\82¹ã\83¯ã\83¼ã\83\89ã\81§ã\81\82ã\82\8bã\80\82
 .PP
-\fIsalt\fP は集合 [\fBa\fP\(en\fBzA\fP\(en\fBZ0\fP\(en\fB9./\fP] から選ばれた 2 文字の文字列である。
-この文字列はアルゴリズムの出力を 4096 通りにかき乱すのに使われる。
+\fIsalt\fP は集合 [\fBa\-zA\-Z0\-9./\fP] から選ばれた 2 文字の文字列である。 この文字列はアルゴリズムの出力を 4096
+通りにかき乱すのに使われる。
 .PP
 \fIkey\fP の最初の 8 文字の各文字から下位 7 ビットをとって 56 ビットの鍵が得られる。 この 56 ビットの鍵は特定の文字列(ふつうはすべて
-0 の文字列)  を繰り返し暗号化するのに用いられる。 返り値は暗号化されたパスワードへのポインタで、13 の印字可能な ASCII 文字
-からなる(最初の 2 文字は salt そのもの)。 返り値は、関数呼出しのたびに上書きされる静的なデータへのポインタである。
+0 ã\81®æ\96\87å­\97å\88\97)  ã\82\92ç¹°ã\82\8aè¿\94ã\81\97æ\9a\97å\8f·å\8c\96ã\81\99ã\82\8bã\81®ã\81«ç\94¨ã\81\84ã\82\89ã\82\8cã\82\8bã\80\82 è¿\94ã\82\8aå\80¤ã\81¯æ\9a\97å\8f·å\8c\96ã\81\95ã\82\8cã\81\9fã\83\91ã\82¹ã\83¯ã\83¼ã\83\89ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\81§ã\80\8113 ã\81®å\8d°å­\97å\8f¯è\83½ã\81ª ASCII æ\96\87å­\97
\81\8bã\82\89ã\81ªã\82\8b\9c\80å\88\9dã\81® 2 æ\96\87å­\97ã\81¯ salt ã\81\9dã\81®ã\82\82ã\81®)ã\80\82 è¿\94ã\82\8aå\80¤ã\81¯ã\80\81é\96¢æ\95°å\91¼å\87ºã\81\97ã\81®ã\81\9fã\81³ã\81«ä¸\8aæ\9b¸ã\81\8dã\81\95ã\82\8cã\82\8bé\9d\99ç\9a\84ã\81ªã\83\87ã\83¼ã\82¿ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\81§ã\81\82ã\82\8bã\80\82
 .PP
 警告: 鍵空間は
 .if  t 2\s-2\u56\s0\d
@@ -83,12 +92,17 @@ DES アルゴリズムにはいくつかの癖があり、それによってパ
 ライブラリのひとつを 手にいれるべきだ。
 
 \fBcrypt_r\fP()  は \fBcrypt\fP()  の再入可能版である。 \fIdata\fP で示される構造体は結果データの保存と情報の管理に使われる。
-この構造体に対して(メモリを割り当てること以外に)呼び出し元がするべき唯一の ことは、 \fBcrypt_r\fP()  の初回の呼び出しの前に
\81\93ã\81®æ§\8bé\80 ä½\93ã\81«å¯¾ã\81\97ã\81¦(ã\83¡ã\83¢ã\83ªã\83¼ã\82\92å\89²ã\82\8aå½\93ã\81¦ã\82\8bã\81\93ã\81¨ä»¥å¤\96ã\81«)å\91¼ã\81³å\87ºã\81\97å\85\83ã\81\8cã\81\99ã\82\8bã\81¹ã\81\8då\94¯ä¸\80ã\81® ã\81\93ã\81¨ã\81¯ã\80\81 \fBcrypt_r\fP()  ã\81®å\88\9då\9b\9eã\81®å\91¼ã\81³å\87ºã\81\97ã\81®å\89\8dã\81«
 \fIdata\->initialized\fP をゼロにすることだけである。
 .SH 返り値
 成功の場合には、暗号化されたパスワードへのポインターが返される。 エラーの場合には NULL が返される。
 .SH エラー
 .TP 
+\fBEINVAL\fP
+\fIsalt\fP が間違ったフォーマットである。
+.TP 
+\fB
+.TP 
 \fBENOSYS\fP
 .\" This level of detail is not necessary in this man page. . .
 .\" .PP
@@ -125,6 +139,14 @@ DES アルゴリズムにはいくつかの癖があり、それによってパ
 .\" Making encrypted data computed using crypt() publicly available has
 .\" to be considered insecure for the given reasons.
 \fBcrypt\fP()  関数が実装されていない。多分アメリカの輸出規制のために。
+.TP 
+\fBEPERM\fP
+\fI/proc/sys/crypto/fips_enabled\fP が 0 でない値で、 DES などの弱い暗号タイプを利用しようとした。
+.SH 属性
+.SS "マルチスレッディング (pthreads(7) 参照)"
+\fBcrypt\fP() 関数はスレッドセーフではない。
+.LP
+\fBcrypt_r\fP() 関数はスレッドセーフである。
 .SH 準拠
 \fBcrypt\fP(): SVr4, 4.3BSD, POSIX.1\-2001.  \fBcrypt_r\fP()  は GNU 拡張である。
 .SH 注意
@@ -170,7 +192,11 @@ SHA\-256 | 43 characters
 SHA\-512 | 86 characters
 .TE
 
-"\fIsalt\fP" と "\fIencrypted\fP" の文字は [\fBa\fP\(en\fBzA\fP\(en\fBZ0\fP\(en\fB9./\fP] の集合から
-選ばれる。 MD5 と SHA の実装では、 \fIkey\fP 全体が意味がある (DES の場合には最初の 8 文字だけに意味がある)。
+"\fIsalt\fP" と "\fIencrypted\fP" の文字は [\fBa\-zA\-Z0\-9./\fP] の集合から 選ばれる。 MD5 と SHA
+の実装では、 \fIkey\fP 全体が意味がある (DES の場合には最初の 8 文字だけに意味がある)。
 .SH 関連項目
 \fBlogin\fP(1), \fBpasswd\fP(1), \fBencrypt\fP(3), \fBgetpass\fP(3), \fBpasswd\fP(5)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。