release/man3/ptsname.3

   1 .\" Hey Emacs! This file is -*- nroff -*- source.
   2 .\" This page is in the public domain. - aeb
   3 .\"
   4 .\" 2004-12-17, mtk, added description of ptsname_r() + ERRORS
   5 .\"
   6 .\" Japanese Version Copyright (c) 2003  Akihiro MOTOKI
   7 .\"         all rights reserved.
   8 .\" Translated 2003-07-08, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
   9 .\" Updated 2005-02-27, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  10 .\"
  11 .\"WORD:        pseudoterminal          µ¼»÷Ã¼Ëö
  12 .\"
  13 .TH PTSNAME 3 2008-09-03 "" "Linux Programmer's Manual"
  14 .SH Ì¾Á°
  15 ptsname, ptsname_r \- ¥¹¥ì¡¼¥Öµ¼»÷Ã¼Ëö¤ÎÌ¾Á°¤ò¼èÆÀ¤¹¤ë
  16 .SH ½ñ¼°
  17 .nf
  18 .BR "#define _XOPEN_SOURCE" "       /* feature_test_macros(7) »²¾È */"
  19 .br
  20 .B #include <stdlib.h>
  21 .sp
  22 .BI "char *ptsname(int " fd ");"
  23 .sp
  24 .BR "#define _GNU_SOURCE" "         /* feature_test_macros(7) »²¾È */"
  25 .br
  26 .B #include <stdlib.h>
  27 .sp
  28 .BI "int ptsname_r(int " fd ", char *" buf ", size_t " buflen ");"
  29 .fi
  30 .SH ÀâÌÀ
  31 .BR ptsname ()
  32 ´Ø¿ô¤Ï
  33 .I fd
  34 ¤Ç»²¾È¤µ¤ì¤ë¥Þ¥¹¥¿µ¼»÷Ã¼Ëö (pts) ¥Ç¥Ð¥¤¥¹¤ËÂÐ±þ¤¹¤ë
  35 ¥¹¥ì¡¼¥Öµ¼»÷Ã¼Ëö¥Ç¥Ð¥¤¥¹¤ÎÌ¾Á°¤òÊÖ¤¹¡£
  36
  37 .BR ptsname_r ()
  38 ´Ø¿ô¤Ï
  39 .BR ptsname ()
  40 ¤Î¥ê¥¨¥ó¥È¥é¥ó¥È¤Ê¥Ð¡¼¥¸¥ç¥ó¤Ç¤¢¤ë¡£
  41 ¤³¤Î´Ø¿ô¤Ï¡¢¥¹¥ì¡¼¥Öµ¿»÷Ã¼Ëö¥Ç¥Ð¥¤¥¹¤ÎÌ¾Á°¤ò¡¢
  42 NULL ¤Ç½ªÃ¼¤µ¤ì¤¿Ê¸»úÎó¤Î·Á¤Ç
  43 .I buf
  44 ¤Ç»ØÄê¤µ¤ì¤¿¥Ð¥Ã¥Õ¥¡¤Ë³ÊÇ¼¤·¤ÆÊÖ¤¹¡£
  45 .I buflen
  46 °ú¤¿ô¤Ë¤Ï
  47 .I buf
  48 ¤Î¥Ð¥¤¥È¿ô¤ò»ØÄê¤¹¤ë¡£
  49 .SH ÊÖ¤êÃÍ
  50 À®¸ù¤Î¾ì¹ç¡¢
  51 .BR ptsname ()
  52 ¤ÏÀÅÅªµ²±ÎÎ°è¤ÎÊ¸»úÎó¤Ø¤Î¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£
  53 ¤³¤Îµ²±ÎÎ°è¤Ï¤³¤Î¸å¤Î
  54 .BR ptsname ()
  55 ¤Î¸Æ¤Ó½Ð¤·¤Ç¾å½ñ¤¤µ¤ì¤ë¡£
  56 ¤³¤Î¥Ý¥¤¥ó¥¿¤ò free ¤·¤Æ¤Ï¤¤¤±¤Ê¤¤¡£
  57 ¥¨¥é¡¼¤Î¾ì¹ç¤Ï NULL ¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£
  58
  59 À®¸ù¤Î¾ì¹ç¡¢
  60 .BR ptsname_r ()
  61 ¤Ï 0 ¤òÊÖ¤¹¡£
  62 ¥¨¥é¡¼¤Î¾ì¹ç¡¢0 °Ê³°¤ÎÃÍ¤òÊÖ¤·¡¢
  63 .I errno
  64 ¤ò¥¨¥é¡¼¤ò¼¨¤¹ÃÍ¤ËÀßÄê¤¹¤ë¡£
  65 .\" ¼ÂºÝ¤Ë¤Ï¡¢errno ¤ÎÃÍ¤¬´Ø¿ô¤Î·ë²Ì¤ÎÊÖ¤êÃÍ¤È¤·¤Æ¤âÊÖ¤µ¤ì¤ë¡£-- MTK, Dec 04
  66 .SH ¥¨¥é¡¼
  67 .TP
  68 .B EINVAL
  69 .RB ( ptsname_r ()
  70 ¤Î¤ß)
  71 .I buf
  72 ¤¬ NULL ¤Ç¤¢¤ë¡£
  73 .TP
  74 .B ENOTTY
  75 .I fd
  76 ¤¬¥Þ¥¹¥¿µ¿»÷Ã¼Ëö¥Ç¥Ð¥¤¥¹¤ò»²¾È¤·¤Æ¤¤¤Ê¤¤¡£
  77 .TP
  78 .B ERANGE
  79 .RB ( ptsname_r ()
  80 ¤Î¤ß)
  81 .I buf
  82 ¤¬¾®¤µ¤¹¤®¤ë¡£
  83 .SH ¥Ð¡¼¥¸¥ç¥ó
  84 .BR ptsname ()
  85 ¤Ï¡¢¥Ð¡¼¥¸¥ç¥ó 2.1 °Ê¹ß¤Î glibc ¤ÇÄó¶¡¤µ¤ì¤Æ¤¤¤ë¡£
  86 .SH ½àµò
  87 .BR ptsname ()
  88 ¤Ï UNIX 98 µ¿»÷Ã¼Ëö»ÅÍÍ¤Î°ìÉô¤Ç¤¢¤ë
  89 .RB ( pts (4)
  90 ¤ò»²¾È¤Î¤³¤È)¡£¤³¤Î´Ø¿ô¤Ï POSIX.1-2001 ¤Çµ¬Äê¤µ¤ì¤Æ¤¤¤ë¡£
  91
  92 .BR ptsname_r ()
  93 ¤Ï Linux ¤Ë¤è¤ë³ÈÄ¥¤Ç¤¢¤ë¡£
  94 ¤³¤Î´Ø¿ô¤Ë¤Ä¤¤¤Æ¤ÎµºÜ¤¬¤¢¤ë¤â¤Î¤È¤·¤Æ Tru64 ¤È HP-UX ¤¬¤¢¤ë¤¬¡¢
  95 ¤³¤ì¤é¤Î OS ¤Ç¤Î¼ÂÁõ¤Ç¤Ï¥¨¥é¡¼¤Î¾ì¹ç \-1 ¤òÊÖ¤·¡¢
  96 .I errno
  97 ¤Ë¥¨¥é¡¼¤ò¼¨¤¹ÃÍ¤òÀßÄê¤¹¤ë¡£
  98 °Ü¿¢¤ò¹ÍÎ¸¤·¤¿¥×¥í¥°¥é¥à¤Ç¤Ï¤³¤Î´Ø¿ô¤Î»ÈÍÑ¤ÏÈò¤±¤ë¤³¤È¡£
  99 .SH ´ØÏ¢¹àÌÜ
 100 .BR grantpt (3),
 101 .BR posix_openpt (3),
 102 .BR ttyname (3),
 103 .BR unlockpt (3),
 104 .BR pts (4),
 105 .BR pty (7)