git: 833ccd66dac6 - stable/14 - cdefs: Add __writeonly to mark write only vars

From: Andrew Turner <andrew_at_FreeBSD.org>
Date: Mon, 15 Jul 2024 12:38:32 UTC
The branch stable/14 has been updated by andrew:

URL: https://cgit.FreeBSD.org/src/commit/?id=833ccd66dac6d9888d542fa0cc52cfa482e314ba

commit 833ccd66dac6d9888d542fa0cc52cfa482e314ba
Author:     Andrew Turner <andrew@FreeBSD.org>
AuthorDate: 2024-06-12 13:04:13 +0000
Commit:     Andrew Turner <andrew@FreeBSD.org>
CommitDate: 2024-07-15 12:28:45 +0000

    cdefs: Add __writeonly to mark write only vars
    
    When a variable in write only and can't be removed, e.g. for API
    reasons, it is useful to document this fact similar to __diagused
    and __witness_used.
    
    Add __writeonly to tell the compiler and anyone looking at the code
    that this variable is expected to only be written to, and to not
    raise and error.
    
    Reviewed by:    imp, kib
    Sponsored by:   Arm Ltd
    Differential Revision:  https://reviews.freebsd.org/D45561
    
    (cherry picked from commit a7ae78caaa17ff840da844c1dcaa780d194c9e20)
---
 sys/sys/cdefs.h | 1 +
 1 file changed, 1 insertion(+)

diff --git a/sys/sys/cdefs.h b/sys/sys/cdefs.h
index 84411e8e4b16..19b7d8fe427d 100644
--- a/sys/sys/cdefs.h
+++ b/sys/sys/cdefs.h
@@ -218,6 +218,7 @@
 #define	__aligned(x)	__attribute__((__aligned__(x)))
 #define	__section(x)	__attribute__((__section__(x)))
 #endif
+#define	__writeonly	__unused
 #if __GNUC_PREREQ__(4, 3) || __has_attribute(__alloc_size__)
 #define	__alloc_size(x)	__attribute__((__alloc_size__(x)))
 #define	__alloc_size2(n, x)	__attribute__((__alloc_size__(n, x)))