All of lore.kernel.org
 help / color / mirror / Atom feed
From: Sebastian Andrzej Siewior <bigeasy@linutronix.de>
To: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Cc: linux-media@vger.kernel.org,
	Mauro Carvalho Chehab <mchehab@kernel.org>,
	linux-usb@vger.kernel.org, tglx@linutronix.de,
	Greg Kroah-Hartman <gregkh@linuxfoundation.org>,
	Alan Stern <stern@rowland.harvard.edu>
Subject: [PATCH] USB: note that usb_fill_int_urb() can be used used for ISOC urbs.
Date: Wed, 20 Jun 2018 17:20:07 +0200	[thread overview]
Message-ID: <20180620152007.xapqkv4ww2hnmvkq@linutronix.de> (raw)
In-Reply-To: <18211658.4PQ3SEps0f@avalon>

Laurent suggested that the kerneldoc documentation could state that
usb_fill_int_urb() can also be used for the initialisation of an
isochronous urb. The USB documentation in
Documentation/driver-api/usb/URB.rst already mentions this, some drivers
do so and there is no explicit usb_fill_iso_urb().

Suggested-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Signed-off-by: Sebastian Andrzej Siewior <bigeasy@linutronix.de>
---
On 2018-06-20 17:14:53 [+0300], Laurent Pinchart wrote:
> > So you simply asking that the kerneldoc of usb_fill_int_urb() is
> > extended to mention isoc, too?
> 
> That would be nice I think.

here it is.

 include/linux/usb.h | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/include/linux/usb.h b/include/linux/usb.h
