]> git.ipfire.org Git - thirdparty/iw.git/blame - iw.h
iw: bump version to 4.7
[thirdparty/iw.git] / iw.h
CommitLineData
cad53b3f
JB
1#ifndef __IW_H
2#define __IW_H
3
7fabd346 4#include <stdbool.h>
45d543f0 5#include <netlink/netlink.h>
cad53b3f
JB
6#include <netlink/genl/genl.h>
7#include <netlink/genl/family.h>
8#include <netlink/genl/ctrl.h>
a82abc2c 9#include <endian.h>
cad53b3f 10
f408e01b 11#include "nl80211.h"
a82abc2c 12#include "ieee80211.h"
f408e01b 13
3d1e8704
LCC
14#define ETH_ALEN 6
15
ded667b0
YY
16/* libnl 1.x compatibility code */
17#if !defined(CONFIG_LIBNL20) && !defined(CONFIG_LIBNL30)
57077d64 18# define nl_sock nl_handle
dfd13ee5 19#endif
57077d64
PE
20
21struct nl80211_state {
22 struct nl_sock *nl_sock;
f09cee6d 23 int nl80211_id;
cad53b3f
JB
24};
25
bd396f2a
JB
26enum command_identify_by {
27 CIB_NONE,
28 CIB_PHY,
29 CIB_NETDEV,
290a3dd4 30 CIB_WDEV,
7c37a24d
JB
31};
32
33enum id_input {
34 II_NONE,
35 II_NETDEV,
36 II_PHY_NAME,
37 II_PHY_IDX,
290a3dd4 38 II_WDEV,
bd396f2a 39};
45c7212c 40
b2c4bf45 41#define HANDLER_RET_USAGE 1
94af668b
JB
42#define HANDLER_RET_DONE 3
43
bd396f2a 44struct cmd {
bd396f2a
JB
45 const char *name;
46 const char *args;
01ae06f9 47 const char *help;
bd396f2a
JB
48 const enum nl80211_commands cmd;
49 int nl_msg_flags;
ce5af55c 50 int hidden;
bd396f2a 51 const enum command_identify_by idby;
5e75fd04
JB
52 /*
53 * The handler should return a negative error code,
86a9801f
OO
54 * zero on success, 1 if the arguments were wrong.
55 * Return 2 iff you provide the error message yourself.
5e75fd04 56 */
7c37a24d 57 int (*handler)(struct nl80211_state *state,
bd396f2a 58 struct nl_msg *msg,
05514f95
JB
59 int argc, char **argv,
60 enum id_input id);
1633ddf7 61 const struct cmd *(*selector)(int argc, char **argv);
4698bfc2 62 const struct cmd *parent;
bd396f2a 63};
3d1e8704 64
c1b2b633
SE
65struct chanmode {
66 const char *name;
67 unsigned int width;
68 int freq1_diff;
69 int chantype; /* for older kernel */
70};
71
7d736016 72#define ARRAY_SIZE(ar) (sizeof(ar)/sizeof(ar[0]))
3ff24563 73#define DIV_ROUND_UP(x, y) (((x) + (y - 1)) / (y))
7d736016 74
1633ddf7 75#define __COMMAND(_section, _symname, _name, _args, _nlcmd, _flags, _hidden, _idby, _handler, _help, _sel)\
78bebb71 76 static struct cmd \
9b92e691
JB
77 __cmd ## _ ## _symname ## _ ## _handler ## _ ## _nlcmd ## _ ## _idby ## _ ## _hidden\
78 __attribute__((used)) __attribute__((section("__cmd"))) = { \
9b92e691
JB
79 .name = (_name), \
80 .args = (_args), \
81 .cmd = (_nlcmd), \
82 .nl_msg_flags = (_flags), \
83 .hidden = (_hidden), \
84 .idby = (_idby), \
85 .handler = (_handler), \
01ae06f9 86 .help = (_help), \
4698bfc2 87 .parent = _section, \
1633ddf7
JB
88 .selector = (_sel), \
89 }
90#define __ACMD(_section, _symname, _name, _args, _nlcmd, _flags, _hidden, _idby, _handler, _help, _sel, _alias)\
91 __COMMAND(_section, _symname, _name, _args, _nlcmd, _flags, _hidden, _idby, _handler, _help, _sel);\
92 static const struct cmd *_alias = &__cmd ## _ ## _symname ## _ ## _handler ## _ ## _nlcmd ## _ ## _idby ## _ ## _hidden
01ae06f9 93#define COMMAND(section, name, args, cmd, flags, idby, handler, help) \
1633ddf7
JB
94 __COMMAND(&(__section ## _ ## section), name, #name, args, cmd, flags, 0, idby, handler, help, NULL)
95#define COMMAND_ALIAS(section, name, args, cmd, flags, idby, handler, help, selector, alias)\
96 __ACMD(&(__section ## _ ## section), name, #name, args, cmd, flags, 0, idby, handler, help, selector, alias)
01ae06f9 97#define HIDDEN(section, name, args, cmd, flags, idby, handler) \
1633ddf7 98 __COMMAND(&(__section ## _ ## section), name, #name, args, cmd, flags, 1, idby, handler, NULL, NULL)
4698bfc2
JB
99
100#define TOPLEVEL(_name, _args, _nlcmd, _flags, _idby, _handler, _help) \
78bebb71 101 struct cmd \
4698bfc2
JB
102 __section ## _ ## _name \
103 __attribute__((used)) __attribute__((section("__cmd"))) = { \
104 .name = (#_name), \
105 .args = (_args), \
106 .cmd = (_nlcmd), \
107 .nl_msg_flags = (_flags), \
108 .idby = (_idby), \
109 .handler = (_handler), \
110 .help = (_help), \
111 }
112#define SECTION(_name) \
78bebb71 113 struct cmd __section ## _ ## _name \
4698bfc2
JB
114 __attribute__((used)) __attribute__((section("__cmd"))) = { \
115 .name = (#_name), \
116 .hidden = 1, \
117 }
118
119#define DECLARE_SECTION(_name) \
78bebb71 120 extern struct cmd __section ## _ ## _name;
14a0380d 121
133b069f 122extern const char iw_version[];
7c37a24d 123
957a0f07
JB
124extern int iw_debug;
125
7c37a24d
JB
126int handle_cmd(struct nl80211_state *state, enum id_input idby,
127 int argc, char **argv);
7fabd346
JB
128
129struct print_event_args {
981b21ad
JB
130 struct timeval ts; /* internal */
131 bool have_ts; /* must be set false */
132 bool frame, time, reltime;
7fabd346
JB
133};
134
72041aa0
JB
135__u32 listen_events(struct nl80211_state *state,
136 const int n_waits, const __u32 *waits);
ee374e4d
JB
137int __prepare_listen_events(struct nl80211_state *state);
138__u32 __do_listen_events(struct nl80211_state *state,
139 const int n_waits, const __u32 *waits,
140 struct print_event_args *args);
7c37a24d 141
34b23014
JB
142int valid_handler(struct nl_msg *msg, void *arg);
143void register_handler(int (*handler)(struct nl_msg *, void *), void *data);
7c37a24d 144
3d1e8704 145int mac_addr_a2n(unsigned char *mac_addr, char *arg);
febeb0c0 146void mac_addr_n2a(char *mac_addr, unsigned char *arg);
3ff24563
JB
147int parse_hex_mask(char *hexmask, unsigned char **result, size_t *result_len,
148 unsigned char **mask);
236d4191 149unsigned char *parse_hex(char *hex, size_t *outlen);
3d1e8704 150
51e9bd80
JB
151int parse_keys(struct nl_msg *msg, char **argv, int argc);
152
7ddfb679 153void print_ht_mcs(const __u8 *mcs);
0950993f
LR
154void print_ampdu_length(__u8 exponent);
155void print_ampdu_spacing(__u8 spacing);
357c1a5d 156void print_ht_capability(__u16 cap);
54eb1613 157void print_vht_info(__u32 capa, const __u8 *mcs);
deb3501c 158
c5df9eb6 159char *channel_width_name(enum nl80211_chan_width width);
541ef425 160const char *iftype_name(enum nl80211_iftype iftype);
9990c1e9 161const char *command_name(enum nl80211_commands cmd);
58b46da2 162int ieee80211_channel_to_frequency(int chan, enum nl80211_band band);
379f8397 163int ieee80211_frequency_to_channel(int freq);
541ef425 164
748f8489
JB
165void print_ssid_escaped(const uint8_t len, const uint8_t *data);
166
57077d64 167int nl_get_multicast_id(struct nl_sock *sock, const char *family, const char *group);
2c61ba61 168
601c6ab2
LR
169char *reg_initiator_to_string(__u8 initiator);
170
27c49ed6 171const char *get_reason_str(uint16_t reason);
22c7d879 172const char *get_status_str(uint16_t status);
27c49ed6 173
febeb0c0
JB
174enum print_ie_type {
175 PRINT_SCAN,
176 PRINT_LINK,
177};
178
179#define BIT(x) (1ULL<<(x))
180
181void print_ies(unsigned char *ie, int ielen, bool unknown,
182 enum print_ie_type ptype);
183
e94f0201 184void parse_bitrate(struct nlattr *bitrate_attr, char *buf, int buflen);
492354de 185void iw_hexdump(const char *prefix, const __u8 *data, size_t len);
4698bfc2 186
c1b2b633
SE
187int get_cf1(const struct chanmode *chanmode, unsigned long freq);
188
9ae0d103
AS
189#define SCHED_SCAN_OPTIONS "[interval <in_msecs> | scan_plans [<interval_secs:iterations>*] <interval_secs>] " \
190 "[delay <in_secs>] [freqs <freq>+] [matches [ssid <ssid>]+]] [active [ssid <ssid>]+|passive] " \
191 "[randomise[=<addr>/<mask>]]"
b1622287
LC
192int parse_sched_scan(struct nl_msg *msg, int *argc, char ***argv);
193
4698bfc2
JB
194DECLARE_SECTION(set);
195DECLARE_SECTION(get);
196
cad53b3f 197#endif /* __IW_H */