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