src/socket-util.h

   1 /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/
   2
   3 #ifndef foosocketutilhfoo
   4 #define foosocketutilhfoo
   5
   6 /***
   7   This file is part of systemd.
   8
   9   Copyright 2010 Lennart Poettering
  10
  11   systemd is free software; you can redistribute it and/or modify it
  12   under the terms of the GNU General Public License as published by
  13   the Free Software Foundation; either version 2 of the License, or
  14   (at your option) any later version.
  15
  16   systemd is distributed in the hope that it will be useful, but
  17   WITHOUT ANY WARRANTY; without even the implied warranty of
  18   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  19   General Public License for more details.
  20
  21   You should have received a copy of the GNU General Public License
  22   along with systemd; If not, see <http://www.gnu.org/licenses/>.
  23 ***/
  24
  25 #include <sys/socket.h>
  26 #include <netinet/in.h>
  27 #include <sys/un.h>
  28 #include <net/if.h>
  29
  30 #include "macro.h"
  31 #include "util.h"
  32
  33 union sockaddr_union {
  34         struct sockaddr sa;
  35         struct sockaddr_in in4;
  36         struct sockaddr_in6 in6;
  37         struct sockaddr_un un;
  38         struct sockaddr_storage storage;
  39 };
  40
  41 typedef struct SocketAddress {
  42         union sockaddr_union sockaddr;
  43
  44         /* We store the size here explicitly due to the weird
  45          * sockaddr_un semantics for abstract sockets */
  46         socklen_t size;
  47
  48         /* Socket type, i.e. SOCK_STREAM, SOCK_DGRAM, ... */
  49         int type;
  50 } SocketAddress;
  51
  52 typedef enum SocketAddressBindIPv6Only {
  53         SOCKET_ADDRESS_DEFAULT,
  54         SOCKET_ADDRESS_BOTH,
  55         SOCKET_ADDRESS_IPV6_ONLY,
  56         _SOCKET_ADDRESS_BIND_IPV6_ONLY_MAX,
  57         _SOCKET_ADDRESS_BIND_IPV6_ONLY_INVALID = -1
  58 } SocketAddressBindIPv6Only;
  59
  60 #define socket_address_family(a) ((a)->sockaddr.sa.sa_family)
  61
  62 int socket_address_parse(SocketAddress *a, const char *s);
  63 int socket_address_print(const SocketAddress *a, char **p);
  64 int socket_address_verify(const SocketAddress *a);
  65
  66 bool socket_address_can_accept(const SocketAddress *a);
  67
  68 int socket_address_listen(
  69                 const SocketAddress *a,
  70                 int backlog,
  71                 SocketAddressBindIPv6Only only,
  72                 const char *bind_to_device,
  73                 bool free_bind,
  74                 mode_t directory_mode,
  75                 mode_t socket_mode,
  76                 const char *label,
  77                 int *ret);
  78
  79 bool socket_address_is(const SocketAddress *a, const char *s, int type);
  80
  81 bool socket_address_equal(const SocketAddress *a, const SocketAddress *b);
  82
  83 bool socket_address_needs_mount(const SocketAddress *a, const char *prefix);
  84
  85 const char* socket_address_bind_ipv6_only_to_string(SocketAddressBindIPv6Only b);
  86 SocketAddressBindIPv6Only socket_address_bind_ipv6_only_from_string(const char *s);
  87
  88 #endif