2 * Copyright (c) 2016 Fabien Siron <fabien.siron@epita.fr>
3 * Copyright (c) 2016 Dmitry V. Levin <ldv@altlinux.org>
4 * Copyright (c) 2016-2017 The strace developers.
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 * 3. The name of the author may not be used to endorse or promote products
16 * derived from this software without specific prior written permission.
18 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
19 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
20 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
21 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
22 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
23 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
27 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
33 #include <linux/audit.h>
34 #include <linux/rtnetlink.h>
35 #include <linux/xfrm.h>
36 #include "xlat/netlink_ack_flags.h"
37 #include "xlat/netlink_delete_flags.h"
38 #include "xlat/netlink_flags.h"
39 #include "xlat/netlink_get_flags.h"
40 #include "xlat/netlink_new_flags.h"
41 #include "xlat/netlink_protocols.h"
42 #include "xlat/netlink_types.h"
43 #include "xlat/nf_acct_msg_types.h"
44 #include "xlat/nf_cthelper_msg_types.h"
45 #include "xlat/nf_ctnetlink_exp_msg_types.h"
46 #include "xlat/nf_ctnetlink_msg_types.h"
47 #include "xlat/nf_cttimeout_msg_types.h"
48 #include "xlat/nf_ipset_msg_types.h"
49 #include "xlat/nf_nft_compat_msg_types.h"
50 #include "xlat/nf_nftables_msg_types.h"
51 #include "xlat/nf_osf_msg_types.h"
52 #include "xlat/nf_queue_msg_types.h"
53 #include "xlat/nf_ulog_msg_types.h"
54 #include "xlat/nl_audit_types.h"
55 #include "xlat/nl_crypto_types.h"
56 #include "xlat/nl_netfilter_msg_types.h"
57 #include "xlat/nl_netfilter_subsys_ids.h"
58 #include "xlat/nl_selinux_types.h"
59 #include "xlat/nl_sock_diag_types.h"
60 #include "xlat/nl_xfrm_types.h"
61 #include "xlat/nlmsgerr_attrs.h"
64 * Fetch a struct nlmsghdr from the given address.
67 fetch_nlmsghdr(struct tcb *const tcp, struct nlmsghdr *const nlmsghdr,
68 const kernel_ulong_t addr, const kernel_ulong_t len)
70 if (len < sizeof(struct nlmsghdr)) {
71 printstr_ex(tcp, addr, len, QUOTE_FORCE_HEX);
75 if (umove_or_printaddr(tcp, addr, nlmsghdr))
82 get_fd_nl_family(struct tcb *const tcp, const int fd)
84 const unsigned long inode = getfdinode(tcp, fd);
88 const char *const details = get_sockaddr_by_inode(tcp, fd, inode);
92 const char *const nl_details = STR_STRIP_PREFIX(details, "NETLINK:[");
93 if (nl_details == details)
96 const struct xlat *xlats = netlink_protocols;
97 for (; xlats->str; ++xlats) {
98 const char *name = STR_STRIP_PREFIX(xlats->str, "NETLINK_");
99 if (!strncmp(nl_details, name, strlen(name)))
103 if (*nl_details >= '0' && *nl_details <= '9')
104 return atoi(nl_details);
110 decode_nlmsg_type_default(struct tcb *tcp, const struct xlat *const xlat,
112 const char *const dflt)
114 printxval(xlat, type, dflt);
118 decode_nlmsg_type_generic(struct tcb *tcp, const struct xlat *const xlat,
120 const char *const dflt)
122 printxval(genl_families_xlat(tcp), type, dflt);
125 static const struct {
126 const struct xlat *const xlat;
127 const char *const dflt;
128 } nf_nlmsg_types[] = {
129 [NFNL_SUBSYS_CTNETLINK] = {
130 nf_ctnetlink_msg_types,
133 [NFNL_SUBSYS_CTNETLINK_EXP] = {
134 nf_ctnetlink_exp_msg_types,
137 [NFNL_SUBSYS_QUEUE] = { nf_queue_msg_types, "NFQNL_MSG_???" },
138 [NFNL_SUBSYS_ULOG] = { nf_ulog_msg_types, "NFULNL_MSG_???" },
139 [NFNL_SUBSYS_OSF] = { nf_osf_msg_types, "OSF_MSG_???" },
140 [NFNL_SUBSYS_IPSET] = { nf_ipset_msg_types, "IPSET_CMD_???" },
141 [NFNL_SUBSYS_ACCT] = { nf_acct_msg_types, "NFNL_MSG_ACCT_???" },
142 [NFNL_SUBSYS_CTNETLINK_TIMEOUT] = {
143 nf_cttimeout_msg_types,
144 "IPCTNL_MSG_TIMEOUT_???"
146 [NFNL_SUBSYS_CTHELPER] = {
147 nf_cthelper_msg_types,
148 "NFNL_MSG_CTHELPER_???"
150 [NFNL_SUBSYS_NFTABLES] = { nf_nftables_msg_types, "NFT_MSG_???" },
151 [NFNL_SUBSYS_NFT_COMPAT] = {
152 nf_nft_compat_msg_types,
153 "NFNL_MSG_COMPAT_???"
158 decode_nlmsg_type_netfilter(struct tcb *tcp, const struct xlat *const xlat,
160 const char *const dflt)
162 /* Reserved control nfnetlink messages first. */
163 const char *const text = xlookup(nl_netfilter_msg_types, type);
170 * Other netfilter message types are split
171 * in two pieces: 8 bits subsystem and 8 bits type.
173 const uint8_t subsys_id = (uint8_t) (type >> 8);
174 const uint8_t msg_type = (uint8_t) type;
176 printxval(xlat, subsys_id, dflt);
179 if (subsys_id < ARRAY_SIZE(nf_nlmsg_types))
180 printxval(nf_nlmsg_types[subsys_id].xlat,
181 msg_type, nf_nlmsg_types[subsys_id].dflt);
183 tprintf("%#x", msg_type);
186 typedef void (*nlmsg_types_decoder_t)(struct tcb *, const struct xlat *,
190 static const struct {
191 const nlmsg_types_decoder_t decoder;
192 const struct xlat *const xlat;
193 const char *const dflt;
195 [NETLINK_AUDIT] = { NULL, nl_audit_types, "AUDIT_???" },
196 [NETLINK_CRYPTO] = { NULL, nl_crypto_types, "CRYPTO_MSG_???" },
197 [NETLINK_GENERIC] = {
198 decode_nlmsg_type_generic,
202 [NETLINK_NETFILTER] = {
203 decode_nlmsg_type_netfilter,
204 nl_netfilter_subsys_ids,
207 [NETLINK_ROUTE] = { NULL, nl_route_types, "RTM_???" },
208 [NETLINK_SELINUX] = { NULL, nl_selinux_types, "SELNL_MSG_???" },
209 [NETLINK_SOCK_DIAG] = { NULL, nl_sock_diag_types, "SOCK_DIAG_???" },
210 [NETLINK_XFRM] = { NULL, nl_xfrm_types, "XFRM_MSG_???" }
214 * As all valid netlink families are positive integers, use unsigned int
215 * for family here to filter out -1.
218 decode_nlmsg_type(struct tcb *tcp, const uint16_t type,
219 const unsigned int family)
221 nlmsg_types_decoder_t decoder = decode_nlmsg_type_default;
222 const struct xlat *xlat = netlink_types;
223 const char *dflt = "NLMSG_???";
226 * type < NLMSG_MIN_TYPE are reserved control messages
227 * that need no family-specific decoding.
229 if (type >= NLMSG_MIN_TYPE && family < ARRAY_SIZE(nlmsg_types)) {
230 if (nlmsg_types[family].decoder)
231 decoder = nlmsg_types[family].decoder;
232 if (nlmsg_types[family].xlat)
233 xlat = nlmsg_types[family].xlat;
234 if (nlmsg_types[family].dflt)
235 dflt = nlmsg_types[family].dflt;
238 decoder(tcp, xlat, type, dflt);
241 static const struct xlat *
242 decode_nlmsg_flags_crypto(const uint16_t type)
245 case CRYPTO_MSG_NEWALG:
246 return netlink_new_flags;
247 case CRYPTO_MSG_DELALG:
248 case CRYPTO_MSG_DELRNG:
249 return netlink_delete_flags;
250 case CRYPTO_MSG_GETALG:
251 return netlink_get_flags;
257 static const struct xlat *
258 decode_nlmsg_flags_netfilter(const uint16_t type)
260 const uint8_t subsys_id = (uint8_t) (type >> 8);
261 const uint8_t msg_type = (uint8_t) type;
264 case NFNL_SUBSYS_CTNETLINK:
266 case IPCTNL_MSG_CT_NEW:
267 return netlink_new_flags;
268 case IPCTNL_MSG_CT_GET:
269 case IPCTNL_MSG_CT_GET_CTRZERO:
270 case IPCTNL_MSG_CT_GET_STATS_CPU:
271 case IPCTNL_MSG_CT_GET_STATS:
272 case IPCTNL_MSG_CT_GET_DYING:
273 case IPCTNL_MSG_CT_GET_UNCONFIRMED:
274 return netlink_get_flags;
275 case IPCTNL_MSG_CT_DELETE:
276 return netlink_delete_flags;
279 case NFNL_SUBSYS_CTNETLINK_EXP:
281 case IPCTNL_MSG_EXP_NEW:
282 return netlink_new_flags;
283 case IPCTNL_MSG_EXP_GET:
284 case IPCTNL_MSG_EXP_GET_STATS_CPU:
285 return netlink_get_flags;
286 case IPCTNL_MSG_EXP_DELETE:
287 return netlink_delete_flags;
290 case NFNL_SUBSYS_ACCT:
292 case NFNL_MSG_ACCT_NEW:
293 return netlink_new_flags;
294 case NFNL_MSG_ACCT_GET:
295 case NFNL_MSG_ACCT_GET_CTRZERO:
296 return netlink_get_flags;
297 case NFNL_MSG_ACCT_DEL:
298 return netlink_delete_flags;
301 case NFNL_SUBSYS_CTNETLINK_TIMEOUT:
303 case IPCTNL_MSG_TIMEOUT_NEW:
304 return netlink_new_flags;
305 case IPCTNL_MSG_TIMEOUT_GET:
306 return netlink_get_flags;
307 case IPCTNL_MSG_TIMEOUT_DELETE:
308 return netlink_delete_flags;
311 case NFNL_SUBSYS_CTHELPER:
313 case NFNL_MSG_CTHELPER_NEW:
314 return netlink_new_flags;
315 case NFNL_MSG_CTHELPER_GET:
316 return netlink_get_flags;
317 case NFNL_MSG_CTHELPER_DEL:
318 return netlink_delete_flags;
321 case NFNL_SUBSYS_NFTABLES:
323 case NFT_MSG_NEWTABLE:
324 case NFT_MSG_NEWCHAIN:
325 case NFT_MSG_NEWRULE:
327 case NFT_MSG_NEWSETELEM:
330 return netlink_new_flags;
331 case NFT_MSG_GETTABLE:
332 case NFT_MSG_GETCHAIN:
333 case NFT_MSG_GETRULE:
335 case NFT_MSG_GETSETELEM:
338 case NFT_MSG_GETOBJ_RESET:
339 return netlink_get_flags;
340 case NFT_MSG_DELTABLE:
341 case NFT_MSG_DELCHAIN:
342 case NFT_MSG_DELRULE:
344 case NFT_MSG_DELSETELEM:
346 return netlink_delete_flags;
349 case NFNL_SUBSYS_NFT_COMPAT:
351 case NFNL_MSG_COMPAT_GET:
352 return netlink_get_flags;
360 static const struct xlat *
361 decode_nlmsg_flags_route(const uint16_t type)
363 /* RTM_DELACTION uses NLM_F_ROOT flags */
364 if (type == RTM_DELACTION)
365 return netlink_get_flags;
368 return netlink_new_flags;
370 return netlink_delete_flags;
372 return netlink_get_flags;
378 static const struct xlat *
379 decode_nlmsg_flags_sock_diag(const uint16_t type)
381 return netlink_get_flags;
384 static const struct xlat *
385 decode_nlmsg_flags_xfrm(const uint16_t type)
389 case XFRM_MSG_NEWPOLICY:
391 case XFRM_MSG_NEWSADINFO:
392 case XFRM_MSG_NEWSPDINFO:
393 return netlink_new_flags;
395 case XFRM_MSG_DELPOLICY:
396 return netlink_delete_flags;
398 case XFRM_MSG_GETPOLICY:
400 case XFRM_MSG_GETSADINFO:
401 case XFRM_MSG_GETSPDINFO:
402 return netlink_get_flags;
408 typedef const struct xlat *(*nlmsg_flags_decoder_t)(const uint16_t type);
410 static const nlmsg_flags_decoder_t nlmsg_flags[] = {
411 [NETLINK_CRYPTO] = decode_nlmsg_flags_crypto,
412 [NETLINK_NETFILTER] = decode_nlmsg_flags_netfilter,
413 [NETLINK_ROUTE] = decode_nlmsg_flags_route,
414 [NETLINK_SOCK_DIAG] = decode_nlmsg_flags_sock_diag,
415 [NETLINK_XFRM] = decode_nlmsg_flags_xfrm
419 * As all valid netlink families are positive integers, use unsigned int
420 * for family here to filter out -1.
423 decode_nlmsg_flags(const uint16_t flags, const uint16_t type,
424 const unsigned int family)
426 const struct xlat *table = NULL;
428 if (type < NLMSG_MIN_TYPE) {
429 if (type == NLMSG_ERROR)
430 table = netlink_ack_flags;
431 } else if (family < ARRAY_SIZE(nlmsg_flags) && nlmsg_flags[family])
432 table = nlmsg_flags[family](type);
434 printflags_ex(flags, "NLM_F_???", netlink_flags, table, NULL);
438 print_nlmsghdr(struct tcb *tcp,
441 const struct nlmsghdr *const nlmsghdr)
443 /* print the whole structure regardless of its nlmsg_len */
445 tprintf("{len=%u, type=", nlmsghdr->nlmsg_len);
447 decode_nlmsg_type(tcp, nlmsghdr->nlmsg_type, family);
450 decode_nlmsg_flags(nlmsghdr->nlmsg_flags,
451 nlmsghdr->nlmsg_type, family);
453 tprintf(", seq=%u, pid=%u}", nlmsghdr->nlmsg_seq,
454 nlmsghdr->nlmsg_pid);
458 print_cookie(struct tcb *const tcp, void *const elem_buf,
459 const size_t elem_size, void *const opaque_data)
461 tprintf("%" PRIu8, *(uint8_t *) elem_buf);
467 decode_nlmsgerr_attr_cookie(struct tcb *const tcp,
468 const kernel_ulong_t addr,
469 const unsigned int len,
470 const void *const opaque_data)
473 const size_t nmemb = len / sizeof(cookie);
475 print_array(tcp, addr, nmemb, &cookie, sizeof(cookie),
476 umoven_or_printaddr, print_cookie, 0);
481 static const nla_decoder_t nlmsgerr_nla_decoders[] = {
482 [NLMSGERR_ATTR_MSG] = decode_nla_str,
483 [NLMSGERR_ATTR_OFFS] = decode_nla_u32,
484 [NLMSGERR_ATTR_COOKIE] = decode_nlmsgerr_attr_cookie
488 decode_nlmsghdr_with_payload(struct tcb *const tcp,
491 const struct nlmsghdr *const nlmsghdr,
492 const kernel_ulong_t addr,
493 const kernel_ulong_t len);
496 decode_nlmsgerr(struct tcb *const tcp,
505 if (len < sizeof(err.error)) {
506 printstr_ex(tcp, addr, len, QUOTE_FORCE_HEX);
510 if (umove_or_printaddr(tcp, addr, &err.error))
514 if (err.error < 0 && (unsigned) -err.error < nerrnos) {
515 tprintf("-%s", errnoent[-err.error]);
517 tprintf("%d", err.error);
520 addr += offsetof(struct nlmsgerr, msg);
521 len -= offsetof(struct nlmsgerr, msg);
525 if (fetch_nlmsghdr(tcp, &err.msg, addr, len)) {
526 unsigned int payload =
527 capped ? sizeof(err.msg) : err.msg.nlmsg_len;
531 decode_nlmsghdr_with_payload(tcp, fd, family,
532 &err.msg, addr, payload);
535 decode_nlattr(tcp, addr + payload,
536 len - payload, nlmsgerr_attrs,
538 nlmsgerr_nla_decoders,
539 ARRAY_SIZE(nlmsgerr_nla_decoders),
548 static const netlink_decoder_t netlink_decoders[] = {
549 #ifdef HAVE_LINUX_CRYPTOUSER_H
550 [NETLINK_CRYPTO] = decode_netlink_crypto,
552 #ifdef HAVE_LINUX_NETFILTER_NFNETLINK_H
553 [NETLINK_NETFILTER] = decode_netlink_netfilter,
555 [NETLINK_ROUTE] = decode_netlink_route,
556 [NETLINK_SELINUX] = decode_netlink_selinux,
557 [NETLINK_SOCK_DIAG] = decode_netlink_sock_diag
561 decode_payload(struct tcb *const tcp,
564 const struct nlmsghdr *const nlmsghdr,
565 const kernel_ulong_t addr,
566 const unsigned int len)
568 if (nlmsghdr->nlmsg_type == NLMSG_ERROR) {
569 decode_nlmsgerr(tcp, fd, family, addr, len,
570 nlmsghdr->nlmsg_flags & NLM_F_CAPPED);
575 * While most of NLMSG_DONE messages indeed have payloads
576 * containing just a single integer, there are few exceptions,
577 * so pass payloads of NLMSG_DONE messages to family-specific
578 * netlink payload decoders.
580 * Other types of reserved control messages need no family-specific
581 * netlink payload decoding.
583 if ((nlmsghdr->nlmsg_type >= NLMSG_MIN_TYPE
584 || nlmsghdr->nlmsg_type == NLMSG_DONE)
585 && (unsigned int) family < ARRAY_SIZE(netlink_decoders)
586 && netlink_decoders[family]
587 && netlink_decoders[family](tcp, nlmsghdr, addr, len)) {
591 if (nlmsghdr->nlmsg_type == NLMSG_DONE && len == sizeof(int)) {
594 if (!umove_or_printaddr(tcp, addr, &num))
599 printstr_ex(tcp, addr, len, QUOTE_FORCE_HEX);
603 decode_nlmsghdr_with_payload(struct tcb *const tcp,
606 const struct nlmsghdr *const nlmsghdr,
607 const kernel_ulong_t addr,
608 const kernel_ulong_t len)
610 const unsigned int nlmsg_len =
611 nlmsghdr->nlmsg_len > len ? len : nlmsghdr->nlmsg_len;
613 if (nlmsg_len > NLMSG_HDRLEN)
616 print_nlmsghdr(tcp, fd, family, nlmsghdr);
618 if (nlmsg_len > NLMSG_HDRLEN) {
620 decode_payload(tcp, fd, family, nlmsghdr, addr + NLMSG_HDRLEN,
621 nlmsg_len - NLMSG_HDRLEN);
627 decode_netlink(struct tcb *const tcp,
632 const int family = get_fd_nl_family(tcp, fd);
634 if (family == NETLINK_KOBJECT_UEVENT) {
635 printstrn(tcp, addr, len);
639 struct nlmsghdr nlmsghdr;
640 bool print_array = false;
643 for (elt = 0; fetch_nlmsghdr(tcp, &nlmsghdr, addr, len); elt++) {
644 if (abbrev(tcp) && elt == max_strlen) {
649 unsigned int nlmsg_len = NLMSG_ALIGN(nlmsghdr.nlmsg_len);
650 kernel_ulong_t next_addr = 0;
651 kernel_ulong_t next_len = 0;
653 if (nlmsghdr.nlmsg_len >= NLMSG_HDRLEN) {
654 next_len = (len >= nlmsg_len) ? len - nlmsg_len : 0;
656 if (next_len && addr + nlmsg_len > addr)
657 next_addr = addr + nlmsg_len;
660 if (!print_array && next_addr) {
665 decode_nlmsghdr_with_payload(tcp, fd, family,
666 &nlmsghdr, addr, len);