draft/man3/getrpcent.3

   1 .\" This page was taken from the 4.4BSD-Lite CDROM (BSD license)
   2 .\"
   3 .\" @(#)getrpcent.3n    2.2 88/08/02 4.0 RPCSRC; from 1.11 88/03/14 SMI
   4 .\"
   5 .\" Japanese Version Copyright (c) 1999 HANATAKA Shinya
   6 .\"         all rights reserved.
   7 .\" Translated 2000-01-11, HANATAKA Shinya <hanataka@abyss.rim.or.jp>
   8 .\" Updated 2008-09-19, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
   9 .\"
  10 .TH GETRPCENT 3 2008-08-19 "" "Linux Programmer's Manual"
  11 .\"O .SH NAME
  12 .SH Ì¾Á°
  13 .\"O getrpcent, getrpcbyname, getrpcbynumber, setrpcent, endrpcent \- get
  14 .\"O RPC entry
  15 getrpcent, getrpcbyname, getrpcbynumber, setrpcent, endrpcent \-
  16 RPC ¥¨¥ó¥È¥ê¤ò¼èÆÀ¤¹¤ë
  17 .\"O .SH SYNOPSIS
  18 .SH ½ñ¼°
  19 .nf
  20 .B #include <netdb.h>
  21
  22 .BI "struct rpcent *getrpcent(void);"
  23
  24 .BI "struct rpcent *getrpcbyname(char *" name );
  25
  26 .BI "struct rpcent *getrpcbynumber(int " number );
  27
  28 .BI "void setrpcent(int " stayopen );
  29
  30 .BI "void endrpcent(void);"
  31 .fi
  32 .\"O .SH DESCRIPTION
  33 .SH ÀâÌÀ
  34 .LP
  35 .BR getrpcent (),
  36 .BR getrpcbyname (),
  37 .\"O and
  38 .BR getrpcbynumber ()
  39 .\"O each return a pointer to an object with the
  40 .\"O following structure containing the broken-out
  41 .\"O fields of an entry in the RPC program number data base.
  42 ¤Ï¤½¤ì¤¾¤ì°Ê²¼¤Î¹½Â¤ÂÎ¤Ø¤Î¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£
  43 ¤³¤Î¹½Â¤ÂÎ¤Ï RPC ¥×¥í¥°¥é¥àÈÖ¹æ¥Ç¡¼¥¿¥Ù¡¼¥¹
  44 ¤Î³Æ¹Ô¤Î¥Õ¥£¡¼¥ë¥É¤ò´Þ¤ó¤Ç¤¤¤ë¡£
  45 .in +4n
  46 .nf
  47
  48 struct rpcent {
  49     char  *r_name;     /* name of server for this RPC program */
  50     char **r_aliases;  /* alias list */
  51     long   r_number;   /* RPC program number */
  52 };
  53 .fi
  54 .in
  55 .LP
  56 .\"O The members of this structure are:
  57 ¤³¤Î¹½Â¤ÂÎ¤Î¥á¥ó¥Ð¡¼¤Ï°Ê²¼¤ÎÄÌ¤ê¡£
  58 .RS 4
  59 .TP 12
  60 .I r_name
  61 .\"O The name of the server for this RPC program.
  62 ¤³¤Î RPC ¥×¥í¥°¥é¥à¤Î¥µ¡¼¥Ð¤ÎÌ¾Á°
  63 .TP
  64 .I r_aliases
  65 .\"O A zero terminated list of alternate names for the RPC program.
  66 RPC ¥×¥í¥°¥é¥à¤ÎÊÌÌ¾¤Î¥ê¥¹¥È¡£¥¼¥í¤Ç½ªÃ¼¤µ¤ì¤Æ¤¤¤ë¡£
  67 .TP
  68 .I r_number
  69 .\"O The RPC program number for this service.
  70 ¤³¤Î¥µ¡¼¥Ó¥¹¤Î RPC ¥×¥í¥°¥é¥àÈÖ¹æ¡£
  71 .RE
  72 .LP
  73 .\"O .BR getrpcent ()
  74 .\"O reads the next entry from the database.
  75 .\"O A connection is opened to the database if necessary.
  76 .BR getrpcent ()
  77 ¤Ï¥Õ¥¡¥¤¥ë¤Î¼¡¤Î¥¨¥ó¥È¥ê¤òÆÉ¤ß¹þ¤à¡£
  78 É¬Í×¤Ê¤é¤Ð¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ø¤ÎÀÜÂ³¤¬¥ª¡¼¥×¥ó¤µ¤ì¤ë¡£
  79 .LP
  80 .\"O .BR setrpcent ()
  81 .\"O function opens a connection to the database,
  82 .\"O and sets the next entry to the first entry.
  83 .\"O If \fIstayopen\fP is nonzero,
  84 .\"O then the connection to the database
  85 .\"O will not be closed between calls to one of the
  86 .\"O .BR getrpc* ()
  87 .\"O functions.
  88 .BR setrpcent ()
  89 ¤Ï¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ø¤ÎÀÜÂ³¤ò¥ª¡¼¥×¥ó¤·¡¢
  90 ¼¡¤ÎÆÉ¤ß¹þ¤ß¥¨¥ó¥È¥ê¤òÀèÆ¬¤Î¥¨¥ó¥È¥ê¤ËÀßÄê¤¹¤ë¡£
  91 \fIstayopen\fP ¤¬ 0 ¤Ç¤Ê¤¤¾ì¹ç¡¢
  92 °ì¤Ä°ì¤Ä¤Î
  93 .BR getrpc* ()
  94 ´Ø¿ô¤Î¸Æ¤Ó½Ð¤·´Ö¤Ç¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ø¤ÎÀÜÂ³¤ò¥¯¥í¡¼¥º¤·¤Ê¤¤¡£
  95 .LP
  96 .\"O The
  97 .\"O .BR endrpcent ()
  98 .\"O function closes the connection to the database.
  99 .BR endrpcent ()
 100 ¤Ï¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ø¤ÎÀÜÂ³¤ò¥¯¥í¡¼¥º¤¹¤ë¡£
 101 .LP
 102 .\"O .BR getrpcbyname ()
 103 .\"O and
 104 .\"O .BR getrpcbynumber ()
 105 .\"O sequentially search from the beginning
 106 .\"O of the file until a matching RPC program name or
 107 .\"O program number is found, or until end-of-file is encountered.
 108 .BR getrpcbyname ()
 109 ¤È
 110 .BR getrpcbynumber ()
 111 ¤Ï¥Õ¥¡¥¤¥ë¤ÎºÇ½é¤«¤é°ìÃ×¤¹¤ë RPC ¥×¥í¥°¥é¥àÌ¾¤«¥×¥í¥°¥é¥àÈÖ¹æ¤¬
 112 ¸«¤Ä¤«¤ë¤«¡¢¥Õ¥¡¥¤¥ë¤ÎºÇ¸å (end-of-file) ¤ËÅþÃ£¤¹¤ë¤Þ¤Ç¡¢½çÈÖ¤Ë
 113 Ãµ¤·¤Æ¤¤¤¯¡£
 114 .\"O .SH RETURN VALUE
 115 .SH ÊÖ¤êÃÍ
 116 .\"O On success,
 117 .\"O .BR getrpcent (),
 118 .\"O .BR getrpcbyname (),
 119 .\"O and
 120 .\"O .BR getrpcbynumber ()
 121 .\"O return a pointer to a statically allocated
 122 .\"O .I rpcent
 123 .\"O structure.
 124 À®¸ù¤¹¤ë¤È¡¢
 125 .BR getrpcent (),
 126 .BR getrpcbyname (),
 127 .BR getrpcbynumber ()
 128 ¤Ï¡¢ÀÅÅª¤Ë³ä¤êÅö¤Æ¤é¤ì¤¿
 129 .I rpcent
 130 ¹½Â¤ÂÎ¤Ø¤Î¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£
 131 .\"O A NULL pointer is returned on EOF or error.
 132 EOF ¤« ¥¨¥é¡¼¤ËÁø¶ø¤·¤¿¾ì¹ç¤Ë¤Ï NULL ¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£
 133 .\"O .SH FILES
 134 .SH ¥Õ¥¡¥¤¥ë
 135 .TP
 136 .I /etc/rpc
 137 .\"O RPC program number database.
 138 RPC ¥×¥í¥°¥é¥àÈÖ¹æ¥Ç¡¼¥¿¥Ù¡¼¥¹
 139 .\"O .SH "CONFORMING TO"
 140 .SH ½àµò
 141 .\"O Not in POSIX.1-2001.
 142 .\"O Present on the BSDs, Solaris, and many other systems.
 143 POSIX.1-2001 ¤Ë¤Ï¤Ê¤¤¡£
 144 BSD ·Ï¡¢Solaris ¤äÂ¾¤ÎÂ¿¤¯¤Î¥·¥¹¥Æ¥à¤ËÂ¸ºß¤¹¤ë¡£
 145 .\"O .SH BUGS
 146 .SH ¥Ð¥°
 147 .\"O All information
 148 .\"O is contained in a static area
 149 .\"O so it must be copied if it is
 150 .\"O to be saved.
 151 Á´¤Æ¤Î¾ðÊó¤ÏÀÅÅªÎÎ°è¤Ë³ÊÇ¼¤µ¤ì¤ë¡£
 152 ÊÝÂ¸¤¹¤ë¤¿¤á¤Ë¤ÏÁ´¤Æ¤ò¥³¥Ô¡¼¤¹¤ëÉ¬Í×¤¬¤¢¤ë¡£
 153 .\"O .SH "SEE ALSO"
 154 .SH ´ØÏ¢¹àÌÜ
 155 .BR getrpcent_r (3),
 156 .BR rpc (5),
 157 .BR rpcinfo (8),
 158 .BR ypserv (8)