xref: /OK3568_Linux_fs/kernel/include/uapi/linux/if_tun.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun /* SPDX-License-Identifier: GPL-2.0+ WITH Linux-syscall-note */
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun  *  Universal TUN/TAP device driver.
4*4882a593Smuzhiyun  *  Copyright (C) 1999-2000 Maxim Krasnyansky <max_mk@yahoo.com>
5*4882a593Smuzhiyun  *
6*4882a593Smuzhiyun  *  This program is free software; you can redistribute it and/or modify
7*4882a593Smuzhiyun  *  it under the terms of the GNU General Public License as published by
8*4882a593Smuzhiyun  *  the Free Software Foundation; either version 2 of the License, or
9*4882a593Smuzhiyun  *  (at your option) any later version.
10*4882a593Smuzhiyun  *
11*4882a593Smuzhiyun  *  This program is distributed in the hope that it will be useful,
12*4882a593Smuzhiyun  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
13*4882a593Smuzhiyun  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14*4882a593Smuzhiyun  *  GNU General Public License for more details.
15*4882a593Smuzhiyun  */
16*4882a593Smuzhiyun 
17*4882a593Smuzhiyun #ifndef _UAPI__IF_TUN_H
18*4882a593Smuzhiyun #define _UAPI__IF_TUN_H
19*4882a593Smuzhiyun 
20*4882a593Smuzhiyun #include <linux/types.h>
21*4882a593Smuzhiyun #include <linux/if_ether.h>
22*4882a593Smuzhiyun #include <linux/filter.h>
23*4882a593Smuzhiyun 
24*4882a593Smuzhiyun /* Read queue size */
25*4882a593Smuzhiyun #define TUN_READQ_SIZE	500
26*4882a593Smuzhiyun /* TUN device type flags: deprecated. Use IFF_TUN/IFF_TAP instead. */
27*4882a593Smuzhiyun #define TUN_TUN_DEV 	IFF_TUN
28*4882a593Smuzhiyun #define TUN_TAP_DEV	IFF_TAP
29*4882a593Smuzhiyun #define TUN_TYPE_MASK   0x000f
30*4882a593Smuzhiyun 
31*4882a593Smuzhiyun /* Ioctl defines */
32*4882a593Smuzhiyun #define TUNSETNOCSUM  _IOW('T', 200, int)
33*4882a593Smuzhiyun #define TUNSETDEBUG   _IOW('T', 201, int)
34*4882a593Smuzhiyun #define TUNSETIFF     _IOW('T', 202, int)
35*4882a593Smuzhiyun #define TUNSETPERSIST _IOW('T', 203, int)
36*4882a593Smuzhiyun #define TUNSETOWNER   _IOW('T', 204, int)
37*4882a593Smuzhiyun #define TUNSETLINK    _IOW('T', 205, int)
38*4882a593Smuzhiyun #define TUNSETGROUP   _IOW('T', 206, int)
39*4882a593Smuzhiyun #define TUNGETFEATURES _IOR('T', 207, unsigned int)
40*4882a593Smuzhiyun #define TUNSETOFFLOAD  _IOW('T', 208, unsigned int)
41*4882a593Smuzhiyun #define TUNSETTXFILTER _IOW('T', 209, unsigned int)
42*4882a593Smuzhiyun #define TUNGETIFF      _IOR('T', 210, unsigned int)
43*4882a593Smuzhiyun #define TUNGETSNDBUF   _IOR('T', 211, int)
44*4882a593Smuzhiyun #define TUNSETSNDBUF   _IOW('T', 212, int)
45*4882a593Smuzhiyun #define TUNATTACHFILTER _IOW('T', 213, struct sock_fprog)
46*4882a593Smuzhiyun #define TUNDETACHFILTER _IOW('T', 214, struct sock_fprog)
47*4882a593Smuzhiyun #define TUNGETVNETHDRSZ _IOR('T', 215, int)
48*4882a593Smuzhiyun #define TUNSETVNETHDRSZ _IOW('T', 216, int)
49*4882a593Smuzhiyun #define TUNSETQUEUE  _IOW('T', 217, int)
50*4882a593Smuzhiyun #define TUNSETIFINDEX	_IOW('T', 218, unsigned int)
51*4882a593Smuzhiyun #define TUNGETFILTER _IOR('T', 219, struct sock_fprog)
52*4882a593Smuzhiyun #define TUNSETVNETLE _IOW('T', 220, int)
53*4882a593Smuzhiyun #define TUNGETVNETLE _IOR('T', 221, int)
54*4882a593Smuzhiyun /* The TUNSETVNETBE and TUNGETVNETBE ioctls are for cross-endian support on
55*4882a593Smuzhiyun  * little-endian hosts. Not all kernel configurations support them, but all
56*4882a593Smuzhiyun  * configurations that support SET also support GET.
57*4882a593Smuzhiyun  */
58*4882a593Smuzhiyun #define TUNSETVNETBE _IOW('T', 222, int)
59*4882a593Smuzhiyun #define TUNGETVNETBE _IOR('T', 223, int)
60*4882a593Smuzhiyun #define TUNSETSTEERINGEBPF _IOR('T', 224, int)
61*4882a593Smuzhiyun #define TUNSETFILTEREBPF _IOR('T', 225, int)
62*4882a593Smuzhiyun #define TUNSETCARRIER _IOW('T', 226, int)
63*4882a593Smuzhiyun #define TUNGETDEVNETNS _IO('T', 227)
64*4882a593Smuzhiyun 
65*4882a593Smuzhiyun /* TUNSETIFF ifr flags */
66*4882a593Smuzhiyun #define IFF_TUN		0x0001
67*4882a593Smuzhiyun #define IFF_TAP		0x0002
68*4882a593Smuzhiyun #define IFF_NAPI	0x0010
69*4882a593Smuzhiyun #define IFF_NAPI_FRAGS	0x0020
70*4882a593Smuzhiyun #define IFF_NO_PI	0x1000
71*4882a593Smuzhiyun /* This flag has no real effect */
72*4882a593Smuzhiyun #define IFF_ONE_QUEUE	0x2000
73*4882a593Smuzhiyun #define IFF_VNET_HDR	0x4000
74*4882a593Smuzhiyun #define IFF_TUN_EXCL	0x8000
75*4882a593Smuzhiyun #define IFF_MULTI_QUEUE 0x0100
76*4882a593Smuzhiyun #define IFF_ATTACH_QUEUE 0x0200
77*4882a593Smuzhiyun #define IFF_DETACH_QUEUE 0x0400
78*4882a593Smuzhiyun /* read-only flag */
79*4882a593Smuzhiyun #define IFF_PERSIST	0x0800
80*4882a593Smuzhiyun #define IFF_NOFILTER	0x1000
81*4882a593Smuzhiyun 
82*4882a593Smuzhiyun /* Socket options */
83*4882a593Smuzhiyun #define TUN_TX_TIMESTAMP 1
84*4882a593Smuzhiyun 
85*4882a593Smuzhiyun /* Features for GSO (TUNSETOFFLOAD). */
86*4882a593Smuzhiyun #define TUN_F_CSUM	0x01	/* You can hand me unchecksummed packets. */
87*4882a593Smuzhiyun #define TUN_F_TSO4	0x02	/* I can handle TSO for IPv4 packets */
88*4882a593Smuzhiyun #define TUN_F_TSO6	0x04	/* I can handle TSO for IPv6 packets */
89*4882a593Smuzhiyun #define TUN_F_TSO_ECN	0x08	/* I can handle TSO with ECN bits. */
90*4882a593Smuzhiyun #define TUN_F_UFO	0x10	/* I can handle UFO packets */
91*4882a593Smuzhiyun 
92*4882a593Smuzhiyun /* Protocol info prepended to the packets (when IFF_NO_PI is not set) */
93*4882a593Smuzhiyun #define TUN_PKT_STRIP	0x0001
94*4882a593Smuzhiyun struct tun_pi {
95*4882a593Smuzhiyun 	__u16  flags;
96*4882a593Smuzhiyun 	__be16 proto;
97*4882a593Smuzhiyun };
98*4882a593Smuzhiyun 
99*4882a593Smuzhiyun /*
100*4882a593Smuzhiyun  * Filter spec (used for SETXXFILTER ioctls)
101*4882a593Smuzhiyun  * This stuff is applicable only to the TAP (Ethernet) devices.
102*4882a593Smuzhiyun  * If the count is zero the filter is disabled and the driver accepts
103*4882a593Smuzhiyun  * all packets (promisc mode).
104*4882a593Smuzhiyun  * If the filter is enabled in order to accept broadcast packets
105*4882a593Smuzhiyun  * broadcast addr must be explicitly included in the addr list.
106*4882a593Smuzhiyun  */
107*4882a593Smuzhiyun #define TUN_FLT_ALLMULTI 0x0001 /* Accept all multicast packets */
108*4882a593Smuzhiyun struct tun_filter {
109*4882a593Smuzhiyun 	__u16  flags; /* TUN_FLT_ flags see above */
110*4882a593Smuzhiyun 	__u16  count; /* Number of addresses */
111*4882a593Smuzhiyun 	__u8   addr[0][ETH_ALEN];
112*4882a593Smuzhiyun };
113*4882a593Smuzhiyun 
114*4882a593Smuzhiyun #endif /* _UAPI__IF_TUN_H */
115