| .. | .. |
|---|
| 2 | 2 | #ifndef _LINUX_KERNEL_H |
|---|
| 3 | 3 | #define _LINUX_KERNEL_H |
|---|
| 4 | 4 | |
|---|
| 5 | + |
|---|
| 5 | 6 | #include <stdarg.h> |
|---|
| 7 | +#include <linux/limits.h> |
|---|
| 6 | 8 | #include <linux/linkage.h> |
|---|
| 7 | 9 | #include <linux/stddef.h> |
|---|
| 8 | 10 | #include <linux/types.h> |
|---|
| 9 | 11 | #include <linux/compiler.h> |
|---|
| 10 | 12 | #include <linux/bitops.h> |
|---|
| 11 | 13 | #include <linux/log2.h> |
|---|
| 14 | +#include <linux/minmax.h> |
|---|
| 12 | 15 | #include <linux/typecheck.h> |
|---|
| 13 | 16 | #include <linux/printk.h> |
|---|
| 14 | 17 | #include <linux/build_bug.h> |
|---|
| 15 | 18 | #include <asm/byteorder.h> |
|---|
| 19 | +#include <asm/div64.h> |
|---|
| 16 | 20 | #include <uapi/linux/kernel.h> |
|---|
| 17 | | -#include <linux/limits.h> |
|---|
| 18 | 21 | |
|---|
| 19 | 22 | #define STACK_MAGIC 0xdeadbeef |
|---|
| 20 | 23 | |
|---|
| .. | .. |
|---|
| 31 | 34 | #define ALIGN_DOWN(x, a) __ALIGN_KERNEL((x) - ((a) - 1), (a)) |
|---|
| 32 | 35 | #define __ALIGN_MASK(x, mask) __ALIGN_KERNEL_MASK((x), (mask)) |
|---|
| 33 | 36 | #define PTR_ALIGN(p, a) ((typeof(p))ALIGN((unsigned long)(p), (a))) |
|---|
| 37 | +#define PTR_ALIGN_DOWN(p, a) ((typeof(p))ALIGN_DOWN((unsigned long)(p), (a))) |
|---|
| 34 | 38 | #define IS_ALIGNED(x, a) (((x) & ((typeof(x))(a) - 1)) == 0) |
|---|
| 35 | 39 | |
|---|
| 36 | 40 | /* generic data direction definitions */ |
|---|
| .. | .. |
|---|
| 76 | 80 | */ |
|---|
| 77 | 81 | #define round_down(x, y) ((x) & ~__round_mask(x, y)) |
|---|
| 78 | 82 | |
|---|
| 79 | | -/** |
|---|
| 80 | | - * FIELD_SIZEOF - get the size of a struct's field |
|---|
| 81 | | - * @t: the target struct |
|---|
| 82 | | - * @f: the target struct's field |
|---|
| 83 | | - * Return: the size of @f in the struct definition without having a |
|---|
| 84 | | - * declared instance of @t. |
|---|
| 85 | | - */ |
|---|
| 86 | | -#define FIELD_SIZEOF(t, f) (sizeof(((t*)0)->f)) |
|---|
| 83 | +#define typeof_member(T, m) typeof(((T*)0)->m) |
|---|
| 87 | 84 | |
|---|
| 88 | 85 | #define DIV_ROUND_UP __KERNEL_DIV_ROUND_UP |
|---|
| 89 | 86 | |
|---|
| .. | .. |
|---|
| 106 | 103 | * |
|---|
| 107 | 104 | * Rounds @x up to next multiple of @y. If @y will always be a power |
|---|
| 108 | 105 | * of 2, consider using the faster round_up(). |
|---|
| 109 | | - * |
|---|
| 110 | | - * The `const' here prevents gcc-3.3 from calling __divdi3 |
|---|
| 111 | 106 | */ |
|---|
| 112 | 107 | #define roundup(x, y) ( \ |
|---|
| 113 | 108 | { \ |
|---|
| 114 | | - const typeof(y) __y = y; \ |
|---|
| 109 | + typeof(y) __y = y; \ |
|---|
| 115 | 110 | (((x) + (__y - 1)) / __y) * __y; \ |
|---|
| 116 | 111 | } \ |
|---|
| 117 | 112 | ) |
|---|
| .. | .. |
|---|
| 176 | 171 | #define _RET_IP_ (unsigned long)__builtin_return_address(0) |
|---|
| 177 | 172 | #define _THIS_IP_ ({ __label__ __here; __here: (unsigned long)&&__here; }) |
|---|
| 178 | 173 | |
|---|
| 179 | | -#ifdef CONFIG_LBDAF |
|---|
| 180 | | -# include <asm/div64.h> |
|---|
| 181 | | -# define sector_div(a, b) do_div(a, b) |
|---|
| 182 | | -#else |
|---|
| 183 | | -# define sector_div(n, b)( \ |
|---|
| 184 | | -{ \ |
|---|
| 185 | | - int _res; \ |
|---|
| 186 | | - _res = (n) % (b); \ |
|---|
| 187 | | - (n) /= (b); \ |
|---|
| 188 | | - _res; \ |
|---|
| 189 | | -} \ |
|---|
| 190 | | -) |
|---|
| 191 | | -#endif |
|---|
| 174 | +#define sector_div(a, b) do_div(a, b) |
|---|
| 192 | 175 | |
|---|
| 193 | 176 | /** |
|---|
| 194 | 177 | * upper_32_bits - return bits 32-63 of a number |
|---|
| .. | .. |
|---|
| 204 | 187 | * lower_32_bits - return bits 0-31 of a number |
|---|
| 205 | 188 | * @n: the number we're accessing |
|---|
| 206 | 189 | */ |
|---|
| 207 | | -#define lower_32_bits(n) ((u32)(n)) |
|---|
| 190 | +#define lower_32_bits(n) ((u32)((n) & 0xffffffff)) |
|---|
| 208 | 191 | |
|---|
| 209 | 192 | struct completion; |
|---|
| 210 | 193 | struct pt_regs; |
|---|
| .. | .. |
|---|
| 218 | 201 | #endif |
|---|
| 219 | 202 | |
|---|
| 220 | 203 | #ifdef CONFIG_DEBUG_ATOMIC_SLEEP |
|---|
| 221 | | - void ___might_sleep(const char *file, int line, int preempt_offset); |
|---|
| 222 | | - void __might_sleep(const char *file, int line, int preempt_offset); |
|---|
| 204 | +extern void ___might_sleep(const char *file, int line, int preempt_offset); |
|---|
| 205 | +extern void __might_sleep(const char *file, int line, int preempt_offset); |
|---|
| 206 | +extern void __cant_sleep(const char *file, int line, int preempt_offset); |
|---|
| 207 | +extern void __cant_migrate(const char *file, int line); |
|---|
| 208 | + |
|---|
| 223 | 209 | /** |
|---|
| 224 | 210 | * might_sleep - annotation for functions that can sleep |
|---|
| 225 | 211 | * |
|---|
| 226 | 212 | * this macro will print a stack trace if it is executed in an atomic |
|---|
| 227 | | - * context (spinlock, irq-handler, ...). |
|---|
| 213 | + * context (spinlock, irq-handler, ...). Additional sections where blocking is |
|---|
| 214 | + * not allowed can be annotated with non_block_start() and non_block_end() |
|---|
| 215 | + * pairs. |
|---|
| 228 | 216 | * |
|---|
| 229 | 217 | * This is a useful debugging help to be able to catch problems early and not |
|---|
| 230 | 218 | * be bitten later when the calling function happens to sleep when it is not |
|---|
| .. | .. |
|---|
| 234 | 222 | do { __might_sleep(__FILE__, __LINE__, 0); might_resched(); } while (0) |
|---|
| 235 | 223 | |
|---|
| 236 | 224 | # define might_sleep_no_state_check() \ |
|---|
| 237 | | - do { ___might_sleep(__FILE__, __LINE__, 0); might_resched(); } while (0) |
|---|
| 225 | + do { ___might_sleep(__FILE__, __LINE__, 0); } while (0) |
|---|
| 226 | + |
|---|
| 227 | +/** |
|---|
| 228 | + * cant_sleep - annotation for functions that cannot sleep |
|---|
| 229 | + * |
|---|
| 230 | + * this macro will print a stack trace if it is executed with preemption enabled |
|---|
| 231 | + */ |
|---|
| 232 | +# define cant_sleep() \ |
|---|
| 233 | + do { __cant_sleep(__FILE__, __LINE__, 0); } while (0) |
|---|
| 238 | 234 | # define sched_annotate_sleep() (current->task_state_change = 0) |
|---|
| 235 | + |
|---|
| 236 | +/** |
|---|
| 237 | + * cant_migrate - annotation for functions that cannot migrate |
|---|
| 238 | + * |
|---|
| 239 | + * Will print a stack trace if executed in code which is migratable |
|---|
| 240 | + */ |
|---|
| 241 | +# define cant_migrate() \ |
|---|
| 242 | + do { \ |
|---|
| 243 | + if (IS_ENABLED(CONFIG_SMP)) \ |
|---|
| 244 | + __cant_migrate(__FILE__, __LINE__); \ |
|---|
| 245 | + } while (0) |
|---|
| 246 | + |
|---|
| 247 | +/** |
|---|
| 248 | + * non_block_start - annotate the start of section where sleeping is prohibited |
|---|
| 249 | + * |
|---|
| 250 | + * This is on behalf of the oom reaper, specifically when it is calling the mmu |
|---|
| 251 | + * notifiers. The problem is that if the notifier were to block on, for example, |
|---|
| 252 | + * mutex_lock() and if the process which holds that mutex were to perform a |
|---|
| 253 | + * sleeping memory allocation, the oom reaper is now blocked on completion of |
|---|
| 254 | + * that memory allocation. Other blocking calls like wait_event() pose similar |
|---|
| 255 | + * issues. |
|---|
| 256 | + */ |
|---|
| 257 | +# define non_block_start() (current->non_block_count++) |
|---|
| 258 | +/** |
|---|
| 259 | + * non_block_end - annotate the end of section where sleeping is prohibited |
|---|
| 260 | + * |
|---|
| 261 | + * Closes a section opened by non_block_start(). |
|---|
| 262 | + */ |
|---|
| 263 | +# define non_block_end() WARN_ON(current->non_block_count-- == 0) |
|---|
| 239 | 264 | #else |
|---|
| 240 | 265 | static inline void ___might_sleep(const char *file, int line, |
|---|
| 241 | 266 | int preempt_offset) { } |
|---|
| .. | .. |
|---|
| 243 | 268 | int preempt_offset) { } |
|---|
| 244 | 269 | # define might_sleep() do { might_resched(); } while (0) |
|---|
| 245 | 270 | # define might_sleep_no_state_check() do { might_resched(); } while (0) |
|---|
| 271 | +# define cant_sleep() do { } while (0) |
|---|
| 272 | +# define cant_migrate() do { } while (0) |
|---|
| 246 | 273 | # define sched_annotate_sleep() do { } while (0) |
|---|
| 274 | +# define non_block_start() do { } while (0) |
|---|
| 275 | +# define non_block_end() do { } while (0) |
|---|
| 247 | 276 | #endif |
|---|
| 248 | 277 | |
|---|
| 249 | 278 | #define might_sleep_if(cond) do { if (cond) might_sleep(); } while (0) |
|---|
| .. | .. |
|---|
| 299 | 328 | #endif |
|---|
| 300 | 329 | |
|---|
| 301 | 330 | extern struct atomic_notifier_head panic_notifier_list; |
|---|
| 302 | | -extern void (*vendor_panic_cb)(u64 sp); |
|---|
| 303 | 331 | extern long (*panic_blink)(int state); |
|---|
| 304 | 332 | __printf(1, 2) |
|---|
| 305 | 333 | void panic(const char *fmt, ...) __noreturn __cold; |
|---|
| 306 | 334 | void nmi_panic(struct pt_regs *regs, const char *msg); |
|---|
| 307 | 335 | extern void oops_enter(void); |
|---|
| 308 | 336 | extern void oops_exit(void); |
|---|
| 309 | | -void print_oops_end_marker(void); |
|---|
| 310 | | -extern int oops_may_print(void); |
|---|
| 337 | +extern bool oops_may_print(void); |
|---|
| 311 | 338 | void do_exit(long error_code) __noreturn; |
|---|
| 312 | 339 | void complete_and_exit(struct completion *, long) __noreturn; |
|---|
| 313 | | - |
|---|
| 314 | | -#ifdef CONFIG_ARCH_HAS_REFCOUNT |
|---|
| 315 | | -void refcount_error_report(struct pt_regs *regs, const char *err); |
|---|
| 316 | | -#else |
|---|
| 317 | | -static inline void refcount_error_report(struct pt_regs *regs, const char *err) |
|---|
| 318 | | -{ } |
|---|
| 319 | | -#endif |
|---|
| 320 | 340 | |
|---|
| 321 | 341 | /* Internal, do not use. */ |
|---|
| 322 | 342 | int __must_check _kstrtoul(const char *s, unsigned int base, unsigned long *res); |
|---|
| .. | .. |
|---|
| 338 | 358 | * @res: Where to write the result of the conversion on success. |
|---|
| 339 | 359 | * |
|---|
| 340 | 360 | * Returns 0 on success, -ERANGE on overflow and -EINVAL on parsing error. |
|---|
| 341 | | - * Used as a replacement for the obsolete simple_strtoull. Return code must |
|---|
| 342 | | - * be checked. |
|---|
| 361 | + * Preferred over simple_strtoul(). Return code must be checked. |
|---|
| 343 | 362 | */ |
|---|
| 344 | 363 | static inline int __must_check kstrtoul(const char *s, unsigned int base, unsigned long *res) |
|---|
| 345 | 364 | { |
|---|
| .. | .. |
|---|
| 367 | 386 | * @res: Where to write the result of the conversion on success. |
|---|
| 368 | 387 | * |
|---|
| 369 | 388 | * Returns 0 on success, -ERANGE on overflow and -EINVAL on parsing error. |
|---|
| 370 | | - * Used as a replacement for the obsolete simple_strtoull. Return code must |
|---|
| 371 | | - * be checked. |
|---|
| 389 | + * Preferred over simple_strtol(). Return code must be checked. |
|---|
| 372 | 390 | */ |
|---|
| 373 | 391 | static inline int __must_check kstrtol(const char *s, unsigned int base, long *res) |
|---|
| 374 | 392 | { |
|---|
| .. | .. |
|---|
| 444 | 462 | return kstrtoint_from_user(s, count, base, res); |
|---|
| 445 | 463 | } |
|---|
| 446 | 464 | |
|---|
| 447 | | -/* Obsolete, do not use. Use kstrto<foo> instead */ |
|---|
| 465 | +/* |
|---|
| 466 | + * Use kstrto<foo> instead. |
|---|
| 467 | + * |
|---|
| 468 | + * NOTE: simple_strto<foo> does not check for the range overflow and, |
|---|
| 469 | + * depending on the input, may give interesting results. |
|---|
| 470 | + * |
|---|
| 471 | + * Use these functions if and only if you cannot use kstrto<foo>, because |
|---|
| 472 | + * the conversion ends on the first non-digit character, which may be far |
|---|
| 473 | + * beyond the supported range. It might be useful to parse the strings like |
|---|
| 474 | + * 10x50 or 12:21 without altering original string or temporary buffer in use. |
|---|
| 475 | + * Keep in mind above caveat. |
|---|
| 476 | + */ |
|---|
| 448 | 477 | |
|---|
| 449 | 478 | extern unsigned long simple_strtoul(const char *,char **,unsigned int); |
|---|
| 450 | 479 | extern long simple_strtol(const char *,char **,unsigned int); |
|---|
| .. | .. |
|---|
| 491 | 520 | extern int kernel_text_address(unsigned long addr); |
|---|
| 492 | 521 | extern int func_ptr_is_kernel_text(void *ptr); |
|---|
| 493 | 522 | |
|---|
| 523 | +u64 int_pow(u64 base, unsigned int exp); |
|---|
| 494 | 524 | unsigned long int_sqrt(unsigned long); |
|---|
| 495 | 525 | |
|---|
| 496 | 526 | #if BITS_PER_LONG < 64 |
|---|
| .. | .. |
|---|
| 502 | 532 | } |
|---|
| 503 | 533 | #endif |
|---|
| 504 | 534 | |
|---|
| 535 | +#ifdef CONFIG_SMP |
|---|
| 536 | +extern unsigned int sysctl_oops_all_cpu_backtrace; |
|---|
| 537 | +#else |
|---|
| 538 | +#define sysctl_oops_all_cpu_backtrace 0 |
|---|
| 539 | +#endif /* CONFIG_SMP */ |
|---|
| 540 | + |
|---|
| 505 | 541 | extern void bust_spinlocks(int yes); |
|---|
| 506 | | -extern int oops_in_progress; /* If set, an oops, panic(), BUG() or die() is in progress */ |
|---|
| 507 | 542 | extern int panic_timeout; |
|---|
| 543 | +extern unsigned long panic_print; |
|---|
| 508 | 544 | extern int panic_on_oops; |
|---|
| 509 | 545 | extern int panic_on_unrecovered_nmi; |
|---|
| 510 | 546 | extern int panic_on_io_nmi; |
|---|
| 511 | 547 | extern int panic_on_warn; |
|---|
| 548 | +extern unsigned long panic_on_taint; |
|---|
| 549 | +extern bool panic_on_taint_nousertaint; |
|---|
| 512 | 550 | extern int sysctl_panic_on_rcu_stall; |
|---|
| 513 | 551 | extern int sysctl_panic_on_stackoverflow; |
|---|
| 514 | 552 | |
|---|
| .. | .. |
|---|
| 577 | 615 | #define TAINT_AUX 16 |
|---|
| 578 | 616 | #define TAINT_RANDSTRUCT 17 |
|---|
| 579 | 617 | #define TAINT_FLAGS_COUNT 18 |
|---|
| 618 | +#define TAINT_FLAGS_MAX ((1UL << TAINT_FLAGS_COUNT) - 1) |
|---|
| 580 | 619 | |
|---|
| 581 | 620 | struct taint_flag { |
|---|
| 582 | 621 | char c_true; /* character printed when tainted */ |
|---|
| .. | .. |
|---|
| 608 | 647 | return buf; |
|---|
| 609 | 648 | } |
|---|
| 610 | 649 | |
|---|
| 650 | +#ifdef __GENKSYMS__ |
|---|
| 611 | 651 | extern int hex_to_bin(char ch); |
|---|
| 652 | +#else |
|---|
| 653 | +extern int hex_to_bin(unsigned char ch); |
|---|
| 654 | +#endif |
|---|
| 612 | 655 | extern int __must_check hex2bin(u8 *dst, const char *src, size_t count); |
|---|
| 613 | 656 | extern char *bin2hex(char *dst, const void *src, size_t count); |
|---|
| 614 | 657 | |
|---|
| .. | .. |
|---|
| 702 | 745 | #define do_trace_printk(fmt, args...) \ |
|---|
| 703 | 746 | do { \ |
|---|
| 704 | 747 | static const char *trace_printk_fmt __used \ |
|---|
| 705 | | - __attribute__((section("__trace_printk_fmt"))) = \ |
|---|
| 748 | + __section("__trace_printk_fmt") = \ |
|---|
| 706 | 749 | __builtin_constant_p(fmt) ? fmt : NULL; \ |
|---|
| 707 | 750 | \ |
|---|
| 708 | 751 | __trace_printk_check_format(fmt, ##args); \ |
|---|
| .. | .. |
|---|
| 746 | 789 | |
|---|
| 747 | 790 | #define trace_puts(str) ({ \ |
|---|
| 748 | 791 | static const char *trace_printk_fmt __used \ |
|---|
| 749 | | - __attribute__((section("__trace_printk_fmt"))) = \ |
|---|
| 792 | + __section("__trace_printk_fmt") = \ |
|---|
| 750 | 793 | __builtin_constant_p(str) ? str : NULL; \ |
|---|
| 751 | 794 | \ |
|---|
| 752 | 795 | if (__builtin_constant_p(str)) \ |
|---|
| .. | .. |
|---|
| 768 | 811 | do { \ |
|---|
| 769 | 812 | if (__builtin_constant_p(fmt)) { \ |
|---|
| 770 | 813 | static const char *trace_printk_fmt __used \ |
|---|
| 771 | | - __attribute__((section("__trace_printk_fmt"))) = \ |
|---|
| 814 | + __section("__trace_printk_fmt") = \ |
|---|
| 772 | 815 | __builtin_constant_p(fmt) ? fmt : NULL; \ |
|---|
| 773 | 816 | \ |
|---|
| 774 | 817 | __ftrace_vbprintk(_THIS_IP_, trace_printk_fmt, vargs); \ |
|---|
| .. | .. |
|---|
| 806 | 849 | } |
|---|
| 807 | 850 | static inline void ftrace_dump(enum ftrace_dump_mode oops_dump_mode) { } |
|---|
| 808 | 851 | #endif /* CONFIG_TRACING */ |
|---|
| 809 | | - |
|---|
| 810 | | -/* |
|---|
| 811 | | - * min()/max()/clamp() macros must accomplish three things: |
|---|
| 812 | | - * |
|---|
| 813 | | - * - avoid multiple evaluations of the arguments (so side-effects like |
|---|
| 814 | | - * "x++" happen only once) when non-constant. |
|---|
| 815 | | - * - perform strict type-checking (to generate warnings instead of |
|---|
| 816 | | - * nasty runtime surprises). See the "unnecessary" pointer comparison |
|---|
| 817 | | - * in __typecheck(). |
|---|
| 818 | | - * - retain result as a constant expressions when called with only |
|---|
| 819 | | - * constant expressions (to avoid tripping VLA warnings in stack |
|---|
| 820 | | - * allocation usage). |
|---|
| 821 | | - */ |
|---|
| 822 | | -#define __typecheck(x, y) \ |
|---|
| 823 | | - (!!(sizeof((typeof(x) *)1 == (typeof(y) *)1))) |
|---|
| 824 | | - |
|---|
| 825 | | -/* |
|---|
| 826 | | - * This returns a constant expression while determining if an argument is |
|---|
| 827 | | - * a constant expression, most importantly without evaluating the argument. |
|---|
| 828 | | - * Glory to Martin Uecker <Martin.Uecker@med.uni-goettingen.de> |
|---|
| 829 | | - */ |
|---|
| 830 | | -#define __is_constexpr(x) \ |
|---|
| 831 | | - (sizeof(int) == sizeof(*(8 ? ((void *)((long)(x) * 0l)) : (int *)8))) |
|---|
| 832 | | - |
|---|
| 833 | | -#define __no_side_effects(x, y) \ |
|---|
| 834 | | - (__is_constexpr(x) && __is_constexpr(y)) |
|---|
| 835 | | - |
|---|
| 836 | | -#define __safe_cmp(x, y) \ |
|---|
| 837 | | - (__typecheck(x, y) && __no_side_effects(x, y)) |
|---|
| 838 | | - |
|---|
| 839 | | -#define __cmp(x, y, op) ((x) op (y) ? (x) : (y)) |
|---|
| 840 | | - |
|---|
| 841 | | -#define __cmp_once(x, y, unique_x, unique_y, op) ({ \ |
|---|
| 842 | | - typeof(x) unique_x = (x); \ |
|---|
| 843 | | - typeof(y) unique_y = (y); \ |
|---|
| 844 | | - __cmp(unique_x, unique_y, op); }) |
|---|
| 845 | | - |
|---|
| 846 | | -#define __careful_cmp(x, y, op) \ |
|---|
| 847 | | - __builtin_choose_expr(__safe_cmp(x, y), \ |
|---|
| 848 | | - __cmp(x, y, op), \ |
|---|
| 849 | | - __cmp_once(x, y, __UNIQUE_ID(__x), __UNIQUE_ID(__y), op)) |
|---|
| 850 | | - |
|---|
| 851 | | -/** |
|---|
| 852 | | - * min - return minimum of two values of the same or compatible types |
|---|
| 853 | | - * @x: first value |
|---|
| 854 | | - * @y: second value |
|---|
| 855 | | - */ |
|---|
| 856 | | -#define min(x, y) __careful_cmp(x, y, <) |
|---|
| 857 | | - |
|---|
| 858 | | -/** |
|---|
| 859 | | - * max - return maximum of two values of the same or compatible types |
|---|
| 860 | | - * @x: first value |
|---|
| 861 | | - * @y: second value |
|---|
| 862 | | - */ |
|---|
| 863 | | -#define max(x, y) __careful_cmp(x, y, >) |
|---|
| 864 | | - |
|---|
| 865 | | -/** |
|---|
| 866 | | - * min3 - return minimum of three values |
|---|
| 867 | | - * @x: first value |
|---|
| 868 | | - * @y: second value |
|---|
| 869 | | - * @z: third value |
|---|
| 870 | | - */ |
|---|
| 871 | | -#define min3(x, y, z) min((typeof(x))min(x, y), z) |
|---|
| 872 | | - |
|---|
| 873 | | -/** |
|---|
| 874 | | - * max3 - return maximum of three values |
|---|
| 875 | | - * @x: first value |
|---|
| 876 | | - * @y: second value |
|---|
| 877 | | - * @z: third value |
|---|
| 878 | | - */ |
|---|
| 879 | | -#define max3(x, y, z) max((typeof(x))max(x, y), z) |
|---|
| 880 | | - |
|---|
| 881 | | -/** |
|---|
| 882 | | - * min_not_zero - return the minimum that is _not_ zero, unless both are zero |
|---|
| 883 | | - * @x: value1 |
|---|
| 884 | | - * @y: value2 |
|---|
| 885 | | - */ |
|---|
| 886 | | -#define min_not_zero(x, y) ({ \ |
|---|
| 887 | | - typeof(x) __x = (x); \ |
|---|
| 888 | | - typeof(y) __y = (y); \ |
|---|
| 889 | | - __x == 0 ? __y : ((__y == 0) ? __x : min(__x, __y)); }) |
|---|
| 890 | | - |
|---|
| 891 | | -/** |
|---|
| 892 | | - * clamp - return a value clamped to a given range with strict typechecking |
|---|
| 893 | | - * @val: current value |
|---|
| 894 | | - * @lo: lowest allowable value |
|---|
| 895 | | - * @hi: highest allowable value |
|---|
| 896 | | - * |
|---|
| 897 | | - * This macro does strict typechecking of @lo/@hi to make sure they are of the |
|---|
| 898 | | - * same type as @val. See the unnecessary pointer comparisons. |
|---|
| 899 | | - */ |
|---|
| 900 | | -#define clamp(val, lo, hi) min((typeof(val))max(val, lo), hi) |
|---|
| 901 | | - |
|---|
| 902 | | -/* |
|---|
| 903 | | - * ..and if you can't take the strict |
|---|
| 904 | | - * types, you can specify one yourself. |
|---|
| 905 | | - * |
|---|
| 906 | | - * Or not use min/max/clamp at all, of course. |
|---|
| 907 | | - */ |
|---|
| 908 | | - |
|---|
| 909 | | -/** |
|---|
| 910 | | - * min_t - return minimum of two values, using the specified type |
|---|
| 911 | | - * @type: data type to use |
|---|
| 912 | | - * @x: first value |
|---|
| 913 | | - * @y: second value |
|---|
| 914 | | - */ |
|---|
| 915 | | -#define min_t(type, x, y) __careful_cmp((type)(x), (type)(y), <) |
|---|
| 916 | | - |
|---|
| 917 | | -/** |
|---|
| 918 | | - * max_t - return maximum of two values, using the specified type |
|---|
| 919 | | - * @type: data type to use |
|---|
| 920 | | - * @x: first value |
|---|
| 921 | | - * @y: second value |
|---|
| 922 | | - */ |
|---|
| 923 | | -#define max_t(type, x, y) __careful_cmp((type)(x), (type)(y), >) |
|---|
| 924 | | - |
|---|
| 925 | | -/** |
|---|
| 926 | | - * clamp_t - return a value clamped to a given range using a given type |
|---|
| 927 | | - * @type: the type of variable to use |
|---|
| 928 | | - * @val: current value |
|---|
| 929 | | - * @lo: minimum allowable value |
|---|
| 930 | | - * @hi: maximum allowable value |
|---|
| 931 | | - * |
|---|
| 932 | | - * This macro does no typechecking and uses temporary variables of type |
|---|
| 933 | | - * @type to make all the comparisons. |
|---|
| 934 | | - */ |
|---|
| 935 | | -#define clamp_t(type, val, lo, hi) min_t(type, max_t(type, val, lo), hi) |
|---|
| 936 | | - |
|---|
| 937 | | -/** |
|---|
| 938 | | - * clamp_val - return a value clamped to a given range using val's type |
|---|
| 939 | | - * @val: current value |
|---|
| 940 | | - * @lo: minimum allowable value |
|---|
| 941 | | - * @hi: maximum allowable value |
|---|
| 942 | | - * |
|---|
| 943 | | - * This macro does no typechecking and uses temporary variables of whatever |
|---|
| 944 | | - * type the input argument @val is. This is useful when @val is an unsigned |
|---|
| 945 | | - * type and @lo and @hi are literals that will otherwise be assigned a signed |
|---|
| 946 | | - * integer type. |
|---|
| 947 | | - */ |
|---|
| 948 | | -#define clamp_val(val, lo, hi) clamp_t(typeof(val), val, lo, hi) |
|---|
| 949 | | - |
|---|
| 950 | | - |
|---|
| 951 | | -/** |
|---|
| 952 | | - * swap - swap values of @a and @b |
|---|
| 953 | | - * @a: first value |
|---|
| 954 | | - * @b: second value |
|---|
| 955 | | - */ |
|---|
| 956 | | -#define swap(a, b) \ |
|---|
| 957 | | - do { typeof(a) __tmp = (a); (a) = (b); (b) = __tmp; } while (0) |
|---|
| 958 | 852 | |
|---|
| 959 | 853 | /* This counts to 12. Any more, it will return 13th argument. */ |
|---|
| 960 | 854 | #define __COUNT_ARGS(_0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12, _n, X...) _n |
|---|