mirror of
https://github.com/openvswitch/ovs
synced 2025-10-27 15:18:06 +00:00
7321bda384
Packets are still sampled at ingress only, so the egress tunnel and/or MPLS structures are only included when there is just 1 output port. The actions are either provided by the datapath in the sample upcall or looked up in the userspace cache. The former is preferred because it is more reliable and does not present any new demands or constraints on the userspace cache, however the code falls back on the userspace lookup so that this solution can work with existing kernel datapath modules. If the lookup fails it is not critical: the compiled user-action-cookie is still available and provides the essential output port and output VLAN forwarding information just as before. The openvswitch actions can express almost any tunneling/mangling so the only totally faithful representation would be to somehow encode the whole list of flow actions in the sFlow output. However the standard sFlow tunnel structures can express most common real-world scenarios, so in parsing the actions we look for those and skip the encoding if we see anything unusual. For example, a single set(tunnel()) or tnl_push() is interpreted, but if a second such action is encountered then the egress tunnel reporting is suppressed. The sFlow standard allows "best effort" encoding so that if a field is not knowable or too onerous to look up then it can be left out. This is often the case for the layer-4 source port or even the src ip address of a tunnel. The assumption is that monitoring is enabled everywhere so a missing field can typically be seen at ingress to the next switch in the path. This patch also adds unit tests to check the sFlow encoding of set(tunnel()), tnl_push() and push_mpls() actions. The netlink attribute to request that actions be included in the upcall from the datapath is inserted for sFlow sampling only. To make that option be explicit would require further changes to the printing and parsing of actions in lib/odp-util.c, and to scripts in the test suite. Further enhancements to report on 802.1AD QinQ, 64-bit tunnel IDs, and NAT transformations can follow in future patches that make only incremental changes. Signed-off-by: Neil McKee <neil.mckee@inmon.com> [blp@nicira.com made stylistic and semantic changes] Signed-off-by: Ben Pfaff <blp@nicira.com>
85 lines
3.0 KiB
C
85 lines
3.0 KiB
C
/*
|
|
* Copyright (c) 2009, 2010 InMon Corp.
|
|
* Copyright (c) 2009, 2012 Nicira, Inc.
|
|
*
|
|
* 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.
|
|
*/
|
|
|
|
#ifndef OFPROTO_DPIF_SFLOW_H
|
|
#define OFPROTO_DPIF_SFLOW_H 1
|
|
|
|
#include <stdint.h>
|
|
#include "svec.h"
|
|
#include "lib/odp-util.h"
|
|
|
|
struct dpif;
|
|
struct dpif_upcall;
|
|
struct flow;
|
|
struct ofproto_sflow_options;
|
|
struct ofport;
|
|
|
|
/* When we have the actions for a sampled packet that
|
|
* will go to just one output, then this structure is
|
|
* populated by parsing them. Only fields relevant to
|
|
* the sFlow export are extracted.
|
|
*/
|
|
struct dpif_sflow_actions {
|
|
odp_port_t out_port; /* ODP output port. */
|
|
|
|
uint32_t encap_depth; /* Count layers of tunnel-encap. */
|
|
struct flow_tnl tunnel; /* Egress tunnel push/set. */
|
|
uint8_t tunnel_ipproto; /* Tunnel push action can set ipproto. */
|
|
bool tunnel_err; /* Tunnel actions parse failure. */
|
|
|
|
/* Using host-byte order for the mpls stack here
|
|
to match the expectations of the sFlow library. Also
|
|
the ordering is reversed, so that the entry at offset 0
|
|
is the bottom of the stack.
|
|
*/
|
|
uint32_t mpls_lse[FLOW_MAX_MPLS_LABELS]; /* Out stack in host byte order. */
|
|
uint32_t mpls_stack_depth; /* Out stack depth. */
|
|
bool mpls_err; /* MPLS actions parse failure. */
|
|
};
|
|
|
|
struct dpif_sflow *dpif_sflow_create(void);
|
|
struct dpif_sflow *dpif_sflow_ref(const struct dpif_sflow *);
|
|
void dpif_sflow_unref(struct dpif_sflow *);
|
|
|
|
uint32_t dpif_sflow_get_probability(const struct dpif_sflow *);
|
|
|
|
void dpif_sflow_set_options(struct dpif_sflow *,
|
|
const struct ofproto_sflow_options *);
|
|
void dpif_sflow_clear(struct dpif_sflow *);
|
|
bool dpif_sflow_is_enabled(const struct dpif_sflow *);
|
|
|
|
void dpif_sflow_add_port(struct dpif_sflow *ds, struct ofport *ofport,
|
|
odp_port_t odp_port);
|
|
void dpif_sflow_del_port(struct dpif_sflow *, odp_port_t odp_port);
|
|
|
|
void dpif_sflow_run(struct dpif_sflow *);
|
|
void dpif_sflow_wait(struct dpif_sflow *);
|
|
|
|
void dpif_sflow_read_actions(const struct flow *,
|
|
const struct nlattr *actions, size_t actions_len,
|
|
struct dpif_sflow_actions *);
|
|
|
|
void dpif_sflow_received(struct dpif_sflow *, const struct dp_packet *,
|
|
const struct flow *, odp_port_t odp_port,
|
|
const union user_action_cookie *,
|
|
const struct dpif_sflow_actions *);
|
|
|
|
int dpif_sflow_odp_port_to_ifindex(const struct dpif_sflow *,
|
|
odp_port_t odp_port);
|
|
|
|
#endif /* ofproto/ofproto-dpif-sflow.h */
|