draft/man3/getttyent.3

   1 .\"  Copyright 2002 walter harms (walter.harms@informatik.uni-oldenburg.de)
   2 .\"
   3 .\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
   4 .\" Distributed under GPL
   5 .\" %%%LICENSE_END
   6 .\"
   7 .\"*******************************************************************
   8 .\"
   9 .\" This file was generated with po4a. Translate the source file.
  10 .\"
  11 .\"*******************************************************************
  12 .\"
  13 .\" Japanese Version Copyright (c) 2004 Yuichi SATO
  14 .\"         all rights reserved.
  15 .\" Translated Fri Aug 20 03:27:22 JST 2004
  16 .\"         by Yuichi SATO <ysato444@yahoo.co.jp>
  17 .\"
  18 .TH GETTTYENT 3 2013\-07\-22 GNU "Linux Programmer's Manual"
  19 .SH 名前
  20 getttyent, getttynam, setttyent, endttyent \- ttys ファイルのエントリを取得する
  21 .SH 書式
  22 \fB#include <ttyent.h>\fP
  23 .sp
  24 \fBstruct ttyent *getttyent(void);\fP
  25 .sp
  26 \fBstruct ttyent *getttynam(const char *\fP\fIname\fP\fB);\fP
  27 .sp
  28 \fBint setttyent(void);\fP
  29 .sp
  30 \fBint endttyent(void);\fP
  31 .SH 説明
  32 これらの関数はファイル \fB_PATH_TTYS\fP (例えば \fI/etc/ttys\fP)  へのインタフェースを提供する。
  33
  34 関数 \fBsetttyent\fP()  はファイルをオープンする。 また既にオープンされている場合は、巻き戻す。
  35
  36 関数 \fBendttyent\fP()  はファイルをクローズする。
  37
  38 関数 \fBgetttynam\fP()  は指定された端末名についてファイルを検索する。 この関数は (以下で説明されている)  \fIttyent\fP
  39 構造体へのポインタを返す。
  40
  41 関数 \fBgetttyent\fP()  は (もし必要であれば) ファイル \fB_PATH_TTYS\fP をオープンし、最初のエントリを返す。
  42 ファイルが既にオープンされている場合は、次のエントリを返す。 \fIttyent\fP 構造体は以下の通りである。
  43 .in +4n
  44 .nf
  45
  46 struct ttyent {
  47     char *ty_name;     /* 端末デバイス名 */
  48     char *ty_getty;    /* 実行するコマンド。通常は getty */
  49     char *ty_type;     /* termcap のための端末タイプ */
  50     int   ty_status;   /* 状態フラグ */
  51     char *ty_window;   /* ウィンドウマネージャを起動するコマンド */
  52     char *ty_comment;  /* コメントフィールド */
  53 };
  54 .fi
  55 .in
  56
  57 \fIty_status\fP は以下のいずれか値をとることができる。
  58 .br
  59 .nf
  60
  61 #define TTY_ON     0x01  /* ログインを有効にする (ty_getty プログラムを開始する) */
  62 #define TTY_SECURE 0x02  /* ユーザ ID 0 でのログインを許可する */
  63 .fi
  64 .SH 属性
  65 .SS "マルチスレッディング (pthreads(7) 参照)"
  66 関数 \fBgetttyent\fP() は静的変数へのポインタを返す。そのため、スレッドセーフではない。
  67 .LP
  68 関数 \fBsetttyent\fP() と \fBendttyent\fP() は静的変数を使用する。そのため、スレッドセーフではない。
  69 .LP
  70 関数 \fBgetttynam\fP() はスレッドセーフではない関数 \fBgetttyent\fP() を呼び出す。そのため、スレッドセーフではない。
  71 .SH 準拠
  72 POSIX.1\-2001 にはない。 BSD 系に存在し、おそらく他のシステムにもあるだろう。
  73 .SH 注意
  74 Linux では、ファイル \fI/etc/ttys\fP と上で説明した関数は使われていない。
  75 .SH 関連項目
  76 \fBttyname\fP(3), \fBttyslot\fP(3)
  77 .SH この文書について
  78 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
  79 である。プロジェクトの説明とバグ報告に関する情報は
  80 http://www.kernel.org/doc/man\-pages/ に書かれている。