[thirdparty/iw.git] / iw.h

#ifndef __IW_H
#define __IW_H

#include <stdbool.h>
#include <netlink/netlink.h>
#include <netlink/genl/genl.h>
#include <netlink/genl/family.h>
#include <netlink/genl/ctrl.h>
#include <endian.h>

#include "nl80211.h"
#include "ieee80211.h"

/* support for extack if compilation headers are too old */
#ifndef NETLINK_EXT_ACK
#define NETLINK_EXT_ACK 11
enum nlmsgerr_attrs {
	NLMSGERR_ATTR_UNUSED,
	NLMSGERR_ATTR_MSG,
	NLMSGERR_ATTR_OFFS,
	NLMSGERR_ATTR_COOKIE,

	__NLMSGERR_ATTR_MAX,
	NLMSGERR_ATTR_MAX = __NLMSGERR_ATTR_MAX - 1
};
#endif
#ifndef NLM_F_CAPPED
#define NLM_F_CAPPED 0x100
#endif
#ifndef NLM_F_ACK_TLVS
#define NLM_F_ACK_TLVS 0x200
#endif
#ifndef SOL_NETLINK
#define SOL_NETLINK 270
#endif

#define ETH_ALEN 6
#define VHT_MUMIMO_GROUP_LEN 24

/* libnl 1.x compatibility code */
#if !defined(CONFIG_LIBNL20) && !defined(CONFIG_LIBNL30)
#  define nl_sock nl_handle
#endif

struct nl80211_state {
	struct nl_sock *nl_sock;
	int nl80211_id;
};

enum command_identify_by {
	CIB_NONE,
	CIB_PHY,
	CIB_NETDEV,
	CIB_WDEV,
};

enum id_input {
	II_NONE,
	II_NETDEV,
	II_PHY_NAME,
	II_PHY_IDX,
	II_WDEV,
};

#define HANDLER_RET_USAGE 1
#define HANDLER_RET_DONE 3

struct cmd {
	const char *name;
	const char *args;
	const char *help;
	const enum nl80211_commands cmd;
	int nl_msg_flags;
	int hidden;
	const enum command_identify_by idby;
	/*
	 * The handler should return a negative error code,
	 * zero on success, 1 if the arguments were wrong.
	 * Return 2 iff you provide the error message yourself.
	 */
	int (*handler)(struct nl80211_state *state,
		       struct nl_msg *msg,
		       int argc, char **argv,
		       enum id_input id);
	const struct cmd *(*selector)(int argc, char **argv);
	const struct cmd *parent;
};

struct chanmode {
	const char *name;
	unsigned int width;
	int freq1_diff;
	int chantype; /* for older kernel */
};

struct chandef {
	enum nl80211_chan_width width;

	unsigned int control_freq;
	unsigned int center_freq1;
	unsigned int center_freq2;
};

#define ARRAY_SIZE(ar) (sizeof(ar)/sizeof(ar[0]))
#define DIV_ROUND_UP(x, y) (((x) + (y - 1)) / (y))

#define __COMMAND(_section, _symname, _name, _args, _nlcmd, _flags, _hidden, _idby, _handler, _help, _sel)\
	static struct cmd						\
	__cmd ## _ ## _symname ## _ ## _handler ## _ ## _nlcmd ## _ ## _idby ## _ ## _hidden = {\
		.name = (_name),					\
		.args = (_args),					\
		.cmd = (_nlcmd),					\
		.nl_msg_flags = (_flags),				\
		.hidden = (_hidden),					\
		.idby = (_idby),					\
		.handler = (_handler),					\
		.help = (_help),					\
		.parent = _section,					\
		.selector = (_sel),					\
	};								\
	static struct cmd *__cmd ## _ ## _symname ## _ ## _handler ## _ ## _nlcmd ## _ ## _idby ## _ ## _hidden ## _p \
	__attribute__((used,section("__cmd"))) =			\
	&__cmd ## _ ## _symname ## _ ## _handler ## _ ## _nlcmd ## _ ## _idby ## _ ## _hidden
#define __ACMD(_section, _symname, _name, _args, _nlcmd, _flags, _hidden, _idby, _handler, _help, _sel, _alias)\
	__COMMAND(_section, _symname, _name, _args, _nlcmd, _flags, _hidden, _idby, _handler, _help, _sel);\
	static const struct cmd *_alias = &__cmd ## _ ## _symname ## _ ## _handler ## _ ## _nlcmd ## _ ## _idby ## _ ## _hidden
