Commit 69674282 authored by Johannes Berg's avatar Johannes Berg
Browse files

wifi: ieee80211: split mesh definitions out 

The ieee80211.h file has gotten very long, start splitting it
by putting mesh definitions into a separate file.

Link: https://patch.msgid.link/20251105153843.489713ca8b34.I3befb4bf6ace0315758a1794224ddd18c4652e32@changeid


Signed-off-by: default avatarJohannes Berg <johannes.berg@intel.com>
parent 1ec9871f

include/linux/ieee80211-mesh.h

0 → 100644
+230 −0
Original line number Diff line number Diff line 
/* SPDX-License-Identifier: GPL-2.0-only */

/*

 * IEEE 802.11 mesh definitions

 *

 * Copyright (c) 2001-2002, SSH Communications Security Corp and Jouni Malinen

 * <jkmaline@cc.hut.fi>

 * Copyright (c) 2002-2003, Jouni Malinen <jkmaline@cc.hut.fi>

 * Copyright (c) 2005, Devicescape Software, Inc.

 * Copyright (c) 2006, Michael Wu <flamingice@sourmilk.net>

 * Copyright (c) 2013 - 2014 Intel Mobile Communications GmbH

 * Copyright (c) 2016 - 2017 Intel Deutschland GmbH

 * Copyright (c) 2018 - 2025 Intel Corporation

 */



#ifndef LINUX_IEEE80211_MESH_H

#define LINUX_IEEE80211_MESH_H



#include <linux/types.h>

#include <linux/if_ether.h>



#define IEEE80211_MAX_MESH_ID_LEN	32



struct ieee80211s_hdr {

	u8 flags;

	u8 ttl;

	__le32 seqnum;

	u8 eaddr1[ETH_ALEN];

	u8 eaddr2[ETH_ALEN];

} __packed __aligned(2);



/* Mesh flags */

#define MESH_FLAGS_AE_A4 	0x1

#define MESH_FLAGS_AE_A5_A6	0x2

#define MESH_FLAGS_AE		0x3

#define MESH_FLAGS_PS_DEEP	0x4



/**

 * enum ieee80211_preq_flags - mesh PREQ element flags

 *

 * @IEEE80211_PREQ_PROACTIVE_PREP_FLAG: proactive PREP subfield

 */

enum ieee80211_preq_flags {

	IEEE80211_PREQ_PROACTIVE_PREP_FLAG	= 1<<2,

};



/**

 * enum ieee80211_preq_target_flags - mesh PREQ element per target flags

 *

 * @IEEE80211_PREQ_TO_FLAG: target only subfield

 * @IEEE80211_PREQ_USN_FLAG: unknown target HWMP sequence number subfield

 */

enum ieee80211_preq_target_flags {

	IEEE80211_PREQ_TO_FLAG	= 1<<0,

	IEEE80211_PREQ_USN_FLAG	= 1<<2,

};



/**

 * struct ieee80211_mesh_chansw_params_ie - mesh channel switch parameters IE

 * @mesh_ttl: Time To Live

 * @mesh_flags: Flags

 * @mesh_reason: Reason Code

 * @mesh_pre_value: Precedence Value

 *

 * This structure represents the payload of the "Mesh Channel Switch

 * Parameters element" as described in IEEE Std 802.11-2020 section

 * 9.4.2.102.

 */

struct ieee80211_mesh_chansw_params_ie {

	u8 mesh_ttl;

	u8 mesh_flags;

	__le16 mesh_reason;

	__le16 mesh_pre_value;

} __packed;



/**

 * struct ieee80211_meshconf_ie - Mesh Configuration element

 * @meshconf_psel: Active Path Selection Protocol Identifier

 * @meshconf_pmetric: Active Path Selection Metric Identifier

 * @meshconf_congest: Congestion Control Mode Identifier

 * @meshconf_synch: Synchronization Method Identifier

 * @meshconf_auth: Authentication Protocol Identifier

 * @meshconf_form: Mesh Formation Info

 * @meshconf_cap: Mesh Capability (see &enum mesh_config_capab_flags)

 *

 * This structure represents the payload of the "Mesh Configuration

 * element" as described in IEEE Std 802.11-2020 section 9.4.2.97.

 */

struct ieee80211_meshconf_ie {

	u8 meshconf_psel;

	u8 meshconf_pmetric;

	u8 meshconf_congest;

	u8 meshconf_synch;

	u8 meshconf_auth;

	u8 meshconf_form;

	u8 meshconf_cap;

} __packed;



