Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752801AbbGWJid (ORCPT ); Thu, 23 Jul 2015 05:38:33 -0400 Received: from smtp02.citrix.com ([66.165.176.63]:64953 "EHLO SMTP02.CITRIX.COM" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752319AbbGWJi0 (ORCPT ); Thu, 23 Jul 2015 05:38:26 -0400 X-IronPort-AV: E=Sophos;i="5.15,529,1432598400"; d="scan'208";a="286793331" Message-ID: <55B0B60E.20609@citrix.com> Date: Thu, 23 Jul 2015 10:38:22 +0100 From: David Vrabel User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:31.0) Gecko/20100101 Icedove/31.7.0 MIME-Version: 1.0 To: Juergen Gross , Greg KH CC: , , , , Subject: Re: [Xen-devel] [Patch V4 1/3] usb: Add Xen pvUSB protocol description References: <1435042405-14235-1-git-send-email-jgross@suse.com> <1435042405-14235-2-git-send-email-jgross@suse.com> <20150722234640.GA29425@kroah.com> <55B067D7.3030904@suse.com> <20150723043653.GA31524@kroah.com> <55B08DB9.60902@suse.com> In-Reply-To: <55B08DB9.60902@suse.com> Content-Type: text/plain; charset="windows-1252" Content-Transfer-Encoding: 7bit X-DLP: MIA2 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 1799 Lines: 49 On 23/07/15 07:46, Juergen Gross wrote: > On 07/23/2015 06:36 AM, Greg KH wrote: >> On Thu, Jul 23, 2015 at 06:04:39AM +0200, Juergen Gross wrote: >>> On 07/23/2015 01:46 AM, Greg KH wrote: >>>> On Tue, Jun 23, 2015 at 08:53:23AM +0200, Juergen Gross wrote: >>>>> Add the definition of pvUSB protocol used between the pvUSB >>>>> frontend in >>>>> a Xen domU and the pvUSB backend in a Xen driver domain (usually >>>>> Dom0). >>>>> >>>>> This header was originally provided by Fujitsu for Xen based on Linux >>>>> 2.6.18. >>>>> >>>>> Changes are: >>>>> - adapt to Linux style guide >>>>> >>>>> Signed-off-by: Juergen Gross >>>>> --- >>>>> include/xen/interface/io/usbif.h | 252 >>>>> +++++++++++++++++++++++++++++++++++++++ >>>> >>>> Why is this a different interface than the existing ones we have today >>>> (i.e. usbip?) Where is it documented? Do the Xen developers / >>> >>> The interface definition is living in the Xen git repository for several >>> years now: >>> >>> git://xenbits.xen.org/xen.git -> xen/include/public/io/usbif.h >> >> That's header file, not a document describing the api here. This is the format that Xen uses to document the interface to frontend drivers. This is also the style used for netfront, blkfront etc. The documentation in the header could be expanded if necessary but... > I suppose you want to tell me I should add something like: > > Documentation/DocBook/usb/API-struct-urb.html ... we certainly don't want a second location for the interface description in the Linux source. David -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/