]> git.ipfire.org Git - thirdparty/iw.git/blob - iw.h
iw: fix "iw reg get" double output
[thirdparty/iw.git] / iw.h
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 #define ETH_ALEN 6
15
16 /* libnl 1.x compatibility code */
17 #if !defined(CONFIG_LIBNL20) && !defined(CONFIG_LIBNL30)
18 # define nl_sock nl_handle
19 #endif
20
21 struct nl80211_state {
22 struct nl_sock *nl_sock;
23 int nl80211_id;
24 };
25
26 enum command_identify_by {
27 CIB_NONE,
28 CIB_PHY,
29 CIB_NETDEV,
30 CIB_WDEV,
31 };
32
33 enum id_input {
34 II_NONE,
35 II_NETDEV,
36 II_PHY_NAME,
37 II_PHY_IDX,
38 II_WDEV,
39 };
40
41 #define HANDLER_RET_DONE 3
42
43 struct cmd {
44 const char *name;
45 const char *args;
46 const char *help;
47 const enum nl80211_commands cmd;
48 int nl_msg_flags;
49 int hidden;
50 const enum command_identify_by idby;
51 /*
52 * The handler should return a negative error code,
53 * zero on success, 1 if the arguments were wrong.
54 * Return 2 iff you provide the error message yourself.
55 */
56 int (*handler)(struct nl80211_state *state,
57 struct nl_msg *msg,
58 int argc, char **argv,
59 enum id_input id);
60 const struct cmd *(*selector)(int argc, char **argv);
61 const struct cmd *parent;
62 };
63
64 struct chanmode {
65 const char *name;
66 unsigned int width;
67 int freq1_diff;
68 int chantype; /* for older kernel */
69 };
70
71 #define ARRAY_SIZE(ar) (sizeof(ar)/sizeof(ar[0]))
72 #define DIV_ROUND_UP(x, y) (((x) + (y - 1)) / (y))
73
74 #define __COMMAND(_section, _symname, _name, _args, _nlcmd, _flags, _hidden, _idby, _handler, _help, _sel)\
75 static struct cmd \
76 __cmd ## _ ## _symname ## _ ## _handler ## _ ## _nlcmd ## _ ## _idby ## _ ## _hidden\
77 __attribute__((used)) __attribute__((section("__cmd"))) = { \
78 .name = (_name), \
79 .args = (_args), \
80 .cmd = (_nlcmd), \
81 .nl_msg_flags = (_flags), \
82 .hidden = (_hidden), \
83 .idby = (_idby), \
84 .handler = (_handler), \
85 .help = (_help), \
86 .parent = _section, \
87 .selector = (_sel), \
88 }
89 #define __ACMD(_section, _symname, _name, _args, _nlcmd, _flags, _hidden, _idby, _handler, _help, _sel, _alias)\
90 __COMMAND(_section, _symname, _name, _args, _nlcmd, _flags, _hidden, _idby, _handler, _help, _sel);\
91 static const struct cmd *_alias = &__cmd ## _ ## _symname ## _ ## _handler ## _ ## _nlcmd ## _ ## _idby ## _ ## _hidden
92 #define COMMAND(section, name, args, cmd, flags, idby, handler, help) \
93 __COMMAND(&(__section ## _ ## section), name, #name, args, cmd, flags, 0, idby, handler, help, NULL)
94 #define COMMAND_ALIAS(section, name, args, cmd, flags, idby, handler, help, selector, alias)\
95 __ACMD(&(__section ## _ ## section), name, #name, args, cmd, flags, 0, idby, handler, help, selector, alias)
96 #define HIDDEN(section, name, args, cmd, flags, idby, handler) \
97 __COMMAND(&(__section ## _ ## section), name, #name, args, cmd, flags, 1, idby, handler, NULL, NULL)
98
99 #define TOPLEVEL(_name, _args, _nlcmd, _flags, _idby, _handler, _help) \
100 struct cmd \
101 __section ## _ ## _name \
102 __attribute__((used)) __attribute__((section("__cmd"))) = { \
103 .name = (#_name), \
104 .args = (_args), \
105 .cmd = (_nlcmd), \
106 .nl_msg_flags = (_flags), \
107 .idby = (_idby), \
108 .handler = (_handler), \
109 .help = (_help), \
110 }
111 #define SECTION(_name) \
112 struct cmd __section ## _ ## _name \
113 __attribute__((used)) __attribute__((section("__cmd"))) = { \
114 .name = (#_name), \
115 .hidden = 1, \
116 }
117
118 #define DECLARE_SECTION(_name) \
119 extern struct cmd __section ## _ ## _name;
120
121 extern const char iw_version[];
122
123 extern int iw_debug;
124
125 int handle_cmd(struct nl80211_state *state, enum id_input idby,
126 int argc, char **argv);
127
128 struct print_event_args {
129 struct timeval ts; /* internal */
130 bool have_ts; /* must be set false */
131 bool frame, time, reltime;
132 };
133
134 __u32 listen_events(struct nl80211_state *state,
135 const int n_waits, const __u32 *waits);
136 int __prepare_listen_events(struct nl80211_state *state);
137 __u32 __do_listen_events(struct nl80211_state *state,
138 const int n_waits, const __u32 *waits,
139 struct print_event_args *args);
140
141 int valid_handler(struct nl_msg *msg, void *arg);
142 void register_handler(int (*handler)(struct nl_msg *, void *), void *data);
143
144 int mac_addr_a2n(unsigned char *mac_addr, char *arg);
145 void mac_addr_n2a(char *mac_addr, unsigned char *arg);
146 int parse_hex_mask(char *hexmask, unsigned char **result, size_t *result_len,
147 unsigned char **mask);
148 unsigned char *parse_hex(char *hex, size_t *outlen);
149
150 int parse_keys(struct nl_msg *msg, char **argv, int argc);
151
152 void print_ht_mcs(const __u8 *mcs);
153 void print_ampdu_length(__u8 exponent);
154 void print_ampdu_spacing(__u8 spacing);
155 void print_ht_capability(__u16 cap);
156 void print_vht_info(__u32 capa, const __u8 *mcs);
157
158 char *channel_width_name(enum nl80211_chan_width width);
159 const char *iftype_name(enum nl80211_iftype iftype);
160 const char *command_name(enum nl80211_commands cmd);
161 int ieee80211_channel_to_frequency(int chan, enum nl80211_band band);
162 int ieee80211_frequency_to_channel(int freq);
163
164 void print_ssid_escaped(const uint8_t len, const uint8_t *data);
165
166 int nl_get_multicast_id(struct nl_sock *sock, const char *family, const char *group);
167
168 char *reg_initiator_to_string(__u8 initiator);
169
170 const char *get_reason_str(uint16_t reason);
171 const char *get_status_str(uint16_t status);
172
173 enum print_ie_type {
174 PRINT_SCAN,
175 PRINT_LINK,
176 };
177
178 #define BIT(x) (1ULL<<(x))
179
180 void print_ies(unsigned char *ie, int ielen, bool unknown,
181 enum print_ie_type ptype);
182
183 void parse_bitrate(struct nlattr *bitrate_attr, char *buf, int buflen);
184 void iw_hexdump(const char *prefix, const __u8 *data, size_t len);
185
186 int get_cf1(const struct chanmode *chanmode, unsigned long freq);
187
188 #define SCHED_SCAN_OPTIONS "interval <in_msecs> [delay <in_secs>] " \
189 "[freqs <freq>+] [matches [ssid <ssid>]+]] [active [ssid <ssid>]+|passive] [randomise[=<addr>/<mask>]]"
190 int parse_sched_scan(struct nl_msg *msg, int *argc, char ***argv);
191
192 DECLARE_SECTION(set);
193 DECLARE_SECTION(get);
194
195 #endif /* __IW_H */