chiark - git - mdw - disorder/blob - lib/addr.h

   1 /*
   2  * This file is part of DisOrder.
   3  * Copyright (C) 2004, 2007, 2008, 2013 Richard Kettlewell
   4  *
   5  * This program is free software: you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License as published by
   7  * the Free Software Foundation, either version 3 of the License, or
   8  * (at your option) any later version.
   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  *
  15  * You should have received a copy of the GNU General Public License
  16  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  17  */
  18 /** @file lib/addr.h
  19  * @brief Socket address support */
  20
  21 #ifndef ADDR_H
  22 #define ADDR_H
  23
  24 #if HAVE_NETDB_H
  25 # include <netdb.h>
  26 #endif
  27
  28 struct stringlist;
  29
  30 /** @brief A network address */
  31 struct 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 };
  45
  46 struct addrinfo *get_address(const struct stringlist *a,
  47                              const struct addrinfo *pref,
  48                              char **namep)
  49   attribute((nonnull (1)));
  50
  51 int addrinfocmp(const struct addrinfo *a,
  52                 const struct addrinfo *b) attribute((nonnull (1, 2)));
  53 int sockaddrcmp(const struct sockaddr *a,
  54                 const struct sockaddr *b) attribute((nonnull (1, 2)));
  55
  56 int multicast(const struct sockaddr *sa) attribute((nonnull (1)));
  57 char *format_sockaddr(const struct sockaddr *sa) attribute((nonnull (1)));
  58
  59 int netaddress_parse(struct netaddress *na,
  60                      int nvec,
  61                      char **vec) attribute((nonnull (1)));
  62 void netaddress_format(const struct netaddress *na,
  63                        int *nvecp,
  64                        char ***vecp) attribute((nonnull (1)));
  65 struct addrinfo *netaddress_resolve(const struct netaddress *na,
  66                                     int passive,
  67                                     int protocol) attribute((nonnull (1)));
  68
  69 #endif /* ADDR_H */
  70
  71 /*
  72 Local Variables:
  73 c-basic-offset:2
  74 comment-column:40
  75 End:
  76 */