Skip to contentSkip to conversation

usb: gadget: f_hid: only clear write_pending from the owning request

PATCH In review Hyeontae Lee 2 participants 2 messages Aug 14

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

PATCH 1/1 usb: gadget: f_hid: only clear write_pending from the owning request

f_hidg_write() sets write_pending, caches hidg->req into a stack local, and drops write_spinlock across copy_from_user(). hidg_disable() frees hidg->req whenever write_pending is clear, so that flag is the only thing keeping the writer's cached pointer alive.

f_hidg_req_complete() clears it for whichever request completes, not for the one the writer owns. A write() that has queued a request leaves it queued indefinitely if the host never issues an IN token. When the host then disables the configuration, usb_ep_disable() gives that old request back, its completion clears write_pending, and hidg_disable() goes on to free hidg->req - which a different write() is holding at that moment.

The writer resumes, finds hidg->req NULL, and frees its cached pointer a second time:

  BUG: KASAN: slab-use-after-free in f_hidg_write+0x7b7/0x920
  Read of size 8 at addr ffff888104fc9018 by task s4-3/163

  Allocated by task 0:
   alloc_ep_req+0x20/0x1b0
   hidg_set_alt+0x1ed/0xbd0
   composite_setup+0x1072/0x8690
   configfs_composite_setup+0xcd/0x110
   dummy_timer+0x1a68/0x31d0

  Freed by task 0:
   kfree+0x121/0x380
   hidg_disable+0x559/0x7a0
   reset_config+0x9d/0x200
   composite_setup+0x32d4/0x8690
   configfs_composite_setup+0xcd/0x110
   dummy_timer+0x1a68/0x31d0

  The buggy address belongs to the object at ffff888104fc9000
   which belongs to the cache kmalloc-128 of size 128

  BUG: KASAN: double-free in f_hidg_write+0x267/0x920

Record which request owns the flag and let only that request's completion clear it. An older queued request being given back then leaves write_pending set, hidg_disable() declines to free, and the writer frees its own request on the existing path.

Fixes 25cd9721c2b1 ("usb: gadget: f_hid: fix: Don't access hidg->req without spinlock held")

---
Notes for reviewers:

The clearer was identified by instrumenting the three sites that clear the
flag: of 4944 frees at hidg_disable(), all 4944 followed a clear from f_hidg_req_complete(), and 4440 freed a request a writer was holding.

749494b6bdbb introduced the stack local but left the uses on hidg->req, so check and use still agreed; 25cd9721c2b1 moved the uses to the local and left the guard on the field, which is why that one is tagged.

Every dereference of the freed pointer is inside f_hidg_write(), so this is not remotely triggerable on its own - a local process must be writing to /dev/hidgN at the time.

hidg_disable() now declines to free a request a writer owns; f_hid's request lifetime under repeated SET_INTERFACE has pre-existing gaps this does not address.

Tested on v7.2-rc7-12 (f5bbbfec59b4) under dummy_hcd, report_length=8: over 45 s of identical workload, double frees of the same address went from 52 to 0 and KASAN reports from 208 to 0.

---
 drivers/usb/gadget/function/f_hid.c | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)
drivers/usb/gadget/function/f_hid.c +16 -1
index 3c6b43d06a6d1..d65169c9645b1 100644
@@ -89,6 +89,7 @@ struct f_hidg {
 	/* send report */
 	spinlock_t			write_spinlock;
 	bool				write_pending;
+	struct usb_request		*write_req;
 	wait_queue_head_t		write_queue;
 	struct usb_request		*req;
 
@@ -443,7 +444,16 @@ static void f_hidg_req_complete(struct usb_ep *ep, struct usb_request *req)
 	}
 
 	spin_lock_irqsave(&hidg->write_spinlock, flags);
-	hidg->write_pending = 0;
+	/*
+	 * Only the completion of the request this writer owns may clear the
+	 * flag. usb_ep_disable() gives back whatever is still queued from an
+	 * earlier write(), and letting that clear write_pending lets
+	 * hidg_disable() go on to free a request a writer is still holding.
+	 */
+	if (req == hidg->write_req) {
+		hidg->write_req = NULL;
+		hidg->write_pending = 0;
+	}
 	spin_unlock_irqrestore(&hidg->write_spinlock, flags);
 	wake_up(&hidg->write_queue);
 }