#define COMMAND(section, name, args, cmd, flags, idby, handler, help)	\
	__COMMAND(&(__section ## _ ## section), name, #name, args, cmd, flags, 0, idby, handler, help, NULL)
#define COMMAND_ALIAS(section, name, args, cmd, flags, idby, handler, help, selector, alias)\
	__ACMD(&(__section ## _ ## section), name, #name, args, cmd, flags, 0, idby, handler, help, selector, alias)
#define HIDDEN(section, name, args, cmd, flags, idby, handler)		\
	__COMMAND(&(__section ## _ ## section), name, #name, args, cmd, flags, 1, idby, handler, NULL, NULL)

#define TOPLEVEL(_name, _args, _nlcmd, _flags, _idby, _handler, _help)	\
	struct cmd __section ## _ ## _name = {				\
		.name = (#_name),					\
		.args = (_args),					\
		.cmd = (_nlcmd),					\
		.nl_msg_flags = (_flags),				\
		.idby = (_idby),					\
		.handler = (_handler),					\
		.help = (_help),					\
	 };								\
	static struct cmd *__section ## _ ## _name ## _p		\
	__attribute__((used,section("__cmd"))) = &__section ## _ ## _name

#define SECTION(_name)							\
	struct cmd __section ## _ ## _name = {				\
		.name = (#_name),					\
		.hidden = 1,						\
	};								\
	static struct cmd *__section ## _ ## _name ## _p		\
	__attribute__((used,section("__cmd"))) = &__section ## _ ## _name

#define DECLARE_SECTION(_name)						\
	extern struct cmd __section ## _ ## _name;

struct vendor_event {
	unsigned int vendor_id, subcmd;
	void (*callback)(unsigned int vendor_id, unsigned int subcmd,
			 struct nlattr *data);
};

#define VENDOR_EVENT(_id, _subcmd, _callback)				\
	const struct vendor_event 					\
	vendor_event_ ## _id ## _ ## _subcmd = {			\
		.vendor_id = _id,					\
		.subcmd = _subcmd,					\
		.callback = _callback,					\
	}, * const vendor_event_ ## _id ## _ ## _subcmd ## _p		\
	__attribute__((used,section("vendor_event"))) =			\
		&vendor_event_ ## _id ## _ ## _subcmd

extern const char iw_version[];

extern int iw_debug;

int handle_cmd(struct nl80211_state *state, enum id_input idby,
	       int argc, char **argv);

struct print_event_args {
	struct timeval ts; /* internal */
	bool have_ts; /* must be set false */
	bool frame, time, reltime;
};

__u32 listen_events(struct nl80211_state *state,
		    const int n_waits, const __u32 *waits);
int __prepare_listen_events(struct nl80211_state *state);
__u32 __do_listen_events(struct nl80211_state *state,
			 const int n_waits, const __u32 *waits,
			 const int n_prints, const __u32 *prints,
			 struct print_event_args *args);

int valid_handler(struct nl_msg *msg, void *arg);
void register_handler(int (*handler)(struct nl_msg *, void *), void *data);

int mac_addr_a2n(unsigned char *mac_addr, char *arg);
void mac_addr_n2a(char *mac_addr, const unsigned char *arg);
int parse_hex_mask(char *hexmask, unsigned char **result, size_t *result_len,
		   unsigned char **mask);
unsigned char *parse_hex(char *hex, size_t *outlen);

int parse_keys(struct nl_msg *msg, char **argv[], int *argc);
int parse_freqchan(struct chandef *chandef, bool chan, int argc, char **argv, int *parsed);
enum nl80211_chan_width str_to_bw(const char *str);
int parse_txq_stats(char *buf, int buflen, struct nlattr *tid_stats_attr, int header,
		    int tid, const char *indent);
int put_chandef(struct nl_msg *msg, struct chandef *chandef);

void print_ht_mcs(const __u8 *mcs);
void print_ampdu_length(__u8 exponent);
void print_ampdu_spacing(__u8 spacing);
void print_ht_capability(__u16 cap);
void print_vht_info(__u32 capa, const __u8 *mcs);
void print_he_capability(const uint8_t *ie, int len);
void print_he_info(struct nlattr *nl_iftype);

char *channel_width_name(enum nl80211_chan_width width);
const char *iftype_name(enum nl80211_iftype iftype);
const char *command_name(enum nl80211_commands cmd);
int ieee80211_channel_to_frequency(int chan, enum nl80211_band band);
int ieee80211_frequency_to_channel(int freq);

void print_ssid_escaped(const uint8_t len, const uint8_t *data);

int nl_get_multicast_id(struct nl_sock *sock, const char *family, const char *group);

char *reg_initiator_to_string(__u8 initiator);

const char *get_reason_str(uint16_t reason);
const char *get_status_str(uint16_t status);

enum print_ie_type {
	PRINT_SCAN,
	PRINT_LINK,
};

#define BIT(x) (1ULL<<(x))

void print_ies(unsigned char *ie, int ielen, bool unknown,
	       enum print_ie_type ptype);

void parse_bitrate(struct nlattr *bitrate_attr, char *buf, int buflen);
void iw_hexdump(const char *prefix, const __u8 *data, size_t len);

int get_cf1(const struct chanmode *chanmode, unsigned long freq);

int parse_random_mac_addr(struct nl_msg *msg, char *addrs);

#define SCHED_SCAN_OPTIONS "[interval <in_msecs> | scan_plans [<interval_secs:iterations>*] <interval_secs>] "	\
	"[delay <in_secs>] [freqs <freq>+] [matches [ssid <ssid>]+]] [active [ssid <ssid>]+|passive] "	\
	"[randomise[=<addr>/<mask>]] [coloc] [flush]"
int parse_sched_scan(struct nl_msg *msg, int *argc, char ***argv);

DECLARE_SECTION(switch);
DECLARE_SECTION(set);
DECLARE_SECTION(get);

void nan_bf(uint8_t idx, uint8_t *bf, uint16_t bf_len, const uint8_t *buf,
	    size_t len);

char *hex2bin(const char *hex, char *buf);

int set_bitrates(struct nl_msg *msg, int argc, char **argv,
		 enum nl80211_attrs attr);

#endif /* __IW_H */
Commit	Line	Data
	1	#ifndef __IW_H
	2	#define __IW_H
	3
	4	#include <stdbool.h>
	5	#include <netlink/netlink.h>
	6	#include <netlink/genl/genl.h>
	7	#include <netlink/genl/family.h>
	8	#include <netlink/genl/ctrl.h>
	9	#include <endian.h>
	10
	11	#include "nl80211.h"
	12	#include "ieee80211.h"
	13
	14	/* support for extack if compilation headers are too old */
	15	#ifndef NETLINK_EXT_ACK
	16	#define NETLINK_EXT_ACK 11
	17	enum nlmsgerr_attrs {
	18	NLMSGERR_ATTR_UNUSED,
	19	NLMSGERR_ATTR_MSG,
	20	NLMSGERR_ATTR_OFFS,
	21	NLMSGERR_ATTR_COOKIE,
	22
	23	__NLMSGERR_ATTR_MAX,
	24	NLMSGERR_ATTR_MAX = __NLMSGERR_ATTR_MAX - 1
	25	};
	26	#endif
	27	#ifndef NLM_F_CAPPED
	28	#define NLM_F_CAPPED 0x100
	29	#endif
	30	#ifndef NLM_F_ACK_TLVS
	31	#define NLM_F_ACK_TLVS 0x200
	32	#endif
	33	#ifndef SOL_NETLINK
	34	#define SOL_NETLINK 270
	35	#endif
	36
	37	#define ETH_ALEN 6
	38	#define VHT_MUMIMO_GROUP_LEN 24
	39
	40	/* libnl 1.x compatibility code */
	41	#if !defined(CONFIG_LIBNL20) && !defined(CONFIG_LIBNL30)
	42	# define nl_sock nl_handle
	43	#endif
	44
	45	struct nl80211_state {
	46	struct nl_sock *nl_sock;
	47	int nl80211_id;
	48	};
	49
	50	enum command_identify_by {
	51	CIB_NONE,
	52	CIB_PHY,
	53	CIB_NETDEV,
	54	CIB_WDEV,
	55	};
	56
	57	enum id_input {
	58	II_NONE,
	59	II_NETDEV,
	60	II_PHY_NAME,
	61	II_PHY_IDX,
	62	II_WDEV,
	63	};
	64
	65	#define HANDLER_RET_USAGE 1
	66	#define HANDLER_RET_DONE 3
	67
	68	struct cmd {
	69	const char *name;
	70	const char *args;
	71	const char *help;
	72	const enum nl80211_commands cmd;
	73	int nl_msg_flags;
	74	int hidden;
	75	const enum command_identify_by idby;
	76	/*
	77	* The handler should return a negative error code,
	78	* zero on success, 1 if the arguments were wrong.
	79	* Return 2 iff you provide the error message yourself.
	80	*/
	81	int (handler)(struct nl80211_state state,
	82	struct nl_msg *msg,
	83	int argc, char **argv,
	84	enum id_input id);
	85	const struct cmd (selector)(int argc, char **argv);
	86	const struct cmd *parent;
	87	};
	88
	89	struct chanmode {
	90	const char *name;
	91	unsigned int width;
	92	int freq1_diff;
	93	int chantype; /* for older kernel */
	94	};
	95
	96	struct chandef {
	97	enum nl80211_chan_width width;
	98
	99	unsigned int control_freq;
	100	unsigned int center_freq1;
	101	unsigned int center_freq2;
	102	};
	103
	104	#define ARRAY_SIZE(ar) (sizeof(ar)/sizeof(ar[0]))
	105	#define DIV_ROUND_UP(x, y) (((x) + (y - 1)) / (y))
	106
	107	#define __COMMAND(_section, _symname, _name, _args, _nlcmd, _flags, _hidden, _idby, _handler, _help, _sel)\
	108	static struct cmd \
	109	__cmd ## _ ## _symname ## _ ## _handler ## _ ## _nlcmd ## _ ## _idby ## _ ## _hidden = {\
	110	.name = (_name), \
	111	.args = (_args), \
	112	.cmd = (_nlcmd), \
	113	.nl_msg_flags = (_flags), \
	114	.hidden = (_hidden), \
	115	.idby = (_idby), \
	116	.handler = (_handler), \
	117	.help = (_help), \
	118	.parent = _section, \
	119	.selector = (_sel), \
	120	}; \
	121	static struct cmd *__cmd ## _ ## _symname ## _ ## _handler ## _ ## _nlcmd ## _ ## _idby ## _ ## _hidden ## _p \
	122	__attribute__((used,section("__cmd"))) = \
	123	&__cmd ## _ ## _symname ## _ ## _handler ## _ ## _nlcmd ## _ ## _idby ## _ ## _hidden
	124	#define __ACMD(_section, _symname, _name, _args, _nlcmd, _flags, _hidden, _idby, _handler, _help, _sel, _alias)\
	125	__COMMAND(_section, _symname, _name, _args, _nlcmd, _flags, _hidden, _idby, _handler, _help, _sel);\
	126	static const struct cmd *_alias = &__cmd ## _ ## _symname ## _ ## _handler ## _ ## _nlcmd ## _ ## _idby ## _ ## _hidden
	127	#define COMMAND(section, name, args, cmd, flags, idby, handler, help) \
	128	__COMMAND(&(__section ## _ ## section), name, #name, args, cmd, flags, 0, idby, handler, help, NULL)
	129	#define COMMAND_ALIAS(section, name, args, cmd, flags, idby, handler, help, selector, alias)\
	130	__ACMD(&(__section ## _ ## section), name, #name, args, cmd, flags, 0, idby, handler, help, selector, alias)
	131	#define HIDDEN(section, name, args, cmd, flags, idby, handler) \
	132	__COMMAND(&(__section ## _ ## section), name, #name, args, cmd, flags, 1, idby, handler, NULL, NULL)
	133
	134	#define TOPLEVEL(_name, _args, _nlcmd, _flags, _idby, _handler, _help) \
	135	struct cmd __section ## _ ## _name = { \
	136	.name = (#_name), \
	137	.args = (_args), \
	138	.cmd = (_nlcmd), \
	139	.nl_msg_flags = (_flags), \
	140	.idby = (_idby), \
	141	.handler = (_handler), \
	142	.help = (_help), \
	143	}; \
	144	static struct cmd *__section ## _ ## _name ## _p \
	145	__attribute__((used,section("__cmd"))) = &__section ## _ ## _name
	146
	147	#define SECTION(_name) \
	148	struct cmd __section ## _ ## _name = { \
	149	.name = (#_name), \
	150	.hidden = 1, \
	151	}; \
	152	static struct cmd *__section ## _ ## _name ## _p \
	153	__attribute__((used,section("__cmd"))) = &__section ## _ ## _name
	154
	155	#define DECLARE_SECTION(_name) \
	156	extern struct cmd __section ## _ ## _name;
	157
	158	struct vendor_event {
	159	unsigned int vendor_id, subcmd;
	160	void (*callback)(unsigned int vendor_id, unsigned int subcmd,
	161	struct nlattr *data);
	162	};
	163
	164	#define VENDOR_EVENT(_id, _subcmd, _callback) \
	165	const struct vendor_event \
	166	vendor_event_ ## _id ## _ ## _subcmd = { \
	167	.vendor_id = _id, \
	168	.subcmd = _subcmd, \
	169	.callback = _callback, \
	170	}, * const vendor_event_ ## _id ## _ ## _subcmd ## _p \
	171	__attribute__((used,section("vendor_event"))) = \
	172	&vendor_event_ ## _id ## _ ## _subcmd
	173
	174	extern const char iw_version[];
	175
	176	extern int iw_debug;
	177
	178	int handle_cmd(struct nl80211_state *state, enum id_input idby,
	179	int argc, char **argv);
	180
	181	struct print_event_args {
	182	struct timeval ts; /* internal */
	183	bool have_ts; /* must be set false */
	184	bool frame, time, reltime;
	185	};
	186
	187	__u32 listen_events(struct nl80211_state *state,
	188	const int n_waits, const __u32 *waits);
	189	int __prepare_listen_events(struct nl80211_state *state);
	190	__u32 __do_listen_events(struct nl80211_state *state,
	191	const int n_waits, const __u32 *waits,
	192	const int n_prints, const __u32 *prints,
	193	struct print_event_args *args);
	194
	195	int valid_handler(struct nl_msg msg, void arg);
	196	void register_handler(int (handler)(struct nl_msg , void ), void data);
	197
	198	int mac_addr_a2n(unsigned char mac_addr, char arg);
	199	void mac_addr_n2a(char mac_addr, const unsigned char arg);
	200	int parse_hex_mask(char hexmask, unsigned char result, size_t result_len,
	201	unsigned char **mask);
	202	unsigned char parse_hex(char hex, size_t *outlen);
	203
	204	int parse_keys(struct nl_msg msg, char argv[], int argc);
	205	int parse_freqchan(struct chandef chandef, bool chan, int argc, char argv, int parsed);
	206	enum nl80211_chan_width str_to_bw(const char *str);
	207	int parse_txq_stats(char buf, int buflen, struct nlattr tid_stats_attr, int header,
	208	int tid, const char *indent);
	209	int put_chandef(struct nl_msg msg, struct chandef chandef);
	210
	211	void print_ht_mcs(const __u8 *mcs);
	212	void print_ampdu_length(__u8 exponent);
	213	void print_ampdu_spacing(__u8 spacing);
	214	void print_ht_capability(__u16 cap);
	215	void print_vht_info(__u32 capa, const __u8 *mcs);
	216	void print_he_capability(const uint8_t *ie, int len);
	217	void print_he_info(struct nlattr *nl_iftype);
	218
	219	char *channel_width_name(enum nl80211_chan_width width);
	220	const char *iftype_name(enum nl80211_iftype iftype);
	221	const char *command_name(enum nl80211_commands cmd);
	222	int ieee80211_channel_to_frequency(int chan, enum nl80211_band band);
	223	int ieee80211_frequency_to_channel(int freq);
	224
	225	void print_ssid_escaped(const uint8_t len, const uint8_t *data);
	226
	227	int nl_get_multicast_id(struct nl_sock sock, const char family, const char *group);
	228
	229	char *reg_initiator_to_string(__u8 initiator);
	230
	231	const char *get_reason_str(uint16_t reason);
	232	const char *get_status_str(uint16_t status);
	233
	234	enum print_ie_type {
	235	PRINT_SCAN,
	236	PRINT_LINK,
	237	};
	238
	239	#define BIT(x) (1ULL<<(x))
	240
	241	void print_ies(unsigned char *ie, int ielen, bool unknown,
	242	enum print_ie_type ptype);
	243
	244	void parse_bitrate(struct nlattr bitrate_attr, char buf, int buflen);
	245	void iw_hexdump(const char prefix, const __u8 data, size_t len);
	246
	247	int get_cf1(const struct chanmode *chanmode, unsigned long freq);
	248
	249	int parse_random_mac_addr(struct nl_msg msg, char addrs);
	250
	251	#define SCHED_SCAN_OPTIONS "[interval <in_msecs> \| scan_plans [<interval_secs:iterations>*] <interval_secs>] " \
	252	"[delay <in_secs>] [freqs <freq>+] [matches [ssid <ssid>]+]] [active [ssid <ssid>]+\|passive] " \
	253	"[randomise[=<addr>/<mask>]] [coloc] [flush]"
	254	int parse_sched_scan(struct nl_msg msg, int argc, char ***argv);
	255
	256	DECLARE_SECTION(switch);
	257	DECLARE_SECTION(set);
	258	DECLARE_SECTION(get);
	259
	260	void nan_bf(uint8_t idx, uint8_t bf, uint16_t bf_len, const uint8_t buf,
	261	size_t len);
	262
	263	char hex2bin(const char hex, char *buf);
	264
	265	int set_bitrates(struct nl_msg msg, int argc, char *argv,
	266	enum nl80211_attrs attr);
	267
	268	#endif /* __IW_H */