From patchwork Sat Feb 4 12:15:01 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?b?SsOzIMOBZ2lsYSBCaXRzY2g=?= X-Patchwork-Id: 52767 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:eb09:0:0:0:0:0 with SMTP id s9csp1332408wrn; Sat, 4 Feb 2023 04:36:28 -0800 (PST) X-Google-Smtp-Source: AK7set+vrUySc8NxUPSPDJ85bzHSZM5H6EIHb4XLfn7onZ9/bfd6AEnqmKy64YwwCfGG6Ad6hQbc X-Received: by 2002:a05:6a00:3254:b0:593:b13a:c4f5 with SMTP id bn20-20020a056a00325400b00593b13ac4f5mr11965227pfb.29.1675514187783; Sat, 04 Feb 2023 04:36:27 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1675514187; cv=none; d=google.com; s=arc-20160816; b=RKzaYrHBOjgqGGQ5NUiTza5WppkTscpwZft0ICdqsG/vSN1jR+zJ7sPwQ8jKq4RRkW YH99JDgjWZJ3MEfqX6OnTTL+oFlHyq4ri2LFhChgqK+pXZKfyB9XLyeauVJyS30JrhKc +k1Ry/GbIEaXZI4kORVSQ+pBHPjCUKmBnhT/d1/Be/o/TqTrgBp2eqcr+4JGPYumnnr4 Jsn3QTBGQ3qIgeMSfmH13T0xMOB+6R7FappA7mLWnnUC9Vy4tFlxkl8fPLC7A4MnTU+H QvnQ1YD2hT5kG2ZChVl7PZ3lBsJocHqGDo5fSCEf6MuqPjct/FND+CIahVKF5KH3HZEg M/KA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:in-reply-to:content-transfer-encoding :content-disposition:mime-version:message-id:subject:to:from:date :dkim-signature; bh=DcLZda2GIW9FF0wLQg8CZVOr2LxDbAuDjShayw2MbDs=; b=en2mR60IlUpTVAyihNP8tJR2ewGGkzAbsg/Is3AihsOvk2t8scwRzSlVBcNXRF/X6N N5f9QKINlVvS2vWA5ubXoX58ZxISg3CCjUs3nbhBIE4NtBYg2ZnGuZRDPLWfaaXzfkGh qEg8MLZ+S8Fagw5iwMW3u9+8ijIZlX+nw+pK71fbXViP5yWJ79jDxh8xw4oV6cWOm9FU d3FPG3Xie2/Si+euH49dqFPinVzo0530PPNeD4EcYapNpn3swEAVehSILF5gI6Ik/Ev+ OpSbpOyeM/LL40cRU3LPOweUFLY4DsL9ZBV743beDwjFr54BkMAu80dQNntXU4PsxHiD +zKA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20210112 header.b=XUSif1Fp; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id j186-20020a6255c3000000b00590569bc56esi5466090pfb.298.2023.02.04.04.36.09; Sat, 04 Feb 2023 04:36:27 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20210112 header.b=XUSif1Fp; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232338AbjBDMPI (ORCPT + 99 others); Sat, 4 Feb 2023 07:15:08 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:44042 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229877AbjBDMPG (ORCPT ); Sat, 4 Feb 2023 07:15:06 -0500 Received: from mail-ej1-x62d.google.com (mail-ej1-x62d.google.com [IPv6:2a00:1450:4864:20::62d]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id E962613DD3; Sat, 4 Feb 2023 04:15:04 -0800 (PST) Received: by mail-ej1-x62d.google.com with SMTP id mf7so22173709ejc.6; Sat, 04 Feb 2023 04:15:04 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=in-reply-to:content-transfer-encoding:content-disposition :mime-version:message-id:subject:to:from:date:from:to:cc:subject :date:message-id:reply-to; bh=DcLZda2GIW9FF0wLQg8CZVOr2LxDbAuDjShayw2MbDs=; b=XUSif1Fp5FlrgbeYWO8T4vmfWe++TAT9Td+cvqsfyqMtthQx0Xoj5FeEkUIEnE/6j5 Dk9QrMWsjSQR22ef2Q777/XZZ8xfQBUFLxt77eXVR3+ArQbzv+CfjHliDIohcb+FhA+X cyrGVEGMcGMb4Vn3r48iBxp2ZN9SkRuPQhfP5YedlgnG+GbYR9mfPkecROK1yA2QtTmf 0ygi2Q6ptXh7H9hHj/zFGhrndz3RSvcwByLxkHHNdASlDu/x0BNaUQBVD0vHSJLO5ruU SDb0x3ZTeDskoiV2uyEFxubWaoVRvEni4TfFOKeqsyIl/2pdcI9Bh0XdPYpj+xNKA492 mpbA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=in-reply-to:content-transfer-encoding:content-disposition :mime-version:message-id:subject:to:from:date:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=DcLZda2GIW9FF0wLQg8CZVOr2LxDbAuDjShayw2MbDs=; b=v1DNpUdnSiboHLOkLw2X2yjG78YdZ1g606CJ7T5atgSHzHIhaT7A5J7BlAYcpcCE6+ RU5U5WmwoV7AunavzvlVxgtHTFQa72rQfihpzYWTZZHDORX51ZbesWK3ZrOwsrHOITDb vfeTIrvkd4HmuaWtswU/EgC0A1+xwGbmPaeYNncZnCZ67DwN5jFtL3pCjtaNgD0gJO5S ehiXrFyJHJRmJsTW1nUGJzVhI9+2+B47DLZwSkDByj6PDUHVvtxMULEdI5wI14RlYdYa a8oX9dGuXw7sOR5bXGmLeo2OumdtNA8nJGRKMK8aDUXKQ0fRBj21kUkQUmsnjPwQ8Jra H77w== X-Gm-Message-State: AO0yUKX3uF8TjtCtf8hCX6m8dWvm7I2ZP3bQKBThkhwZGwc012CTMP5d yxTEjjdZUjYVnAB1uLHdUm/J/eXp668= X-Received: by 2002:a17:907:7b99:b0:88d:ba89:1846 with SMTP id ne25-20020a1709077b9900b0088dba891846mr10375569ejc.23.1675512903081; Sat, 04 Feb 2023 04:15:03 -0800 (PST) Received: from jo-einhundert ([2a02:908:13d6:2180:e7f7:5368:343b:83fd]) by smtp.gmail.com with ESMTPSA id c21-20020a056402101500b004a2440f0150sm2402992edu.97.2023.02.04.04.15.02 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 04 Feb 2023 04:15:02 -0800 (PST) Date: Sat, 4 Feb 2023 13:15:01 +0100 From: =?iso-8859-1?q?J=F3_=C1gila?= Bitsch To: Greg KH , Stephen Rothwell , Linux Kernel Mailing List , Linux Next Mailing List , linux-usb@vger.kernel.org Subject: [PATCH v2] usb: gadget: add doc to struct usb_composite_dev Message-ID: MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM, RCVD_IN_DNSWL_NONE,SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1756016666360727659?= X-GMAIL-MSGID: =?utf-8?q?1756903964861196926?= Added documentation to new struct members for WebUSB: * bcd_webusb_version * b_webusb_vendor_code * landing_page * use_webusb to avoid warnings in the build of htmldocs Fixes: 93c473948c58 ("usb: gadget: add WebUSB landing page support") Reported-by: Stephen Rothwell Signed-off-by: Jó Ágila Bitsch --- V0 -> V1: added Reported-By and Fixes Tags V1 -> V2: fixed Reported-by tag (capitalization of "-by" was wrong) also post to linux-usb include/linux/usb/composite.h | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/include/linux/usb/composite.h b/include/linux/usb/composite.h index 91d22c3ed458..7ef8cea67f50 100644 --- a/include/linux/usb/composite.h +++ b/include/linux/usb/composite.h @@ -432,6 +432,10 @@ static inline struct usb_composite_driver *to_cdriver( * @qw_sign: qwSignature part of the OS string * @b_vendor_code: bMS_VendorCode part of the OS string * @use_os_string: false by default, interested gadgets set it + * @bcd_webusb_version: 0x0100 by default, WebUSB specification version + * @b_webusb_vendor_code: 0x0 by default, vendor code for WebUSB + * @landing_page: empty by default, landing page to announce in WebUSB + * @use_webusb:: false by default, interested gadgets set it * @os_desc_config: the configuration to be used with OS descriptors * @setup_pending: true when setup request is queued but not completed * @os_desc_pending: true when os_desc request is queued but not completed