/**

 * enum mesh_config_capab_flags - Mesh Configuration IE capability field flags

 *

 * @IEEE80211_MESHCONF_CAPAB_ACCEPT_PLINKS: STA is willing to establish

 *	additional mesh peerings with other mesh STAs

 * @IEEE80211_MESHCONF_CAPAB_FORWARDING: the STA forwards MSDUs

 * @IEEE80211_MESHCONF_CAPAB_TBTT_ADJUSTING: TBTT adjustment procedure

 *	is ongoing

 * @IEEE80211_MESHCONF_CAPAB_POWER_SAVE_LEVEL: STA is in deep sleep mode or has

 *	neighbors in deep sleep mode

 *

 * Enumerates the "Mesh Capability" as described in IEEE Std

 * 802.11-2020 section 9.4.2.97.7.

 */

enum mesh_config_capab_flags {

	IEEE80211_MESHCONF_CAPAB_ACCEPT_PLINKS		= 0x01,

	IEEE80211_MESHCONF_CAPAB_FORWARDING		= 0x08,

	IEEE80211_MESHCONF_CAPAB_TBTT_ADJUSTING		= 0x20,

	IEEE80211_MESHCONF_CAPAB_POWER_SAVE_LEVEL	= 0x40,

};



#define IEEE80211_MESHCONF_FORM_CONNECTED_TO_GATE 0x1



/*

 * mesh channel switch parameters element's flag indicator

 *

 */

#define WLAN_EID_CHAN_SWITCH_PARAM_TX_RESTRICT BIT(0)

#define WLAN_EID_CHAN_SWITCH_PARAM_INITIATOR BIT(1)

#define WLAN_EID_CHAN_SWITCH_PARAM_REASON BIT(2)



/**

 * struct ieee80211_rann_ie - RANN (root announcement) element

 * @rann_flags: Flags

 * @rann_hopcount: Hop Count

 * @rann_ttl: Element TTL

 * @rann_addr: Root Mesh STA Address

 * @rann_seq: HWMP Sequence Number

 * @rann_interval: Interval

 * @rann_metric: Metric

 *

 * This structure represents the payload of the "RANN element" as

 * described in IEEE Std 802.11-2020 section 9.4.2.111.

 */

struct ieee80211_rann_ie {

	u8 rann_flags;

	u8 rann_hopcount;

	u8 rann_ttl;

	u8 rann_addr[ETH_ALEN];

	__le32 rann_seq;

	__le32 rann_interval;

	__le32 rann_metric;

} __packed;



enum ieee80211_rann_flags {

	RANN_FLAG_IS_GATE = 1 << 0,

};



/* Mesh action codes */

enum ieee80211_mesh_actioncode {

	WLAN_MESH_ACTION_LINK_METRIC_REPORT,

	WLAN_MESH_ACTION_HWMP_PATH_SELECTION,

	WLAN_MESH_ACTION_GATE_ANNOUNCEMENT,

	WLAN_MESH_ACTION_CONGESTION_CONTROL_NOTIFICATION,

	WLAN_MESH_ACTION_MCCA_SETUP_REQUEST,

	WLAN_MESH_ACTION_MCCA_SETUP_REPLY,

	WLAN_MESH_ACTION_MCCA_ADVERTISEMENT_REQUEST,

	WLAN_MESH_ACTION_MCCA_ADVERTISEMENT,

	WLAN_MESH_ACTION_MCCA_TEARDOWN,

	WLAN_MESH_ACTION_TBTT_ADJUSTMENT_REQUEST,

	WLAN_MESH_ACTION_TBTT_ADJUSTMENT_RESPONSE,

};



/**

 * enum ieee80211_mesh_sync_method - mesh synchronization method identifier

 *

 * @IEEE80211_SYNC_METHOD_NEIGHBOR_OFFSET: the default synchronization method

 * @IEEE80211_SYNC_METHOD_VENDOR: a vendor specific synchronization method

 *	that will be specified in a vendor specific information element

 */

enum ieee80211_mesh_sync_method {

	IEEE80211_SYNC_METHOD_NEIGHBOR_OFFSET = 1,

	IEEE80211_SYNC_METHOD_VENDOR = 255,

};



/**

 * enum ieee80211_mesh_path_protocol - mesh path selection protocol identifier

 *

 * @IEEE80211_PATH_PROTOCOL_HWMP: the default path selection protocol

 * @IEEE80211_PATH_PROTOCOL_VENDOR: a vendor specific protocol that will

 *	be specified in a vendor specific information element

 */

enum ieee80211_mesh_path_protocol {

	IEEE80211_PATH_PROTOCOL_HWMP = 1,

	IEEE80211_PATH_PROTOCOL_VENDOR = 255,

};



