Christoph Hellwig f5678e7f2a kernel: better document the use_mm/unuse_mm API contract ...

Switch the function documentation to kerneldoc comments, and add
WARN_ON_ONCE asserts that the calling thread is a kernel thread and does
not have ->mm set (or has ->mm set in the case of unuse_mm).

Also give the functions a kthread_ prefix to better document the use case.

[hch@lst.de: fix a comment typo, cover the newly merged use_mm/unuse_mm caller in vfio]
  Link: http://lkml.kernel.org/r/20200416053158.586887-3-hch@lst.de
[sfr@canb.auug.org.au: powerpc/vas: fix up for {un}use_mm() rename]
  Link: http://lkml.kernel.org/r/20200422163935.5aa93ba5@canb.auug.org.au

Signed-off-by: Christoph Hellwig <hch@lst.de>
Signed-off-by: Stephen Rothwell <sfr@canb.auug.org.au>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Tested-by: Jens Axboe <axboe@kernel.dk>
Reviewed-by: Jens Axboe <axboe@kernel.dk>
Acked-by: Felix Kuehling <Felix.Kuehling@amd.com>
Acked-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org> [usb]
Acked-by: Haren Myneni <haren@linux.ibm.com>
Cc: Alex Deucher <alexander.deucher@amd.com>
Cc: Al Viro <viro@zeniv.linux.org.uk>
Cc: Felipe Balbi <balbi@kernel.org>
Cc: Jason Wang <jasowang@redhat.com>
Cc: "Michael S. Tsirkin" <mst@redhat.com>
Cc: Zhenyu Wang <zhenyuw@linux.intel.com>
Cc: Zhi Wang <zhi.a.wang@intel.com>
Link: http://lkml.kernel.org/r/20200404094101.672954-6-hch@lst.de
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>

2020-06-10 19:14:18 -07:00

..

copy-paste.h

…

eeh-powernv.c

powerpc/eeh: Rework eeh_ops->probe()

2020-03-25 12:09:39 +11:00

idle.c

powerpc/powernv: Fix a warning message

2020-05-11 23:15:14 +10:00

Kconfig

…

Makefile

powerpc/vas: Add VAS user space API

2020-04-20 16:53:14 +10:00

memtrace.c

powernv/memtrace: always online added memory blocks

2020-04-07 10:43:40 -07:00

npu-dma.c

powerpc/powernv/npu: Move IOMMU group setup into npu-dma.c

2020-05-28 23:24:38 +10:00

ocxl.c

…

opal-async.c

…

opal-call.c

powerpc/powernv: Add OPAL API interface to access secure variable

2019-11-13 00:33:22 +11:00

opal-core.c

powerpc/powernv: Move core and fadump_release_opalcore under new kobject

2020-02-19 21:07:10 +11:00

opal-dump.c

…

opal-elog.c

…

opal-fadump.c

powerpc: Replace _ALIGN_DOWN() by ALIGN_DOWN()

2020-05-11 23:15:15 +10:00

opal-fadump.h

powerpc/fadump: support holes in kernel boot memory area

2019-09-14 00:04:46 +10:00

opal-flash.c

…

opal-hmi.c

…

opal-imc.c

powerpc/powernv: Re-enable imc trace-mode in kernel

2020-04-03 00:09:58 +11:00

opal-irqchip.c

…

opal-kmsg.c

…

opal-lpc.c

…

opal-memory-errors.c

…

opal-msglog.c

…

opal-nvram.c

…

opal-power.c

…

opal-powercap.c

powerpc/powernv: Make some symbols static

2019-11-13 16:58:06 +11:00

opal-prd.c

…

opal-psr.c

powerpc/powernv: Make some symbols static

2019-11-13 16:58:06 +11:00

opal-rtc.c

…

opal-secvar.c

powerpc/powernv: Add OPAL API interface to access secure variable

2019-11-13 00:33:22 +11:00

opal-sensor-groups.c

powerpc/powernv: Make some symbols static

2019-11-13 16:58:06 +11:00

opal-sensor.c

…

opal-sysparam.c

…

opal-tracepoints.c

…

opal-wrappers.S

…

opal-xscom.c

…

opal.c

powerpc/powernv: add NULL check after kzalloc

2020-05-20 23:39:56 +10:00

pci-cxl.c

…

pci-ioda-tce.c

powerpc/powernv/pci: Move tce size parsing to pci-ioda-tce.c

2020-05-28 23:24:38 +10:00

pci-ioda.c

powerpc/powernv/pci: Sprinkle around some WARN_ON()s

2020-05-28 23:24:39 +10:00

pci.c

powerpc/powernv/pci: Add device to iommu group during dma_dev_setup()

2020-05-28 23:24:38 +10:00

pci.h

powerpc/powernv/pci: Reserve the root bus PE during init

2020-05-28 23:24:39 +10:00

powernv.h

…

rng.c

…

setup.c

powerpc/powernv: Add explicit fast-reboot support

2020-03-04 22:44:27 +11:00

smp.c

sched/core: Fix illegal RCU from offline CPUs

2020-04-30 20:14:41 +02:00

subcore-asm.S

…

subcore.c

…

subcore.h

…

ultravisor.c

…

vas-api.c

powerpc/vas: Add VAS user space API

2020-04-20 16:53:14 +10:00

vas-debug.c

powerpc/vas: Take reference to PID and mm for user space windows

2020-04-20 16:53:00 +10:00

vas-fault.c

kernel: better document the use_mm/unuse_mm API contract

2020-06-10 19:14:18 -07:00

vas-trace.h

…

vas-window.c

powerpc/vas: Add VAS user space API

2020-04-20 16:53:14 +10:00

vas.c

powerpc/vas: Setup thread IRQ handler per VAS instance

2020-04-20 16:53:00 +10:00

vas.h

powerpc/vas: Add VAS user space API

2020-04-20 16:53:14 +10:00