draft/man3/getlogin.3

   1 .\" Copyright 1995  James R. Van Zandt <jrv@vanzandt.mv.com>
   2 .\"
   3 .\" %%%LICENSE_START(VERBATIM)
   4 .\" Permission is granted to make and distribute verbatim copies of this
   5 .\" manual provided the copyright notice and this permission notice are
   6 .\" preserved on all copies.
   7 .\"
   8 .\" Permission is granted to copy and distribute modified versions of this
   9 .\" manual under the conditions for verbatim copying, provided that the
  10 .\" entire resulting derived work is distributed under the terms of a
  11 .\" permission notice identical to this one.
  12 .\"
  13 .\" Since the Linux kernel and libraries are constantly changing, this
  14 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  15 .\" responsibility for errors or omissions, or for damages resulting from
  16 .\" the use of the information contained herein.  The author(s) may not
  17 .\" have taken the same level of care in the production of this manual,
  18 .\" which is licensed free of charge, as they might when working
  19 .\" professionally.
  20 .\"
  21 .\" Formatted or processed versions of this manual, if unaccompanied by
  22 .\" the source, must acknowledge the copyright and authors of this work.
  23 .\" %%%LICENSE_END
  24 .\"
  25 .\" Changed Tue Sep 19 01:49:29 1995, aeb: moved from man2 to man3
  26 .\"  added ref to /etc/utmp, added BUGS section, etc.
  27 .\" modified 2003 Walter Harms, aeb - added getlogin_r, note on stdin use
  28 .\"*******************************************************************
  29 .\"
  30 .\" This file was generated with po4a. Translate the source file.
  31 .\"
  32 .\"*******************************************************************
  33 .\"
  34 .\" Japanese Version Copyright (c) 1998 NAKANO Takeo all rights reserved.
  35 .\" Translated 1998-03-01, NAKANO Takeo <nakano@apm.seikei.ac.jp>
  36 .\" Updated & Modified 1999-08-21, NAKANO Takeo <nakano@apm.seikei.ac.jp>
  37 .\" Updated & Modified 2005-03-18, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  38 .\" Updated 2013-03-25, Akihiro MOTOKI <amotoki@gmail.com>
  39 .\" Updated 2013-07-24, Akihiro MOTOKI <amotoki@gmail.com>
  40 .\"
  41 .TH GETLOGIN 3 2013\-04\-19 GNU "Linux Programmer's Manual"
  42 .SH 名前
  43 getlogin, getlogin_r, cuserid \- ユーザー名を取得する
  44 .SH 書式
  45 \fB#include <unistd.h>\fP
  46 .sp
  47 \fBchar *getlogin(void);\fP
  48 .br
  49 \fBint getlogin_r(char *\fP\fIbuf\fP\fB, size_t \fP\fIbufsize\fP\fB);\fP
  50 .sp
  51 \fB#include <stdio.h>\fP
  52 .sp
  53 \fBchar *cuserid(char *\fP\fIstring\fP\fB);\fP
  54 .sp
  55 .in -4n
  56 glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
  57 .in
  58 .sp
  59 \fBgetlogin_r\fP(): _REENTRANT || _POSIX_C_SOURCE\ >=\ 199506L
  60 .br
  61 \fBcuserid\fP(): _XOPEN_SOURCE
  62 .SH 説明
  63 \fBgetlogin\fP()  は、現在のプロセスの制御端末にログインしているユーザー名の文字列への ポインタを返す。ユーザー名が決定できない場合は
  64 NULL ポインタを返す。 文字列は静的領域に割り当てられており、この後でこの関数や \fBcuserid\fP()
  65 が呼び出された際に上書きされることがある。
  66 .PP
  67 \fBgetlogin_r\fP()  は、上記の同じユーザ名を、大きさ \fIbufsize\fP の配列 \fIbuf\fP に入れて返す。
  68 .PP
  69 \fBcuserid\fP()  は、現在のプロセスの実効ユーザーID に対応するユーザー名の 文字列へのポインタを返す。 \fIstring\fP が NULL
  70 ポインタ以外の場合、\fIstring\fP は少なくとも \fBL_cuserid\fP 文字を保持できる配列でなければならない。 \fIstring\fP が
  71 NULL ポインタの場合には、静的領域に置かれた文字列への ポインタが返される。この文字列は静的領域に割り当てられており、後で この関数や
  72 \fBgetlogin\fP()  が呼び出された際に上書きされることがある。
  73 .PP
  74 マクロ \fBL_cuserid\fP は integer の定数で、ユーザー名を保持するために 必要な配列の長さを示す。 \fBL_cuserid\fP は
  75 \fBstdio.h\fP で宣言されて いる。
  76 .PP
  77 これらの関数を使うと、プログラムを実行しているユーザー (\fBcuserid\fP())  や このセッションにログインしているユーザー
  78 (\fBgetlogin\fP())  を明確に特定することができる (ただし set\-user\-ID プログラムでは、状況が違うこともある)。
  79 .PP
  80 たいていの目的では、ユーザーの特定には環境変数 \fBLOGNAME\fP を調べ るほうが便利である。LOGNAME 変数はユーザーが自由に設定できるので
  81 より柔軟な対応が可能になる。
  82 .SH 返り値
  83 \fBgetlogin\fP()  は成功した場合はユーザ名へのポインタを返す。 失敗した場合は NULL を返し、 \fIerrno\fP
  84 にエラーの原因を示す値を設定する。 \fBgetlogin_r\fP()  は成功すると 0 を返し、失敗すると 0 以外を返す。
  85 .SH エラー
  86 POSIX では以下のエラーが規定されている:
  87 .TP
  88 \fBEMFILE\fP
  89 呼び出し元プロセスがオープンしているファイル数がすでにプロセスあたりの 上限に達している。
  90 .TP
  91 \fBENFILE\fP
  92 システム全体でオープンしているファイル数がすでに上限に達している。
  93 .TP
  94 \fBENXIO\fP
  95 呼び出し元プロセスには制御端末がない。
  96 .TP
  97 \fBERANGE\fP
  98 (getlogin_r)  (終端の NULL バイト (\(aq\e0\(aq) も含めた) ユーザ名の長さが \fIbufsize\fP よりも長い。
  99 .LP
 100 Linux/glibc には以下のエラーもある。
 101 .TP
 102 \fBENOENT\fP
 103 utmp ファイルに対応するエントリがなかった。
 104 .TP
 105 \fBENOMEM\fP
 106 passwd 構造体を割り当てるのに十分なメモリがない。
 107 .TP
 108 \fBENOTTY\fP
 109 標準入力が端末を参照していない (「バグ」の節を参照)。
 110 .SH ファイル
 111 .TP
 112 \fI/etc/passwd\fP
 113 パスワードデータベースのファイル
 114 .TP
 115 \fI/var/run/utmp\fP
 116 (伝統的には \fI/etc/utmp\fP が使われている; libc の中には \fI/var/adm/utmp\fP を使うものもある)
 117 .SH 属性
 118 .SS "マルチスレッディング (pthreads(7) 参照)"
 119 \fBgetlogin\fP() 関数はスレッドセーフではない。
 120 .LP
 121 \fBgetlogin_r\fP() 関数はスレッドセーフである。
 122 .LP
 123 \fBcuserid\fP() 関数は、例外付きのスレッドセーフである。 パラメータ NULL で呼び出した場合はスレッドセーフではない。
 124 .SH 準拠
 125 \fBgetlogin\fP()  と \fBgetlogin_r\fP()  は POSIX.1\-2001 で規定されている。
 126
 127 System V にも \fBcuserid\fP()  があるが、 これは実効ユーザー ID ではなく、実ユーザー ID を使用する。
 128 \fBcuserid\fP()  関数は 1988 年版の POSIX には含まれていたが、 1990 年版では削除された。 SUSv2
 129 に存在したが、POSIX.1\-2001 で削除された。
 130 .LP
 131 OpenBSD には \fBgetlogin\fP()  と \fBsetlogin\fP()  があり、 セッションに対応したユーザ名がある。制御端末がない
 132 セッションの場合であっても、対応するユーザ名がある。
 133 .SH バグ
 134 残念ながら、 \fBgetlogin\fP() をだますのはそれほど難しいことではない。別のプログラムが utmp ファイルを
 135 壊してしまうと、全く動作しないこともある。またログイン名の最初の 8 文字
 136 しか返さないことも多い。また、プログラムの制御端末に現在ログインしているユーザーは、プログラムを実行したユーザーでない場合もある。
 137 セキュリティの絡む用途には \fBgetlogin\fP() を用いるべきではない。
 138 .LP
 139 glibc は POSIX 仕様には従っておらず、 \fI/dev/tty\fP ではなく \fI標準入力 (stdin)\fP を使う。これはバグである。
 140 (SunOS 5.8 や HP\-UX 11.11 や FreeBSD 4.8 といった他の最近のシステムはいずれも、 \fI標準入力\fP
 141 がリダイレクトされた場合でもログイン名を返す。)
 142 .LP
 143 \fBcuserid\fP()  が何を行っているのか、実際のところを知っている者は誰もいない; 移植性が求められるプログラムでは \fBcuserid\fP()
 144 は使うべきではない。 というかどんなプログラムでも使うべきではない: 代わりに \fIgetpwuid(geteuid())\fP を用いるべきである
 145 (これが意図していることならば、だが)。 \fBcuserid\fP()  は「使わない」こと。
 146 .SH 関連項目
 147 \fBgeteuid\fP(2), \fBgetuid\fP(2), \fButmp\fP(5)
 148 .SH この文書について
 149 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
 150 である。プロジェクトの説明とバグ報告に関する情報は
 151 http://www.kernel.org/doc/man\-pages/ に書かれている。