Skip to contentSkip to conversation

can: raw: return -ERANGE when filterset does not fit into user space buffer

RFC PATCH In review Oliver Hartkopp 3 participants 4 messages Dec 16, 2020 – Dec 18, 2020

Subsystems (2)
lore
Share & tools
lore

Oliver Hartkopp

author maintainer
#0 lore raw

RFC PATCH 1/1 can: raw: return -ERANGE when filterset does not fit into user space buffer

Multiple filters (struct can_filter) can be set with the setsockopt() function, which was originally intended as a write-only operation.

As getsockopt() also provides a CAN_RAW_FILTER option to read back the given filters, the caller has to provide an appropriate user space buffer. In the case this buffer is too small the getsockopt() silently truncates the filter information and gives no information about the needed space. This is safe but not convenient for the programmer.

In net/core/sock.c the SO_PEERGROUPS sockopt had a similar requirement and solved it by returning -ERANGE in the case that the provided data does not fit into the given user space buffer and fills the required size into optlen, so that the caller can retry with a matching buffer length.

This patch adopts this approach for CAN_RAW_FILTER getsockopt().

---
 net/can/raw.c | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)
net/can/raw.c +12 -4
index 6ec8aa1d0da4..37b47a39a3ed 100644
@@ -663,14 +663,22 @@ static int raw_getsockopt(struct socket *sock, int level, int optname,
 	case CAN_RAW_FILTER:
 		lock_sock(sk);
 		if (ro->count > 0) {
 			int fsize = ro->count * sizeof(struct can_filter);
 
-			if (len > fsize)
-				len = fsize;
-			if (copy_to_user(optval, ro->filter, len))
-				err = -EFAULT;
+			/* user space buffer to small for filter list? */
+			if (len < fsize) {
+				/* return -ERANGE and needed space in optlen */
+				err = -ERANGE;
+				if (put_user(fsize, optlen))
+					err = -EFAULT;
+			} else {
+				if (len > fsize)
+					len = fsize;
+				if (copy_to_user(optval, ro->filter, len))
+					err = -EFAULT;
+			}
 		} else {
 			len = 0;
 		}
 		release_sock(sk);
 
Signature · 1 line
2.29.2
Tested-by on v1 1/1
#1 lore raw
Quoted 21 lines · Oliver Hartkopp

Multiple filters (struct can_filter) can be set with the setsockopt() function, which was originally intended as a write-only operation.

As getsockopt() also provides a CAN_RAW_FILTER option to read back the
given filters, the caller has to provide an appropriate user space buffer.
In the case this buffer is too small the getsockopt() silently truncates
the filter information and gives no information about the needed space.
This is safe but not convenient for the programmer.

In net/core/sock.c the SO_PEERGROUPS sockopt had a similar requirement
and solved it by returning -ERANGE in the case that the provided data does not fit into the given user space buffer and fills the required size
into optlen, so that the caller can retry with a matching buffer length.

Quoted 4 lines

This patch adopts this approach for CAN_RAW_FILTER getsockopt().

Successfully tested this in my Java bindings.

~ Phillip

Quoted 40 lines

---
 net/can/raw.c | 16 ++++++++++++----

 1 file changed, 12 insertions(+), 4 deletions(-)
net/can/raw.c +0 -0
index 6ec8aa1d0da4..37b47a39a3ed 100644
@@ -663,14 +663,22 @@ static int raw_getsockopt(struct socket *sock,
 int level, int optname,

        case CAN_RAW_FILTER:
                lock_sock(sk);
                if (ro->count > 0) {
                        int fsize = ro->count * sizeof(struct can_filter);

-                       if (len > fsize)
-                               len = fsize;
-                       if (copy_to_user(optval, ro->filter, len)) -                               err = -EFAULT;
+                       /* user space buffer to small for filter list? */
+                       if (len < fsize) {
+                               /* return -ERANGE and needed space in optlen */
+                               err = -ERANGE;
+                               if (put_user(fsize, optlen)) +                                       err = -EFAULT;
+                       } else {
+                               if (len > fsize)
+                                       len = fsize;
+                               if (copy_to_user(optval, ro->filter, len))
+                                       err = -EFAULT;
+                       }
                } else {
                        len = 0;
                }
                release_sock(sk);

#2 lore raw
In reply to Oliver Hartkopp
Quoted 14 lines · Oliver Hartkopp

Multiple filters (struct can_filter) can be set with the setsockopt() function, which was originally intended as a write-only operation.

As getsockopt() also provides a CAN_RAW_FILTER option to read back the given filters, the caller has to provide an appropriate user space buffer. In the case this buffer is too small the getsockopt() silently truncates the filter information and gives no information about the needed space. This is safe but not convenient for the programmer.

In net/core/sock.c the SO_PEERGROUPS sockopt had a similar requirement and solved it by returning -ERANGE in the case that the provided data does not fit into the given user space buffer and fills the required size into optlen, so that the caller can retry with a matching buffer length.

Quoted 4 lines

This patch adopts this approach for CAN_RAW_FILTER getsockopt().

Added to linux-can-next/testing. Do we need an update to the in kernel Documentation?

Marc

Signature · 4 lines
Pengutronix e.K.                 | Marc Kleine-Budde           |
Embedded Linux                   | https://www.pengutronix.de  |
Vertretung West/Dortmund         | Phone: +49-231-2826-924     |
Amtsgericht Hildesheim, HRA 2686 | Fax:   +49-5121-206917-5555 |
author maintainer
#3 lore raw
Quoted 15 lines · Marc Kleine-Budde
Quoted 14 lines · Oliver Hartkopp

Multiple filters (struct can_filter) can be set with the setsockopt() function, which was originally intended as a write-only operation.

As getsockopt() also provides a CAN_RAW_FILTER option to read back the given filters, the caller has to provide an appropriate user space buffer. In the case this buffer is too small the getsockopt() silently truncates the filter information and gives no information about the needed space. This is safe but not convenient for the programmer.

In net/core/sock.c the SO_PEERGROUPS sockopt had a similar requirement and solved it by returning -ERANGE in the case that the provided data does not fit into the given user space buffer and fills the required size into optlen, so that the caller can retry with a matching buffer length.

Quoted 7 lines
Quoted 4 lines

This patch adopts this approach for CAN_RAW_FILTER getsockopt().

Added to linux-can-next/testing. Do we need an update to the in kernel Documentation?

Yes. Also thought about it.

Will prepare a patch for the documentation too.

Regards,
Oliver