blob: e9137ca7d7e6b93ca4dcb8dfc039a1fc0bb164c7 [file] [log] [blame]
/*
**************************************************************************
* Copyright (c) 2014-2015, 2018-2021 The Linux Foundation. All rights reserved.
* Permission to use, copy, modify, and/or distribute this software for
* any purpose with or without fee is hereby granted, provided that the
* above copyright notice and this permission notice appear in all copies.
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
* ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
* ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
* OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
**************************************************************************
*/
extern int ecm_classifier_accel_delay_pkts; /* Default slow path packets allowed before the acceleration */
struct ecm_classifier_instance;
/*
* Classifier types.
* MUST BE RECORDED IN ASCENDING ORDER OF PRIORITY
*/
enum ecm_classifier_types {
ECM_CLASSIFIER_TYPE_DEFAULT = 0, /* MUST BE FIRST, Default classifier */
#ifdef ECM_CLASSIFIER_MARK_ENABLE
ECM_CLASSIFIER_TYPE_MARK, /* Mark classifier */
#endif
#ifdef ECM_CLASSIFIER_HYFI_ENABLE
ECM_CLASSIFIER_TYPE_HYFI, /* HyFi classifier */
#endif
#ifdef ECM_CLASSIFIER_DSCP_ENABLE
ECM_CLASSIFIER_TYPE_DSCP, /* Provides DSCP and DSCP remarking support */
#endif
#ifdef ECM_CLASSIFIER_MSCS_ENABLE
ECM_CLASSIFIER_TYPE_MSCS, /* Mirrored Stream Classification Signalling(MSCS) classifier */
#endif
#ifdef ECM_CLASSIFIER_EMESH_ENABLE
ECM_CLASSIFIER_TYPE_EMESH, /* E-Mesh classifier */
#endif
#ifdef ECM_CLASSIFIER_NL_ENABLE
ECM_CLASSIFIER_TYPE_NL, /* Provides netlink interface */
#endif
#ifdef ECM_CLASSIFIER_OVS_ENABLE
ECM_CLASSIFIER_TYPE_OVS, /* OVS classifier */
#endif
#ifdef ECM_CLASSIFIER_PCC_ENABLE
ECM_CLASSIFIER_TYPE_PCC, /* Parental control subsystem support classifier */
#endif
ECM_CLASSIFIER_TYPES, /* MUST BE LAST */
};
typedef enum ecm_classifier_types ecm_classifier_type_t;
/*
* enum ecm_classifier_relevances
* Whether a classifier is relevant to a connection
*/
enum ecm_classifier_relevances {
ECM_CLASSIFIER_RELEVANCE_MAYBE = 0, /* Classifier has not yet determined relevance */
ECM_CLASSIFIER_RELEVANCE_NO, /* Classifier is not relevant to a connection (classifier will be unassigned from the connection after returning this from a process() call) */
ECM_CLASSIFIER_RELEVANCE_YES, /* Classifier is relevant to the connection, process actions will be inspected by the front end when returning this from a process() call */
};
typedef enum ecm_classifier_relevances ecm_classifier_relevence_t;
/*
* enum ecm_classifier_acceleration_modes
* Modes in which a connection may be accelerated
*
* These are used by a classifier to indicate its desire to accelerate.
*/
enum ecm_classifier_acceleration_modes {
ECM_CLASSIFIER_ACCELERATION_MODE_DONT_CARE = 0, /* Classifier does not care if the connection is accelerated */
ECM_CLASSIFIER_ACCELERATION_MODE_NO, /* Connection must not be accelerated */
ECM_CLASSIFIER_ACCELERATION_MODE_ACCEL, /* Connection can be accelerated whenever */
};
typedef enum ecm_classifier_acceleration_modes ecm_classifier_acceleration_mode_t;
/*
* Process actions
* A process result, that is relevant, may contain zero or more actions for the front end.
* Due to the parallel processing nature of classifiers, *usually* the action(s) of the highest priority
* classifier will override any lower priority actions. This is up to front end discretion, of course.
*/
#define ECM_CLASSIFIER_PROCESS_ACTION_DROP 0x00000001 /* Drop */
#define ECM_CLASSIFIER_PROCESS_ACTION_QOS_TAG 0x00000002 /* Contains flow & return qos tags */
#define ECM_CLASSIFIER_PROCESS_ACTION_ACCEL_MODE 0x00000004 /* Contains an accel mode */
#define ECM_CLASSIFIER_PROCESS_ACTION_TIMER_GROUP 0x00000008 /* Contains a timer group change */
#ifdef ECM_CLASSIFIER_DSCP_ENABLE
#define ECM_CLASSIFIER_PROCESS_ACTION_DSCP 0x00000010 /* Contains DSCP marking information */
#define ECM_CLASSIFIER_PROCESS_ACTION_DSCP_DENY 0x00000020 /* Denies any DSCP changes */
#define ECM_CLASSIFIER_PROCESS_ACTION_IGS_QOS_TAG 0x00000040 /* Contains flow & return ingress qos tags */
#endif
#ifdef ECM_CLASSIFIER_OVS_ENABLE
#define ECM_CLASSIFIER_PROCESS_ACTION_OVS_VLAN_TAG 0x00000080 /* Contains OVS VLAN tags */
#define ECM_CLASSIFIER_PROCESS_ACTION_OVS_VLAN_QINQ_TAG 0x00000100 /* Contains OVS QinQ VLAN tags */
#define ECM_CLASSIFIER_PROCESS_ACTION_OVS_MCAST_DENY_ACCEL 0x00000200 /* Multicast OVS flow */
#endif
#ifdef ECM_CLASSIFIER_EMESH_ENABLE
#define ECM_CLASSIFIER_PROCESS_ACTION_EMESH_SP_FLOW 0x00000400 /* Mark the E-MESH Service Prioritization flow */
#endif
#define ECM_CLASSIFIER_PROCESS_ACTION_TIMER_GROUP_NO_TOUCH 0x00000400 /* Do not update CI time */
#ifdef ECM_CLASSIFIER_PCC_ENABLE
#define ECM_CLASSIFIER_PROCESS_ACTION_MIRROR_ENABLED 0x00000800 /* Contains mirror dynamic interface number */
#endif
/*
* struct ecm_classifier_process_response
* Response structure returned by a process call
*/
struct ecm_classifier_process_response {
ecm_classifier_relevence_t relevance; /* Is this classifier relevant to the connection? */
uint32_t became_relevant; /* DB time the classifier became relevant or not relevant, if relevance is maybe this field is not relevant! */
uint32_t process_actions; /* Actions this process response contains */
/*
* The following fields are only to be inspected if this response is relevant AND the process_actions indicates so
*/
bool drop; /* Drop packet at hand */
uint32_t flow_qos_tag; /* QoS tag to use for the packet */
uint32_t return_qos_tag; /* QoS tag to use for the packet */
#ifdef ECM_CLASSIFIER_DSCP_ENABLE
#ifdef ECM_CLASSIFIER_DSCP_IGS
uint16_t igs_flow_qos_tag; /* Ingress QoS tag to use for the packet */
uint16_t igs_return_qos_tag; /* Ingress QoS tag to use for the return packet */
#endif
uint8_t flow_dscp; /* DSCP mark for flow */
uint8_t return_dscp; /* DSCP mark for return */
#endif
#ifdef ECM_CLASSIFIER_OVS_ENABLE
uint32_t ingress_vlan_tag[2]; /* Ingress VLAN tags */
uint32_t egress_vlan_tag[2]; /* Egress VLAN tags */
#ifdef ECM_MULTICAST_ENABLE
int32_t egress_netdev_index[ECM_DB_MULTICAST_IF_MAX]; /* Multicast egress net device interface index */
uint32_t egress_mc_vlan_tag[ECM_DB_MULTICAST_IF_MAX][2]; /* Multicast egress VLAN tags */
#endif
#endif
#ifdef ECM_CLASSIFIER_PCC_ENABLE
int flow_mirror_ifindex; /* Flow mirror device index value */
int return_mirror_ifindex; /* Return mirror device index value */
#endif
ecm_classifier_acceleration_mode_t accel_mode; /* Acceleration needed for this connection */
ecm_db_timer_group_t timer_group; /* Timer group the connection should be in */
};
/*
* Sync rule structure.
* Acceleration engine's sync parameters will be stored
* in this data structure to update the classifiers.
*/
struct ecm_classifier_rule_sync {
uint32_t tx_packet_count[ECM_CONN_DIR_MAX];
uint32_t tx_byte_count[ECM_CONN_DIR_MAX];
uint32_t rx_packet_count[ECM_CONN_DIR_MAX];
uint32_t rx_byte_count[ECM_CONN_DIR_MAX];
uint32_t reason;
};
/*
* Create rule structure.
* Additional create rule parameters from the classifiers
* will be copied to this data structure before pushing them to
* the underlying accelaration engine.
*/
struct ecm_classifier_rule_create {
#ifdef ECM_CLASSIFIER_EMESH_ENABLE
struct sk_buff *skb;
#endif
};
/*
* To be implemented by all classifiers
*/
typedef void (*ecm_classifier_ref_method_t)(struct ecm_classifier_instance *ci);
typedef int (*ecm_classifier_deref_callback_t)(struct ecm_classifier_instance *ci);
typedef void (*ecm_classifier_process_callback_t)(struct ecm_classifier_instance *ci, ecm_tracker_sender_type_t sender, struct ecm_tracker_ip_header *ip_hdr, struct sk_buff *skb, struct ecm_classifier_process_response *process_response);
/* Process new data for connection, process_response is populated with the response of processing */
typedef void (*ecm_classifier_sync_from_v4_callback_t)(struct ecm_classifier_instance *ci, struct ecm_classifier_rule_create *ecrc);
/* Sync the accel engine state with state from the classifier */
typedef void (*ecm_classifier_sync_to_v4_callback_t)(struct ecm_classifier_instance *ci, struct ecm_classifier_rule_sync *sync);
/* Sync the classifier state with current accel engine state */
typedef void (*ecm_classifier_sync_from_v6_callback_t)(struct ecm_classifier_instance *ci, struct ecm_classifier_rule_create *ecrc);
/* Sync the accel engine state with state from the classifier */
typedef void (*ecm_classifier_sync_to_v6_callback_t)(struct ecm_classifier_instance *ci, struct ecm_classifier_rule_sync *sync);
/* Sync the classifier state with current accel engine state */
typedef ecm_classifier_type_t (*ecm_classifier_type_get_callback_t)(struct ecm_classifier_instance *ci);
/* Get type of classifier this is */
typedef bool (*ecm_classifier_reclassify_allowed_get_callback_t)(struct ecm_classifier_instance *ci);
/* Get whether reclassification is allowed */
typedef void (*ecm_classifier_reclassify_callback_t)(struct ecm_classifier_instance *ci);
/* Reclassify */
typedef void (*ecm_classifier_last_process_response_get_callback_t)(struct ecm_classifier_instance *ci, struct ecm_classifier_process_response *process_response);
/* Get last process response */
#ifdef ECM_STATE_OUTPUT_ENABLE
typedef int (*ecm_classifier_state_get_callback_t)(struct ecm_classifier_instance *ci, struct ecm_state_file_instance *sfi);
/* Get state output. Returns 0 upon success. */
#endif
/*
* Determines if a connection should be kept.
*/
typedef bool (*ecm_classifier_should_keep_connection_t)
(struct ecm_classifier_instance *ci, uint8_t *mac);
/*
* Base class for all types of classifiers
*/
struct ecm_classifier_instance {
struct ecm_classifier_instance *ca_next; /* DB use only: Connection assignment next pointer */
struct ecm_classifier_instance *ca_prev; /* DB use only: Connection assignment prev pointer */
ecm_classifier_process_callback_t process; /* Process new skb */
ecm_classifier_sync_from_v4_callback_t sync_from_v4;
/* Sync the accel engine with state from the classifier */
ecm_classifier_sync_to_v4_callback_t sync_to_v4;/* Sync the classifier with state from the accel engine */
ecm_classifier_sync_from_v6_callback_t sync_from_v6;
/* Sync the accel engine with state from the classifier */
ecm_classifier_sync_to_v6_callback_t sync_to_v6;/* Sync the classifier with state from the accel engine */
ecm_classifier_type_get_callback_t type_get; /* Get type of classifier */
ecm_classifier_reclassify_allowed_get_callback_t reclassify_allowed;
/* Get whether reclassification is allowed */
ecm_classifier_reclassify_callback_t reclassify;
/* Reclassify */
ecm_classifier_last_process_response_get_callback_t last_process_response_get;
/* Return last process response */
ecm_classifier_should_keep_connection_t should_keep_connection;
/* Check if connection should be kept when FDB updates */
#ifdef ECM_STATE_OUTPUT_ENABLE
ecm_classifier_state_get_callback_t state_get;
/* Return its state */
#endif
ecm_classifier_ref_method_t ref;
ecm_classifier_deref_callback_t deref;
};
#ifdef ECM_STATE_OUTPUT_ENABLE
/*
* ecm_classifier_process_response_state_get()
* Output detail for the process response
*
* Returns 0 on success.
*/
static inline int ecm_classifier_process_response_state_get(struct ecm_state_file_instance *sfi, struct ecm_classifier_process_response *pr)
{
int result;
if ((result = ecm_state_prefix_add(sfi, "pr"))) {
return result;
}
if (pr->relevance == ECM_CLASSIFIER_RELEVANCE_NO) {
return ecm_state_write(sfi, "relevant", "%s", "no");
}
if (pr->process_actions & ECM_CLASSIFIER_PROCESS_ACTION_DROP) {
if (pr->drop) {
if ((result = ecm_state_write(sfi, "drop", "yes"))) {
return result;
}
} else {
if ((result = ecm_state_write(sfi, "drop", "no"))) {
return result;
}
}
}
if (pr->relevance == ECM_CLASSIFIER_RELEVANCE_MAYBE) {
if ((result = ecm_state_write(sfi, "accel", "denied"))) {
return result;
}
if ((result = ecm_state_write(sfi, "relevant", "maybe"))) {
return result;
}
} else {
if ((result = ecm_state_write(sfi, "relevant", "yes"))) {
return result;
}
if (pr->process_actions & ECM_CLASSIFIER_PROCESS_ACTION_ACCEL_MODE) {
if (pr->accel_mode == ECM_CLASSIFIER_ACCELERATION_MODE_ACCEL) {
if ((result = ecm_state_write(sfi, "accel", "wanted"))) {
return result;
}
}
else if (pr->accel_mode == ECM_CLASSIFIER_ACCELERATION_MODE_NO) {
if ((result = ecm_state_write(sfi, "accel", "denied"))) {
return result;
}
}
/* Else don't care */
}
}
#ifdef ECM_CLASSIFIER_OVS_ENABLE
if (pr->process_actions & ECM_CLASSIFIER_PROCESS_ACTION_OVS_VLAN_TAG) {
#ifdef ECM_MULTICAST_ENABLE
int i;
#endif
/*
* TODO: Clean up the function later to print classifier
* specific data in each classifier’s state_get function.
*/
if (pr->ingress_vlan_tag[0] != ECM_FRONT_END_VLAN_ID_NOT_CONFIGURED) {
if ((result = ecm_state_write(sfi, "ingress_vlan_tag[0]", "0x%x", pr->ingress_vlan_tag[0]))) {
return result;
}
}
if (pr->ingress_vlan_tag[1] != ECM_FRONT_END_VLAN_ID_NOT_CONFIGURED) {
if ((result = ecm_state_write(sfi, "ingress_vlan_tag[1]", "0x%x", pr->ingress_vlan_tag[1]))) {
return result;
}
}
if (pr->egress_vlan_tag[0] != ECM_FRONT_END_VLAN_ID_NOT_CONFIGURED) {
if ((result = ecm_state_write(sfi, "egress_vlan_tag[0]", "0x%x", pr->egress_vlan_tag[0]))) {
return result;
}
}
if (pr->egress_vlan_tag[1] != ECM_FRONT_END_VLAN_ID_NOT_CONFIGURED) {
if ((result = ecm_state_write(sfi, "egress_vlan_tag[1]", "0x%x", pr->egress_vlan_tag[1]))) {
return result;
}
}
#ifdef ECM_MULTICAST_ENABLE
for (i = 0; i < ECM_DB_MULTICAST_IF_MAX; i++) {
struct net_device *dev;
if (pr->egress_mc_vlan_tag[i][0] == ECM_FRONT_END_VLAN_ID_NOT_CONFIGURED) {
continue;
}
dev = dev_get_by_index(&init_net, pr->egress_netdev_index[i]);
if (dev) {
if ((result = ecm_state_write(sfi, "port_egress", "%s", dev->name))) {
dev_put(dev);
return result;
}
dev_put(dev);
}
if ((result = ecm_state_write(sfi, "port_egress_vlan_tag[0]", "0x%x", pr->egress_mc_vlan_tag[i][0]))) {
return result;
}
if (pr->egress_mc_vlan_tag[i][1] != ECM_FRONT_END_VLAN_ID_NOT_CONFIGURED) {
if ((result = ecm_state_write(sfi, "port_egress_vlan_tag[1]", "0x%x", pr->egress_mc_vlan_tag[i][1]))) {
return result;
}
}
}
#endif
}
#endif
if (pr->process_actions & ECM_CLASSIFIER_PROCESS_ACTION_QOS_TAG) {
if ((result = ecm_state_write(sfi, "flow_qos_tag", "%u", pr->flow_qos_tag))) {
return result;
}
if ((result = ecm_state_write(sfi, "return_qos_tag", "%u", pr->return_qos_tag))) {
return result;
}
}
#ifdef ECM_CLASSIFIER_DSCP_ENABLE
#ifdef ECM_CLASSIFIER_DSCP_IGS
if (pr->process_actions & ECM_CLASSIFIER_PROCESS_ACTION_IGS_QOS_TAG) {
if ((result = ecm_state_write(sfi, "igs_flow_qos_tag", "%u", pr->igs_flow_qos_tag))) {
return result;
}
if ((result = ecm_state_write(sfi, "igs_return_qos_tag", "%u", pr->igs_return_qos_tag))) {
return result;
}
}
#endif
if (pr->process_actions & ECM_CLASSIFIER_PROCESS_ACTION_DSCP) {
if ((result = ecm_state_write(sfi, "flow_dscp", "%u", pr->flow_dscp))) {
return result;
}
if ((result = ecm_state_write(sfi, "return_dscp", "%u", pr->return_dscp))) {
return result;
}
}
#endif
if (pr->process_actions & ECM_CLASSIFIER_PROCESS_ACTION_TIMER_GROUP) {
if ((result = ecm_state_write(sfi, "timer_group", "%d", pr->timer_group))) {
return result;
}
}
return ecm_state_prefix_remove(sfi);
}
#endif
extern struct ecm_classifier_instance *ecm_classifier_assign_classifier(struct ecm_db_connection_instance *ci, ecm_classifier_type_t type);
extern bool ecm_classifier_reclassify(struct ecm_db_connection_instance *ci, int assignment_count, struct ecm_classifier_instance *assignments[]);