release/man3/getpt.3

   1 .\" Hey Emacs! This file is -*- nroff -*- source.
   2 .\" This man page was written by Jeremy Phelps <jphelps@notreached.net>.
   3 .\" Redistribute and modify at will.
   4 .\"
   5 .\" Japanese Version Copyright (c) 2003  Akihiro MOTOKI
   6 .\"         all rights reserved.
   7 .\" Translated Tue Jul  8 01:44:54 JST 2003
   8 .\"         by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
   9 .\"
  10 .\"WORD:        pseudoterminal          擬似端末
  11 .\"WORD:        specific                独自の
  12 .\"
  13 .TH GETPT 3 2010-09-10 "GNU" "Linux Programmer's Manual"
  14 .SH 名前
  15 getpt \- 擬似端末マスタ (PTM) をオープンする
  16 .SH 書式
  17 .nf
  18 .BR "#define _GNU_SOURCE" "             /* feature_test_macros(7) 参照 */"
  19 .B #include <stdlib.h>
  20 .sp
  21 .B "int getpt(void);"
  22 .fi
  23 .SH 説明
  24 .BR getpt ()
  25 は、擬似端末マスタをオープンし、そのファイル・ディスクリプタを返す。
  26 これは、 Linux システムにおいては
  27 .nf
  28
  29     open(/dev/ptmx, O_RDWR | O_NOCTTY);
  30
  31 .fi
  32 と等価である。但し、 GNU Libc を使用していても、
  33 擬似端末マスタがどこか他の場所にあるシステムもある。
  34 .SH 返り値
  35 成功した場合、
  36 .BR getpt ()
  37 はオープンしたファイルのディスクリプタを返す。
  38 そうでない場合、\-1 を返し、
  39 .I errno
  40 にエラーを示す値がセットされる。
  41 .SH エラー
  42 .BR getpt ()
  43 は
  44 .BR open (2)
  45 で説明されている種々のエラーで失敗する可能性がある。
  46 .SH バージョン
  47 .BR getpt ()
  48 は、バージョン 2.1 以降の glibc で提供されている。
  49 .SH 準拠
  50 .BR getpt ()
  51 は glibc 独自である。代わりに
  52 .BR posix_openpt (3)
  53 を使用すること。
  54 .SH 関連項目
  55 .BR grantpt (3),
  56 .BR posix_openpt (3),
  57 .BR ptsname (3),
  58 .BR unlockpt (3),
  59 .BR ptmx (4),
  60 .BR pty (7)