/**

 * enum ieee80211_mesh_path_metric - mesh path selection metric identifier

 *

 * @IEEE80211_PATH_METRIC_AIRTIME: the default path selection metric

 * @IEEE80211_PATH_METRIC_VENDOR: a vendor specific metric that will be

 *	specified in a vendor specific information element

 */

enum ieee80211_mesh_path_metric {

	IEEE80211_PATH_METRIC_AIRTIME = 1,

	IEEE80211_PATH_METRIC_VENDOR = 255,

};



/**

 * enum ieee80211_root_mode_identifier - root mesh STA mode identifier

 *

 * These attribute are used by dot11MeshHWMPRootMode to set root mesh STA mode

 *

 * @IEEE80211_ROOTMODE_NO_ROOT: the mesh STA is not a root mesh STA (default)

 * @IEEE80211_ROOTMODE_ROOT: the mesh STA is a root mesh STA if greater than

 *	this value

 * @IEEE80211_PROACTIVE_PREQ_NO_PREP: the mesh STA is a root mesh STA supports

 *	the proactive PREQ with proactive PREP subfield set to 0

 * @IEEE80211_PROACTIVE_PREQ_WITH_PREP: the mesh STA is a root mesh STA

 *	supports the proactive PREQ with proactive PREP subfield set to 1

 * @IEEE80211_PROACTIVE_RANN: the mesh STA is a root mesh STA supports

 *	the proactive RANN

 */

enum ieee80211_root_mode_identifier {

	IEEE80211_ROOTMODE_NO_ROOT = 0,

	IEEE80211_ROOTMODE_ROOT = 1,

	IEEE80211_PROACTIVE_PREQ_NO_PREP = 2,

	IEEE80211_PROACTIVE_PREQ_WITH_PREP = 3,

	IEEE80211_PROACTIVE_RANN = 4,

};



#endif /* LINUX_IEEE80211_MESH_H */

include/linux/ieee80211.h

+2 −209
Original line number Diff line number Diff line
@@ -252,8 +252,6 @@ static inline u16 ieee80211_sn_sub(u16 sn1, u16 sn2) 


#define IEEE80211_MAX_SSID_LEN		32



#define IEEE80211_MAX_MESH_ID_LEN	32



#define IEEE80211_FIRST_TSPEC_TSID	8

#define IEEE80211_NUM_TIDS		16
@@ -881,40 +879,6 @@ static inline u16 ieee80211_get_sn(struct ieee80211_hdr *hdr) 
	return le16_get_bits(hdr->seq_ctrl, IEEE80211_SCTL_SEQ);

}



struct ieee80211s_hdr {

	u8 flags;

	u8 ttl;

	__le32 seqnum;

	u8 eaddr1[ETH_ALEN];

	u8 eaddr2[ETH_ALEN];

} __packed __aligned(2);



/* Mesh flags */

#define MESH_FLAGS_AE_A4 	0x1

#define MESH_FLAGS_AE_A5_A6	0x2

#define MESH_FLAGS_AE		0x3

#define MESH_FLAGS_PS_DEEP	0x4



/**

 * enum ieee80211_preq_flags - mesh PREQ element flags

 *

 * @IEEE80211_PREQ_PROACTIVE_PREP_FLAG: proactive PREP subfield

 */

enum ieee80211_preq_flags {

	IEEE80211_PREQ_PROACTIVE_PREP_FLAG	= 1<<2,

};



/**

 * enum ieee80211_preq_target_flags - mesh PREQ element per target flags

 *

 * @IEEE80211_PREQ_TO_FLAG: target only subfield

 * @IEEE80211_PREQ_USN_FLAG: unknown target HWMP sequence number subfield

 */

enum ieee80211_preq_target_flags {

	IEEE80211_PREQ_TO_FLAG	= 1<<0,

	IEEE80211_PREQ_USN_FLAG	= 1<<2,

};



/**

 * struct ieee80211_quiet_ie - Quiet element

 * @count: Quiet Count
@@ -993,24 +957,6 @@ struct ieee80211_sec_chan_offs_ie { 
	u8 sec_chan_offs;

} __packed;



/**

 * struct ieee80211_mesh_chansw_params_ie - mesh channel switch parameters IE

 * @mesh_ttl: Time To Live

 * @mesh_flags: Flags

 * @mesh_reason: Reason Code

 * @mesh_pre_value: Precedence Value

 *

 * This structure represents the payload of the "Mesh Channel Switch

 * Parameters element" as described in IEEE Std 802.11-2020 section

 * 9.4.2.102.

 */

