src/socket-util.h

   1 /*-*- Mode: C; c-basic-offset: 8 -*-*/
   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 typedef struct SocketAddress {
  34         union {
  35                 struct sockaddr sa;
  36                 struct sockaddr_in in4;
  37                 struct sockaddr_in6 in6;
  38                 struct sockaddr_un un;
  39                 struct sockaddr_storage storage;
  40         } sockaddr;
  41
  42         /* We store the size here explicitly due to the weird
  43          * sockaddr_un semantics for abstract sockets */
  44         socklen_t size;
  45
  46         /* Socket type, i.e. SOCK_STREAM, SOCK_DGRAM, ... */
  47         int type;
  48 } SocketAddress;
  49
  50 typedef enum SocketAddressBindIPv6Only {
  51         SOCKET_ADDRESS_DEFAULT,
  52         SOCKET_ADDRESS_BOTH,
  53         SOCKET_ADDRESS_IPV6_ONLY,
  54         _SOCKET_ADDRESS_BIND_IPV6_ONLY_MAX,
  55         _SOCKET_ADDRESS_BIND_IPV6_ONLY_INVALID = -1
  56 } SocketAddressBindIPv6Only;
  57
  58 #define socket_address_family(a) ((a)->sockaddr.sa.sa_family)
  59
  60 int socket_address_parse(SocketAddress *a, const char *s);
  61 int socket_address_print(const SocketAddress *a, char **p);
  62 int socket_address_verify(const SocketAddress *a);
  63
  64 bool socket_address_can_accept(const SocketAddress *a);
  65
  66 int socket_address_listen(
  67                 const SocketAddress *a,
  68                 int backlog,
  69                 SocketAddressBindIPv6Only only,
  70                 const char *bind_to_device,
  71                 bool free_bind,
  72                 mode_t directory_mode,
  73                 mode_t socket_mode,
  74                 int *ret);
  75
  76 bool socket_address_is(const SocketAddress *a, const char *s, int type);
  77
  78 bool socket_address_equal(const SocketAddress *a, const SocketAddress *b);
  79
  80 bool socket_address_needs_mount(const SocketAddress *a, const char *prefix);
  81
  82 const char* socket_address_bind_ipv6_only_to_string(SocketAddressBindIPv6Only b);
  83 SocketAddressBindIPv6Only socket_address_bind_ipv6_only_from_string(const char *s);
  84
  85 #endif