mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/chenhuacai/linux-loongson
synced 2025-08-29 11:42:36 +00:00
7b1b2b60c6
Although not explicitly documented in the psample module itself, the definition of PSAMPLE_ATTR_SAMPLE_RATE seems inherited from act_sample. Quoting tc-sample(8): "RATE of 100 will lead to an average of one sampled packet out of every 100 observed." With this semantics, the rates that we can express with an unsigned 32-bits number are very unevenly distributed and concentrated towards "sampling few packets". For example, we can express a probability of 2.32E-8% but we cannot express anything between 100% and 50%. For sampling applications that are capable of sampling a decent amount of packets, this sampling rate semantics is not very useful. Add a new flag to the uAPI that indicates that the sampling rate is expressed in scaled probability, this is: - 0 is 0% probability, no packets get sampled. - U32_MAX is 100% probability, all packets get sampled. Reviewed-by: Aaron Conole <aconole@redhat.com> Acked-by: Eelco Chaudron <echaudro@redhat.com> Reviewed-by: Ido Schimmel <idosch@nvidia.com> Signed-off-by: Adrian Moreno <amorenoz@redhat.com> Link: https://patch.msgid.link/20240704085710.353845-5-amorenoz@redhat.com Signed-off-by: Jakub Kicinski <kuba@kernel.org>
72 lines
2.6 KiB
C
72 lines
2.6 KiB
C
/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
|
|
#ifndef __UAPI_PSAMPLE_H
|
|
#define __UAPI_PSAMPLE_H
|
|
|
|
enum {
|
|
PSAMPLE_ATTR_IIFINDEX,
|
|
PSAMPLE_ATTR_OIFINDEX,
|
|
PSAMPLE_ATTR_ORIGSIZE,
|
|
PSAMPLE_ATTR_SAMPLE_GROUP,
|
|
PSAMPLE_ATTR_GROUP_SEQ,
|
|
PSAMPLE_ATTR_SAMPLE_RATE, /* u32, ratio between observed and
|
|
* sampled packets or scaled probability
|
|
* if PSAMPLE_ATTR_SAMPLE_PROBABILITY
|
|
* is set.
|
|
*/
|
|
PSAMPLE_ATTR_DATA,
|
|
PSAMPLE_ATTR_GROUP_REFCOUNT,
|
|
PSAMPLE_ATTR_TUNNEL,
|
|
|
|
PSAMPLE_ATTR_PAD,
|
|
PSAMPLE_ATTR_OUT_TC, /* u16 */
|
|
PSAMPLE_ATTR_OUT_TC_OCC, /* u64, bytes */
|
|
PSAMPLE_ATTR_LATENCY, /* u64, nanoseconds */
|
|
PSAMPLE_ATTR_TIMESTAMP, /* u64, nanoseconds */
|
|
PSAMPLE_ATTR_PROTO, /* u16 */
|
|
PSAMPLE_ATTR_USER_COOKIE, /* binary, user provided data */
|
|
PSAMPLE_ATTR_SAMPLE_PROBABILITY,/* no argument, interpret rate in
|
|
* PSAMPLE_ATTR_SAMPLE_RATE as a
|
|
* probability scaled 0 - U32_MAX.
|
|
*/
|
|
|
|
__PSAMPLE_ATTR_MAX
|
|
};
|
|
|
|
enum psample_command {
|
|
PSAMPLE_CMD_SAMPLE,
|
|
PSAMPLE_CMD_GET_GROUP,
|
|
PSAMPLE_CMD_NEW_GROUP,
|
|
PSAMPLE_CMD_DEL_GROUP,
|
|
};
|
|
|
|
enum psample_tunnel_key_attr {
|
|
PSAMPLE_TUNNEL_KEY_ATTR_ID, /* be64 Tunnel ID */
|
|
PSAMPLE_TUNNEL_KEY_ATTR_IPV4_SRC, /* be32 src IP address. */
|
|
PSAMPLE_TUNNEL_KEY_ATTR_IPV4_DST, /* be32 dst IP address. */
|
|
PSAMPLE_TUNNEL_KEY_ATTR_TOS, /* u8 Tunnel IP ToS. */
|
|
PSAMPLE_TUNNEL_KEY_ATTR_TTL, /* u8 Tunnel IP TTL. */
|
|
PSAMPLE_TUNNEL_KEY_ATTR_DONT_FRAGMENT, /* No argument, set DF. */
|
|
PSAMPLE_TUNNEL_KEY_ATTR_CSUM, /* No argument. CSUM packet. */
|
|
PSAMPLE_TUNNEL_KEY_ATTR_OAM, /* No argument. OAM frame. */
|
|
PSAMPLE_TUNNEL_KEY_ATTR_GENEVE_OPTS, /* Array of Geneve options. */
|
|
PSAMPLE_TUNNEL_KEY_ATTR_TP_SRC, /* be16 src Transport Port. */
|
|
PSAMPLE_TUNNEL_KEY_ATTR_TP_DST, /* be16 dst Transport Port. */
|
|
PSAMPLE_TUNNEL_KEY_ATTR_VXLAN_OPTS, /* Nested VXLAN opts* */
|
|
PSAMPLE_TUNNEL_KEY_ATTR_IPV6_SRC, /* struct in6_addr src IPv6 address. */
|
|
PSAMPLE_TUNNEL_KEY_ATTR_IPV6_DST, /* struct in6_addr dst IPv6 address. */
|
|
PSAMPLE_TUNNEL_KEY_ATTR_PAD,
|
|
PSAMPLE_TUNNEL_KEY_ATTR_ERSPAN_OPTS, /* struct erspan_metadata */
|
|
PSAMPLE_TUNNEL_KEY_ATTR_IPV4_INFO_BRIDGE, /* No argument. IPV4_INFO_BRIDGE mode.*/
|
|
__PSAMPLE_TUNNEL_KEY_ATTR_MAX
|
|
};
|
|
|
|
/* Can be overridden at runtime by module option */
|
|
#define PSAMPLE_ATTR_MAX (__PSAMPLE_ATTR_MAX - 1)
|
|
|
|
#define PSAMPLE_NL_MCGRP_CONFIG_NAME "config"
|
|
#define PSAMPLE_NL_MCGRP_SAMPLE_NAME "packets"
|
|
#define PSAMPLE_GENL_NAME "psample"
|
|
#define PSAMPLE_GENL_VERSION 1
|
|
|
|
#endif
|