struct ieee80211_mesh_chansw_params_ie {

	u8 mesh_ttl;

	u8 mesh_flags;

	__le16 mesh_reason;

	__le16 mesh_pre_value;

} __packed;



/**

 * struct ieee80211_wide_bw_chansw_ie - wide bandwidth channel switch IE

 * @new_channel_width: New Channel Width
@@ -1051,87 +997,6 @@ struct ieee80211_tim_ie { 
	};

} __packed;



/**

 * struct ieee80211_meshconf_ie - Mesh Configuration element

 * @meshconf_psel: Active Path Selection Protocol Identifier

 * @meshconf_pmetric: Active Path Selection Metric Identifier

 * @meshconf_congest: Congestion Control Mode Identifier

 * @meshconf_synch: Synchronization Method Identifier

 * @meshconf_auth: Authentication Protocol Identifier

 * @meshconf_form: Mesh Formation Info

 * @meshconf_cap: Mesh Capability (see &enum mesh_config_capab_flags)

 *

 * This structure represents the payload of the "Mesh Configuration

 * element" as described in IEEE Std 802.11-2020 section 9.4.2.97.

 */

struct ieee80211_meshconf_ie {

	u8 meshconf_psel;

	u8 meshconf_pmetric;

	u8 meshconf_congest;

	u8 meshconf_synch;

	u8 meshconf_auth;

	u8 meshconf_form;

	u8 meshconf_cap;

} __packed;



/**

 * enum mesh_config_capab_flags - Mesh Configuration IE capability field flags

 *

 * @IEEE80211_MESHCONF_CAPAB_ACCEPT_PLINKS: STA is willing to establish

 *	additional mesh peerings with other mesh STAs

 * @IEEE80211_MESHCONF_CAPAB_FORWARDING: the STA forwards MSDUs

 * @IEEE80211_MESHCONF_CAPAB_TBTT_ADJUSTING: TBTT adjustment procedure

 *	is ongoing

 * @IEEE80211_MESHCONF_CAPAB_POWER_SAVE_LEVEL: STA is in deep sleep mode or has

 *	neighbors in deep sleep mode

 *

 * Enumerates the "Mesh Capability" as described in IEEE Std

 * 802.11-2020 section 9.4.2.97.7.

 */

enum mesh_config_capab_flags {

	IEEE80211_MESHCONF_CAPAB_ACCEPT_PLINKS		= 0x01,

	IEEE80211_MESHCONF_CAPAB_FORWARDING		= 0x08,

	IEEE80211_MESHCONF_CAPAB_TBTT_ADJUSTING		= 0x20,

	IEEE80211_MESHCONF_CAPAB_POWER_SAVE_LEVEL	= 0x40,

};



#define IEEE80211_MESHCONF_FORM_CONNECTED_TO_GATE 0x1



/*

 * mesh channel switch parameters element's flag indicator

 *

 */

#define WLAN_EID_CHAN_SWITCH_PARAM_TX_RESTRICT BIT(0)

#define WLAN_EID_CHAN_SWITCH_PARAM_INITIATOR BIT(1)

#define WLAN_EID_CHAN_SWITCH_PARAM_REASON BIT(2)



/**

 * struct ieee80211_rann_ie - RANN (root announcement) element

 * @rann_flags: Flags

 * @rann_hopcount: Hop Count

 * @rann_ttl: Element TTL

 * @rann_addr: Root Mesh STA Address

 * @rann_seq: HWMP Sequence Number

 * @rann_interval: Interval

 * @rann_metric: Metric

 *

 * This structure represents the payload of the "RANN element" as

 * described in IEEE Std 802.11-2020 section 9.4.2.111.

 */

struct ieee80211_rann_ie {

	u8 rann_flags;

	u8 rann_hopcount;

	u8 rann_ttl;

	u8 rann_addr[ETH_ALEN];

	__le32 rann_seq;

	__le32 rann_interval;

	__le32 rann_metric;

} __packed;



enum ieee80211_rann_flags {

	RANN_FLAG_IS_GATE = 1 << 0,

};



enum ieee80211_ht_chanwidth_values {

	IEEE80211_HT_CHANWIDTH_20MHZ = 0,

	IEEE80211_HT_CHANWIDTH_ANY = 1,
@@ -3971,21 +3836,6 @@ enum ieee80211_self_protected_actioncode { 
	WLAN_SP_MGK_ACK = 5,

};



/* Mesh action codes */

enum ieee80211_mesh_actioncode {

	WLAN_MESH_ACTION_LINK_METRIC_REPORT,

	WLAN_MESH_ACTION_HWMP_PATH_SELECTION,

