Re: [PATCH v1 3/3] xen/arm: smmu: Renaming struct iommu_domain *domain to, struct iommu_domain *iommu_domain

[Ian Campbell <ian.campbell@citrix.com>]

On Mon, 2015-04-06 at 16:15 +0200, Julien Grall wrote:
> Hi Ian,
> 
> On 01/04/2015 10:30, Ian Campbell wrote:
> > On Tue, 2015-03-31 at 17:48 +0100, Stefano Stabellini wrote:
> >> If it helps we could add a couple of comments on top of the structs in
> >> smmu.c to explain the meaning of the fields, like:
> >>
> >>
> >> /* iommu_domain, not to be confused with a Xen domain */
> >
> > I was going to suggest something similar but more expansive, i.e. a
> > table of them all in one place (i.e. at the top of the file) for ease of
> > referencing:
> >
> > Struct Name            What             Wherefrom     Normally found in
> > ---------------------------------------------------------------------
> > iommu_domain           IOMMU Context    Linux         d->arch.blah
> > arch_smmu_xen_device   Device specific  Xen           device->arch.blurg
> 
> The actual name of the structure is arm_smmu_xen_device not 
> arch_smmu_xen_device. Did you suggest to rename the name?

No, I was just suggesting someone should create such a table with actual
current information, instead of made up filler, in it. (you'll notice
that there is, hopefully, no field blah in d->arch either nor
device->arch.blurg in the tree either and please don't rename the field
to match those ;-)).


Ian.