/
util-net.h
112 lines (95 loc) · 4.14 KB
/
util-net.h
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
/*****************************************************************************
* Written by Chris Dunlap <cdunlap@llnl.gov>.
* Copyright (C) 2007-2013 Lawrence Livermore National Security, LLC.
* Copyright (C) 2001-2007 The Regents of the University of California.
* UCRL-CODE-2002-009.
*
* This file is part of ConMan: The Console Manager.
* For details, see <http://conman.googlecode.com/>.
*
* ConMan is free software: you can redistribute it and/or modify it under
* the terms of the GNU General Public License as published by the Free
* Software Foundation, either version 3 of the License, or (at your option)
* any later version.
*
* ConMan is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* for more details.
*
* You should have received a copy of the GNU General Public License along
* with ConMan. If not, see <http://www.gnu.org/licenses/>.
*****************************************************************************/
#ifndef _UTIL_NET_H
#define _UTIL_NET_H
#if HAVE_CONFIG_H
# include <config.h>
#endif /* HAVE_CONFIG_H */
#include <netdb.h>
#include <netinet/in.h>
#include <unistd.h>
#define HOSTENT_SIZE 8192 /* cf. Stevens UNPv1 11.15 p304 */
struct hostent * get_host_by_name(const char *name,
void *buf, int buflen, int *h_err);
/*
* A portable thread-safe alternative to be used in place of gethostbyname().
* The result is stored in the buffer (buf) of length (buflen); if the buffer
* is too small to hold the result, NULL is returned with errno = ERANGE.
* Returns a ptr into (buf) on success; returns NULL on error, setting the
* (h_err) variable reference (if not NULL) to indicate the h_error.
*/
struct hostent * get_host_by_addr(const char *addr, int len, int type,
void *buf, int buflen, int *h_err);
/*
* A portable thread-safe alternative to be used in place of gethostbyaddr().
* The result is stored in the buffer (buf) of length (buflen); if the buffer
* is too small to hold the result, NULL is returned with errno = ERANGE.
* Returns a ptr into (buf) on success; returns NULL on error, setting the
* (h_err) variable reference (if not NULL) to indicate the h_error.
*/
const char * host_strerror(int h_err);
/*
* Returns a string describing the error code (h_err) returned by
* get_host_by_name() or get_host_by_addr().
*/
int host_name_to_addr4(const char *name, struct in_addr *addr);
/*
* Converts the string (name) to an IPv4 address (addr).
* Returns 0 on success, or -1 on error.
* Note that this routine is thread-safe.
*/
char * host_addr4_to_name(const struct in_addr *addr, char *dst, int dstlen);
/*
* Converts an IPv4 address (addr) to a host name string residing in
* buffer (dst) of length (dstlen).
* Returns a ptr to the NULL-terminated string (dst) on success,
* or NULL on error.
* Note that this routine is thread-safe.
*/
char * host_name_to_cname(const char *src, char *dst, int dstlen);
/*
* Converts the hostname or IP address string (src) to the
* canonical name of the host residing in buffer (dst) of length (dstlen).
* Returns a ptr to the NULL-terminated string (dst) on success,
* or NULL on error.
* Note that this routine is thread-safe.
*/
#if ! HAVE_INET_PTON
int inet_pton(int family, const char *str, void *addr);
/*
* Convert from presentation format of an internet number in (str)
* to the binary network format, storing the result for interface
* type (family) in the socket address structure specified by (addr).
* Returns 1 if OK, 0 if input not a valid presentation format, -1 on error.
*/
#endif /* !HAVE_INET_PTON */
#if ! HAVE_INET_NTOP
const char * inet_ntop(int family, const void *addr, char *str, size_t len);
/*
* Convert an Internet address in binary network format for interface
* type (family) in the socket address structure specified by (addr),
* storing the result in the buffer (str) of length (len).
* Returns ptr to result buffer if OK, or NULL on error.
*/
#endif /* !HAVE_INET_NTOP */
#endif /* !_UTIL_NET_H */