	WLAN_MESH_ACTION_GATE_ANNOUNCEMENT,

	WLAN_MESH_ACTION_CONGESTION_CONTROL_NOTIFICATION,

	WLAN_MESH_ACTION_MCCA_SETUP_REQUEST,

	WLAN_MESH_ACTION_MCCA_SETUP_REPLY,

	WLAN_MESH_ACTION_MCCA_ADVERTISEMENT_REQUEST,

	WLAN_MESH_ACTION_MCCA_ADVERTISEMENT,

	WLAN_MESH_ACTION_MCCA_TEARDOWN,

	WLAN_MESH_ACTION_TBTT_ADJUSTMENT_REQUEST,

	WLAN_MESH_ACTION_TBTT_ADJUSTMENT_RESPONSE,

};



/* Unprotected WNM action codes */

enum ieee80211_unprotected_wnm_actioncode {

	WLAN_UNPROTECTED_WNM_ACTION_TIM = 0,
@@ -4198,65 +4048,6 @@ enum ieee80211_tdls_actioncode { 
/* BSS Coex IE information field bits */

#define WLAN_BSS_COEX_INFORMATION_REQUEST	BIT(0)



/**

 * enum ieee80211_mesh_sync_method - mesh synchronization method identifier

 *

 * @IEEE80211_SYNC_METHOD_NEIGHBOR_OFFSET: the default synchronization method

 * @IEEE80211_SYNC_METHOD_VENDOR: a vendor specific synchronization method

 *	that will be specified in a vendor specific information element

 */

enum ieee80211_mesh_sync_method {

	IEEE80211_SYNC_METHOD_NEIGHBOR_OFFSET = 1,

	IEEE80211_SYNC_METHOD_VENDOR = 255,

};



/**

 * enum ieee80211_mesh_path_protocol - mesh path selection protocol identifier

 *

 * @IEEE80211_PATH_PROTOCOL_HWMP: the default path selection protocol

 * @IEEE80211_PATH_PROTOCOL_VENDOR: a vendor specific protocol that will

 *	be specified in a vendor specific information element

 */

enum ieee80211_mesh_path_protocol {

	IEEE80211_PATH_PROTOCOL_HWMP = 1,

	IEEE80211_PATH_PROTOCOL_VENDOR = 255,

};



/**

 * enum ieee80211_mesh_path_metric - mesh path selection metric identifier

 *

 * @IEEE80211_PATH_METRIC_AIRTIME: the default path selection metric

 * @IEEE80211_PATH_METRIC_VENDOR: a vendor specific metric that will be

 *	specified in a vendor specific information element

 */

enum ieee80211_mesh_path_metric {

	IEEE80211_PATH_METRIC_AIRTIME = 1,

	IEEE80211_PATH_METRIC_VENDOR = 255,

};



/**

 * enum ieee80211_root_mode_identifier - root mesh STA mode identifier

 *

 * These attribute are used by dot11MeshHWMPRootMode to set root mesh STA mode

 *

 * @IEEE80211_ROOTMODE_NO_ROOT: the mesh STA is not a root mesh STA (default)

 * @IEEE80211_ROOTMODE_ROOT: the mesh STA is a root mesh STA if greater than

 *	this value

 * @IEEE80211_PROACTIVE_PREQ_NO_PREP: the mesh STA is a root mesh STA supports

 *	the proactive PREQ with proactive PREP subfield set to 0

 * @IEEE80211_PROACTIVE_PREQ_WITH_PREP: the mesh STA is a root mesh STA

 *	supports the proactive PREQ with proactive PREP subfield set to 1

 * @IEEE80211_PROACTIVE_RANN: the mesh STA is a root mesh STA supports

 *	the proactive RANN

 */

enum ieee80211_root_mode_identifier {

	IEEE80211_ROOTMODE_NO_ROOT = 0,

	IEEE80211_ROOTMODE_ROOT = 1,

	IEEE80211_PROACTIVE_PREQ_NO_PREP = 2,

	IEEE80211_PROACTIVE_PREQ_WITH_PREP = 3,

	IEEE80211_PROACTIVE_RANN = 4,

};



/*

 * IEEE 802.11-2007 7.3.2.9 Country information element

 *
@@ -6098,4 +5889,6 @@ static inline u32 ieee80211_eml_trans_timeout_in_us(u16 eml_cap) 
#define NAN_DEV_CAPA_NDPE_SUPPORTED		0x08

#define NAN_DEV_CAPA_S3_SUPPORTED		0x10



#include "ieee80211-mesh.h"



#endif /* LINUX_IEEE80211_H */