release/man3/grantpt.3

   1 .\" Hey Emacs! This file is -*- nroff -*- source.
   2 .\" This page is in the public domain. - aeb
   3 .\"
   4 .\" Japanese Version Copyright (c) 2003  Akihiro MOTOKI
   5 .\"         all rights reserved.
   6 .\" Translated Tue Jul  8 01:56:27 JST 2003
   7 .\"         by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
   8 .\"
   9 .\"WORD:        pseudoterminal          擬似端末
  10 .\"WORD:        pseudotty               擬似端末
  11 .\"
  12 .TH GRANTPT 3 2008-06-14 "GNU" "Linux Programmer's Manual"
  13 .SH 名前
  14 grantpt \- スレーブ擬似端末へのアクセスを許可する
  15 .SH 書式
  16 .nf
  17 .BR "#define _XOPEN_SOURCE" "       /* feature_test_macros(7) 参照 */"
  18 .br
  19 .B #include <stdlib.h>
  20 .sp
  21 .BI "int grantpt(int " fd ");"
  22 .fi
  23 .SH 説明
  24 .BR grantpt ()
  25 関数は、
  26 .I fd
  27 で参照されたマスタ擬似端末に対応するスレーブ擬似端末デバイス
  28 のモードと所有者を変更する。
  29 スレーブのユーザID は呼び出したプロセスの実 UID に設定される。
  30 グループID として設定される値は規定されていない (例えば \fItty\fP になる)。
  31 スレーブのモードは 0620 (crw\-\-w\-\-\-\-) に設定される。
  32 .PP
  33 .B SIGCHLD
  34 シグナルを捕捉するためにシグナル・ハンドラが設定されている場合の
  35 .BR grantpt ()
  36 の動作は規定されていない。
  37 .SH 返り値
  38 成功した場合、
  39 .BR grantpt ()
  40 は 0 を返す。そうでない場合、\-1 を返し、
  41 .I errno
  42 に適切な値がセットされる。
  43 .SH エラー
  44 .TP
  45 .B EACCES
  46 対応するスレーブ擬似端末にアクセスできなかった。
  47 .TP
  48 .B EBADF
  49 引き数
  50 .I fd
  51 が有効なオープンされたファイル・ディスクリプタでない。
  52 .TP
  53 .B EINVAL
  54 引き数
  55 .I fd
  56 は有効だが、マスタ擬似端末に対応するものではない。
  57 .SH バージョン
  58 .BR grantpt ()
  59 は、バージョン 2.1 以降の glibc で提供されている。
  60 .SH 準拠
  61 POSIX.1-2001.
  62 .SH 備考
  63 これは UNIX 98 擬似端末 (pseudoterminal) 仕様の一部である。
  64 .BR pts (4)
  65 を参照のこと。
  66 多くのシステムでは、この関数は "pt_chown" と呼ばれる set-user-ID された
  67 補助バイナリを用いて実装されている。
  68 Linux の devpts では、このような補助バイナリを必要としない。
  69 .SH 関連項目
  70 .BR open (2),
  71 .BR posix_openpt (3),
  72 .BR ptsname (3),
  73 .BR unlockpt (3),
  74 .BR pts (4),
  75 .BR pty (7)