@@ -480,6 +490,7 @@ static ssize_t f_hidg_write(struct file *file, const char __user *buffer,
 
 	hidg->write_pending = 1;
 	req = hidg->req;
+	hidg->write_req = req;
 	count  = min_t(unsigned, count, hidg->report_length);
 
 	spin_unlock_irqrestore(&hidg->write_spinlock, flags);
@@ -502,6 +513,8 @@ static ssize_t f_hidg_write(struct file *file, const char __user *buffer,
 
 	/* when our function has been disabled by host */
 	if (!hidg->req) {
+		if (hidg->write_req == req)
+			hidg->write_req = NULL;
 		free_ep_req(hidg->in_ep, req);
 		/*
 		 * TODO
@@ -534,6 +547,7 @@ static ssize_t f_hidg_write(struct file *file, const char __user *buffer,
 release_write_pending:
 	spin_lock_irqsave(&hidg->write_spinlock, flags);
 	hidg->write_pending = 0;
+	hidg->write_req = NULL;
 	spin_unlock_irqrestore(&hidg->write_spinlock, flags);
 
 	wake_up(&hidg->write_queue);
@@ -1102,6 +1116,7 @@ static int hidg_set_alt(struct usb_function *f, unsigned intf, unsigned alt)
 		spin_lock_irqsave(&hidg->write_spinlock, flags);
 		hidg->req = req_in;
 		hidg->write_pending = 0;
+		hidg->write_req = NULL;
 		spin_unlock_irqrestore(&hidg->write_spinlock, flags);
 
 		wake_up(&hidg->write_queue);
Signature · 1 line
2.43.0
#1 lore raw
Quoted 61 lines · Hyeontae Lee

f_hidg_write() sets write_pending, caches hidg->req into a stack local, and drops write_spinlock across copy_from_user(). hidg_disable() frees hidg->req whenever write_pending is clear, so that flag is the only thing keeping the writer's cached pointer alive.

f_hidg_req_complete() clears it for whichever request completes, not for the one the writer owns. A write() that has queued a request leaves it queued indefinitely if the host never issues an IN token. When the host then disables the configuration, usb_ep_disable() gives that old request back, its completion clears write_pending, and hidg_disable() goes on to free hidg->req - which a different write() is holding at that moment.

The writer resumes, finds hidg->req NULL, and frees its cached pointer a second time:

  BUG: KASAN: slab-use-after-free in f_hidg_write+0x7b7/0x920
  Read of size 8 at addr ffff888104fc9018 by task s4-3/163

  Allocated by task 0:
   alloc_ep_req+0x20/0x1b0
   hidg_set_alt+0x1ed/0xbd0
   composite_setup+0x1072/0x8690
   configfs_composite_setup+0xcd/0x110
   dummy_timer+0x1a68/0x31d0

  Freed by task 0:
   kfree+0x121/0x380
   hidg_disable+0x559/0x7a0
   reset_config+0x9d/0x200
   composite_setup+0x32d4/0x8690
   configfs_composite_setup+0xcd/0x110
   dummy_timer+0x1a68/0x31d0

  The buggy address belongs to the object at ffff888104fc9000
   which belongs to the cache kmalloc-128 of size 128

  BUG: KASAN: double-free in f_hidg_write+0x267/0x920

Record which request owns the flag and let only that request's completion clear it. An older queued request being given back then leaves write_pending set, hidg_disable() declines to free, and the writer frees its own request on the existing path.

Fixes 25cd9721c2b1 ("usb: gadget: f_hid: fix: Don't access hidg->req without spinlock held")

---
Notes for reviewers:

The clearer was identified by instrumenting the three sites that clear the
flag: of 4944 frees at hidg_disable(), all 4944 followed a clear from f_hidg_req_complete(), and 4440 freed a request a writer was holding.

749494b6bdbb introduced the stack local but left the uses on hidg->req, so check and use still agreed; 25cd9721c2b1 moved the uses to the local and left the guard on the field, which is why that one is tagged.

Every dereference of the freed pointer is inside f_hidg_write(), so this is not remotely triggerable on its own - a local process must be writing to /dev/hidgN at the time.

Quoted 7 lines

hidg_disable() now declines to free a request a writer owns; f_hid's request lifetime under repeated SET_INTERFACE has pre-existing gaps this does not address.

Tested on v7.2-rc7-12 (f5bbbfec59b4) under dummy_hcd, report_length=8: over 45 s of identical workload, double frees of the same address went from 52 to 0 and KASAN reports from 208 to 0.

Did you forget to add an Assisted-by: tag?

Quoted 17 lines
---
 drivers/usb/gadget/function/f_hid.c | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)
drivers/usb/gadget/function/f_hid.c +1 -0
index 3c6b43d06a6d1..d65169c9645b1 100644
@@ -89,6 +89,7 @@ struct f_hidg {
 	/* send report */
 	spinlock_t			write_spinlock;
 	bool				write_pending;
+	struct usb_request		*write_req;
 	wait_queue_head_t		write_queue;
 	struct usb_request		*req;
 

drivers/usb/gadget/function/f_hid.c static void f_hidg_req_complete(struct usb_ep *ep, struct usb_request *req) · line 451

Quoted 9 lines
drivers/usb/gadget/function/f_hid.c +5 -1
@@ -443,7 +444,16 @@ static void f_hidg_req_complete(struct usb_ep *ep, struct usb_request *req)
 	}
 
 	spin_lock_irqsave(&hidg->write_spinlock, flags);
-	hidg->write_pending = 0;
+	/*
+	 * Only the completion of the request this writer owns may clear the
+	 * flag. usb_ep_disable() gives back whatever is still queued from an
+	 * earlier write(), and letting that clear write_pending lets
+	 * hidg_disable() go on to free a request a writer is still holding.

LLMs love to add comments when it's not needed, be judicious please.

thanks,

greg k-h