iommu/arm-smmu-v3: Document ordering guarantees of command insertion
authorWill Deacon <will@kernel.org>
Tue, 20 Aug 2019 12:25:36 +0000 (13:25 +0100)
committerWill Deacon <will@kernel.org>
Wed, 21 Aug 2019 14:01:53 +0000 (15:01 +0100)
commit05cbaf4ddd02b69d78d43481e3813b4579572f71
tree0dbec94468c8ba9fe1d9a2d3237ba4b4cd5a687c
parent2af2e72b18b499fa36d3f7379fd010ff25d2a984
iommu/arm-smmu-v3: Document ordering guarantees of command insertion

It turns out that we've always relied on some subtle ordering guarantees
when inserting commands into the SMMUv3 command queue. With the recent
changes to elide locking when possible, these guarantees become more
subtle and even more important.

Add a comment documented the barrier semantics of command insertion so
that we don't have to derive the behaviour from scratch each time it
comes up on the list.

Signed-off-by: Will Deacon <will@kernel.org>
drivers/iommu/arm-smmu-v3.c