seqlock: Prefix internal seqcount_t-only macros with a "do_"
authorAhmed S. Darwish <a.darwish@linutronix.de>
Sun, 6 Dec 2020 16:21:42 +0000 (17:21 +0100)
committerPeter Zijlstra <peterz@infradead.org>
Wed, 9 Dec 2020 16:08:49 +0000 (17:08 +0100)
commit66bcfcdf89d00f2409f4b5da0f8c20c08318dc72
treee738d44e90f9d546710e696ca6ba3cb6e8a65051
parentcf48647243cc28d15280600292db5777592606c5
seqlock: Prefix internal seqcount_t-only macros with a "do_"

When the seqcount_LOCKNAME_t group of data types were introduced, two
classes of seqlock.h sequence counter macros were added:

  - An external public API which can either take a plain seqcount_t or
    any of the seqcount_LOCKNAME_t variants.

  - An internal API which takes only a plain seqcount_t.

To distinguish between the two groups, the "*_seqcount_t_*" pattern was
used for the latter. This confused a number of mm/ call-site developers,
and Linus also commented that it was not a standard practice for marking
seqlock.h internal APIs.

Distinguish the latter group of macros by prefixing a "do_".

Signed-off-by: Ahmed S. Darwish <a.darwish@linutronix.de>
Signed-off-by: Peter Zijlstra (Intel) <peterz@infradead.org>
Link: https://lkml.kernel.org/r/CAHk-=wikhGExmprXgaW+MVXG1zsGpztBbVwOb23vetk41EtTBQ@mail.gmail.com
include/linux/seqlock.h