OSDN Git Service

Retire LDP man-pages repository
[linuxjm/LDP_man-pages.git] / draft / man3 / getpass.3
diff --git a/draft/man3/getpass.3 b/draft/man3/getpass.3
deleted file mode 100644 (file)
index 8009270..0000000
+++ /dev/null
@@ -1,135 +0,0 @@
-.\" Copyright (c) 2000 Andries Brouwer (aeb@cwi.nl)
-.\"
-.\" %%%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
-.\" the License, or (at your option) any later version.
-.\"
-.\" The GNU General Public License's references to "object code"
-.\" and "executables" are to be interpreted as the output of any
-.\" document formatting or typesetting system, including
-.\" intermediate and printed output.
-.\"
-.\" This manual is distributed in the hope that it will be useful,
-.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
-.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-.\" 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, see
-.\" <http://www.gnu.org/licenses/>.
-.\" %%%LICENSE_END
-.\"
-.\"*******************************************************************
-.\"
-.\" This file was generated with po4a. Translate the source file.
-.\"
-.\"*******************************************************************
-.\"
-.\" Japanese Version Copyright (c) 1997 Hiroaki Nagoya
-.\"         all rights reserved.
-.\" Translated Mon Sep 21 20:47:50 JST 1998 by Hiroaki Nagoya <nagoya@is.titech.ac.jp>
-.\" Updated&Modified Fri 9 Feb 2001 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
-.\" Updated 2013-03-26, Akihiro MOTOKI <amotoki@gmail.com>
-.\" Updated 2013-07-22, Akihiro MOTOKI <amotoki@gmail.com>
-.\"
-.TH GETPASS 3 2014\-08\-19 Linux "Linux Programmer's Manual"
-.SH 名前
-getpass \- パスワードを取得する
-.SH 書式
-\fB#include <unistd.h>\fP
-.sp
-\fBchar *getpass(const char *\fP\fIprompt\fP\fB);\fP
-.sp
-.in -4n
-glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
-.in
-.sp
-\fBgetpass\fP():
-.ad l
-.RS 4
-.PD 0
-.TP  4
-glibc 2.2.2 以降:
-.nf
-_BSD_SOURCE ||
-    (_XOPEN_SOURCE\ >=\ 500 ||
-        _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED) &&
-    !(_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600)
-.fi
-.TP  4
-glibc 2.2.2 より前:
-なし
-.PD
-.RE
-.ad b
-.SH 説明
-この関数は時代遅れ (obsolete) である。使用しないこと。端末のエコーを有効にせずに入力の読み込みを行いたい場合は、 \fBtermios\fP(3)
-の \fIECHO\fP フラグの説明を参照のこと。
-.PP
-\fBgetpass\fP()  関数は \fI/dev/tty\fP (プロセスの制御端末) をオープンし、文字列 \fIprompt\fP を出力する。そして
-echo をオフにし、一行 (「パスワード」)  を読み込み、端末の状態を元に戻して、再び \fI/dev/tty\fP をクローズする。
-.SH 返り値
-\fBgetpass\fP()  関数は入力されたパスワード (の最初の \fBPASS_MAX\fP バイトまで) が書きこまれた、
-スタティックなバッファーへのポインターを返す。 末尾の改行は含まれない。この文字列はヌルバイト (\(aq\e0\(aq) で終端される。
-このバッファーは、以降の関数コールで上書きされるかもしれない。 エラーが起こると、端末の状態を復元し、 \fIerrno\fP を適切な値に設定して、NULL
-を返す。
-.SH エラー
-この関数は以下のような場合に失敗しうる。
-.TP 
-\fBENXIO\fP
-プロセスが制御端末を持っていない。
-.SH ファイル
-.\" .SH HISTORY
-.\" A
-.\" .BR getpass ()
-.\" function appeared in Version 7 AT&T UNIX.
-\fI/dev/tty\fP
-.SH 属性
-.SS "マルチスレッディング (pthreads(7) 参照)"
-\fBgetpass\fP() 関数はスレッドセーフではない。
-.SH 準拠
-SUSv2 には存在するが、過去の名残 (LEGACY) と位置付けられている。 POSIX.1\-2001 で削除された。
-.SH 注意
-.\" For libc4 and libc5, the prompt is not written to
-.\" .I /dev/tty
-.\" but to
-.\" .IR stderr .
-.\" Moreover, if
-.\" .I /dev/tty
-.\" cannot be opened, the password is read from
-.\" .IR stdin .
-.\" The static buffer has length 128 so that only the first 127
-.\" bytes of the password are returned.
-.\" While reading the password, signal generation
-.\" .RB ( SIGINT ,
-.\" .BR SIGQUIT ,
-.\" .BR SIGSTOP ,
-.\" .BR SIGTSTP )
-.\" is disabled and the corresponding characters
-.\" (usually control-C, control-\e, control-Z and control-Y)
-.\" are transmitted as part of the password.
-.\" Since libc 5.4.19 also line editing is disabled, so that also
-.\" backspace and the like will be seen as part of the password.
-.PP
-GNU C ライブラリの実装では、 \fI/dev/tty\fP がオープンできない場合は \fIprompt\fP は \fIstderr\fP
-に書き出され、パスワードは \fIstdin\fP から読み込まれた。 パスワードの長さには制限はなく、 行編集も無効にはされなかった。
-.PP
-.\" Libc4 and libc5 have never supported
-.\" .B PASS_MAX
-.\" or
-.\" .BR _SC_PASS_MAX .
-SUSv2 によれば、 \fBPASS_MAX\fP の値が 8 以下の場合は、この値は \fI<limits.h>\fP
-で定義されていなければならない。 いずれの場合でもこの値は \fIsysconf(_SC_PASS_MAX)\fP によって取得できる。
-しかし、POSIX.2 は定数 \fBPASS_MAX\fP, \fB_SC_PASS_MAX\fP と関数 \fBgetpass\fP()  を取り下げた。 glibc
-版は \fB_SC_PASS_MAX\fP を受け付け、 \fBBUFSIZE\fP (例えば 8192) を返す。
-.SH バグ
-この関数を呼び出したプロセスは、 できる限り早くそのパスワードを消去 (ゼロクリア) し、 クリアテキストのパスワードが
-そのプロセスのアドレス空間で見えないようにすべきである。
-.SH 関連項目
-\fBcrypt\fP(3)
-.SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
-である。プロジェクトの説明とバグ報告に関する情報は
-http://www.kernel.org/doc/man\-pages/ に書かれている。