icmp: support rfc 4884
Subsystems (3)
PATCH v2 1/1 icmp: support rfc 4884
From: Willem de Bruijn <[email protected]>
Add setsockopt SOL_IP/IP_RECVERR_4884 to return the offset to an extension struct if present.
ICMP messages may include an extension structure after the original datagram. RFC 4884 standardized this behavior. It stores the offset in words to the extension header in u8 icmphdr.un.reserved[1].
The field is valid only for ICMP types destination unreachable, time exceeded and parameter problem, if length is at least 128 bytes and entire packet does not exceed 576 bytes.
Return the offset to the start of the extension struct when reading an ICMP error from the error queue, if it matches the above constraints.
Do not return the raw u8 field. Return the offset from the start of the user buffer, in bytes. The kernel does not return the network and transport headers, so subtract those.
Also validate the headers. Return the offset regardless of validation, as an invalid extension must still not be misinterpreted as part of the original datagram. Note that !invalid does not imply valid. If the extension version does not match, no validation can take place, for instance.
For backward compatibility, make this optional, set by setsockopt SOL_IP/IP_RECVERR_RFC4884. For API example and feature test, see github.com/wdebruij/kerneltools/blob/master/tests/recv_icmp_v2.c
For forward compatibility, reserve only setsockopt value 1, leaving other bits for additional icmp extensions.
Changes
v1->v2:
- convert word offset to byte offset from start of user buffer
- return in ee_data as u8 may be insufficient
- define extension struct and object header structs
- return len only if constraints met
- if returning len, also validate
--- include/linux/icmp.h | 4 ++ include/net/inet_sock.h | 1 + include/uapi/linux/errqueue.h | 14 ++++++- include/uapi/linux/icmp.h | 22 +++++++++++ include/uapi/linux/in.h | 1 + net/ipv4/icmp.c | 71 +++++++++++++++++++++++++++++++++++ net/ipv4/ip_sockglue.c | 12 ++++++ 7 files changed, 124 insertions(+), 1 deletion(-)
include/linux/icmp.h +4 -0
@@ -15,6 +15,7 @@#include <linux/skbuff.h> #include <uapi/linux/icmp.h> +#include <uapi/linux/errqueue.h> static inline struct icmphdr *icmp_hdr (const struct sk_buff *skb) {
@@ -35,4 +36,7 @@ static inline bool icmp_is_err(int type) return false; } +void ip_icmp_error_rfc4884 (const struct sk_buff *skb, +struct sock_ee_data_rfc4884 *out); +#endif /* _LINUX_ICMP_H */
include/net/inet_sock.h +1 -0
@@ -225,6 +225,7 @@ struct inet_sock { mc_all:1 , nodefrag:1; __u8 bind_address_no_port:1, + recverr_rfc4884:1, defer_connect:1; /* Indicates that fastopen_connect is set* and cookie exists so we defer connect * until first data frame is written
include/uapi/linux/errqueue.h +13 -1
@@ -5,6 +5,13 @@#include <linux/types.h> #include <linux/time_types.h> +/* RFC 4884: return offset to extension struct + validation */ +struct sock_ee_data_rfc4884 { +__u16 len; +__u8 flags; +__u8 reserved; +}; +struct sock_extended_err {__u32 ee_errno;__u8 ee_origin;
@@ -12,7 +19,10 @@ struct sock_extended_err {__u8 ee_code;__u8 ee_pad;__u32 ee_info; -__u32 ee_data; +union { +__u32 ee_data; +struct sock_ee_data_rfc4884 ee_rfc4884; + }; };#define SO_EE_ORIGIN_NONE 0
@@ -31,6 +41,8 @@ struct sock_extended_err {#define SO_EE_CODE_TXTIME_INVALID_PARAM 1#define SO_EE_CODE_TXTIME_MISSED 2 +#define SO_EE_RFC4884_FLAG_INVALID 1 +/** * struct scm_timestamping - timestamps exposed through cmsg *
include/uapi/linux/icmp.h +22 -0
@@ -19,6 +19,7 @@#define _UAPI_LINUX_ICMP_H#include <linux/types.h> +#include <asm/byteorder.h> #define ICMP_ECHOREPLY 0/* Echo Reply */ #define ICMP_DEST_UNREACH 3/* Destination Unreachable */
@@ -95,5 +96,26 @@ struct icmp_filter { __u32 data; }; +/* RFC 4884 extension struct: one per message */ +struct icmp_ext_hdr { +#if defined(__LITTLE_ENDIAN_BITFIELD) +__u8 reserved1:4 , + version:4 ; +#elif defined(__BIG_ENDIAN_BITFIELD) +__u8 version:4 , + reserved1:4 ; +#else +#error "Please fix <asm/byteorder.h>" +#endif +__u8 reserved2; +__sum16 checksum; +}; + +/* RFC 4884 extension object header: one for each object */ +struct icmp_extobj_hdr { +__be16 length; +__u8 class_num; +__u8 class_type; +};#endif /* _UAPI_LINUX_ICMP_H */
include/uapi/linux/in.h +1 -0
@@ -123,6 +123,7 @@ struct in_addr {#define IP_CHECKSUM 23#define IP_BIND_ADDRESS_NO_PORT 24#define IP_RECVFRAGSIZE 25 +#define IP_RECVERR_RFC4884 26/* IP_MTU_DISCOVER values */ #define IP_PMTUDISC_DONT 0/* Never send DF frames */
net/ipv4/icmp.c +71 -0
77 lines not on this page · raw message
net/ipv4/ip_sockglue.c +12 -0
@@ -411,6 +411,9 @@ void ip_icmp_error(struct sock *sk, struct sk_buff *skb, int err, serr->port = port;if (skb_pull (skb, payload - skb->data)) { +if (inet_sk (sk)->recverr_rfc4884) +ip_icmp_error_rfc4884 (skb, &serr->ee.ee_rfc4884); +skb_reset_transport_header (skb);if (sock_queue_err_skb (sk, skb) ==0 )return ;
@@ -755,6 +758,7 @@ static int do_ip_setsockopt(struct sock *sk, int level,case IP_RECVORIGDSTADDR :case IP_CHECKSUM :case IP_RECVFRAGSIZE : +case IP_RECVERR_RFC4884 :if (optlen >=sizeof (int )) {if (get_user (val, (int __user *) optval))return -EFAULT ;
@@ -914,6 +918,11 @@ static int do_ip_setsockopt(struct sock *sk, int level,if (!val)skb_queue_purge (&sk->sk_error_queue);break ; +case IP_RECVERR_RFC4884 : +if (val <0 || val >1 ) + goto e_inval; + inet->recverr_rfc4884 = !!val; +break ;case IP_MULTICAST_TTL :if (sk->sk_type ==SOCK_STREAM ) goto e_inval;
@@ -1588,6 +1597,9 @@ static int do_ip_getsockopt(struct sock *sk, int level, int optname,case IP_RECVERR : val = inet->recverr;break ; +case IP_RECVERR_RFC4884 : + val = inet->recverr_rfc4884; +break ;case IP_MULTICAST_TTL : val = inet->mc_ttl;break ;
Signature · 1 line
2.27.0.383.g050319c2ae-goog
Quoted 42 lines · Willem de Bruijn
From: Willem de Bruijn <[email protected]>
Add setsockopt SOL_IP/IP_RECVERR_4884 to return the offset to an extension struct if present.
ICMP messages may include an extension structure after the original datagram. RFC 4884 standardized this behavior. It stores the offset in words to the extension header in u8 icmphdr.un.reserved[1].
The field is valid only for ICMP types destination unreachable, time exceeded and parameter problem, if length is at least 128 bytes and entire packet does not exceed 576 bytes.
Return the offset to the start of the extension struct when reading an ICMP error from the error queue, if it matches the above constraints.
Do not return the raw u8 field. Return the offset from the start of the user buffer, in bytes. The kernel does not return the network and transport headers, so subtract those.
Also validate the headers. Return the offset regardless of validation, as an invalid extension must still not be misinterpreted as part of the original datagram. Note that !invalid does not imply valid. If the extension version does not match, no validation can take place, for instance.
For backward compatibility, make this optional, set by setsockopt SOL_IP/IP_RECVERR_RFC4884. For API example and feature test, see
github.com/wdebruij/kerneltools/blob/master/tests/recv_icmp_v2.cFor forward compatibility, reserve only setsockopt value 1, leaving other bits for additional icmp extensions.
Changes
v1->v2:
- convert word offset to byte offset from start of user buffer
- return inee_dataas u8 may be insufficient
- define extension struct and object header structs
- return len only if constraints met
- if returning len, also validate
Quoted 1 line
Signed-off-by Willem de Bruijn <[email protected]>
Tom, Eric, does this address your concerns from v1?
To summarize:
- cleaner api
- only return offset if rfc 4884 constraints met
- return as byte offset from start of user buffer, not raw packet off
- define self-describing new union in sock_extended_err
- define rfc 4884 extension struct and objects in uapi
- validate
- verify checksum
- verify object boundaries
Does not
- validate individual users from subsequent RFCs: a number of classes and subtypes are defined in an IANA registry [1]. But unlike rfc 4884 those are at best proposed standards, some not updated since 2015. I don't think those are mature enough to encode in the kernel ABI.
- truncate packet for socket matching: I think that should be a separate (stable) commit if a real issue. Personally, I'm not convinced yet that it is. The 128B original datagram + outer header minimum offset concerns IPv4, where packet is at most 576B. For IPv6, which has the extension header issue, the relevant rfc 4443 states that that the length should be 1280. More importantly, it would take a malicious/buggy sender to craft a packet with an extension header that overlaps the headers. But it does not need to mess with the extension header offset field to create such a payload to begin with.
[1] https://www.iana.org/assignments/icmp-parameters/icmp-parameters.xhtml#icmp-parameters-ext-classes
From: Willem de Bruijn <[email protected]>
Date: Fri, 10 Jul 2020 09:29:02 -0400
Quoted 41 lines
From: Willem de Bruijn <[email protected]>
Add setsockopt SOL_IP/IP_RECVERR_4884 to return the offset to an extension struct if present.
ICMP messages may include an extension structure after the original datagram. RFC 4884 standardized this behavior. It stores the offset in words to the extension header in u8 icmphdr.un.reserved[1].
The field is valid only for ICMP types destination unreachable, time exceeded and parameter problem, if length is at least 128 bytes and entire packet does not exceed 576 bytes.
Return the offset to the start of the extension struct when reading an ICMP error from the error queue, if it matches the above constraints.
Do not return the raw u8 field. Return the offset from the start of the user buffer, in bytes. The kernel does not return the network and transport headers, so subtract those.
Also validate the headers. Return the offset regardless of validation, as an invalid extension must still not be misinterpreted as part of the original datagram. Note that !invalid does not imply valid. If the extension version does not match, no validation can take place, for instance.
For backward compatibility, make this optional, set by setsockopt SOL_IP/IP_RECVERR_RFC4884. For API example and feature test, see
github.com/wdebruij/kerneltools/blob/master/tests/recv_icmp_v2.cFor forward compatibility, reserve only setsockopt value 1, leaving other bits for additional icmp extensions.
Changes
v1->v2:
- convert word offset to byte offset from start of user buffer
- return inee_dataas u8 may be insufficient
- define extension struct and object header structs
- return len only if constraints met
- if returning len, also validate
Quoted 1 line
Signed-off-by Willem de Bruijn <[email protected]>
Applied, thanks Willem.