chiark / gitweb /
lib/addr.c, etc.: Return plain addresses from `netaddress_resolve'.
[disorder] / lib / addr.h
CommitLineData
460b9539 1/*
2 * This file is part of DisOrder.
cca89d7c 3 * Copyright (C) 2004, 2007, 2008, 2013 Richard Kettlewell
460b9539 4 *
e7eb3a27 5 * This program is free software: you can redistribute it and/or modify
460b9539 6 * it under the terms of the GNU General Public License as published by
e7eb3a27 7 * the Free Software Foundation, either version 3 of the License, or
460b9539 8 * (at your option) any later version.
e7eb3a27
RK
9 *
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
14 *
460b9539 15 * You should have received a copy of the GNU General Public License
e7eb3a27 16 * along with this program. If not, see <http://www.gnu.org/licenses/>.
460b9539 17 */
d6ea854a
RK
18/** @file lib/addr.h
19 * @brief Socket address support */
460b9539 20
21#ifndef ADDR_H
22#define ADDR_H
23
cca89d7c
RK
24#if HAVE_NETDB_H
25# include <netdb.h>
26#endif
05b75f8d 27
76e72f65
RK
28struct stringlist;
29
30/** @brief A network address */
31struct netaddress {
32 /** @brief Address family
33 *
34 * Typically @c AF_UNIX, @c AF_INET, @c AF_INET6 or @c AF_UNSPEC.
35 * Set to -1 to mean 'no address'.
36 */
37 int af;
38
39 /** @brief Address or NULL for 'any' */
40 char *address;
41
42 /** @brief Port number */
43 int port;
44};
05b75f8d 45
802bb596
MW
46/** @brief A socket address and length */
47struct resolved {
48
49 /** @brief Pointer to the address */
50 struct sockaddr *sa;
51
52 /** @brief Length of the address */
53 socklen_t len;
54};
55
460b9539 56struct addrinfo *get_address(const struct stringlist *a,
57 const struct addrinfo *pref,
38e8ac48
RK
58 char **namep)
59 attribute((nonnull (1)));
460b9539 60
61int addrinfocmp(const struct addrinfo *a,
38e8ac48 62 const struct addrinfo *b) attribute((nonnull (1, 2)));
80dc2c5f 63int sockaddrcmp(const struct sockaddr *a,
38e8ac48 64 const struct sockaddr *b) attribute((nonnull (1, 2)));
460b9539 65
38e8ac48
RK
66int multicast(const struct sockaddr *sa) attribute((nonnull (1)));
67char *format_sockaddr(const struct sockaddr *sa) attribute((nonnull (1)));
6fba990c 68
76e72f65
RK
69int netaddress_parse(struct netaddress *na,
70 int nvec,
38e8ac48 71 char **vec) attribute((nonnull (1)));
76e72f65
RK
72void netaddress_format(const struct netaddress *na,
73 int *nvecp,
38e8ac48 74 char ***vecp) attribute((nonnull (1)));
802bb596
MW
75int netaddress_resolve(const struct netaddress *na, int passive, int type,
76 struct resolved **raddr_out, size_t *nraddr_out)
77 attribute((nonnull (1, 4, 5)));
78void netaddress_free_resolved(struct resolved *raddr, size_t nraddr);
76e72f65 79
460b9539 80#endif /* ADDR_H */
81
82/*
83Local Variables:
84c-basic-offset:2
85comment-column:40
86End:
87*/