src/lxc/network.h

   1 /*
   2  * lxc: linux Container library
   3  *
   4  * (C) Copyright IBM Corp. 2007, 2008
   5  *
   6  * Authors:
   7  * Daniel Lezcano <daniel.lezcano at free.fr>
   8  *
   9  * This library is free software; you can redistribute it and/or
  10  * modify it under the terms of the GNU Lesser General Public
  11  * License as published by the Free Software Foundation; either
  12  * version 2.1 of the License, or (at your option) any later version.
  13  *
  14  * This library is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  17  * Lesser General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU Lesser General Public
  20  * License along with this library; if not, write to the Free Software
  21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  22  */
  23 #ifndef __LXC_NETWORK_H
  24 #define __LXC_NETWORK_H
  25
  26 #include <stdbool.h>
  27 #include <stdio.h>
  28 #include <unistd.h>
  29 #include <arpa/inet.h>
  30 #include <linux/types.h>
  31 #include <sys/socket.h>
  32
  33 #include "list.h"
  34
  35 struct lxc_conf;
  36 struct lxc_handler;
  37 struct lxc_netdev;
  38
  39 enum {
  40         LXC_NET_EMPTY,
  41         LXC_NET_VETH,
  42         LXC_NET_MACVLAN,
  43         LXC_NET_PHYS,
  44         LXC_NET_VLAN,
  45         LXC_NET_NONE,
  46         LXC_NET_MAXCONFTYPE,
  47 };
  48
  49 /*
  50  * Defines the structure to configure an ipv4 address
  51  * @address   : ipv4 address
  52  * @broadcast : ipv4 broadcast address
  53  * @mask      : network mask
  54  */
  55 struct lxc_inetdev {
  56         struct in_addr addr;
  57         struct in_addr bcast;
  58         unsigned int prefix;
  59 };
  60
  61 struct lxc_route {
  62         struct in_addr addr;
  63 };
  64
  65 /*
  66  * Defines the structure to configure an ipv6 address
  67  * @flags     : set the address up
  68  * @address   : ipv6 address
  69  * @broadcast : ipv6 broadcast address
  70  * @mask      : network mask
  71  */
  72 struct lxc_inet6dev {
  73         struct in6_addr addr;
  74         struct in6_addr mcast;
  75         struct in6_addr acast;
  76         unsigned int prefix;
  77 };
  78
  79 struct lxc_route6 {
  80         struct in6_addr addr;
  81 };
  82
  83 /* Contains information about the host side veth device.
  84  * @pair    : Name of the host side veth device.
  85  *            If the user requested that the host veth device be created with a
  86  *            specific names this field will be set. If this field is set @veth1
  87  *            is not set.
  88  * @veth1   : Name of the host side veth device.
  89  *            If the user did not request that the host veth device be created
  90  *            with a specific name this field will be set. If this field is set
  91  *            @pair is not set.
  92  * @ifindex : Ifindex of the network device.
  93  */
  94 struct ifla_veth {
  95         char pair[IFNAMSIZ];
  96         char veth1[IFNAMSIZ];
  97         int ifindex;
  98 };
  99
 100 struct ifla_vlan {
 101         unsigned int   flags;
 102         unsigned int   fmask;
 103         unsigned short   vid;
 104         unsigned short   pad;
 105 };
 106
 107 struct ifla_macvlan {
 108         int mode; /* private, vepa, bridge, passthru */
 109 };
 110
 111 /* Contains information about the physical network device as seen from the host.
 112  * @ifindex : The ifindex of the physical network device in the host's network
 113  *            namespace.
 114  */
 115 struct ifla_phys {
 116         int ifindex;
 117 };
 118
 119 union netdev_p {
 120         struct ifla_macvlan macvlan_attr;
 121         struct ifla_phys phys_attr;
 122         struct ifla_veth veth_attr;
 123         struct ifla_vlan vlan_attr;
 124 };
 125
 126 /*
 127  * Defines a structure to configure a network device
 128  * @idx               : network counter
 129  * @ifindex           : ifindex of the network device
 130  *                      Note that this is the ifindex of the network device in
 131  *                      the container's network namespace. If the network device
 132  *                      consists of a pair of network devices (e.g. veth pairs
 133  *                      attached to a network bridge) then this index cannot be
 134  *                      used to identify or modify the host veth device. See
 135  *                      struct ifla_veth for the host side information.
 136  * @type              : network type (veth, macvlan, vlan, ...)
 137  * @flags             : flag of the network device (IFF_UP, ... )
 138  * @link              : lxc.net.[i].link, name of bridge or host iface to attach
 139  *                      if any
 140  * @name              : lxc.net.[i].name, name of iface on the container side
 141  * @hwaddr            : mac address
 142  * @mtu               : maximum transmission unit
 143  * @priv              : information specific to the specificed network type
 144  *                      Note that this is a union so whether accessing a struct
 145  *                      is possible is dependent on the network type.
 146  * @ipv4              : a list of ipv4 addresses to be set on the network device
 147  * @ipv6              : a list of ipv6 addresses to be set on the network device
 148  * @ipv4_gateway_auto : whether the ipv4 gateway is to be automatically gathered
 149  *                      from the associated @link
 150  * @ipv4_gateway      : ipv4 gateway
 151  * @ipv6_gateway_auto : whether the ipv6 gateway is to be automatically gathered
 152  *                      from the associated @link
 153  * @ipv6_gateway      : ipv6 gateway
 154  * @upscript          : a script filename to be executed during interface
 155  *                      configuration
 156  * @downscript        : a script filename to be executed during interface
 157  *                      destruction
 158  */
 159 struct lxc_netdev {
 160         ssize_t idx;
 161         int ifindex;
 162         int type;
 163         int flags;
 164         char link[IFNAMSIZ];
 165         char name[IFNAMSIZ];
 166         char *hwaddr;
 167         char *mtu;
 168         union netdev_p priv;
 169         struct lxc_list ipv4;
 170         struct lxc_list ipv6;
 171         bool ipv4_gateway_auto;
 172         struct in_addr *ipv4_gateway;
 173         bool ipv6_gateway_auto;
 174         struct in6_addr *ipv6_gateway;
 175         char *upscript;
 176         char *downscript;
 177 };
 178
 179 /* Convert a string mac address to a socket structure. */
 180 extern int lxc_convert_mac(char *macaddr, struct sockaddr *sockaddr);
 181
 182 /* Move a device between namespaces. */
 183 extern int lxc_netdev_move_by_index(int ifindex, pid_t pid, const char *ifname);
 184 extern int lxc_netdev_move_by_name(const char *ifname, pid_t pid,
 185                                    const char *newname);
 186
 187 /* Delete a network device. */
 188 extern int lxc_netdev_delete_by_name(const char *name);
 189 extern int lxc_netdev_delete_by_index(int ifindex);
 190
 191 /* Change the device name. */
 192 extern int lxc_netdev_rename_by_name(const char *oldname, const char *newname);
 193 extern int lxc_netdev_rename_by_index(int ifindex, const char *newname);
 194
 195 extern int netdev_set_flag(const char *name, int flag);
 196
 197 /* Set the device network up or down. */
 198 extern int lxc_netdev_isup(const char *name);
 199 extern int lxc_netdev_up(const char *name);
 200 extern int lxc_netdev_down(const char *name);
 201
 202 /* Change the mtu size for the specified device. */
 203 extern int lxc_netdev_set_mtu(const char *name, int mtu);
 204
 205 /* Create a virtual network devices. */
 206 extern int lxc_veth_create(const char *name1, const char *name2);
 207 extern int lxc_macvlan_create(const char *master, const char *name, int mode);
 208 extern int lxc_vlan_create(const char *master, const char *name,
 209                            unsigned short vid);
 210
 211 /* Set ip address. */
 212 extern int lxc_ipv6_addr_add(int ifindex, struct in6_addr *addr,
 213                              struct in6_addr *mcast,
 214                              struct in6_addr *acast, int prefix);
 215
 216 extern int lxc_ipv4_addr_add(int ifindex, struct in_addr *addr,
 217                              struct in_addr *bcast, int prefix);
 218
 219 /* Get ip address. */
 220 extern int lxc_ipv4_addr_get(int ifindex, struct in_addr **res);
 221 extern int lxc_ipv6_addr_get(int ifindex, struct in6_addr **res);
 222
 223 /* Set a destination route to an interface. */
 224 extern int lxc_ipv4_dest_add(int ifindex, struct in_addr *dest);
 225 extern int lxc_ipv6_dest_add(int ifindex, struct in6_addr *dest);
 226
 227 /* Set default route. */
 228 extern int lxc_ipv4_gateway_add(int ifindex, struct in_addr *gw);
 229 extern int lxc_ipv6_gateway_add(int ifindex, struct in6_addr *gw);
 230
 231 /* Attach an interface to the bridge. */
 232 extern int lxc_bridge_attach(const char *bridge, const char *ifname);
 233 extern int lxc_ovs_delete_port(const char *bridge, const char *nic);
 234
 235 extern bool is_ovs_bridge(const char *bridge);
 236
 237 /* Create default gateway. */
 238 extern int lxc_route_create_default(const char *addr, const char *ifname,
 239                                     int gateway);
 240
 241 /* Delete default gateway. */
 242 extern int lxc_route_delete_default(const char *addr, const char *ifname,
 243                                     int gateway);
 244
 245 /* Activate neighbor proxying. */
 246 extern int lxc_neigh_proxy_on(const char *name, int family);
 247
 248 /* Disable neighbor proxying. */
 249 extern int lxc_neigh_proxy_off(const char *name, int family);
 250
 251 /* Generate a new unique network interface name.
 252  * Allocated memory must be freed by caller.
 253  */
 254 extern char *lxc_mkifname(char *template);
 255
 256 extern const char *lxc_net_type_to_str(int type);
 257 extern int setup_private_host_hw_addr(char *veth1);
 258 extern int netdev_get_mtu(int ifindex);
 259 extern int lxc_create_network_priv(struct lxc_handler *handler);
 260 extern int lxc_network_move_created_netdev_priv(const char *lxcpath,
 261                                                 const char *lxcname,
 262                                                 struct lxc_list *network,
 263                                                 pid_t pid);
 264 extern void lxc_delete_network(struct lxc_handler *handler);
 265 extern int lxc_find_gateway_addresses(struct lxc_handler *handler);
 266 extern int lxc_create_network_unpriv(const char *lxcpath, const char *lxcname,
 267                                      struct lxc_list *network, pid_t pid, unsigned int hook_version);
 268 extern int lxc_requests_empty_network(struct lxc_handler *handler);
 269 extern int lxc_restore_phys_nics_to_netns(struct lxc_handler *handler);
 270 extern int lxc_setup_network_in_child_namespaces(const struct lxc_conf *conf,
 271                                                  struct lxc_list *network);
 272 extern int lxc_network_send_veth_names_to_child(struct lxc_handler *handler);
 273 extern int lxc_network_recv_veth_names_from_parent(struct lxc_handler *handler);
 274 extern int lxc_network_send_name_and_ifindex_to_parent(struct lxc_handler *handler);
 275 extern int lxc_network_recv_name_and_ifindex_from_child(struct lxc_handler *handler);
 276 extern int lxc_netns_set_nsid(int netns_fd);
 277 extern int lxc_netns_get_nsid(__s32 fd);
 278
 279 #endif /* __LXC_NETWORK_H */