tap_attach.h

/*
 * Copyright (c) 2015-2019 Contributors as noted in the AUTHORS file
 *
 * This file is part of Solo5, a sandboxed execution environment.
 *
 * Permission to use, copy, modify, and/or distribute this software
 * for any purpose with or without fee is hereby granted, provided
 * that the above copyright notice and this permission notice appear
 * in all copies.
 *
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
 * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
 * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
 * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR
 * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
 * OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
 * NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
 * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */

/*
 * tap_attach.h: Common functions for attaching to TAP interfaces.
 */

#ifndef COMMON_TAP_ATTACH_H
#define COMMON_TAP_ATTACH_H

/*
 * Attach to an existing TAP interface named (ifname). If ifname is "@<num>",
 * assume that a pre-existing TAP interface is open as file descriptor <num>.
 *
 * Returns -1 and an appropriate errno on failure (ENOENT if the interface does
 * not exist), and the tap device file descriptor on success.
 */
int tap_attach(const char *ifname);

/*
 * Generate a random, locally-administered and unicast MAC address, and store it
 * in (*mac), which must be an uint8_t[6].
 */
void tap_attach_genmac(uint8_t *mac);

#endif /* COMMON_TAP_ATTACH_H */