index 4cdd515a4385..c3a8bd586121 100644
--- a/include/linux/usb.h
+++ b/include/linux/usb.h
@@ -1657,7 +1657,8 @@ static inline void usb_fill_bulk_urb(struct urb *urb,
  *	the endpoint descriptor's bInterval value.
  *
  * Initializes a interrupt urb with the proper information needed to submit
- * it to a device.
+ * it to a device. This function can also be used to initialize an isochronous
+ * urb.
  *
  * Note that High Speed and SuperSpeed(+) interrupt endpoints use a logarithmic
  * encoding of the endpoint interval, and express polling intervals in
-- 
2.17.1

WARNING: multiple messages have this Message-ID (diff)
From: Sebastian Andrzej Siewior <bigeasy@linutronix.de>
To: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Cc: linux-media@vger.kernel.org,
	Mauro Carvalho Chehab <mchehab@kernel.org>,
	linux-usb@vger.kernel.org, tglx@linutronix.de,
	Greg Kroah-Hartman <gregkh@linuxfoundation.org>,
	Alan Stern <stern@rowland.harvard.edu>
Subject: USB: note that usb_fill_int_urb() can be used used for ISOC urbs.
Date: Wed, 20 Jun 2018 17:20:07 +0200	[thread overview]
Message-ID: <20180620152007.xapqkv4ww2hnmvkq@linutronix.de> (raw)

Laurent suggested that the kerneldoc documentation could state that
usb_fill_int_urb() can also be used for the initialisation of an
isochronous urb. The USB documentation in
Documentation/driver-api/usb/URB.rst already mentions this, some drivers
do so and there is no explicit usb_fill_iso_urb().

Suggested-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Signed-off-by: Sebastian Andrzej Siewior <bigeasy@linutronix.de>
---
On 2018-06-20 17:14:53 [+0300], Laurent Pinchart wrote:
> > So you simply asking that the kerneldoc of usb_fill_int_urb() is
> > extended to mention isoc, too?
> 
> That would be nice I think.

here it is.

 include/linux/usb.h | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/include/linux/usb.h b/include/linux/usb.h
index 4cdd515a4385..c3a8bd586121 100644
--- a/include/linux/usb.h
+++ b/include/linux/usb.h
@@ -1657,7 +1657,8 @@ static inline void usb_fill_bulk_urb(struct urb *urb,
  *	the endpoint descriptor's bInterval value.
  *
  * Initializes a interrupt urb with the proper information needed to submit
- * it to a device.
+ * it to a device. This function can also be used to initialize an isochronous
+ * urb.
  *
  * Note that High Speed and SuperSpeed(+) interrupt endpoints use a logarithmic
  * encoding of the endpoint interval, and express polling intervals in

  reply	other threads:[~2018-06-20 15:20 UTC|newest]

Thread overview: 100+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2018-06-20 11:00 medial: use irqsave() in URB completion + usb_fill_int_urb Sebastian Andrzej Siewior
2018-06-20 11:00 ` [PATCH 01/27] media: b2c2: use usb_fill_int_urb() Sebastian Andrzej Siewior
2018-06-20 11:00   ` [01/27] " Sebastian Andrzej Siewior
2018-06-20 11:00 ` [PATCH 02/27] media: cpia2_usb: " Sebastian Andrzej Siewior
2018-06-20 11:00   ` [02/27] " Sebastian Andrzej Siewior
2018-06-20 11:00 ` [PATCH 03/27] media: cx231xx: use usb_fill_XXX_urb() Sebastian Andrzej Siewior
2018-06-20 11:00   ` [03/27] " Sebastian Andrzej Siewior
2018-06-20 11:00 ` [PATCH 04/27] media: cx231xx: use irqsave() in USB's complete callback Sebastian Andrzej Siewior
2018-06-20 11:00   ` [04/27] " Sebastian Andrzej Siewior
2018-06-20 11:00 ` [PATCH 05/27] media: dvb-usb: use usb_fill_int_urb() Sebastian Andrzej Siewior
2018-06-20 11:00   ` [05/27] " Sebastian Andrzej Siewior
2018-06-20 11:00 ` [PATCH 06/27] media: dvb_usb_v2: " Sebastian Andrzej Siewior
2018-06-20 11:00   ` [06/27] " Sebastian Andrzej Siewior
2018-06-20 11:00 ` [PATCH 07/27] media: em28xx-audio: use GFP_KERNEL for memory allocation during init Sebastian Andrzej Siewior
2018-06-20 11:00   ` [07/27] " Sebastian Andrzej Siewior
2018-06-20 11:00 ` [PATCH 08/27] media: em28xx-audio: use irqsave() in USB's complete callback Sebastian Andrzej Siewior
2018-06-20 11:00   ` [08/27] " Sebastian Andrzej Siewior
2018-06-20 11:00 ` [PATCH 09/27] media: em28xx-audio: use usb_fill_int_urb() Sebastian Andrzej Siewior
2018-06-20 11:00   ` [09/27] " Sebastian Andrzej Siewior
2018-06-20 11:00 ` [PATCH 10/27] media: go7007: use irqsave() in USB's complete callback Sebastian Andrzej Siewior
2018-06-20 11:00   ` [10/27] " Sebastian Andrzej Siewior
2018-06-20 11:00 ` [PATCH 11/27] media: gspca: benq: use usb_fill_int_urb() Sebastian Andrzej Siewior
2018-06-20 11:00   ` [11/27] " Sebastian Andrzej Siewior
2018-06-20 11:00 ` [PATCH 12/27] media: gspca: gspca: use usb_fill_XXX_urb() Sebastian Andrzej Siewior
2018-06-20 11:00   ` [12/27] " Sebastian Andrzej Siewior
2018-06-20 11:00 ` [PATCH 13/27] media: gspca: konica: use usb_fill_int_urb() Sebastian Andrzej Siewior
2018-06-20 11:00   ` [13/27] " Sebastian Andrzej Siewior
2018-06-20 11:00 ` [PATCH 14/27] media: gspca: sq930x: use GFP_KERNEL in sd_dq_callback() Sebastian Andrzej Siewior
2018-06-20 11:00   ` [14/27] " Sebastian Andrzej Siewior
2018-06-20 11:00 ` [PATCH 15/27] media: msi2500: use usb_fill_int_urb() Sebastian Andrzej Siewior
2018-06-20 11:00   ` [15/27] " Sebastian Andrzej Siewior
2018-06-20 11:00 ` [PATCH 16/27] media: pwc: " Sebastian Andrzej Siewior
2018-06-20 11:00   ` [16/27] " Sebastian Andrzej Siewior
2018-06-20 11:00 ` [PATCH 17/27] media: stk1160: " Sebastian Andrzej Siewior
2018-06-20 11:00   ` [17/27] " Sebastian Andrzej Siewior
2018-06-20 11:00 ` [PATCH 18/27] media: stkwebcam: " Sebastian Andrzej Siewior
2018-06-20 11:00   ` [18/27] " Sebastian Andrzej Siewior
2018-06-20 11:00 ` [PATCH 19/27] media: tm6000: use irqsave() in USB's complete callback Sebastian Andrzej Siewior
2018-06-20 11:00   ` [19/27] " Sebastian Andrzej Siewior
2018-06-20 11:00 ` [PATCH 20/27] media: ttusb-budget: use usb_fill_int_urb() Sebastian Andrzej Siewior
2018-06-20 11:00   ` [20/27] " Sebastian Andrzej Siewior
2018-06-20 11:00 ` [PATCH 21/27] media: ttusb-dec: " Sebastian Andrzej Siewior
2018-06-20 11:00   ` [21/27] " Sebastian Andrzej Siewior
2018-06-20 11:01 ` [PATCH 22/27] media: ttusbir: " Sebastian Andrzej Siewior
2018-06-20 11:01   ` [22/27] " Sebastian Andrzej Siewior
2018-06-20 20:50   ` [PATCH 22/27] " Sean Young
2018-06-20 20:50     ` [22/27] " Sean Young
2018-06-21  7:37     ` [PATCH 22/27] " Sebastian Andrzej Siewior
2018-06-21  7:37       ` [22/27] " Sebastian Andrzej Siewior
2018-06-20 11:01 ` [PATCH 23/27] media: usbtv: use irqsave() in USB's complete callback Sebastian Andrzej Siewior
2018-06-20 11:01   ` [23/27] " Sebastian Andrzej Siewior
2018-06-20 11:01 ` [PATCH 24/27] media: usbtv: use usb_fill_int_urb() Sebastian Andrzej Siewior
2018-06-20 11:01   ` [24/27] " Sebastian Andrzej Siewior
2018-06-20 11:01 ` [PATCH 25/27] media: usbvision: remove time_in_irq Sebastian Andrzej Siewior
2018-06-20 11:01   ` [25/27] " Sebastian Andrzej Siewior
2018-06-20 11:01 ` [PATCH 26/27] media: usbvision: use usb_fill_int_urb() Sebastian Andrzej Siewior
2018-06-20 11:01   ` [26/27] " Sebastian Andrzej Siewior
2018-06-20 11:01 ` [PATCH 27/27] media: uvcvideo: " Sebastian Andrzej Siewior
2018-06-20 11:01   ` [27/27] " Sebastian Andrzej Siewior
2018-06-20 11:55   ` [PATCH 27/27] " Laurent Pinchart
2018-06-20 11:55     ` [27/27] " Laurent Pinchart
2018-06-20 13:21     ` [PATCH 27/27] " Sebastian Andrzej Siewior
2018-06-20 13:21       ` [27/27] " Sebastian Andrzej Siewior
2018-06-20 14:14       ` [PATCH 27/27] " Laurent Pinchart
2018-06-20 14:14         ` [27/27] " Laurent Pinchart
2018-06-20 15:20         ` Sebastian Andrzej Siewior [this message]
2018-06-20 15:20           ` USB: note that usb_fill_int_urb() can be used used for ISOC urbs Sebastian Andrzej Siewior
2018-06-20 15:35           ` [PATCH] " Alan Stern
2018-06-20 15:35             ` Alan Stern
2018-06-20 16:02             ` [PATCH] " Sebastian Andrzej Siewior
2018-06-20 16:02               ` Sebastian Andrzej Siewior
2018-06-20 16:21               ` [PATCH] " Alan Stern
2018-06-20 16:21                 ` Alan Stern
2018-06-20 16:49                 ` [PATCH] " Sebastian Andrzej Siewior
2018-06-20 16:49                   ` Sebastian Andrzej Siewior
2018-06-20 17:23                   ` [PATCH] " Alan Stern
2018-06-20 17:23                     ` Alan Stern
2018-07-12 22:35                     ` [PATCH RFC] usb: add usb_fill_iso_urb() Sebastian Andrzej Siewior
2018-07-12 22:35                       ` [RFC] " Sebastian Andrzej Siewior
2018-07-13  7:29                       ` [PATCH RFC] " Greg Kroah-Hartman
2018-07-13  7:29                         ` [RFC] " Greg Kroah-Hartman
2018-07-13  7:47                         ` [PATCH RFC] " Sebastian Andrzej Siewior
2018-07-13  7:47                           ` [RFC] " Sebastian Andrzej Siewior
2018-07-16 22:53                           ` [PATCH RFC] " Sebastian Andrzej Siewior
2018-07-16 22:53                             ` [RFC] " Sebastian Andrzej Siewior
2018-07-17  6:54                             ` [PATCH RFC] " Clemens Ladisch
2018-07-17  6:54                               ` Clemens Ladisch
2018-07-17  6:54                               ` [RFC] " Clemens Ladisch
2018-08-06 21:21                             ` [PATCH RFC] " Laurent Pinchart
2018-08-06 21:21                               ` [RFC] " Laurent Pinchart
2018-08-06 22:02                               ` [PATCH RFC] " Sebastian Andrzej Siewior
2018-08-06 22:02                                 ` [RFC] " Sebastian Andrzej Siewior
2018-07-13  8:01                       ` [PATCH RFC] " Laurent Pinchart
2018-07-13  8:01                         ` [RFC] " Laurent Pinchart
2018-07-13 20:12                       ` [PATCH RFC] " Alan Stern
2018-07-13 20:12                         ` [RFC] " Alan Stern
2018-06-20 15:21         ` [PATCH 27/27 v2] media: uvcvideo: use usb_fill_int_urb() for the ->intarval value Sebastian Andrzej Siewior
2018-06-20 15:21           ` [27/27,v2] " Sebastian Andrzej Siewior
2018-06-20 15:40           ` [PATCH 27/27 v2] " Alan Stern
2018-06-20 15:40             ` [27/27,v2] " Alan Stern

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20180620152007.xapqkv4ww2hnmvkq@linutronix.de \
    --to=bigeasy@linutronix.de \
    --cc=gregkh@linuxfoundation.org \
    --cc=laurent.pinchart@ideasonboard.com \
    --cc=linux-media@vger.kernel.org \
    --cc=linux-usb@vger.kernel.org \
    --cc=mchehab@kernel.org \
    --cc=stern@rowland.harvard.edu \
    --cc=tglx@linutronix.de \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.