2 * Copyright (c) 2016 Antonin Décimo, Jean-Raphaël Gaglione
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions
7 * 1. Redistributions of source code must retain the above copyright
8 * notice, this list of conditions and the following disclaimer.
9 * 2. Redistributions in binary form must reproduce the above copyright
10 * notice, this list of conditions and the following disclaimer in the
11 * documentation and/or other materials provided with the distribution.
12 * 3. Neither the name of the project nor the names of its contributors
13 * may be used to endorse or promote products derived from this software
14 * without specific prior written permission.
16 * THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
17 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19 * ARE DISCLAIMED. IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
20 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29 /* \summary: Home Networking Control Protocol (HNCP) printer */
35 #include <netdissect-stdinc.h>
40 #include "netdissect.h"
41 #include "addrtoname.h"
45 hncp_print_rec(netdissect_options *ndo,
46 const u_char *cp, u_int length, int indent);
49 hncp_print(netdissect_options *ndo,
50 const u_char *cp, u_int length)
52 ND_PRINT((ndo, "hncp (%d)", length));
53 hncp_print_rec(ndo, cp, length, 1);
57 #define DNCP_REQUEST_NETWORK_STATE 1
58 #define DNCP_REQUEST_NODE_STATE 2
59 #define DNCP_NODE_ENDPOINT 3
60 #define DNCP_NETWORK_STATE 4
61 #define DNCP_NODE_STATE 5
63 #define DNCP_KEEP_ALIVE_INTERVAL 9
64 #define DNCP_TRUST_VERDICT 10
67 #define HNCP_HNCP_VERSION 32
68 #define HNCP_EXTERNAL_CONNECTION 33
69 #define HNCP_DELEGATED_PREFIX 34
70 #define HNCP_PREFIX_POLICY 43
71 #define HNCP_DHCPV4_DATA 37
72 #define HNCP_DHCPV6_DATA 38
73 #define HNCP_ASSIGNED_PREFIX 35
74 #define HNCP_NODE_ADDRESS 36
75 #define HNCP_DNS_DELEGATED_ZONE 39
76 #define HNCP_DOMAIN_NAME 40
77 #define HNCP_NODE_NAME 41
78 #define HNCP_MANAGED_PSK 42
80 /* See type_mask in hncp_print_rec below */
81 #define RANGE_DNCP_RESERVED 0x10000
82 #define RANGE_HNCP_UNASSIGNED 0x10001
83 #define RANGE_DNCP_PRIVATE_USE 0x10002
84 #define RANGE_DNCP_FUTURE_USE 0x10003
86 static const struct tok type_values[] = {
87 { DNCP_REQUEST_NETWORK_STATE, "Request network state" },
88 { DNCP_REQUEST_NODE_STATE, "Request node state" },
89 { DNCP_NODE_ENDPOINT, "Node endpoint" },
90 { DNCP_NETWORK_STATE, "Network state" },
91 { DNCP_NODE_STATE, "Node state" },
92 { DNCP_PEER, "Peer" },
93 { DNCP_KEEP_ALIVE_INTERVAL, "Keep-alive interval" },
94 { DNCP_TRUST_VERDICT, "Trust-Verdict" },
96 { HNCP_HNCP_VERSION, "HNCP-Version" },
97 { HNCP_EXTERNAL_CONNECTION, "External-Connection" },
98 { HNCP_DELEGATED_PREFIX, "Delegated-Prefix" },
99 { HNCP_PREFIX_POLICY, "Prefix-Policy" },
100 { HNCP_DHCPV4_DATA, "DHCPv4-Data" },
101 { HNCP_DHCPV6_DATA, "DHCPv6-Data" },
102 { HNCP_ASSIGNED_PREFIX, "Assigned-Prefix" },
103 { HNCP_NODE_ADDRESS, "Node-Address" },
104 { HNCP_DNS_DELEGATED_ZONE, "DNS-Delegated-Zone" },
105 { HNCP_DOMAIN_NAME, "Domain-Name" },
106 { HNCP_NODE_NAME, "Node-Name" },
107 { HNCP_MANAGED_PSK, "Managed-PSK" },
109 { RANGE_DNCP_RESERVED, "Reserved" },
110 { RANGE_HNCP_UNASSIGNED, "Unassigned" },
111 { RANGE_DNCP_PRIVATE_USE, "Private use" },
112 { RANGE_DNCP_FUTURE_USE, "Future use" },
117 #define DH4OPT_DNS_SERVERS 6 /* RFC2132 */
118 #define DH4OPT_NTP_SERVERS 42 /* RFC2132 */
119 #define DH4OPT_DOMAIN_SEARCH 119 /* RFC3397 */
121 static const struct tok dh4opt_str[] = {
122 { DH4OPT_DNS_SERVERS, "DNS-server" },
123 { DH4OPT_NTP_SERVERS, "NTP-server"},
124 { DH4OPT_DOMAIN_SEARCH, "DNS-search" },
128 #define DH6OPT_DNS_SERVERS 23 /* RFC3646 */
129 #define DH6OPT_DOMAIN_LIST 24 /* RFC3646 */
130 #define DH6OPT_SNTP_SERVERS 31 /* RFC4075 */
132 static const struct tok dh6opt_str[] = {
133 { DH6OPT_DNS_SERVERS, "DNS-server" },
134 { DH6OPT_DOMAIN_LIST, "DNS-search-list" },
135 { DH6OPT_SNTP_SERVERS, "SNTP-servers" },
140 * For IPv4-mapped IPv6 addresses, length of the prefix that precedes
141 * the 4 bytes of IPv4 address at the end of the IPv6 address.
143 #define IPV4_MAPPED_HEADING_LEN 12
146 * Is an IPv6 address an IPv4-mapped address?
149 is_ipv4_mapped_address(const u_char *addr)
151 /* The value of the prefix */
152 static const u_char ipv4_mapped_heading[IPV4_MAPPED_HEADING_LEN] =
153 { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0xFF, 0xFF };
155 return memcmp(addr, ipv4_mapped_heading, IPV4_MAPPED_HEADING_LEN) == 0;
159 format_nid(const u_char *data)
161 static char buf[4][11+5];
164 snprintf(buf[i], 16, "%02x:%02x:%02x:%02x",
165 data[0], data[1], data[2], data[3]);
170 format_256(const u_char *data)
172 static char buf[4][64+5];
175 snprintf(buf[i], 28, "%016" PRIx64 "%016" PRIx64 "%016" PRIx64 "%016" PRIx64,
176 EXTRACT_64BITS(data),
177 EXTRACT_64BITS(data + 8),
178 EXTRACT_64BITS(data + 16),
179 EXTRACT_64BITS(data + 24)
185 format_interval(const uint32_t n)
187 static char buf[4][sizeof("0000000.000s")];
190 snprintf(buf[i], sizeof(buf[i]), "%u.%03us", n / 1000, n % 1000);
195 format_ip6addr(netdissect_options *ndo, const u_char *cp)
197 if (is_ipv4_mapped_address(cp))
198 return ipaddr_string(ndo, cp + IPV4_MAPPED_HEADING_LEN);
200 return ip6addr_string(ndo, cp);
204 print_prefix(netdissect_options *ndo, const u_char *prefix, u_int max_length)
207 char buf[sizeof("xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx::/128")];
209 if (prefix[0] >= 96 && max_length >= IPV4_MAPPED_HEADING_LEN + 1 &&
210 is_ipv4_mapped_address(&prefix[1])) {
219 memset(&addr, 0, sizeof(addr));
220 plenbytes = (plen + 7) / 8;
221 if (max_length < (u_int)plenbytes + IPV4_MAPPED_HEADING_LEN)
223 memcpy(&addr, &prefix[1 + IPV4_MAPPED_HEADING_LEN], plenbytes);
225 ((u_char *)&addr)[plenbytes - 1] &=
226 ((0xff00 >> (plen % 8)) & 0xff);
228 snprintf(buf, sizeof(buf), "%s/%d", ipaddr_string(ndo, &addr), plen);
229 plenbytes += 1 + IPV4_MAPPED_HEADING_LEN;
231 plenbytes = decode_prefix6(ndo, prefix, max_length, buf, sizeof(buf));
234 ND_PRINT((ndo, "%s", buf));
239 print_dns_label(netdissect_options *ndo,
240 const u_char *cp, u_int max_length, int print)
243 while (length < max_length) {
244 u_int lab_length = cp[length++];
247 if (length > 1 && print)
248 safeputchar(ndo, '.');
249 if (length+lab_length > max_length) {
251 safeputs(ndo, cp+length, max_length-length);
255 safeputs(ndo, cp+length, lab_length);
256 length += lab_length;
259 ND_PRINT((ndo, "[|DNS]"));
264 dhcpv4_print(netdissect_options *ndo,
265 const u_char *cp, u_int length, int indent)
268 const u_char *tlv, *value;
269 uint8_t type, optlen;
276 type = (uint8_t)tlv[0];
277 optlen = (uint8_t)tlv[1];
280 ND_PRINT((ndo, "\n"));
281 for (t = indent; t > 0; t--)
282 ND_PRINT((ndo, "\t"));
284 ND_PRINT((ndo, "%s", tok2str(dh4opt_str, "Unknown", type)));
285 ND_PRINT((ndo," (%u)", optlen + 2 ));
286 if (i + 2 + optlen > length)
290 case DH4OPT_DNS_SERVERS:
291 case DH4OPT_NTP_SERVERS: {
292 if (optlen < 4 || optlen % 4 != 0) {
295 for (t = 0; t < optlen; t += 4)
296 ND_PRINT((ndo, " %s", ipaddr_string(ndo, value + t)));
299 case DH4OPT_DOMAIN_SEARCH: {
300 const u_char *tp = value;
301 while (tp < value + optlen) {
302 ND_PRINT((ndo, " "));
303 if ((tp = ns_nprint(ndo, tp, value + optlen)) == NULL)
316 dhcpv6_print(netdissect_options *ndo,
317 const u_char *cp, u_int length, int indent)
320 const u_char *tlv, *value;
321 uint16_t type, optlen;
328 type = EXTRACT_16BITS(tlv);
329 optlen = EXTRACT_16BITS(tlv + 2);
332 ND_PRINT((ndo, "\n"));
333 for (t = indent; t > 0; t--)
334 ND_PRINT((ndo, "\t"));
336 ND_PRINT((ndo, "%s", tok2str(dh6opt_str, "Unknown", type)));
337 ND_PRINT((ndo," (%u)", optlen + 4 ));
338 if (i + 4 + optlen > length)
342 case DH6OPT_DNS_SERVERS:
343 case DH6OPT_SNTP_SERVERS: {
344 if (optlen % 16 != 0) {
345 ND_PRINT((ndo, " %s", istr));
348 for (t = 0; t < optlen; t += 16)
349 ND_PRINT((ndo, " %s", ip6addr_string(ndo, value + t)));
352 case DH6OPT_DOMAIN_LIST: {
353 const u_char *tp = value;
354 while (tp < value + optlen) {
355 ND_PRINT((ndo, " "));
356 if ((tp = ns_nprint(ndo, tp, value + optlen)) == NULL)
368 /* Determine in-line mode */
370 is_in_line(netdissect_options *ndo, int indent)
372 return indent - 1 >= ndo->ndo_vflag && ndo->ndo_vflag < 3;
376 print_type_in_line(netdissect_options *ndo,
377 uint32_t type, int count, int indent, int *first_one)
384 ND_PRINT((ndo, "\n"));
385 for (t = indent; t > 0; t--)
386 ND_PRINT((ndo, "\t"));
388 ND_PRINT((ndo, " "));
391 ND_PRINT((ndo, ", "));
393 ND_PRINT((ndo, "%s", tok2str(type_values, "Easter Egg", type)));
395 ND_PRINT((ndo, " (x%d)", count));
400 hncp_print_rec(netdissect_options *ndo,
401 const u_char *cp, u_int length, int indent)
403 const int in_line = is_in_line(ndo, indent);
408 uint32_t last_type_mask = 0xffffffffU;
409 int last_type_count = -1;
411 const u_char *tlv, *value;
412 uint16_t type, bodylen;
420 ND_PRINT((ndo, "\n"));
421 for (t = indent; t > 0; t--)
422 ND_PRINT((ndo, "\t"));
429 type = EXTRACT_16BITS(tlv);
430 bodylen = EXTRACT_16BITS(tlv + 2);
432 ND_TCHECK2(*value, bodylen);
433 if (i + bodylen + 4 > length)
437 (type == 0) ? RANGE_DNCP_RESERVED:
438 (44 <= type && type <= 511) ? RANGE_HNCP_UNASSIGNED:
439 (768 <= type && type <= 1023) ? RANGE_DNCP_PRIVATE_USE:
440 RANGE_DNCP_FUTURE_USE;
441 if (type == 6 || type == 7)
442 type_mask = RANGE_DNCP_FUTURE_USE;
448 u_int key = type_values[t++].v;
459 if (last_type_mask == type_mask) {
462 print_type_in_line(ndo, last_type_mask, last_type_count, indent, &first_one);
463 last_type_mask = type_mask;
470 ND_PRINT((ndo,"%s", tok2str(type_values, "Easter Egg (42)", type_mask) ));
471 if (type_mask > 0xffff)
472 ND_PRINT((ndo,": type=%u", type ));
473 ND_PRINT((ndo," (%u)", bodylen + 4 ));
477 case DNCP_REQUEST_NETWORK_STATE: {
479 ND_PRINT((ndo, " %s", istr));
483 case DNCP_REQUEST_NODE_STATE: {
484 const char *node_identifier;
486 ND_PRINT((ndo, " %s", istr));
489 node_identifier = format_nid(value);
490 ND_PRINT((ndo, " NID: %s", node_identifier));
494 case DNCP_NODE_ENDPOINT: {
495 const char *node_identifier;
496 uint32_t endpoint_identifier;
498 ND_PRINT((ndo, " %s", istr));
501 node_identifier = format_nid(value);
502 endpoint_identifier = EXTRACT_32BITS(value + 4);
503 ND_PRINT((ndo, " NID: %s EPID: %08x",
510 case DNCP_NETWORK_STATE: {
513 ND_PRINT((ndo, " %s", istr));
516 hash = EXTRACT_64BITS(value);
517 ND_PRINT((ndo, " hash: %016" PRIx64, hash));
521 case DNCP_NODE_STATE: {
522 const char *node_identifier, *interval;
523 uint32_t sequence_number;
526 ND_PRINT((ndo, " %s", istr));
529 node_identifier = format_nid(value);
530 sequence_number = EXTRACT_32BITS(value + 4);
531 interval = format_interval(EXTRACT_32BITS(value + 8));
532 hash = EXTRACT_64BITS(value + 12);
533 ND_PRINT((ndo, " NID: %s seqno: %u %s hash: %016" PRIx64,
539 hncp_print_rec(ndo, value+20, bodylen-20, indent+1);
544 const char *peer_node_identifier;
545 uint32_t peer_endpoint_identifier, endpoint_identifier;
547 ND_PRINT((ndo, " %s", istr));
550 peer_node_identifier = format_nid(value);
551 peer_endpoint_identifier = EXTRACT_32BITS(value + 4);
552 endpoint_identifier = EXTRACT_32BITS(value + 8);
553 ND_PRINT((ndo, " Peer-NID: %s Peer-EPID: %08x Local-EPID: %08x",
554 peer_node_identifier,
555 peer_endpoint_identifier,
561 case DNCP_KEEP_ALIVE_INTERVAL: {
562 uint32_t endpoint_identifier;
563 const char *interval;
565 ND_PRINT((ndo, " %s", istr));
568 endpoint_identifier = EXTRACT_32BITS(value);
569 interval = format_interval(EXTRACT_32BITS(value + 4));
570 ND_PRINT((ndo, " EPID: %08x Interval: %s",
577 case DNCP_TRUST_VERDICT: {
579 ND_PRINT((ndo, " %s", istr));
582 ND_PRINT((ndo, " Verdict: %u Fingerprint: %s Common Name: ",
584 format_256(value + 4)));
585 safeputs(ndo, value + 36, bodylen - 36);
589 case HNCP_HNCP_VERSION: {
590 uint16_t capabilities;
593 ND_PRINT((ndo, " %s", istr));
596 capabilities = EXTRACT_16BITS(value + 2);
597 M = (uint8_t)((capabilities >> 12) & 0xf);
598 P = (uint8_t)((capabilities >> 8) & 0xf);
599 H = (uint8_t)((capabilities >> 4) & 0xf);
600 L = (uint8_t)(capabilities & 0xf);
601 ND_PRINT((ndo, " M: %u P: %u H: %u L: %u User-agent: ",
604 safeputs(ndo, value + 4, bodylen - 4);
608 case HNCP_EXTERNAL_CONNECTION: {
610 hncp_print_rec(ndo, value, bodylen, indent+1);
614 case HNCP_DELEGATED_PREFIX: {
616 if (bodylen < 9 || bodylen < 9 + (value[8] + 7) / 8) {
617 ND_PRINT((ndo, " %s", istr));
620 ND_PRINT((ndo, " VLSO: %s PLSO: %s Prefix: ",
621 format_interval(EXTRACT_32BITS(value)),
622 format_interval(EXTRACT_32BITS(value + 4))
624 l = print_prefix(ndo, value + 8, bodylen - 8);
626 ND_PRINT((ndo, "(length is invalid)"));
631 * We've already checked that we've captured the
632 * entire TLV, based on its length, so this will
633 * either be -1, meaning "the prefix length is
634 * greater than the longest possible address of
635 * that type" (i.e., > 32 for IPv4 or > 128 for
636 * IPv6", or -3, meaning "the prefix runs past
637 * the end of the TLV".
639 ND_PRINT((ndo, " %s", istr));
645 hncp_print_rec(ndo, value + l, bodylen - l, indent+1);
649 case HNCP_PREFIX_POLICY: {
653 ND_PRINT((ndo, " %s", istr));
657 ND_PRINT((ndo, " type: "));
660 ND_PRINT((ndo, " %s", istr));
663 ND_PRINT((ndo, "Internet connectivity"));
664 } else if (policy >= 1 && policy <= 128) {
665 ND_PRINT((ndo, "Dest-Prefix: "));
666 l = print_prefix(ndo, value, bodylen);
668 ND_PRINT((ndo, "(length is invalid)"));
673 * We've already checked that we've captured the
674 * entire TLV, based on its length, so this will
675 * either be -1, meaning "the prefix length is
676 * greater than the longest possible address of
677 * that type" (i.e., > 32 for IPv4 or > 128 for
678 * IPv6", or -3, meaning "the prefix runs past
679 * the end of the TLV".
681 ND_PRINT((ndo, " %s", istr));
684 } else if (policy == 129) {
685 ND_PRINT((ndo, "DNS domain: "));
686 print_dns_label(ndo, value+1, bodylen-1, 1);
687 } else if (policy == 130) {
688 ND_PRINT((ndo, "Opaque UTF-8: "));
689 safeputs(ndo, value + 1, bodylen - 1);
690 } else if (policy == 131) {
692 ND_PRINT((ndo, " %s", istr));
695 ND_PRINT((ndo, "Restrictive assignment"));
696 } else if (policy >= 132) {
697 ND_PRINT((ndo, "Unknown (%u)", policy)); /* Reserved for future additions */
702 case HNCP_DHCPV4_DATA: {
704 ND_PRINT((ndo, " %s", istr));
707 if (dhcpv4_print(ndo, value, bodylen, indent+1) != 0)
712 case HNCP_DHCPV6_DATA: {
714 ND_PRINT((ndo, " %s", istr));
717 if (dhcpv6_print(ndo, value, bodylen, indent+1) != 0) {
718 ND_PRINT((ndo, " %s", istr));
724 case HNCP_ASSIGNED_PREFIX: {
727 if (bodylen < 6 || bodylen < 6 + (value[5] + 7) / 8) {
728 ND_PRINT((ndo, " %s", istr));
731 prty = (uint8_t)(value[4] & 0xf);
732 ND_PRINT((ndo, " EPID: %08x Prty: %u",
733 EXTRACT_32BITS(value),
736 ND_PRINT((ndo, " Prefix: "));
737 if ((l = print_prefix(ndo, value + 5, bodylen - 5)) < 0) {
738 ND_PRINT((ndo, " %s", istr));
745 hncp_print_rec(ndo, value + l, bodylen - l, indent+1);
749 case HNCP_NODE_ADDRESS: {
750 uint32_t endpoint_identifier;
751 const char *ip_address;
753 ND_PRINT((ndo, " %s", istr));
756 endpoint_identifier = EXTRACT_32BITS(value);
757 ip_address = format_ip6addr(ndo, value + 4);
758 ND_PRINT((ndo, " EPID: %08x IP Address: %s",
763 hncp_print_rec(ndo, value + 20, bodylen - 20, indent+1);
767 case HNCP_DNS_DELEGATED_ZONE: {
768 const char *ip_address;
771 ND_PRINT((ndo, " %s", istr));
774 ip_address = format_ip6addr(ndo, value);
775 ND_PRINT((ndo, " IP-Address: %s %c%c%c ",
777 (value[16] & 4) ? 'l' : '-',
778 (value[16] & 2) ? 'b' : '-',
779 (value[16] & 1) ? 's' : '-'
781 len = print_dns_label(ndo, value+17, bodylen-17, 1);
783 ND_PRINT((ndo, " %s", istr));
789 hncp_print_rec(ndo, value+len, bodylen-len, indent+1);
793 case HNCP_DOMAIN_NAME: {
795 ND_PRINT((ndo, " %s", istr));
798 ND_PRINT((ndo, " Domain: "));
799 print_dns_label(ndo, value, bodylen, 1);
803 case HNCP_NODE_NAME: {
806 ND_PRINT((ndo, " %s", istr));
810 if (bodylen < 17 + l) {
811 ND_PRINT((ndo, " %s", istr));
814 ND_PRINT((ndo, " IP-Address: %s Name: ",
815 format_ip6addr(ndo, value)
818 safeputchar(ndo, '"');
819 safeputs(ndo, value + 17, l);
820 safeputchar(ndo, '"');
822 ND_PRINT((ndo, "%s", istr));
827 hncp_print_rec(ndo, value + l, bodylen - l, indent+1);
831 case HNCP_MANAGED_PSK: {
833 ND_PRINT((ndo, " %s", istr));
836 ND_PRINT((ndo, " PSK: %s", format_256(value)));
837 hncp_print_rec(ndo, value + 32, bodylen - 32, indent+1);
841 case RANGE_DNCP_RESERVED:
842 case RANGE_HNCP_UNASSIGNED:
843 case RANGE_DNCP_PRIVATE_USE:
844 case RANGE_DNCP_FUTURE_USE:
850 i += 4 + bodylen + (-bodylen & 3);
852 print_type_in_line(ndo, last_type_mask, last_type_count, indent, &first_one);
857 ND_PRINT((ndo, "%s", "[|hncp]"));
861 ND_PRINT((ndo, "%s", istr));