minmax: make generic MIN() and MAX() macros available everywhere
authorLinus Torvalds <torvalds@linux-foundation.org>
Sun, 28 Jul 2024 22:49:18 +0000 (15:49 -0700)
committerLinus Torvalds <torvalds@linux-foundation.org>
Sun, 28 Jul 2024 22:49:18 +0000 (15:49 -0700)
commit1a251f52cfdc417c84411a056bc142cbd77baef4
tree2ea60e35ecbb9891dd8746180bf48154095f1272
parent8400291e289ee6b2bf9779ff1c83a291501f017b
minmax: make generic MIN() and MAX() macros available everywhere

This just standardizes the use of MIN() and MAX() macros, with the very
traditional semantics.  The goal is to use these for C constant
expressions and for top-level / static initializers, and so be able to
simplify the min()/max() macros.

These macro names were used by various kernel code - they are very
traditional, after all - and all such users have been fixed up, with a
few different approaches:

 - trivial duplicated macro definitions have been removed

   Note that 'trivial' here means that it's obviously kernel code that
   already included all the major kernel headers, and thus gets the new
   generic MIN/MAX macros automatically.

 - non-trivial duplicated macro definitions are guarded with #ifndef

   This is the "yes, they define their own versions, but no, the include
   situation is not entirely obvious, and maybe they don't get the
   generic version automatically" case.

 - strange use case #1

   A couple of drivers decided that the way they want to describe their
   versioning is with

#define MAJ 1
#define MIN 2
#define DRV_VERSION __stringify(MAJ) "." __stringify(MIN)

   which adds zero value and I just did my Alexander the Great
   impersonation, and rewrote that pointless Gordian knot as

#define DRV_VERSION "1.2"

   instead.

 - strange use case #2

   A couple of drivers thought that it's a good idea to have a random
   'MIN' or 'MAX' define for a value or index into a table, rather than
   the traditional macro that takes arguments.

   These values were re-written as C enum's instead. The new
   function-line macros only expand when followed by an open
   parenthesis, and thus don't clash with enum use.

Happily, there weren't really all that many of these cases, and a lot of
users already had the pattern of using '#ifndef' guarding (or in one
case just using '#undef MIN') before defining their own private version
that does the same thing. I left such cases alone.

Cc: David Laight <David.Laight@aculab.com>
Cc: Lorenzo Stoakes <lorenzo.stoakes@oracle.com>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
20 files changed:
arch/um/drivers/mconsole_user.c
drivers/edac/skx_common.h
drivers/gpu/drm/amd/display/dc/core/dc_stream.c
drivers/gpu/drm/amd/display/modules/hdcp/hdcp_ddc.c
drivers/gpu/drm/amd/pm/powerplay/hwmgr/ppevvmath.h
drivers/gpu/drm/radeon/evergreen_cs.c
drivers/hwmon/adt7475.c
drivers/media/dvb-frontends/stv0367_priv.h
drivers/net/fjes/fjes_main.c
drivers/nfc/pn544/i2c.c
drivers/platform/x86/sony-laptop.c
drivers/scsi/isci/init.c
drivers/staging/media/atomisp/pci/hive_isp_css_include/math_support.h
include/linux/minmax.h
kernel/trace/preemptirq_delay_test.c
lib/btree.c
lib/decompress_unlzma.c
mm/zsmalloc.c
tools/testing/selftests/mm/mremap_test.c
tools/testing/selftests/seccomp/seccomp_bpf.c