From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-16.4 required=3.0 tests=DKIMWL_WL_MED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, MENTIONS_GIT_HOSTING,SPF_HELO_NONE,SPF_PASS,USER_AGENT_GIT, USER_IN_DEF_DKIM_WL autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 30131C43603 for ; Wed, 18 Dec 2019 19:27:08 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 054A2206D7 for ; Wed, 18 Dec 2019 19:27:07 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b="XhtkzLSf" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1727490AbfLRT1H (ORCPT ); Wed, 18 Dec 2019 14:27:07 -0500 Received: from mail-qv1-f73.google.com ([209.85.219.73]:38774 "EHLO mail-qv1-f73.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726699AbfLRT1F (ORCPT ); Wed, 18 Dec 2019 14:27:05 -0500 Received: by mail-qv1-f73.google.com with SMTP id ce17so2032137qvb.5 for ; Wed, 18 Dec 2019 11:27:03 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20161025; h=date:message-id:mime-version:subject:from:to:cc; bh=TVGdYk+xoUeaPiO0H9f6MWnkivghvA1sBOueLHicqQ4=; b=XhtkzLSf9aomRjhnviFpUv3OXk7Hjoow5GlAYB1/OUFQvyDXgEb3ltN/xHWwIqfyv4 JfkncybKTW0KTqzLnFts5ZraA0+Ld83WOcKkpeNeqzrXjJAxi+NcR70I/PRqw8ahJShA BcLqNW1AeQSUPVuonylwW6FMsOlU8lewzwvWdHzFQv1V131Ag7eguCWjNybCoP3UPkgC 22I2DP/lV1BhadPlfZZRycpSO8+SgPfxr7wDFwtKzZOchogUZjyuC0Sknoj7l6DHlDxk 5iw9LgYnOplLJ56So06hig0/yFMq5TUfhbfYTaTOfORNaKvtIMnjNJOanAD2YjQEF5KV ja2Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:message-id:mime-version:subject:from:to:cc; bh=TVGdYk+xoUeaPiO0H9f6MWnkivghvA1sBOueLHicqQ4=; b=TJXDzVjRscvEc9gXa8qV/jbSWuPp03HcQnoBgCwDDcNQfq1bVHhvAeRphasAaU85kB bMBEUVxCm9t7KXeTXXF9CCCLeAvrDvGymnR2IBX3yvq7zP6QvQEXlg7Dear3NSfF4noJ xL9mlqqqMeW+Pr6Txkxwh3y5EpYOeNcgvkib2uoNrPq8SZNudrTfMU/9B8PyBmiMrBy1 w0zbSVwiGgHCHGJL/zAkWdNKNfPxyZ5mNkPkFks3CiIaHXFdHCtihm5M9Rhg+3dgbMiV uf1LfHj5G9lIVvmUXHZyWhNTLBzIdZlab4u59bCyHT3IW+hMJ6SW9v0YsLERpWkZHJNW od9A== X-Gm-Message-State: APjAAAXB74QsMNpCLVtzo7nN4U36tGOQwXkN/JD8dfLWPp+ikZhUf/b0 EW9qlOvKrqE8X3vnfjJoRBw0Zj+bsoG+nbtRcisWbPB7ia6zFB4P/ex2FukcmDP4tTjjATi9Uyu JrBbxkdZQa7A6bm1Yiv8mNQWF7r06lRyF3ejQBKepK8Wl3Vc/8cQAvxcwql2Y89yMK8x17wxgT1 da X-Google-Smtp-Source: APXvYqzrIDbluclhkbrlfM/Big9TGT60Egl7TBvwLUB7Cnm5H3NtJY7Lk/gKvdgTDBfTp5yv5ZG6ZNsZxg7onu3e X-Received: by 2002:ad4:4810:: with SMTP id g16mr3853583qvy.22.1576697222665; Wed, 18 Dec 2019 11:27:02 -0800 (PST) Date: Wed, 18 Dec 2019 20:26:56 +0100 Message-Id: Mime-Version: 1.0 X-Mailer: git-send-email 2.24.1.735.g03f4e72817-goog Subject: [PATCH v4 0/1] usb: gadget: add raw-gadget interface From: Andrey Konovalov To: linux-usb@vger.kernel.org, linux-kernel@vger.kernel.org, Greg Kroah-Hartman , Alan Stern Cc: Jonathan Corbet , Felipe Balbi , Dmitry Vyukov , Alexander Potapenko , Marco Elver , Andrey Konovalov Content-Type: text/plain; charset="UTF-8" Sender: linux-usb-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-usb@vger.kernel.org This patchset (currently a single patch) adds a new userspace interface for the USB Gadget subsystem called USB Raw Gadget (I don't mind changing the name to something else if there are better ideas). This is what currently being used to enable coverage-buided USB fuzzing with syzkaller: https://github.com/google/syzkaller/blob/master/docs/linux/external_fuzzing_usb.md Initially I was using GadgetFS (together with the Dummy HCD/UDC module) to perform emulation of USB devices for fuzzing, but later switched to a custom written interface. The incentive to implement a different interface was to provide a somewhat raw and direct access to the USB Gadget layer for the userspace, where every USB request is passed to the userspace to get a response. See documentation for the list of differences between Raw Gadget and GadgetFS. This patchset has been pushed to the public Linux kernel Gerrit instance: https://linux-review.googlesource.com/c/linux/kernel/git/torvalds/linux/+/2144 Changes v3 -> v4: - Print debug message when maxpacket check fails. - Use module_misc_device() instead of module_init/exit(). - Reuse DRIVER_NAME macro in raw_device struct definition. - Don't print WARNING in raw_release(). - Add comment that explains locking into raw_event_queue_fetch(). - Print a WARNING when event queue size is exceeded. - Rename raw.c to raw_gadget.c. - Mention module name in Kconfig. - Reworked logging to use dev_err/dbg() instead of pr_err/debug(). Changes v2 -> v3: - Updated device path in documentation. - Changed usb_raw_init struct layout to make it the same for 32 bit compat mode. - Added compat_ioctl to raw_fops. - Changed raw_ioctl_init() to return EINVAL for invalid USB speeds, except for USB_SPEED_UNKNOWN, which defaults to USB_SPEED_HIGH. - Reject endpoints with maxpacket = 0 in raw_ioctl_ep_enable(). Changes v1 -> v2: - Moved raw.c to legacy/. - Changed uapi header to use __u* types. - Switched from debugfs entry to a misc device. - Changed raw_dev from refcount to kref. - Moved UDC_NAME_LENGTH_MAX to uapi headers. - Used usb_endpoint_type() and usb_endpoint_dir_in/out() functions instead of open coding them. - Added "WITH Linux-syscall-note" to SPDX id in the uapi header. - Removed pr_err() if case dev_new() fails. - Reduced the number of debugging messages. Andrey Konovalov (1): usb: gadget: add raw-gadget interface Documentation/usb/index.rst | 1 + Documentation/usb/raw-gadget.rst | 59 ++ drivers/usb/gadget/legacy/Kconfig | 11 + drivers/usb/gadget/legacy/Makefile | 1 + drivers/usb/gadget/legacy/raw_gadget.c | 1071 ++++++++++++++++++++++++ include/uapi/linux/usb/raw_gadget.h | 167 ++++ 6 files changed, 1310 insertions(+) create mode 100644 Documentation/usb/raw-gadget.rst create mode 100644 drivers/usb/gadget/legacy/raw_gadget.c create mode 100644 include/uapi/linux/usb/raw_gadget.h -- 2.24.1.735.g03f4e72817-goog