1 |
2 |
drasko |
/* Copyright (C) 1996-2002, 2003, 2004 Free Software Foundation, Inc.
|
2 |
|
|
This file is part of the GNU C Library.
|
3 |
|
|
|
4 |
|
|
The GNU C Library is free software; you can redistribute it and/or
|
5 |
|
|
modify it under the terms of the GNU Lesser General Public
|
6 |
|
|
License as published by the Free Software Foundation; either
|
7 |
|
|
version 2.1 of the License, or (at your option) any later version.
|
8 |
|
|
|
9 |
|
|
The GNU C Library is distributed in the hope that it will be useful,
|
10 |
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
11 |
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
12 |
|
|
Lesser General Public License for more details.
|
13 |
|
|
|
14 |
|
|
You should have received a copy of the GNU Lesser General Public
|
15 |
|
|
License along with the GNU C Library; if not, write to the Free
|
16 |
|
|
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
|
17 |
|
|
02111-1307 USA. */
|
18 |
|
|
|
19 |
|
|
/* All data returned by the network data base library are supplied in
|
20 |
|
|
host order and returned in network order (suitable for use in
|
21 |
|
|
system calls). */
|
22 |
|
|
|
23 |
|
|
#ifndef _NETDB_H
|
24 |
|
|
#define _NETDB_H 1
|
25 |
|
|
|
26 |
|
|
#include <features.h>
|
27 |
|
|
|
28 |
|
|
#include <netinet/in.h>
|
29 |
|
|
#include <stdint.h>
|
30 |
|
|
#ifdef __USE_MISC
|
31 |
|
|
/* This is necessary to make this include file properly replace the
|
32 |
|
|
Sun version. */
|
33 |
|
|
# include <rpc/netdb.h>
|
34 |
|
|
#endif
|
35 |
|
|
|
36 |
|
|
#ifdef __USE_GNU
|
37 |
|
|
# define __need_sigevent_t
|
38 |
|
|
# include <bits/siginfo.h>
|
39 |
|
|
# define __need_timespec
|
40 |
|
|
# include <time.h>
|
41 |
|
|
#endif
|
42 |
|
|
|
43 |
|
|
#include <bits/netdb.h>
|
44 |
|
|
|
45 |
|
|
/* Absolute file name for network data base files. */
|
46 |
|
|
#define _PATH_HEQUIV "/etc/hosts.equiv"
|
47 |
|
|
#define _PATH_HOSTS "/etc/hosts"
|
48 |
|
|
#define _PATH_NETWORKS "/etc/networks"
|
49 |
|
|
#define _PATH_NSSWITCH_CONF "/etc/nsswitch.conf"
|
50 |
|
|
#define _PATH_PROTOCOLS "/etc/protocols"
|
51 |
|
|
#define _PATH_SERVICES "/etc/services"
|
52 |
|
|
|
53 |
|
|
|
54 |
|
|
__BEGIN_DECLS
|
55 |
|
|
|
56 |
|
|
/* Error status for non-reentrant lookup functions.
|
57 |
|
|
We use a macro to access always the thread-specific `h_errno' variable.
|
58 |
|
|
We always need the extern int here in case internal libc code undefines
|
59 |
|
|
the macro because it needs access to the underlying storage. */
|
60 |
|
|
extern int h_errno;
|
61 |
|
|
#ifdef __UCLIBC_HAS_THREADS__
|
62 |
|
|
# define h_errno (*__h_errno_location ())
|
63 |
|
|
#endif
|
64 |
|
|
|
65 |
|
|
/* Function to get address of global `h_errno' variable. */
|
66 |
|
|
extern int *__h_errno_location (void) __THROW __attribute__ ((__const__));
|
67 |
|
|
|
68 |
|
|
#ifdef _LIBC
|
69 |
|
|
# define __set_h_errno(x) (h_errno = (x))
|
70 |
|
|
#endif
|
71 |
|
|
|
72 |
|
|
/* Possible values left in `h_errno'. */
|
73 |
|
|
#define NETDB_INTERNAL -1 /* See errno. */
|
74 |
|
|
#define NETDB_SUCCESS 0 /* No problem. */
|
75 |
|
|
#define HOST_NOT_FOUND 1 /* Authoritative Answer Host not found. */
|
76 |
|
|
#define TRY_AGAIN 2 /* Non-Authoritative Host not found,
|
77 |
|
|
or SERVERFAIL. */
|
78 |
|
|
#define NO_RECOVERY 3 /* Non recoverable errors, FORMERR, REFUSED,
|
79 |
|
|
NOTIMP. */
|
80 |
|
|
#define NO_DATA 4 /* Valid name, no data record of requested
|
81 |
|
|
type. */
|
82 |
|
|
#define NO_ADDRESS NO_DATA /* No address, look for MX record. */
|
83 |
|
|
|
84 |
|
|
#ifdef __USE_XOPEN2K
|
85 |
|
|
/* Highest reserved Internet port number. */
|
86 |
|
|
# define IPPORT_RESERVED 1024
|
87 |
|
|
#endif
|
88 |
|
|
|
89 |
|
|
#ifdef __USE_GNU
|
90 |
|
|
/* Scope delimiter for getaddrinfo(), getnameinfo(). */
|
91 |
|
|
# define SCOPE_DELIMITER '%'
|
92 |
|
|
#endif
|
93 |
|
|
|
94 |
|
|
/* Print error indicated by `h_errno' variable on standard error. STR
|
95 |
|
|
if non-null is printed before the error string. */
|
96 |
|
|
extern void herror (__const char *__str) __THROW;
|
97 |
|
|
|
98 |
|
|
/* Return string associated with error ERR_NUM. */
|
99 |
|
|
extern __const char *hstrerror (int __err_num) __THROW;
|
100 |
|
|
|
101 |
|
|
|
102 |
|
|
|
103 |
|
|
/* Description of data base entry for a single host. */
|
104 |
|
|
struct hostent
|
105 |
|
|
{
|
106 |
|
|
char *h_name; /* Official name of host. */
|
107 |
|
|
char **h_aliases; /* Alias list. */
|
108 |
|
|
int h_addrtype; /* Host address type. */
|
109 |
|
|
int h_length; /* Length of address. */
|
110 |
|
|
char **h_addr_list; /* List of addresses from name server. */
|
111 |
|
|
#define h_addr h_addr_list[0] /* Address, for backward compatibility. */
|
112 |
|
|
};
|
113 |
|
|
|
114 |
|
|
/* Open host data base files and mark them as staying open even after
|
115 |
|
|
a later search if STAY_OPEN is non-zero.
|
116 |
|
|
|
117 |
|
|
This function is a possible cancellation point and therefore not
|
118 |
|
|
marked with __THROW. */
|
119 |
|
|
extern void sethostent (int __stay_open);
|
120 |
|
|
|
121 |
|
|
/* Close host data base files and clear `stay open' flag.
|
122 |
|
|
|
123 |
|
|
This function is a possible cancellation point and therefore not
|
124 |
|
|
marked with __THROW. */
|
125 |
|
|
extern void endhostent (void);
|
126 |
|
|
|
127 |
|
|
/* Get next entry from host data base file. Open data base if
|
128 |
|
|
necessary.
|
129 |
|
|
|
130 |
|
|
This function is a possible cancellation point and therefore not
|
131 |
|
|
marked with __THROW. */
|
132 |
|
|
extern struct hostent *gethostent (void);
|
133 |
|
|
|
134 |
|
|
/* Return entry from host data base which address match ADDR with
|
135 |
|
|
length LEN and type TYPE.
|
136 |
|
|
|
137 |
|
|
This function is a possible cancellation point and therefore not
|
138 |
|
|
marked with __THROW. */
|
139 |
|
|
extern struct hostent *gethostbyaddr (__const void *__addr, __socklen_t __len,
|
140 |
|
|
int __type);
|
141 |
|
|
|
142 |
|
|
/* Return entry from host data base for host with NAME.
|
143 |
|
|
|
144 |
|
|
This function is a possible cancellation point and therefore not
|
145 |
|
|
marked with __THROW. */
|
146 |
|
|
extern struct hostent *gethostbyname (__const char *__name);
|
147 |
|
|
|
148 |
|
|
#ifdef __USE_MISC
|
149 |
|
|
/* Return entry from host data base for host with NAME. AF must be
|
150 |
|
|
set to the address type which is `AF_INET' for IPv4 or `AF_INET6'
|
151 |
|
|
for IPv6.
|
152 |
|
|
|
153 |
|
|
This function is not part of POSIX and therefore no official
|
154 |
|
|
cancellation point. But due to similarity with an POSIX interface
|
155 |
|
|
or due to the implementation it is a cancellation point and
|
156 |
|
|
therefore not marked with __THROW. */
|
157 |
|
|
extern struct hostent *gethostbyname2 (__const char *__name, int __af);
|
158 |
|
|
|
159 |
|
|
/* Reentrant versions of the functions above. The additional
|
160 |
|
|
arguments specify a buffer of BUFLEN starting at BUF. The last
|
161 |
|
|
argument is a pointer to a variable which gets the value which
|
162 |
|
|
would be stored in the global variable `herrno' by the
|
163 |
|
|
non-reentrant functions.
|
164 |
|
|
|
165 |
|
|
These functions are not part of POSIX and therefore no official
|
166 |
|
|
cancellation point. But due to similarity with an POSIX interface
|
167 |
|
|
or due to the implementation they are cancellation points and
|
168 |
|
|
therefore not marked with __THROW. */
|
169 |
|
|
extern int gethostent_r (struct hostent *__restrict __result_buf,
|
170 |
|
|
char *__restrict __buf, size_t __buflen,
|
171 |
|
|
struct hostent **__restrict __result,
|
172 |
|
|
int *__restrict __h_errnop);
|
173 |
|
|
|
174 |
|
|
extern int gethostbyaddr_r (__const void *__restrict __addr, __socklen_t __len,
|
175 |
|
|
int __type,
|
176 |
|
|
struct hostent *__restrict __result_buf,
|
177 |
|
|
char *__restrict __buf, size_t __buflen,
|
178 |
|
|
struct hostent **__restrict __result,
|
179 |
|
|
int *__restrict __h_errnop);
|
180 |
|
|
|
181 |
|
|
extern int gethostbyname_r (__const char *__restrict __name,
|
182 |
|
|
struct hostent *__restrict __result_buf,
|
183 |
|
|
char *__restrict __buf, size_t __buflen,
|
184 |
|
|
struct hostent **__restrict __result,
|
185 |
|
|
int *__restrict __h_errnop);
|
186 |
|
|
|
187 |
|
|
extern int gethostbyname2_r (__const char *__restrict __name, int __af,
|
188 |
|
|
struct hostent *__restrict __result_buf,
|
189 |
|
|
char *__restrict __buf, size_t __buflen,
|
190 |
|
|
struct hostent **__restrict __result,
|
191 |
|
|
int *__restrict __h_errnop);
|
192 |
|
|
#endif /* misc */
|
193 |
|
|
|
194 |
|
|
|
195 |
|
|
/* Open network data base files and mark them as staying open even
|
196 |
|
|
after a later search if STAY_OPEN is non-zero.
|
197 |
|
|
|
198 |
|
|
This function is a possible cancellation point and therefore not
|
199 |
|
|
marked with __THROW. */
|
200 |
|
|
extern void setnetent (int __stay_open);
|
201 |
|
|
|
202 |
|
|
/* Close network data base files and clear `stay open' flag.
|
203 |
|
|
|
204 |
|
|
This function is a possible cancellation point and therefore not
|
205 |
|
|
marked with __THROW. */
|
206 |
|
|
extern void endnetent (void);
|
207 |
|
|
|
208 |
|
|
/* Get next entry from network data base file. Open data base if
|
209 |
|
|
necessary.
|
210 |
|
|
|
211 |
|
|
This function is a possible cancellation point and therefore not
|
212 |
|
|
marked with __THROW. */
|
213 |
|
|
extern struct netent *getnetent (void);
|
214 |
|
|
|
215 |
|
|
/* Return entry from network data base which address match NET and
|
216 |
|
|
type TYPE.
|
217 |
|
|
|
218 |
|
|
This function is a possible cancellation point and therefore not
|
219 |
|
|
marked with __THROW. */
|
220 |
|
|
extern struct netent *getnetbyaddr (uint32_t __net, int __type);
|
221 |
|
|
|
222 |
|
|
/* Return entry from network data base for network with NAME.
|
223 |
|
|
|
224 |
|
|
This function is a possible cancellation point and therefore not
|
225 |
|
|
marked with __THROW. */
|
226 |
|
|
extern struct netent *getnetbyname (__const char *__name);
|
227 |
|
|
|
228 |
|
|
#if 0
|
229 |
|
|
/* FIXME */
|
230 |
|
|
#ifdef __USE_MISC
|
231 |
|
|
/* Reentrant versions of the functions above. The additional
|
232 |
|
|
arguments specify a buffer of BUFLEN starting at BUF. The last
|
233 |
|
|
argument is a pointer to a variable which gets the value which
|
234 |
|
|
would be stored in the global variable `herrno' by the
|
235 |
|
|
non-reentrant functions.
|
236 |
|
|
|
237 |
|
|
These functions are not part of POSIX and therefore no official
|
238 |
|
|
cancellation point. But due to similarity with an POSIX interface
|
239 |
|
|
or due to the implementation they are cancellation points and
|
240 |
|
|
therefore not marked with __THROW. */
|
241 |
|
|
extern int getnetent_r (struct netent *__restrict __result_buf,
|
242 |
|
|
char *__restrict __buf, size_t __buflen,
|
243 |
|
|
struct netent **__restrict __result,
|
244 |
|
|
int *__restrict __h_errnop);
|
245 |
|
|
|
246 |
|
|
extern int getnetbyaddr_r (uint32_t __net, int __type,
|
247 |
|
|
struct netent *__restrict __result_buf,
|
248 |
|
|
char *__restrict __buf, size_t __buflen,
|
249 |
|
|
struct netent **__restrict __result,
|
250 |
|
|
int *__restrict __h_errnop);
|
251 |
|
|
|
252 |
|
|
extern int getnetbyname_r (__const char *__restrict __name,
|
253 |
|
|
struct netent *__restrict __result_buf,
|
254 |
|
|
char *__restrict __buf, size_t __buflen,
|
255 |
|
|
struct netent **__restrict __result,
|
256 |
|
|
int *__restrict __h_errnop);
|
257 |
|
|
#endif /* misc */
|
258 |
|
|
#endif
|
259 |
|
|
|
260 |
|
|
|
261 |
|
|
/* Description of data base entry for a single service. */
|
262 |
|
|
struct servent
|
263 |
|
|
{
|
264 |
|
|
char *s_name; /* Official service name. */
|
265 |
|
|
char **s_aliases; /* Alias list. */
|
266 |
|
|
int s_port; /* Port number. */
|
267 |
|
|
char *s_proto; /* Protocol to use. */
|
268 |
|
|
};
|
269 |
|
|
|
270 |
|
|
/* Open service data base files and mark them as staying open even
|
271 |
|
|
after a later search if STAY_OPEN is non-zero.
|
272 |
|
|
|
273 |
|
|
This function is a possible cancellation point and therefore not
|
274 |
|
|
marked with __THROW. */
|
275 |
|
|
extern void setservent (int __stay_open);
|
276 |
|
|
|
277 |
|
|
/* Close service data base files and clear `stay open' flag.
|
278 |
|
|
|
279 |
|
|
This function is a possible cancellation point and therefore not
|
280 |
|
|
marked with __THROW. */
|
281 |
|
|
extern void endservent (void);
|
282 |
|
|
|
283 |
|
|
/* Get next entry from service data base file. Open data base if
|
284 |
|
|
necessary.
|
285 |
|
|
|
286 |
|
|
This function is a possible cancellation point and therefore not
|
287 |
|
|
marked with __THROW. */
|
288 |
|
|
extern struct servent *getservent (void);
|
289 |
|
|
|
290 |
|
|
/* Return entry from network data base for network with NAME and
|
291 |
|
|
protocol PROTO.
|
292 |
|
|
|
293 |
|
|
This function is a possible cancellation point and therefore not
|
294 |
|
|
marked with __THROW. */
|
295 |
|
|
extern struct servent *getservbyname (__const char *__name,
|
296 |
|
|
__const char *__proto);
|
297 |
|
|
|
298 |
|
|
/* Return entry from service data base which matches port PORT and
|
299 |
|
|
protocol PROTO.
|
300 |
|
|
|
301 |
|
|
This function is a possible cancellation point and therefore not
|
302 |
|
|
marked with __THROW. */
|
303 |
|
|
extern struct servent *getservbyport (int __port, __const char *__proto);
|
304 |
|
|
|
305 |
|
|
|
306 |
|
|
#ifdef __USE_MISC
|
307 |
|
|
/* Reentrant versions of the functions above. The additional
|
308 |
|
|
arguments specify a buffer of BUFLEN starting at BUF.
|
309 |
|
|
|
310 |
|
|
These functions are not part of POSIX and therefore no official
|
311 |
|
|
cancellation point. But due to similarity with an POSIX interface
|
312 |
|
|
or due to the implementation they are cancellation points and
|
313 |
|
|
therefore not marked with __THROW. */
|
314 |
|
|
extern int getservent_r (struct servent *__restrict __result_buf,
|
315 |
|
|
char *__restrict __buf, size_t __buflen,
|
316 |
|
|
struct servent **__restrict __result);
|
317 |
|
|
|
318 |
|
|
extern int getservbyname_r (__const char *__restrict __name,
|
319 |
|
|
__const char *__restrict __proto,
|
320 |
|
|
struct servent *__restrict __result_buf,
|
321 |
|
|
char *__restrict __buf, size_t __buflen,
|
322 |
|
|
struct servent **__restrict __result);
|
323 |
|
|
|
324 |
|
|
extern int getservbyport_r (int __port, __const char *__restrict __proto,
|
325 |
|
|
struct servent *__restrict __result_buf,
|
326 |
|
|
char *__restrict __buf, size_t __buflen,
|
327 |
|
|
struct servent **__restrict __result);
|
328 |
|
|
#endif /* misc */
|
329 |
|
|
|
330 |
|
|
|
331 |
|
|
/* Description of data base entry for a single service. */
|
332 |
|
|
struct protoent
|
333 |
|
|
{
|
334 |
|
|
char *p_name; /* Official protocol name. */
|
335 |
|
|
char **p_aliases; /* Alias list. */
|
336 |
|
|
int p_proto; /* Protocol number. */
|
337 |
|
|
};
|
338 |
|
|
|
339 |
|
|
/* Open protocol data base files and mark them as staying open even
|
340 |
|
|
after a later search if STAY_OPEN is non-zero.
|
341 |
|
|
|
342 |
|
|
This function is a possible cancellation point and therefore not
|
343 |
|
|
marked with __THROW. */
|
344 |
|
|
extern void setprotoent (int __stay_open);
|
345 |
|
|
|
346 |
|
|
/* Close protocol data base files and clear `stay open' flag.
|
347 |
|
|
|
348 |
|
|
This function is a possible cancellation point and therefore not
|
349 |
|
|
marked with __THROW. */
|
350 |
|
|
extern void endprotoent (void);
|
351 |
|
|
|
352 |
|
|
/* Get next entry from protocol data base file. Open data base if
|
353 |
|
|
necessary.
|
354 |
|
|
|
355 |
|
|
This function is a possible cancellation point and therefore not
|
356 |
|
|
marked with __THROW. */
|
357 |
|
|
extern struct protoent *getprotoent (void);
|
358 |
|
|
|
359 |
|
|
/* Return entry from protocol data base for network with NAME.
|
360 |
|
|
|
361 |
|
|
This function is a possible cancellation point and therefore not
|
362 |
|
|
marked with __THROW. */
|
363 |
|
|
extern struct protoent *getprotobyname (__const char *__name);
|
364 |
|
|
|
365 |
|
|
/* Return entry from protocol data base which number is PROTO.
|
366 |
|
|
|
367 |
|
|
This function is a possible cancellation point and therefore not
|
368 |
|
|
marked with __THROW. */
|
369 |
|
|
extern struct protoent *getprotobynumber (int __proto);
|
370 |
|
|
|
371 |
|
|
|
372 |
|
|
#ifdef __USE_MISC
|
373 |
|
|
/* Reentrant versions of the functions above. The additional
|
374 |
|
|
arguments specify a buffer of BUFLEN starting at BUF.
|
375 |
|
|
|
376 |
|
|
These functions are not part of POSIX and therefore no official
|
377 |
|
|
cancellation point. But due to similarity with an POSIX interface
|
378 |
|
|
or due to the implementation they are cancellation points and
|
379 |
|
|
therefore not marked with __THROW. */
|
380 |
|
|
extern int getprotoent_r (struct protoent *__restrict __result_buf,
|
381 |
|
|
char *__restrict __buf, size_t __buflen,
|
382 |
|
|
struct protoent **__restrict __result);
|
383 |
|
|
|
384 |
|
|
extern int getprotobyname_r (__const char *__restrict __name,
|
385 |
|
|
struct protoent *__restrict __result_buf,
|
386 |
|
|
char *__restrict __buf, size_t __buflen,
|
387 |
|
|
struct protoent **__restrict __result);
|
388 |
|
|
|
389 |
|
|
extern int getprotobynumber_r (int __proto,
|
390 |
|
|
struct protoent *__restrict __result_buf,
|
391 |
|
|
char *__restrict __buf, size_t __buflen,
|
392 |
|
|
struct protoent **__restrict __result);
|
393 |
|
|
|
394 |
|
|
|
395 |
|
|
#ifdef __UCLIBC_HAS_NETGROUP__
|
396 |
|
|
/* Establish network group NETGROUP for enumeration.
|
397 |
|
|
|
398 |
|
|
This function is not part of POSIX and therefore no official
|
399 |
|
|
cancellation point. But due to similarity with an POSIX interface
|
400 |
|
|
or due to the implementation it is a cancellation point and
|
401 |
|
|
therefore not marked with __THROW. */
|
402 |
|
|
extern int setnetgrent (__const char *__netgroup);
|
403 |
|
|
|
404 |
|
|
/* Free all space allocated by previous `setnetgrent' call.
|
405 |
|
|
|
406 |
|
|
This function is not part of POSIX and therefore no official
|
407 |
|
|
cancellation point. But due to similarity with an POSIX interface
|
408 |
|
|
or due to the implementation it is a cancellation point and
|
409 |
|
|
therefore not marked with __THROW. */
|
410 |
|
|
extern void endnetgrent (void);
|
411 |
|
|
|
412 |
|
|
/* Get next member of netgroup established by last `setnetgrent' call
|
413 |
|
|
and return pointers to elements in HOSTP, USERP, and DOMAINP.
|
414 |
|
|
|
415 |
|
|
This function is not part of POSIX and therefore no official
|
416 |
|
|
cancellation point. But due to similarity with an POSIX interface
|
417 |
|
|
or due to the implementation it is a cancellation point and
|
418 |
|
|
therefore not marked with __THROW. */
|
419 |
|
|
extern int getnetgrent (char **__restrict __hostp,
|
420 |
|
|
char **__restrict __userp,
|
421 |
|
|
char **__restrict __domainp);
|
422 |
|
|
|
423 |
|
|
|
424 |
|
|
/* Test whether NETGROUP contains the triple (HOST,USER,DOMAIN).
|
425 |
|
|
|
426 |
|
|
This function is not part of POSIX and therefore no official
|
427 |
|
|
cancellation point. But due to similarity with an POSIX interface
|
428 |
|
|
or due to the implementation it is a cancellation point and
|
429 |
|
|
therefore not marked with __THROW. */
|
430 |
|
|
extern int innetgr (__const char *__netgroup, __const char *__host,
|
431 |
|
|
__const char *__user, __const char *domain);
|
432 |
|
|
|
433 |
|
|
/* Reentrant version of `getnetgrent' where result is placed in BUFFER.
|
434 |
|
|
|
435 |
|
|
This function is not part of POSIX and therefore no official
|
436 |
|
|
cancellation point. But due to similarity with an POSIX interface
|
437 |
|
|
or due to the implementation it is a cancellation point and
|
438 |
|
|
therefore not marked with __THROW. */
|
439 |
|
|
extern int getnetgrent_r (char **__restrict __hostp,
|
440 |
|
|
char **__restrict __userp,
|
441 |
|
|
char **__restrict __domainp,
|
442 |
|
|
char *__restrict __buffer, size_t __buflen);
|
443 |
|
|
#endif /* UCLIBC_HAS_NETGROUP */
|
444 |
|
|
#endif /* misc */
|
445 |
|
|
|
446 |
|
|
|
447 |
|
|
#ifdef __USE_BSD
|
448 |
|
|
/* Call `rshd' at port RPORT on remote machine *AHOST to execute CMD.
|
449 |
|
|
The local user is LOCUSER, on the remote machine the command is
|
450 |
|
|
executed as REMUSER. In *FD2P the descriptor to the socket for the
|
451 |
|
|
connection is returned. The caller must have the right to use a
|
452 |
|
|
reserved port. When the function returns *AHOST contains the
|
453 |
|
|
official host name.
|
454 |
|
|
|
455 |
|
|
This function is not part of POSIX and therefore no official
|
456 |
|
|
cancellation point. But due to similarity with an POSIX interface
|
457 |
|
|
or due to the implementation it is a cancellation point and
|
458 |
|
|
therefore not marked with __THROW. */
|
459 |
|
|
extern int rcmd (char **__restrict __ahost, unsigned short int __rport,
|
460 |
|
|
__const char *__restrict __locuser,
|
461 |
|
|
__const char *__restrict __remuser,
|
462 |
|
|
__const char *__restrict __cmd, int *__restrict __fd2p);
|
463 |
|
|
|
464 |
|
|
#if 0
|
465 |
|
|
/* FIXME */
|
466 |
|
|
/* This is the equivalent function where the protocol can be selected
|
467 |
|
|
and which therefore can be used for IPv6.
|
468 |
|
|
|
469 |
|
|
This function is not part of POSIX and therefore no official
|
470 |
|
|
cancellation point. But due to similarity with an POSIX interface
|
471 |
|
|
or due to the implementation it is a cancellation point and
|
472 |
|
|
therefore not marked with __THROW. */
|
473 |
|
|
extern int rcmd_af (char **__restrict __ahost, unsigned short int __rport,
|
474 |
|
|
__const char *__restrict __locuser,
|
475 |
|
|
__const char *__restrict __remuser,
|
476 |
|
|
__const char *__restrict __cmd, int *__restrict __fd2p,
|
477 |
|
|
sa_family_t __af);
|
478 |
|
|
#endif
|
479 |
|
|
|
480 |
|
|
/* Call `rexecd' at port RPORT on remote machine *AHOST to execute
|
481 |
|
|
CMD. The process runs at the remote machine using the ID of user
|
482 |
|
|
NAME whose cleartext password is PASSWD. In *FD2P the descriptor
|
483 |
|
|
to the socket for the connection is returned. When the function
|
484 |
|
|
returns *AHOST contains the official host name.
|
485 |
|
|
|
486 |
|
|
This function is not part of POSIX and therefore no official
|
487 |
|
|
cancellation point. But due to similarity with an POSIX interface
|
488 |
|
|
or due to the implementation it is a cancellation point and
|
489 |
|
|
therefore not marked with __THROW. */
|
490 |
|
|
extern int rexec (char **__restrict __ahost, int __rport,
|
491 |
|
|
__const char *__restrict __name,
|
492 |
|
|
__const char *__restrict __pass,
|
493 |
|
|
__const char *__restrict __cmd, int *__restrict __fd2p);
|
494 |
|
|
|
495 |
|
|
/* This is the equivalent function where the protocol can be selected
|
496 |
|
|
and which therefore can be used for IPv6.
|
497 |
|
|
|
498 |
|
|
This function is not part of POSIX and therefore no official
|
499 |
|
|
cancellation point. But due to similarity with an POSIX interface
|
500 |
|
|
or due to the implementation it is a cancellation point and
|
501 |
|
|
therefore not marked with __THROW. */
|
502 |
|
|
extern int rexec_af (char **__restrict __ahost, int __rport,
|
503 |
|
|
__const char *__restrict __name,
|
504 |
|
|
__const char *__restrict __pass,
|
505 |
|
|
__const char *__restrict __cmd, int *__restrict __fd2p,
|
506 |
|
|
sa_family_t __af);
|
507 |
|
|
|
508 |
|
|
/* Check whether user REMUSER on system RHOST is allowed to login as LOCUSER.
|
509 |
|
|
If SUSER is not zero the user tries to become superuser. Return 0 if
|
510 |
|
|
it is possible.
|
511 |
|
|
|
512 |
|
|
This function is not part of POSIX and therefore no official
|
513 |
|
|
cancellation point. But due to similarity with an POSIX interface
|
514 |
|
|
or due to the implementation it is a cancellation point and
|
515 |
|
|
therefore not marked with __THROW. */
|
516 |
|
|
extern int ruserok (__const char *__rhost, int __suser,
|
517 |
|
|
__const char *__remuser, __const char *__locuser);
|
518 |
|
|
|
519 |
|
|
#if 0
|
520 |
|
|
/* FIXME */
|
521 |
|
|
/* This is the equivalent function where the protocol can be selected
|
522 |
|
|
and which therefore can be used for IPv6.
|
523 |
|
|
|
524 |
|
|
This function is not part of POSIX and therefore no official
|
525 |
|
|
cancellation point. But due to similarity with an POSIX interface
|
526 |
|
|
or due to the implementation it is a cancellation point and
|
527 |
|
|
therefore not marked with __THROW. */
|
528 |
|
|
extern int ruserok_af (__const char *__rhost, int __suser,
|
529 |
|
|
__const char *__remuser, __const char *__locuser,
|
530 |
|
|
sa_family_t __af);
|
531 |
|
|
#endif
|
532 |
|
|
|
533 |
|
|
/* Try to allocate reserved port, returning a descriptor for a socket opened
|
534 |
|
|
at this port or -1 if unsuccessful. The search for an available port
|
535 |
|
|
will start at ALPORT and continues with lower numbers.
|
536 |
|
|
|
537 |
|
|
This function is not part of POSIX and therefore no official
|
538 |
|
|
cancellation point. But due to similarity with an POSIX interface
|
539 |
|
|
or due to the implementation it is a cancellation point and
|
540 |
|
|
therefore not marked with __THROW. */
|
541 |
|
|
extern int rresvport (int *__alport);
|
542 |
|
|
|
543 |
|
|
#if 0
|
544 |
|
|
/* FIXME */
|
545 |
|
|
/* This is the equivalent function where the protocol can be selected
|
546 |
|
|
and which therefore can be used for IPv6.
|
547 |
|
|
|
548 |
|
|
This function is not part of POSIX and therefore no official
|
549 |
|
|
cancellation point. But due to similarity with an POSIX interface
|
550 |
|
|
or due to the implementation it is a cancellation point and
|
551 |
|
|
therefore not marked with __THROW. */
|
552 |
|
|
extern int rresvport_af (int *__alport, sa_family_t __af);
|
553 |
|
|
#endif
|
554 |
|
|
#endif
|
555 |
|
|
|
556 |
|
|
|
557 |
|
|
/* Extension from POSIX.1g. */
|
558 |
|
|
#ifdef __USE_POSIX
|
559 |
|
|
/* Structure to contain information about address of a service provider. */
|
560 |
|
|
struct addrinfo
|
561 |
|
|
{
|
562 |
|
|
int ai_flags; /* Input flags. */
|
563 |
|
|
int ai_family; /* Protocol family for socket. */
|
564 |
|
|
int ai_socktype; /* Socket type. */
|
565 |
|
|
int ai_protocol; /* Protocol for socket. */
|
566 |
|
|
socklen_t ai_addrlen; /* Length of socket address. */
|
567 |
|
|
struct sockaddr *ai_addr; /* Socket address for socket. */
|
568 |
|
|
char *ai_canonname; /* Canonical name for service location. */
|
569 |
|
|
struct addrinfo *ai_next; /* Pointer to next in list. */
|
570 |
|
|
};
|
571 |
|
|
|
572 |
|
|
/* Possible values for `ai_flags' field in `addrinfo' structure. */
|
573 |
|
|
# define AI_PASSIVE 0x0001 /* Socket address is intended for `bind'. */
|
574 |
|
|
# define AI_CANONNAME 0x0002 /* Request for canonical name. */
|
575 |
|
|
# define AI_NUMERICHOST 0x0004 /* Don't use name resolution. */
|
576 |
|
|
# define AI_V4MAPPED 0x0008 /* IPv4 mapped addresses are acceptable. */
|
577 |
|
|
# define AI_ALL 0x0010 /* Return IPv4 mapped and IPv6 addresses. */
|
578 |
|
|
# define AI_ADDRCONFIG 0x0020 /* Use configuration of this host to choose
|
579 |
|
|
returned address type.. */
|
580 |
|
|
# ifdef __USE_GNU
|
581 |
|
|
# define AI_IDN 0x0040 /* IDN encode input (assuming it is encoded
|
582 |
|
|
in the current locale's character set)
|
583 |
|
|
before looking it up. */
|
584 |
|
|
# define AI_CANONIDN 0x0080 /* Translate canonical name from IDN format. */
|
585 |
|
|
# define AI_IDN_ALLOW_UNASSIGNED 0x0100 /* Don't reject unassigned Unicode
|
586 |
|
|
code points. */
|
587 |
|
|
# define AI_IDN_USE_STD3_ASCII_RULES 0x0200 /* Validate strings according to
|
588 |
|
|
STD3 rules. */
|
589 |
|
|
# endif
|
590 |
|
|
# define AI_NUMERICSERV 0x0400 /* Don't use name resolution. */
|
591 |
|
|
|
592 |
|
|
/* Error values for `getaddrinfo' function. */
|
593 |
|
|
# define EAI_BADFLAGS -1 /* Invalid value for `ai_flags' field. */
|
594 |
|
|
# define EAI_NONAME -2 /* NAME or SERVICE is unknown. */
|
595 |
|
|
# define EAI_AGAIN -3 /* Temporary failure in name resolution. */
|
596 |
|
|
# define EAI_FAIL -4 /* Non-recoverable failure in name res. */
|
597 |
|
|
# define EAI_NODATA -5 /* No address associated with NAME. */
|
598 |
|
|
# define EAI_FAMILY -6 /* `ai_family' not supported. */
|
599 |
|
|
# define EAI_SOCKTYPE -7 /* `ai_socktype' not supported. */
|
600 |
|
|
# define EAI_SERVICE -8 /* SERVICE not supported for `ai_socktype'. */
|
601 |
|
|
# define EAI_ADDRFAMILY -9 /* Address family for NAME not supported. */
|
602 |
|
|
# define EAI_MEMORY -10 /* Memory allocation failure. */
|
603 |
|
|
# define EAI_SYSTEM -11 /* System error returned in `errno'. */
|
604 |
|
|
# define EAI_OVERFLOW -12 /* Argument buffer overflow. */
|
605 |
|
|
# ifdef __USE_GNU
|
606 |
|
|
# define EAI_INPROGRESS -100 /* Processing request in progress. */
|
607 |
|
|
# define EAI_CANCELED -101 /* Request canceled. */
|
608 |
|
|
# define EAI_NOTCANCELED -102 /* Request not canceled. */
|
609 |
|
|
# define EAI_ALLDONE -103 /* All requests done. */
|
610 |
|
|
# define EAI_INTR -104 /* Interrupted by a signal. */
|
611 |
|
|
# define EAI_IDN_ENCODE -105 /* IDN encoding failed. */
|
612 |
|
|
# endif
|
613 |
|
|
|
614 |
|
|
# define NI_MAXHOST 1025
|
615 |
|
|
# define NI_MAXSERV 32
|
616 |
|
|
|
617 |
|
|
# define NI_NUMERICHOST 1 /* Don't try to look up hostname. */
|
618 |
|
|
# define NI_NUMERICSERV 2 /* Don't convert port number to name. */
|
619 |
|
|
# define NI_NOFQDN 4 /* Only return nodename portion. */
|
620 |
|
|
# define NI_NAMEREQD 8 /* Don't return numeric addresses. */
|
621 |
|
|
# define NI_DGRAM 16 /* Look up UDP service rather than TCP. */
|
622 |
|
|
# ifdef __USE_GNU
|
623 |
|
|
# define NI_IDN 32 /* Convert name from IDN format. */
|
624 |
|
|
# define NI_IDN_ALLOW_UNASSIGNED 64 /* Don't reject unassigned Unicode
|
625 |
|
|
code points. */
|
626 |
|
|
# define NI_IDN_USE_STD3_ASCII_RULES 128 /* Validate strings according to
|
627 |
|
|
STD3 rules. */
|
628 |
|
|
# endif
|
629 |
|
|
|
630 |
|
|
/* Translate name of a service location and/or a service name to set of
|
631 |
|
|
socket addresses.
|
632 |
|
|
|
633 |
|
|
This function is a possible cancellation point and therefore not
|
634 |
|
|
marked with __THROW. */
|
635 |
|
|
extern int getaddrinfo (__const char *__restrict __name,
|
636 |
|
|
__const char *__restrict __service,
|
637 |
|
|
__const struct addrinfo *__restrict __req,
|
638 |
|
|
struct addrinfo **__restrict __pai);
|
639 |
|
|
|
640 |
|
|
/* Free `addrinfo' structure AI including associated storage. */
|
641 |
|
|
extern void freeaddrinfo (struct addrinfo *__ai) __THROW;
|
642 |
|
|
|
643 |
|
|
/* Convert error return from getaddrinfo() to a string. */
|
644 |
|
|
extern __const char *gai_strerror (int __ecode) __THROW;
|
645 |
|
|
|
646 |
|
|
/* Translate a socket address to a location and service name.
|
647 |
|
|
|
648 |
|
|
This function is a possible cancellation point and therefore not
|
649 |
|
|
marked with __THROW. */
|
650 |
|
|
extern int getnameinfo (__const struct sockaddr *__restrict __sa,
|
651 |
|
|
socklen_t __salen, char *__restrict __host,
|
652 |
|
|
socklen_t __hostlen, char *__restrict __serv,
|
653 |
|
|
socklen_t __servlen, unsigned int __flags);
|
654 |
|
|
#endif /* POSIX */
|
655 |
|
|
|
656 |
|
|
__END_DECLS
|
657 |
|
|
|
658 |
|
|
#endif /* netdb.h */
|