OpenCores
URL https://opencores.org/ocsvn/openrisc/openrisc/trunk

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [ref/] [net-common-tcpip-manpages-getservent.html] - Blame information for rev 174

Details | Compare with Previous | View Log

Line No. Rev Author Line
1 28 unneback
<!-- Copyright (C) 2003 Red Hat, Inc.                                -->
2
<!-- This material may be distributed only subject to the terms      -->
3
<!-- and conditions set forth in the Open Publication License, v1.0  -->
4
<!-- or later (the latest version is presently available at          -->
5
<!-- http://www.opencontent.org/openpub/).                           -->
6
<!-- Distribution of the work or derivative of the work in any       -->
7
<!-- standard (paper) book form is prohibited unless prior           -->
8
<!-- permission is obtained from the copyright holder.               -->
9
<HTML
10
><HEAD
11
><TITLE
12
>getservent</TITLE
13
><meta name="MSSmartTagsPreventParsing" content="TRUE">
14
<META
15
NAME="GENERATOR"
16
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
17
"><LINK
18
REL="HOME"
19
TITLE="eCos Reference Manual"
20
HREF="ecos-ref.html"><LINK
21
REL="UP"
22
TITLE="TCP/IP Library Reference"
23
HREF="tcpip-library-reference.html"><LINK
24
REL="PREVIOUS"
25
TITLE="getrrsetbyname"
26
HREF="net-common-tcpip-manpages-getrrsetbyname.html"><LINK
27
REL="NEXT"
28
TITLE="if_nametoindex"
29
HREF="net-common-tcpip-manpages-if-nametoindex.html"></HEAD
30
><BODY
31
CLASS="SECT1"
32
BGCOLOR="#FFFFFF"
33
TEXT="#000000"
34
LINK="#0000FF"
35
VLINK="#840084"
36
ALINK="#0000FF"
37
><DIV
38
CLASS="NAVHEADER"
39
><TABLE
40
SUMMARY="Header navigation table"
41
WIDTH="100%"
42
BORDER="0"
43
CELLPADDING="0"
44
CELLSPACING="0"
45
><TR
46
><TH
47
COLSPAN="3"
48
ALIGN="center"
49
>eCos Reference Manual</TH
50
></TR
51
><TR
52
><TD
53
WIDTH="10%"
54
ALIGN="left"
55
VALIGN="bottom"
56
><A
57
HREF="net-common-tcpip-manpages-getrrsetbyname.html"
58
ACCESSKEY="P"
59
>Prev</A
60
></TD
61
><TD
62
WIDTH="80%"
63
ALIGN="center"
64
VALIGN="bottom"
65
>Chapter 38. TCP/IP Library Reference</TD
66
><TD
67
WIDTH="10%"
68
ALIGN="right"
69
VALIGN="bottom"
70
><A
71
HREF="net-common-tcpip-manpages-if-nametoindex.html"
72
ACCESSKEY="N"
73
>Next</A
74
></TD
75
></TR
76
></TABLE
77
><HR
78
ALIGN="LEFT"
79
WIDTH="100%"></DIV
80
><DIV
81
CLASS="SECT1"
82
><H1
83
CLASS="SECT1"
84
><A
85
NAME="NET-COMMON-TCPIP-MANPAGES-GETSERVENT">getservent</H1
86
><TABLE
87
BORDER="5"
88
BGCOLOR="#E0E0F0"
89
WIDTH="70%"
90
><TR
91
><TD
92
><PRE
93
CLASS="SCREEN"
94
>GETSERVENT(3)           System Library Functions Manual          GETSERVENT(3)
95
 
96
NAME
97
     getservent, getservbyport, getservbyname, setservent, endservent - get
98
     service entry
99
 
100
SYNOPSIS
101
     #include &lt;netdb.h&#62;
102
 
103
     struct servent *
104
     getservent(void);
105
 
106
     struct servent *
107
     getservbyname(char *name, char *proto);
108
 
109
     struct servent *
110
     getservbyport(int port, char *proto);
111
 
112
     void
113
     setservent(int stayopen);
114
 
115
     void
116
     endservent(void);
117
 
118
DESCRIPTION
119
     The getservent(), getservbyname(), and getservbyport() functions each
120
     return a pointer to an object with the following structure containing the
121
     broken-out fields of a line in the network services database,
122
     /etc/services.
123
 
124
           struct  servent {
125
                   char    *s_name;        /* official name of service */
126
                   char    **s_aliases;    /* alias list */
127
                   int     s_port;         /* port service resides at */
128
                   char    *s_proto;       /* protocol to use */
129
           };
130
 
131
     The members of this structure are:
132
 
133
     s_name     The official name of the service.
134
 
135
     s_aliases  A zero-terminated list of alternate names for the service.
136
 
137
     s_port     The port number at which the service resides.  Port numbers
138
                are returned in network byte order.
139
 
140
     s_proto    The name of the protocol to use when contacting the service.
141
 
142
     The getservent() function reads the next line of the file, opening the
143
     file if necessary.
144
 
145
     The setservent() function opens and rewinds the file.  If the stayopen
146
     flag is non-zero, the net database will not be closed after each call to
147
     getservbyname() or getservbyport().
148
 
149
     The endservent() function closes the file.
150
 
151
     The getservbyname() and getservbyport() functions sequentially search
152
     from the beginning of the file until a matching protocol name or port
153
     number (specified in network byte order) is found, or until EOF is
154
     encountered.  If a protocol name is also supplied (non-null), searches
155
     must also match the protocol.
156
 
157
FILES
158
     /etc/services
159
 
160
DIAGNOSTICS
161
     Null pointer (0) returned on EOF or error.
162
 
163
SEE ALSO
164
     getprotoent(3), services(5)
165
 
166
HISTORY
167
     The getservent(), getservbyport(), getservbyname(), setservent(), and
168
     endservent() functions appeared in 4.2BSD.
169
 
170
BUGS
171
     These functions use static data storage; if the data is needed for future
172
     use, it should be copied before any subsequent calls overwrite it.
173
     Expecting port numbers to fit in a 32-bit quantity is probably naive.
174
 
175
BSD                            January 12, 1994                            BSD
176
    </PRE
177
></TD
178
></TR
179
></TABLE
180
></DIV
181
><DIV
182
CLASS="NAVFOOTER"
183
><HR
184
ALIGN="LEFT"
185
WIDTH="100%"><TABLE
186
SUMMARY="Footer navigation table"
187
WIDTH="100%"
188
BORDER="0"
189
CELLPADDING="0"
190
CELLSPACING="0"
191
><TR
192
><TD
193
WIDTH="33%"
194
ALIGN="left"
195
VALIGN="top"
196
><A
197
HREF="net-common-tcpip-manpages-getrrsetbyname.html"
198
ACCESSKEY="P"
199
>Prev</A
200
></TD
201
><TD
202
WIDTH="34%"
203
ALIGN="center"
204
VALIGN="top"
205
><A
206
HREF="ecos-ref.html"
207
ACCESSKEY="H"
208
>Home</A
209
></TD
210
><TD
211
WIDTH="33%"
212
ALIGN="right"
213
VALIGN="top"
214
><A
215
HREF="net-common-tcpip-manpages-if-nametoindex.html"
216
ACCESSKEY="N"
217
>Next</A
218
></TD
219
></TR
220
><TR
221
><TD
222
WIDTH="33%"
223
ALIGN="left"
224
VALIGN="top"
225
>getrrsetbyname</TD
226
><TD
227
WIDTH="34%"
228
ALIGN="center"
229
VALIGN="top"
230
><A
231
HREF="tcpip-library-reference.html"
232
ACCESSKEY="U"
233
>Up</A
234
></TD
235
><TD
236
WIDTH="33%"
237
ALIGN="right"
238
VALIGN="top"
239
>if_nametoindex</TD
240
></TR
241
></TABLE
242
></DIV
243
></BODY
244
></HTML
245
>

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.