erspan.h 9.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321
  1. #ifndef __LINUX_ERSPAN_H
  2. #define __LINUX_ERSPAN_H
  3. /*
  4. * GRE header for ERSPAN type I encapsulation (4 octets [34:37])
  5. * 0 1 2 3
  6. * 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
  7. * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  8. * |0|0|0|0|0|00000|000000000|00000| Protocol Type for ERSPAN |
  9. * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  10. *
  11. * The Type I ERSPAN frame format is based on the barebones IP + GRE
  12. * encapsulation (as described above) on top of the raw mirrored frame.
  13. * There is no extra ERSPAN header.
  14. *
  15. *
  16. * GRE header for ERSPAN type II and II encapsulation (8 octets [34:41])
  17. * 0 1 2 3
  18. * 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
  19. * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  20. * |0|0|0|1|0|00000|000000000|00000| Protocol Type for ERSPAN |
  21. * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  22. * | Sequence Number (increments per packet per session) |
  23. * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  24. *
  25. * Note that in the above GRE header [RFC1701] out of the C, R, K, S,
  26. * s, Recur, Flags, Version fields only S (bit 03) is set to 1. The
  27. * other fields are set to zero, so only a sequence number follows.
  28. *
  29. * ERSPAN Version 1 (Type II) header (8 octets [42:49])
  30. * 0 1 2 3
  31. * 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
  32. * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  33. * | Ver | VLAN | COS | En|T| Session ID |
  34. * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  35. * | Reserved | Index |
  36. * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  37. *
  38. *
  39. * ERSPAN Version 2 (Type III) header (12 octets [42:49])
  40. * 0 1 2 3
  41. * 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
  42. * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  43. * | Ver | VLAN | COS |BSO|T| Session ID |
  44. * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  45. * | Timestamp |
  46. * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  47. * | SGT |P| FT | Hw ID |D|Gra|O|
  48. * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  49. *
  50. * Platform Specific SubHeader (8 octets, optional)
  51. * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  52. * | Platf ID | Platform Specific Info |
  53. * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  54. * | Platform Specific Info |
  55. * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  56. *
  57. * GRE proto ERSPAN type I/II = 0x88BE, type III = 0x22EB
  58. */
  59. #include <linux/ip.h>
  60. #include <linux/ipv6.h>
  61. #include <linux/skbuff.h>
  62. #include <uapi/linux/erspan.h>
  63. #define ERSPAN_VERSION 0x1 /* ERSPAN type II */
  64. #define VER_MASK 0xf000
  65. #define VLAN_MASK 0x0fff
  66. #define COS_MASK 0xe000
  67. #define EN_MASK 0x1800
  68. #define T_MASK 0x0400
  69. #define ID_MASK 0x03ff
  70. #define INDEX_MASK 0xfffff
  71. #define ERSPAN_VERSION2 0x2 /* ERSPAN type III*/
  72. #define BSO_MASK EN_MASK
  73. #define SGT_MASK 0xffff0000
  74. #define P_MASK 0x8000
  75. #define FT_MASK 0x7c00
  76. #define HWID_MASK 0x03f0
  77. #define DIR_MASK 0x0008
  78. #define GRA_MASK 0x0006
  79. #define O_MASK 0x0001
  80. #define HWID_OFFSET 4
  81. #define DIR_OFFSET 3
  82. enum erspan_encap_type {
  83. ERSPAN_ENCAP_NOVLAN = 0x0, /* originally without VLAN tag */
  84. ERSPAN_ENCAP_ISL = 0x1, /* originally ISL encapsulated */
  85. ERSPAN_ENCAP_8021Q = 0x2, /* originally 802.1Q encapsulated */
  86. ERSPAN_ENCAP_INFRAME = 0x3, /* VLAN tag perserved in frame */
  87. };
  88. #define ERSPAN_V1_MDSIZE 4
  89. #define ERSPAN_V2_MDSIZE 8
  90. struct erspan_base_hdr {
  91. #if defined(__LITTLE_ENDIAN_BITFIELD)
  92. __u8 vlan_upper:4,
  93. ver:4;
  94. __u8 vlan:8;
  95. __u8 session_id_upper:2,
  96. t:1,
  97. en:2,
  98. cos:3;
  99. __u8 session_id:8;
  100. #elif defined(__BIG_ENDIAN_BITFIELD)
  101. __u8 ver: 4,
  102. vlan_upper:4;
  103. __u8 vlan:8;
  104. __u8 cos:3,
  105. en:2,
  106. t:1,
  107. session_id_upper:2;
  108. __u8 session_id:8;
  109. #else
  110. #error "Please fix <asm/byteorder.h>"
  111. #endif
  112. };
  113. static inline void set_session_id(struct erspan_base_hdr *ershdr, u16 id)
  114. {
  115. ershdr->session_id = id & 0xff;
  116. ershdr->session_id_upper = (id >> 8) & 0x3;
  117. }
  118. static inline u16 get_session_id(const struct erspan_base_hdr *ershdr)
  119. {
  120. return (ershdr->session_id_upper << 8) + ershdr->session_id;
  121. }
  122. static inline void set_vlan(struct erspan_base_hdr *ershdr, u16 vlan)
  123. {
  124. ershdr->vlan = vlan & 0xff;
  125. ershdr->vlan_upper = (vlan >> 8) & 0xf;
  126. }
  127. static inline u16 get_vlan(const struct erspan_base_hdr *ershdr)
  128. {
  129. return (ershdr->vlan_upper << 8) + ershdr->vlan;
  130. }
  131. static inline void set_hwid(struct erspan_md2 *md2, u8 hwid)
  132. {
  133. md2->hwid = hwid & 0xf;
  134. md2->hwid_upper = (hwid >> 4) & 0x3;
  135. }
  136. static inline u8 get_hwid(const struct erspan_md2 *md2)
  137. {
  138. return (md2->hwid_upper << 4) + md2->hwid;
  139. }
  140. static inline int erspan_hdr_len(int version)
  141. {
  142. if (version == 0)
  143. return 0;
  144. return sizeof(struct erspan_base_hdr) +
  145. (version == 1 ? ERSPAN_V1_MDSIZE : ERSPAN_V2_MDSIZE);
  146. }
  147. static inline u8 tos_to_cos(u8 tos)
  148. {
  149. u8 dscp, cos;
  150. dscp = tos >> 2;
  151. cos = dscp >> 3;
  152. return cos;
  153. }
  154. static inline void erspan_build_header(struct sk_buff *skb,
  155. u32 id, u32 index,
  156. bool truncate, bool is_ipv4)
  157. {
  158. struct ethhdr *eth = (struct ethhdr *)skb->data;
  159. enum erspan_encap_type enc_type;
  160. struct erspan_base_hdr *ershdr;
  161. struct qtag_prefix {
  162. __be16 eth_type;
  163. __be16 tci;
  164. } *qp;
  165. u16 vlan_tci = 0;
  166. u8 tos;
  167. __be32 *idx;
  168. tos = is_ipv4 ? ip_hdr(skb)->tos :
  169. (ipv6_hdr(skb)->priority << 4) +
  170. (ipv6_hdr(skb)->flow_lbl[0] >> 4);
  171. enc_type = ERSPAN_ENCAP_NOVLAN;
  172. /* If mirrored packet has vlan tag, extract tci and
  173. * perserve vlan header in the mirrored frame.
  174. */
  175. if (eth->h_proto == htons(ETH_P_8021Q)) {
  176. qp = (struct qtag_prefix *)(skb->data + 2 * ETH_ALEN);
  177. vlan_tci = ntohs(qp->tci);
  178. enc_type = ERSPAN_ENCAP_INFRAME;
  179. }
  180. skb_push(skb, sizeof(*ershdr) + ERSPAN_V1_MDSIZE);
  181. ershdr = (struct erspan_base_hdr *)skb->data;
  182. memset(ershdr, 0, sizeof(*ershdr) + ERSPAN_V1_MDSIZE);
  183. /* Build base header */
  184. ershdr->ver = ERSPAN_VERSION;
  185. ershdr->cos = tos_to_cos(tos);
  186. ershdr->en = enc_type;
  187. ershdr->t = truncate;
  188. set_vlan(ershdr, vlan_tci);
  189. set_session_id(ershdr, id);
  190. /* Build metadata */
  191. idx = (__be32 *)(ershdr + 1);
  192. *idx = htonl(index & INDEX_MASK);
  193. }
  194. /* ERSPAN GRA: timestamp granularity
  195. * 00b --> granularity = 100 microseconds
  196. * 01b --> granularity = 100 nanoseconds
  197. * 10b --> granularity = IEEE 1588
  198. * Here we only support 100 microseconds.
  199. */
  200. static inline __be32 erspan_get_timestamp(void)
  201. {
  202. u64 h_usecs;
  203. ktime_t kt;
  204. kt = ktime_get_real();
  205. h_usecs = ktime_divns(kt, 100 * NSEC_PER_USEC);
  206. /* ERSPAN base header only has 32-bit,
  207. * so it wraps around 4 days.
  208. */
  209. return htonl((u32)h_usecs);
  210. }
  211. /* ERSPAN BSO (Bad/Short/Oversized), see RFC1757
  212. * 00b --> Good frame with no error, or unknown integrity
  213. * 01b --> Payload is a Short Frame
  214. * 10b --> Payload is an Oversized Frame
  215. * 11b --> Payload is a Bad Frame with CRC or Alignment Error
  216. */
  217. enum erspan_bso {
  218. BSO_NOERROR = 0x0,
  219. BSO_SHORT = 0x1,
  220. BSO_OVERSIZED = 0x2,
  221. BSO_BAD = 0x3,
  222. };
  223. static inline u8 erspan_detect_bso(struct sk_buff *skb)
  224. {
  225. /* BSO_BAD is not handled because the frame CRC
  226. * or alignment error information is in FCS.
  227. */
  228. if (skb->len < ETH_ZLEN)
  229. return BSO_SHORT;
  230. if (skb->len > ETH_FRAME_LEN)
  231. return BSO_OVERSIZED;
  232. return BSO_NOERROR;
  233. }
  234. static inline void erspan_build_header_v2(struct sk_buff *skb,
  235. u32 id, u8 direction, u16 hwid,
  236. bool truncate, bool is_ipv4)
  237. {
  238. struct ethhdr *eth = (struct ethhdr *)skb->data;
  239. struct erspan_base_hdr *ershdr;
  240. struct erspan_md2 *md2;
  241. struct qtag_prefix {
  242. __be16 eth_type;
  243. __be16 tci;
  244. } *qp;
  245. u16 vlan_tci = 0;
  246. u8 gra = 0; /* 100 usec */
  247. u8 bso = 0; /* Bad/Short/Oversized */
  248. u8 sgt = 0;
  249. u8 tos;
  250. tos = is_ipv4 ? ip_hdr(skb)->tos :
  251. (ipv6_hdr(skb)->priority << 4) +
  252. (ipv6_hdr(skb)->flow_lbl[0] >> 4);
  253. /* Unlike v1, v2 does not have En field,
  254. * so only extract vlan tci field.
  255. */
  256. if (eth->h_proto == htons(ETH_P_8021Q)) {
  257. qp = (struct qtag_prefix *)(skb->data + 2 * ETH_ALEN);
  258. vlan_tci = ntohs(qp->tci);
  259. }
  260. bso = erspan_detect_bso(skb);
  261. skb_push(skb, sizeof(*ershdr) + ERSPAN_V2_MDSIZE);
  262. ershdr = (struct erspan_base_hdr *)skb->data;
  263. memset(ershdr, 0, sizeof(*ershdr) + ERSPAN_V2_MDSIZE);
  264. /* Build base header */
  265. ershdr->ver = ERSPAN_VERSION2;
  266. ershdr->cos = tos_to_cos(tos);
  267. ershdr->en = bso;
  268. ershdr->t = truncate;
  269. set_vlan(ershdr, vlan_tci);
  270. set_session_id(ershdr, id);
  271. /* Build metadata */
  272. md2 = (struct erspan_md2 *)(ershdr + 1);
  273. md2->timestamp = erspan_get_timestamp();
  274. md2->sgt = htons(sgt);
  275. md2->p = 1;
  276. md2->ft = 0;
  277. md2->dir = direction;
  278. md2->gra = gra;
  279. md2->o = 0;
  280. set_hwid(md2, hwid);
  281. }
  282. #endif