2009-10-22 18:49:05 +02:00
|
|
|
/*
|
|
|
|
* QEMU System Emulator
|
|
|
|
*
|
|
|
|
* Copyright (c) 2003-2008 Fabrice Bellard
|
|
|
|
* Copyright (c) 2009 Red Hat, Inc.
|
|
|
|
*
|
|
|
|
* Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
|
|
* of this software and associated documentation files (the "Software"), to deal
|
|
|
|
* in the Software without restriction, including without limitation the rights
|
|
|
|
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
|
|
* copies of the Software, and to permit persons to whom the Software is
|
|
|
|
* furnished to do so, subject to the following conditions:
|
|
|
|
*
|
|
|
|
* The above copyright notice and this permission notice shall be included in
|
|
|
|
* all copies or substantial portions of the Software.
|
|
|
|
*
|
|
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
|
|
|
|
* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
|
|
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
|
|
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
|
|
* THE SOFTWARE.
|
|
|
|
*/
|
|
|
|
|
2016-06-29 10:12:57 +02:00
|
|
|
#ifndef NET_TAP_INT_H
|
|
|
|
#define NET_TAP_INT_H
|
2009-10-22 18:49:05 +02:00
|
|
|
|
2018-02-11 10:36:01 +01:00
|
|
|
#include "qapi/qapi-types-net.h"
|
2009-10-22 18:49:05 +02:00
|
|
|
|
2013-01-30 12:12:34 +01:00
|
|
|
int tap_open(char *ifname, int ifname_size, int *vnet_hdr,
|
2015-05-15 13:58:58 +02:00
|
|
|
int vnet_hdr_required, int mq_required, Error **errp);
|
2009-10-22 18:49:08 +02:00
|
|
|
|
2009-10-22 18:49:09 +02:00
|
|
|
ssize_t tap_read_packet(int tapfd, uint8_t *buf, int maxlen);
|
|
|
|
|
2015-05-15 13:58:55 +02:00
|
|
|
void tap_set_sndbuf(int fd, const NetdevTapOptions *tap, Error **errp);
|
net: detect errors from probing vnet hdr flag for TAP devices
When QEMU sets up a tap based network device backend, it mostly ignores errors
reported from various ioctl() calls it makes, assuming the TAP file descriptor
is valid. This assumption can easily be violated when the user is passing in a
pre-opened file descriptor. At best, the ioctls may fail with a -EBADF, but if
the user passes in a bogus FD number that happens to clash with a FD number that
QEMU has opened internally for another reason, a wide variety of errnos may
result, as the TUNGETIFF ioctl number may map to a completely different command
on a different type of file.
By ignoring all these errors, QEMU sets up a zombie network backend that will
never pass any data. Even worse, when QEMU shuts down, or that network backend
is hot-removed, it will close this bogus file descriptor, which could belong to
another QEMU device backend.
There's no obvious guaranteed reliable way to detect that a FD genuinely is a
TAP device, as opposed to a UNIX socket, or pipe, or something else. Checking
the errno from probing vnet hdr flag though, does catch the big common cases.
ie calling TUNGETIFF will return EBADF for an invalid FD, and ENOTTY when FD is
a UNIX socket, or pipe which catches accidental collisions with FDs used for
stdio, or monitor socket.
Previously the example below where bogus fd 9 collides with the FD used for the
chardev saw:
$ ./x86_64-softmmu/qemu-system-x86_64 -netdev tap,id=hostnet0,fd=9 \
-chardev socket,id=charchannel0,path=/tmp/qga,server,nowait \
-monitor stdio -vnc :0
qemu-system-x86_64: -netdev tap,id=hostnet0,fd=9: TUNGETIFF ioctl() failed: Inappropriate ioctl for device
TUNSETOFFLOAD ioctl() failed: Bad address
QEMU 2.9.1 monitor - type 'help' for more information
(qemu) Warning: netdev hostnet0 has no peer
which gives a running QEMU with a zombie network backend.
With this change applied we get an error message and QEMU immediately exits
before carrying on and making a bigger disaster:
$ ./x86_64-softmmu/qemu-system-x86_64 -netdev tap,id=hostnet0,fd=9 \
-chardev socket,id=charchannel0,path=/tmp/qga,server,nowait \
-monitor stdio -vnc :0
qemu-system-x86_64: -netdev tap,id=hostnet0,vhost=on,fd=9: Unable to query TUNGETIFF on FD 9: Inappropriate ioctl for device
Reported-by: Dr. David Alan Gilbert <dgilbert@redhat.com>
Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
Tested-by: Dr. David Alan Gilbert <dgilbert@redhat.com>
Message-id: 20171027085548.3472-1-berrange@redhat.com
[lv: to simplify, don't check on EINVAL with TUNGETIFF as it exists since v2.6.27]
Signed-off-by: Laurent Vivier <lvivier@redhat.com>
Signed-off-by: Jason Wang <jasowang@redhat.com>
2020-07-07 20:45:15 +02:00
|
|
|
int tap_probe_vnet_hdr(int fd, Error **errp);
|
2010-07-16 10:16:06 +02:00
|
|
|
int tap_probe_vnet_hdr_len(int fd, int len);
|
2009-10-22 18:49:16 +02:00
|
|
|
int tap_probe_has_ufo(int fd);
|
2009-10-22 18:49:15 +02:00
|
|
|
void tap_fd_set_offload(int fd, int csum, int tso4, int tso6, int ecn, int ufo);
|
2010-07-16 10:16:06 +02:00
|
|
|
void tap_fd_set_vnet_hdr_len(int fd, int len);
|
2015-06-17 15:23:44 +02:00
|
|
|
int tap_fd_set_vnet_le(int fd, int vnet_is_le);
|
|
|
|
int tap_fd_set_vnet_be(int fd, int vnet_is_be);
|
2013-01-30 12:12:31 +01:00
|
|
|
int tap_fd_enable(int fd);
|
|
|
|
int tap_fd_disable(int fd);
|
2013-01-30 12:12:33 +01:00
|
|
|
int tap_fd_get_ifname(int fd, char *ifname);
|
2021-05-14 13:48:30 +02:00
|
|
|
int tap_fd_set_steering_ebpf(int fd, int prog_fd);
|
2009-10-22 18:49:13 +02:00
|
|
|
|
2016-06-29 10:12:57 +02:00
|
|
|
#endif /* NET_TAP_INT_H */
|