/*
* Copyright (c) 2015 Cisco and/or its affiliates.
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at:
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*
* pcap.h: libpcap packet capture format
*
* Copyright (c) 2008 Eliot Dresselhaus
*
* 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.
*/
/**
* @file
* @brief PCAP utility definitions
*/
#ifndef included_vppinfra_pcap_h
#define included_vppinfra_pcap_h
#include <vppinfra/types.h>
#include <vppinfra/cache.h>
#include <vppinfra/mem.h>
#include <vppinfra/lock.h>
/**
* @brief Known libpcap encap types
*
* These codes end up in the pcap file header.
* If you decide to build a wireshark dissector,
* you'll need to know that these codes are mapped
* through the pcap_to_wtap_map[] array in .../wiretap/pcap-common.c.
*
* For example:
*
* { 280, WTAP_ENCAP_VPP },
*
* A file with the officially-allocated vpp packet type PCAP_PACKET_TYPE_vpp
* aka 280, will need a top-level dissector registered to
* deal with WTAP_ENCAP_VPP [=206].
*
* Something like so:
*
* dissector_add_uint("wtap_encap", WTAP_ENCAP_VPP, vpp_dissector_handle);
*
*/
#define foreach_vnet_pcap_packet_type \
_ (null, 0) \
_ (ethernet, 1) \
_ (ppp, 9) \
_ (ip, 12) \
_ (hdlc, 104) \
_ (user0, 147) \
_ (user1, 148) \
_ (user2, 149) \
_ (user3, 150) \
_ (user4, 151) \
_ (user5, 152) \
_ (user6, 153) \
_ (user7, 154) \
_ (user8, 155) \
_ (user9, 156) \
_ (user10, 157) \
_ (user11, 158) \
_ (user12, 159) \
_ (user13, 160) \
_ (user14, 161) \
_ (user15, 162) \
_ (vpp, 280) \
typedef enum
{
#define _(f,n) PCAP_PACKET_TYPE_##f = (n),
foreach_vnet_pcap_packet_type
#undef _
} pcap_packet_type_t;
#define foreach_pcap_file_header \
/** 0xa1b2c3d4 host byte order. \
0xd4c3b2a1 => need to byte swap everything. */ \
_ (u32, magic) \
\
/** Currently major 2 minor 4. */ \
_ (u16, major_version) \
_ (u16, minor_version) \
\
/** 0 for GMT. */ \
_ (u32, time_zone) \
\
/** Accuracy of timestamps. Typically set to 0. */ \
_ (u32, sigfigs) \
\
/** Size of largest packet in file. */ \
_ (u32, max_packet_size_in_bytes) \
\
/** One of vnet_pcap_packet_type_t. */ \
_ (u32, packet_type)
/** File header struct */
typedef struct
{
#define _(t, f) t f;
foreach_pcap_file_header
#undef _
} pcap_file_header_t;
#define foreach_pcap_packet_header \
/** Time stamp in seconds */ Descriptions of section entries:
M: Maintainer Full name and E-mail address: Full Name <address@domain>
One maintainer per line. Multiple M: lines acceptable.
F: Files and directories with wildcard patterns.
A trailing slash includes all files and subdirectory files.
F: drivers/net/ all files in and below drivers/net
F: drivers/net/* all files in drivers/net, but not below
One pattern per line. Multiple F: lines acceptable.
E: exclude file(s) matched by F:
C: Single line comment related to current section.
I: single word feature/component identifier
Y: path to feature YAML file
-----------------------------------
Build System
I: build
M: Damjan Marion <damarion@cisco.com>
F: Makefile
F: src/CMakeLists.txt
F: src/cmake/
F: build/
Build System Internal
I: ebuild
M: Dave Barach <dave@barachs.net>
F: build-root/Makefile
F: build-data/
Link Bonding
I: bonding
M: Steven Luong <sluong@cisco.com>
F: src/vnet/bonding/
Doxygen
I: doxygen
M: Chris Luke <chrisy@flirble.org>
F: doxygen/
Sphinx Documents
I: docs
M: John DeNisco <jdenisco@cisco.com>
M: Ray Kinsella <raykinsella78@gmail.com>
F: docs/
Infrastructure Library
I: vppinfra
M: Dave Barach <dave@barachs.net>
F: src/vppinfra/
Physical Memory Allocator
I: pmalloc
M: Damjan Marion <damarion@cisco.com>
F: src/vppinfra/pmalloc.[ch]
Vector Library
I: vlib
M: Dave Barach <dave@barachs.net>
M: Damjan Marion <damarion@cisco.com>
F: src/vlib/
E: src/vlib/buffer*.[ch]
E: src/vlib/pci/
E: src/vlib/linux/pci.[ch]
E: src/vlib/linux/vfio.[ch]
Vector Library - Buffer Management
I: buffers
M: Damjan Marion <damarion@cisco.com>
M: Dave Barach <dave@barachs.net>
F: src/vlib/buffer*.[ch]
Vector Library - PCI
I: pci
M: Damjan Marion <damarion@cisco.com>
F: src/vlib/pci/
F: src/vlib/linux/pci.[ch]
F: src/vlib/linux/vfio.[ch]
Binary API Libraries
I: api
M: Dave Barach <dave@barachs.net>
F: src/vlibapi/
F: src/vlibmemory/
VNET Bidirectional Forwarding Detection (BFD)
I: bfd
M: Klement Sekera <ksekera@cisco.com>
F: src/vnet/bfd/
VNET Classifier
I: classify
M: Dave Barach <dave@barachs.net>
F: src/vnet/classify
VNET Policer
I: policer
M: N/A
F: src/vnet/policer/
VNET Device Drivers
I: devices
Y: src/vnet/devices/af_packet/FEATURE.yaml
Y: src/vnet/devices/pipe/FEATURE.yaml
M: Damjan Marion <damarion@cisco.com>
F: src/vnet/devices/
VNET TAP Drivers
I: tap
Y: src/vnet/devices/tap/FEATURE.yaml
M: Damjan Marion <damarion@cisco.com>
M: Steven Luong <sluong@cisco.com>
M: Mohsin Kazmi <sykazmi@cisco.com>
F: src/vnet/devices/tap/
VNET Native Virtio Drivers
I: virtio
Y: src/vnet/devices/virtio/FEATURE.yaml
M: Mohsin Kazmi <sykazmi@cisco.com>
M: Damjan Marion <damarion@cisco.com>
F: src/vnet/devices/virtio/
VNET Ethernet
I: ethernet
M: Dave Barach <dave@barachs.net>
M: Damjan Marion <damarion@cisco.com>
F: src/vnet/ethernet/
VNET Feature Arcs
I: feature
M: Dave Barach <dave@barachs.net>
M: Damjan Marion <damarion@cisco.com>
F: src/vnet/feature/
VNET FIB
I: fib
M: Neale Ranns <nranns@cisco.com>
F: src/vnet/fib/
F: src/vnet/mfib/
F: src/vnet/dpo
F: src/vnet/adj
VNET IPv4 LPM
I: ip
M: Dave Barach <dave@barachs.net>
F: src/vnet/ip/
VNET IPv6 LPM
I: ip6
M: Neale Ranns <nranns@cisco.com>
M: Jon Loeliger <jdl@netgate.com>
F: src/vnet/ip/
VNET IP Neighbors
I: ip-neighbor
M: Neale Ranns <nranns@cisco.com>
F: src/vnet/ip-neighbor
VNET QoS
I: qos
M: Neale Ranns <nranns@cisco.com>
F: src/vnet/qos/
VNET Interface Common
I: interface
M: Dave Barach <dave@barachs.net>
F: src/vnet/interface*.[ch]
VNET Packet Generator
I: pg
M: Dave Barach <dave@barachs.net>
F: src/vnet/pg/
VNET Segment Routing (IPv6 and MPLS)
I: sr
M: Pablo Camarillo <pcamaril@cisco.com>
F: src/vnet/srv6/
F: src/vnet/srmpls/
F: src/examples/srv6-sample-localsid/
VNET IPSec
I: ipsec
M: Neale Ranns <nranns@cisco.com>
M: Radu Nicolau <radu.nicolau@intel.com>
F: src/vnet/ipsec/
VNET Crypto Infra
I: crypto
M: Damjan Marion <damarion@cisco.com>
M: Neale Ranns <nranns@cisco.com>
F: src/vnet/crypto/
VNET TEIB
I: teib
M: Neale Ranns <nranns@cisco.com>
F: src/vnet/teib/
VNET SPAN
I: span
M: N/A
F: src/vnet/span
Plugin - Crypto - native
I: crypto-native
M: Damjan Marion <damarion@cisco.com>
F: src/plugins/crypto_native/
Plugin - Crypto - OpenSSL
I: crypto-openssl
M: Damjan Marion <damarion@cisco.com>
F: src/plugins/crypto_openssl/
Plugin - Crypto - ipsecmb
I: crypto-ipsecmb
M: Neale Ranns <nranns@cisco.com>
F: src/plugins/crypto_ipsecmb/
VNET L2
I: l2
M: John Lo <loj@cisco.com>
F: src/vnet/l2/
VNET Link Layer Discovery Protocol (LLDP)
I: lldp
M: Klement Sekera <ksekera@cisco.com>
F: src/vnet/lldp/
VNET LISP
I: lisp
Y: src/vnet/lisp-cp/FEATURE.yaml
Y: src/vnet/lisp-gpe/FEATURE.yaml
M: Florin Coras <fcoras@cisco.com>
F: src/vnet/lisp-cp/
F: src/vnet/lisp-gpe/
VNET GRE
I: gre
M: Neale Ranns <nranns@cisco.com>
F: src/vnet/gre/
VNET GSO
I: gso
M: Andrew Yourtchenko <ayourtch@gmail.com>
M: Mohsin Kazmi <sykazmi@cisco.com>
F: src/vnet/gso/
Plugin - MAP
I: map
Y: src/plugins/map/FEATURE.yaml
M: Ole Troan <ot@cisco.com>
M: Jon Loeliger <jdl@netgate.com>
F: src/plugins/map
VNET MPLS
I: mpls
M: Neale Ranns <nranns@cisco.com>
F: src/vnet/mpls/
VNET BIER
I: bier
M: Neale Ranns <nranns@cisco.com>
F: src/vnet/bier/
VNET Session Layer
I: session
Y: src/vnet/session/FEATURE.yaml
M: Florin Coras <fcoras@cisco.com>
F: src/vnet/session
VNET TCP
I: tcp
Y: src/vnet/tcp/FEATURE.yaml
M: Florin Coras <fcoras@cisco.com>
F: src/vnet/tcp
VNET UDP
I: udp
Y: src/vnet/udp/FEATURE.yaml
M: Florin Coras <fcoras@cisco.com>
F: src/vnet/udp
VNET VXLAN
I: vxlan
M: John Lo <loj@cisco.com>
F: src/vnet/vxlan/
VNET VXLAN-GPE
I: vxlan-gpe
M: Hongjun Ni <hongjun.ni@intel.com>
F: src/vnet/vxlan-gpe/
VNET VXLAN-GBP
I: vxlan-gbp
M: Mohsin Kazmi <sykazmi@cisco.com>
M: Neale Ranns <nranns@cisco.com>
F: src/vnet/vxlan-gbp/
VNET IPIP
I: ipip
Y: src/vnet/ipip/FEATURE.yaml
M: Ole Troan <otroan@employees.org>
F: src/vnet/ipip/
VNET tunnel
I: tunnel
M: Neale Ranns <nranns@cisco.com>
F: src/vnet/tunnel'
VNET TLS and TLS engine plugins
I: tls
M: Florin Coras <fcoras@cisco.com>
M: Ping Yu <ping.yu@intel.com>
F: src/vnet/tls
F: src/plugins/tlsopenssl
F: src/plugins/tlsmbedtls
F: src/plugins/tlspicotls
VNET SYSLOG
I: syslog
M: Matus Fabian <matfabia@cisco.com>
F: src/vnet/syslog
Plugin - DHCP
I: dhcp
M: Dave Barach <dave@barachs.net>
M: Neale Ranns <nranns@cisco.com>
F: src/plugins/dhcp/
Plugin - ARP
I: arp
M: Dave Barach <dave@barachs.net>
M: Neale Ranns <nranns@cisco.com>
F: src/plugins/arp/
Plugin - IP6 Neighbor Discovery
I: ip6-nd
M: Dave Barach <dave@barachs.net>
M: Neale Ranns <nranns@cisco.com>
F: src/plugins/ip6-nd/
VNET GENEVE
I: geneve
M: N/A
F: src/vnet/geneve/
VNET FLOW
I: flow
M: Damjan Marion <damarion@cisco.com>
F: src/vnet/flow/
VNET Classify
I: classify
M: N/A
F: src/vnet/classify/
VPP Main App
I: vpp
M: Dave Barach <dave@barachs.net>
M: Damjan Marion <damarion@cisco.com>
F: src/vpp/
Plugin - Access Control List (ACL) Based Forwarding
I: abf
M: Neale Ranns <nranns@cisco.com>
F: src/plugins/abf/
Plugin - Allow / Deny List
I: adl
M: Dave Barach <dave@barachs.net>
F: src/plugins/adl/
Plugin - Simple DNS name resolver
I: dns
M: Dave Barach <dave@barachs.net>
F: src/plugins/dns/
Plugin - Group Based Policy (GBP)
I: gbp
M: Neale Ranns <nranns@cisco.com>
F: src/plugins/gbp/
Plugin - ACL
I: acl
M: Andrew Yourtchenko <ayourtch@gmail.com>
F: src/plugins/acl/
Plugin - NAT
I: nat
M: Ole Troan <ot@cisco.com>
F: src/plugins/nat/
Plugin - AVF Device driver
I: avf
M: Damjan Marion <damarion@cisco.com>
F: src/plugins/avf/
Plugin - DPDK
I: dpdk
M: Damjan Marion <damarion@cisco.com>
F: src/plugins/dpdk/
Plugin - DPDK Crypto
I: dpdk-ipsec
M: Sergio Gonzalez Monroy <sergio.gonzalez.monroy@outlook.com>
M: Radu Nicolau <radu.nicolau@intel.com>
F: src/plugins/dpdk/ipsec/
Plugin - flowprobe
I: flowprobe
Y: src/plugins/flowprobe/FEATURE.yaml
M: Ole Troan <otroan@employees.org>
F: src/plugins/flowprobe/
Plugin - http_static
I: http_static
M: Dave Barach <dbarach@cisco.com>
F: src/plugins/http_static/
Plugin - builtinurl
I: builtinurl
M: Dave Barach <dbarach@cisco.com>
F: src/plugins/builtinurl/
Plugin - Group Based Policy (GBP)
I: gbp
M: Neale Ranns <nranns@cisco.com>
F: src/plugins/gbp/
Plugin - GTPU
I: gtpu
M: Hongjun Ni <hongjun.ni@intel.com>
F: src/plugins/gtpu/
Plugin - Internet Key Exchange (IKEv2) Protocol
I: ikev2
M: Damjan Marion <damarion@cisco.com>
M: Neale Ranns <nranns@cisco.com>
M: Filip Tehlar <ftehlar@cisco.com>
M: Benoît Ganne <bganne@cisco.com>
F: src/plugins/ikev2/
Plugin - Internet Group Management Protocol (IGMP)
I: igmp
M: Neale Ranns <nranns@cisco.com>
F: src/plugins/igmp/
Plugin - L3 Cross-Connect (L3XC)
I: l3xc
M: Neale Ranns <nranns@cisco.com>
F: src/plugins/l3xc/
Plugin - memif device driver
I: memif
M: Damjan Marion <damarion@cisco.com>
F: src/plugins/memif/
Plugin - Marvell MUSDK device driver
I: marvell
M: Damjan Marion <damarion@cisco.com>
F: src/plugins/marvell/
Plugin - performance counter
I: perfmon
M: Dave Barach <dave@barachs.net>
F: src/plugins/perfmon/
Plugin - PPPoE
I: pppoe
M: Hongjun Ni <hongjun.ni@intel.com>
F: src/plugins/pppoe/
Plugin - Ping
I: ping
M: Andrew Yourtchenko <ayourtch@gmail.com>
F: src/plugins/ping
Plugin - IPv6 Segment Routing Dynamic Proxy
I: srv6-ad
M: Francois Clad <fclad@cisco.com>
F: src/plugins/srv6-ad/
Plugin - IPv6 Segment Routing Masquerading Proxy
I: srv6-am
M: Francois Clad <fclad@cisco.com>
F: src/plugins/srv6-am/
Plugin - IPv6 Segment Routing Static Proxy
I: srv6-as
M: Francois Clad <fclad@cisco.com>
F: src/plugins/srv6-as/
Plugin - IPv6 Segment Routing Mobile
I: srv6-mobile
M: Tetsuya Murakami <tetsuya.mrk@gmail.com>
M: Satoru Matsushima <satoru.matsushima@gmail.com>
F: src/plugins/srv6-mobile/
Plugin - Link Aggregation Control Protocol
I: lacp
M: Steven Luong <sluong@cisco.com>
F: src/plugins/lacp/
Plugin - Load Balancer
I: lb
M: Pfister <ppfister@cisco.com>
M: Hongjun Ni <hongjun.ni@intel.com>
F: src/plugins/lb/
Plugin - NSH
I: nsh
M: Hongjun Ni <hongjun.ni@intel.com>
M: Vengada <venggovi@cisco.com>
F: src/plugins/nsh/
Plugin - Time-based MAC filter
I: mactime
Y: src/plugins/mactime/FEATURE.yaml
M: Dave Barach <dave@barachs.net>
F: src/plugins/mactime/
Plugin - Network Delay Simulator
I: nsim
Y: src/plugins/nsim/FEATURE.yaml
M: Dave Barach <dave@barachs.net>
F: src/plugins/nsim/
Plugin - Buffer Metadata Modification Tracker
I: mdata
M: Dave Barach <dave@barachs.net>
F: src/plugins/mdata/
Plugin - Unit Tests
I: unittest
M: Dave Barach <dave@barachs.net>
M: Florin Coras <fcoras@cisco.com
F: src/plugins/unittest/
Test Infrastructure
I: tests
M: Klement Sekera <ksekera@cisco.com>
M: Paul Vinciguerra <pvinci@vinciconsulting.com>
F: test/
SVM Library
I: svm
M: Dave Barach <dave@barachs.net>
F: src/svm
VPP API TEST
I: vat
M: Dave Barach <dave@barachs.net>
F: src/vat/
VPP Executable
I: vpp
M: Dave Barach <dave@barachs.net>
F: src/vpp/
Emacs templates
I: emacs
M: Dave Barach <dave@barachs.net>
F: extras/emacs/
Graphical Event Viewer
I: g2
M: Dave Barach <dave@barachs.net>
F: src/tools/g2/
Performance Tooling
I: perftool
M: Dave Barach <dave@barachs.net>
F: src/tools/perftool/
Plugin - vmxnet3 device driver
I: vmxnet3
M: Steven Luong <sluong@cisco.com>
F: src/plugins/vmxnet3/
Binary API Compiler for Python
I: vppapigen
M: Ole Troan <otroan@employees.org>
F: src/tools/vppapigen/
API trace tool
I: vppapitrace
M: Ole Troan <otroan@employees.org>
F: src/tools/vppapitrace/
Binary API Compiler for C and C++
I: vapi
M: Ole Troan <ot@cisco.com>
F: src/vpp-api/vapi
Plugin - RDMA (ibverb) driver
I: rdma
M: Benoît Ganne <bganne@cisco.com>
M: Damjan Marion <damarion@cisco.com>
F: src/plugins/rdma/
Plugin - QUIC protocol
I: quic
M: Aloys Augustin <aloaugus@cisco.com>
M: Nathan Skrzypczak <nathan.skrzypczak@gmail.com>
M: Dave Wallace <dwallacelf@gmail.com>
M: Florin Coras <fcoras@cisco.com>
Y: src/plugins/quic/FEATURE.yaml
F: src/plugins/quic/
libmemif
I: libmemif
M: Damjan Marion <damarion@cisco.com>
F: extras/libmemif
gomemif
I: gomemif
M: Jakub Grajciar <jgrajcia@cisco.com>
F: extras/gomemif
VPP Comms Library
I: vcl
Y: src/vnet/vcl/FEATURE.yaml
M: Florin Coras <fcoras@cisco.com>
F: src/vcl
Statistics Segment
I: stats
M: Ole Troan <ot@cisco.com>
F: src/vpp/stats/
F: src/vpp-api/client/stat_client.[ch]
Plugin - Host Stack Applications
I: hsa
M: Florin Coras <fcoras@cisco.com>
M: Dave Wallace <dwallacelf@gmail.com>
M: Aloys Augustin <aloaugus@cisco.com>
M: Nathan Skrzypczak <nathan.skrzypczak@gmail.com>
F: src/plugins/hs_apps/
Python binding for the VPP API
I: papi
M: Ole Troan <ot@cisco.com>
M: Paul Vinciguerra <pvinci@vinciconsulting.com>
F: src/vpp-api/python
Cisco Discovery Protocol
I: cdp
F: src/plugins/cdp/
Source VRF Select
I: svs
M: Neale Ranns <nranns@cisco.com>
F: src/plugins/svs/
LAN Emulation
I: l2e
M: Neale Ranns <nranns@cisco.com>
F: src/plugins/l2e/
IPv6 Connection Tracker
I: ct6
M: Dave Barach <dave@barachs.net>
F: src/plugins/ct6
Steal The NIC
I: stn
F: src/plugins/stn
IOAM
I: ioam
F: src/plugins/ioam
Awkward chained buffer geometry tool
I: oddbuf
F: src/plugins/oddbuf
Plugin - VRRP
I: vrrp
M: Matthew Smith <mgsmith@netgate.com>
F: src/plugins/vrrp
Plugin - Unicast Reverse Path forwarding
I: urpf
M: Neale Ranns <nranns@cisco.com>
F: src/plugins/urpf
Plugin - CNat
I: cnat
M: Nathan Skrzypczak <nathan.skrzypczak@gmail.com>
M: Neale Ranns <nranns@cisco.com>
F: src/plugins/cnat
Plugin - Wireguard
I: wireguard
M: Artem Glazychev <artem.glazychev@xored.com>
F: src/plugins/wireguard
VPP Config Tooling
I: vpp_config
M: John DeNisco <jdenisco@cisco.com>
F: extras/vpp_config
bash functions
I: bash
M: Dave Wallace <dwallacelf@gmail.com>
F: extras/bash/
Plugin - AF_XDP driver
I: af_xdp
M: Benoît Ganne <bganne@cisco.com>
M: Damjan Marion <damarion@cisco.com>
F: src/plugins/af_xdp/
Plugin - geneve
I: geneve
M: community vpp-dev@lists.fd.io
F: src/plugins/geneve/
THE REST
I: misc
C: Contact vpp-dev Mailing List <vpp-dev@fd.io>
F: *
F: */
