manual/LDP_man-pages/draft/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:        pseudo-terminal         µ¼»÷Ã¼Ëö
  11 .\"WORD:        specific                ÆÈ¼«¤Î
  12 .\"
  13 .TH GETPT 3 2008-06-14 "GNU" "Linux Programmer's Manual"
  14 .\"O .SH NAME
  15 .\"O getpt \- open the pseudo-terminal master (PTM)
  16 .SH Ì¾Á°
  17 getpt \- µ¼»÷Ã¼Ëö¥Þ¥¹¥¿ (PTM) ¤ò¥ª¡¼¥×¥ó¤¹¤ë
  18 .\"O .SH SYNOPSIS
  19 .SH ½ñ¼°
  20 .nf
  21 .B #define _GNU_SOURCE
  22 .B #include <stdlib.h>
  23 .sp
  24 .B "int getpt(void);"
  25 .fi
  26 .\"O .SH DESCRIPTION
  27 .SH ÀâÌÀ
  28 .\"O .BR getpt ()
  29 .\"O opens a pseudo-terminal master and returns its file descriptor.
  30 .BR getpt ()
  31 ¤Ï¡¢µ¼»÷Ã¼Ëö¥Þ¥¹¥¿¤ò¥ª¡¼¥×¥ó¤·¡¢¤½¤Î¥Õ¥¡¥¤¥ë¡¦¥Ç¥£¥¹¥¯¥ê¥×¥¿¤òÊÖ¤¹¡£
  32 .\"O It is equivalent to
  33 .\"O .nf
  34 .\"O
  35 .\"O     open(/dev/ptmx, O_RDWR | O_NOCTTY);
  36 .\"O
  37 .\"O .fi
  38 .\"O on Linux systems, though the pseudo-terminal master is located
  39 .\"O elsewhere on some systems that use GNU Libc.
  40 ¤³¤ì¤Ï¡¢ Linux ¥·¥¹¥Æ¥à¤Ë¤ª¤¤¤Æ¤Ï
  41 .nf
  42
  43     open(/dev/ptmx, O_RDWR | O_NOCTTY);
  44
  45 .fi
  46 ¤ÈÅù²Á¤Ç¤¢¤ë¡£Ã¢¤·¡¢ GNU Libc ¤ò»ÈÍÑ¤·¤Æ¤¤¤Æ¤â¡¢
  47 µ¼»÷Ã¼Ëö¥Þ¥¹¥¿¤¬¤É¤³¤«Â¾¤Î¾ì½ê¤Ë¤¢¤ë¥·¥¹¥Æ¥à¤â¤¢¤ë¡£
  48 .\"O .SH "RETURN VALUE"
  49 .SH ÊÖ¤êÃÍ
  50 .\"O .BR getpt ()
  51 .\"O returns an open file descriptor upon successful completion.
  52 .\"O Otherwise, it
  53 .\"O returns \-1 and sets
  54 .\"O .I errno
  55 .\"O to indicate the error.
  56 À®¸ù¤·¤¿¾ì¹ç¡¢
  57 .BR getpt ()
  58 ¤Ï¥ª¡¼¥×¥ó¤·¤¿¥Õ¥¡¥¤¥ë¤Î¥Ç¥£¥¹¥¯¥ê¥×¥¿¤òÊÖ¤¹¡£
  59 ¤½¤¦¤Ç¤Ê¤¤¾ì¹ç¡¢\-1 ¤òÊÖ¤·¡¢
  60 .I errno
  61 ¤Ë¥¨¥é¡¼¤ò¼¨¤¹ÃÍ¤¬¥»¥Ã¥È¤µ¤ì¤ë¡£
  62 .\"O .SH ERRORS
  63 .SH ¥¨¥é¡¼
  64 .\"O .BR getpt ()
  65 .\"O can fail with various errors described in
  66 .\"O .BR open (2).
  67 .BR getpt ()
  68 ¤Ï
  69 .BR open (2)
  70 ¤ÇÀâÌÀ¤µ¤ì¤Æ¤¤¤ë¼ï¡¹¤Î¥¨¥é¡¼¤Ç¼ºÇÔ¤¹¤ë²ÄÇ½À¤¬¤¢¤ë¡£
  71 .\"O .SH VERSIONS
  72 .SH ¥Ð¡¼¥¸¥ç¥ó
  73 .\"O .BR getpt ()
  74 .\"O is provided in glibc since version 2.1.
  75 .BR getpt ()
  76 ¤Ï¡¢¥Ð¡¼¥¸¥ç¥ó 2.1 °Ê¹ß¤Î glibc ¤ÇÄó¶¡¤µ¤ì¤Æ¤¤¤ë¡£
  77 .\"O .SH CONFORMING TO
  78 .SH ½àµò
  79 .\"O .BR getpt ()
  80 .\"O is glibc-specific;
  81 .\"O use
  82 .\"O .BR posix_openpt (3)
  83 .\"O instead.
  84 .BR getpt ()
  85 ¤Ï glibc ÆÈ¼«¤Ç¤¢¤ë¡£Âå¤ï¤ê¤Ë
  86 .BR posix_openpt (3)
  87 ¤ò»ÈÍÑ¤¹¤ë¤³¤È¡£
  88 .\"O .SH "SEE ALSO"
  89 .SH ´ØÏ¢¹àÌÜ
  90 .BR grantpt (3),
  91 .BR posix_openpt (3),
  92 .BR ptsname (3),
  93 .BR unlockpt (3),
  94 .BR ptmx (4),
  95 .BR pty (7)