Enumerated bits in enum
David Sterba
maintainercover Enumerated bits in enum
With some macro magic it's possible to let enum autoincrement define all bits without manually specifying the value. How it's done is described in the first patch, the rest are example conversions.
David Sterba (6):
btrfs: add helper for bit enumeration
btrfs: convert BTRFS_ILOCK-* defines to enum bit
btrfs: convert extent_io page op defines to enum bits
btrfs: convert EXTENT_* bits to enums
btrfs: convert QGROUP_* defines to enum bits
btrfs: convert __TRANS_* defines to enum bits
fs/btrfs/ctree.h | 9 +++-- fs/btrfs/extent-io-tree.h | 71 +++++++++++++++++++++------------------ fs/btrfs/extent_io.h | 17 ++++++---- fs/btrfs/misc.h | 8 +++++ fs/btrfs/qgroup.h | 9 +++-- fs/btrfs/transaction.h | 18 +++++----- 6 files changed, 78 insertions(+), 54 deletions(-)
Signature · 1 line
2.37.3
David Sterba
maintainerPATCH 2/6 btrfs: convert BTRFS_ILOCK-* defines to enum bit
--- fs/btrfs/ctree.h | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-)
fs/btrfs/ctree.h +6 -3
@@ -34,6 +34,7 @@#include "async-thread.h" #include "block-rsv.h" #include "locking.h" +#include "misc.h" struct btrfs_trans_handle ;struct btrfs_transaction ;
@@ -3128,9 +3129,11 @@ ssize_t btrfs_dio_rw(struct kiocb *iocb, struct iov_iter *iter, size_t done_befoextern const struct dentry_operations btrfs_dentry_operations;/* Inode locking type flags, by default the exclusive lock is taken */ -#define BTRFS_ILOCK_SHARED (1U << 0) -#define BTRFS_ILOCK_TRY (1U << 1) -#define BTRFS_ILOCK_MMAP (1U << 2) +enum btrfs_ilock_type { + ENUM_BIT(BTRFS_ILOCK_SHARED), + ENUM_BIT(BTRFS_ILOCK_TRY), + ENUM_BIT(BTRFS_ILOCK_MMAP), +};int btrfs_inode_lock (struct inode *inode,unsigned int ilock_flags);void btrfs_inode_unlock (struct inode *inode,unsigned int ilock_flags);
Signature · 1 line
2.37.3
David Sterba
maintainerPATCH 1/6 btrfs: add helper for bit enumeration
In reply to David SterbaDefine helper macro that can be used in enum {} to utilize the automatic increment to define all bits without directly defining the values or using additional linear bits.
1. capture the sequence value, N
2. use the value to define the given enum with N-th bit set
3. reset the sequence back to N
Use for enums that do not require fixed values for symbolic names (like for on-disk structures):
enum {
ENUM_BIT(FIRST),
ENUM_BIT(SECOND),
ENUM_BIT(THIRD)
};
Where the values would be 0x1, 0x2 and 0x4.
--- fs/btrfs/misc.h | 8 ++++++++ 1 file changed, 8 insertions(+)
fs/btrfs/misc.h +8 -0
@@ -10,6 +10,14 @@#define in_range (b, first, len) ((b) >= (first) && (b) < (first) + (len)) +/* +* Enumerate bits using enum autoincrement. Define the @name as the n-th bit. +*/ +#define ENUM_BIT (name) \ + __ ## name ## _BIT, \ + name = (1U << __ ## name ## _BIT), \ + __ ## name ## _SEQ = __ ## name ## _BIT +static inline void cond_wake_up (struct wait_queue_head *wq) {/*
Signature · 1 line
2.37.3
David Sterba
maintainerPATCH 3/6 btrfs: convert extent_io page op defines to enum bits
In reply to David Sterba--- fs/btrfs/extent_io.h | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-)
fs/btrfs/extent_io.h +10 -7
@@ -9,6 +9,7 @@#include <linux/btrfs_tree.h> #include "compression.h" #include "ulist.h" +#include "misc.h" enum {EXTENT_BUFFER_UPTODATE ,
@@ -29,13 +30,15 @@ enum { };/* these are flags for __process_pages_contig */ -#define PAGE_UNLOCK (1 << 0) -/* Page starts writeback, clear dirty bit and set writeback bit */ -#define PAGE_START_WRITEBACK (1 << 1) -#define PAGE_END_WRITEBACK (1 << 2) -#define PAGE_SET_ORDERED (1 << 3) -#define PAGE_SET_ERROR (1 << 4) -#define PAGE_LOCK (1 << 5) +enum { + ENUM_BIT(PAGE_UNLOCK), +/* Page starts writeback, clear dirty bit and set writeback bit */ + ENUM_BIT(PAGE_START_WRITEBACK), + ENUM_BIT(PAGE_END_WRITEBACK), + ENUM_BIT(PAGE_SET_ORDERED), + ENUM_BIT(PAGE_SET_ERROR), + ENUM_BIT(PAGE_LOCK), +};/* * page->private values. Every page that is controlled by the extent
Signature · 1 line
2.37.3
David Sterba
maintainerPATCH 4/6 btrfs: convert EXTENT_* bits to enums
In reply to David Sterba--- fs/btrfs/extent-io-tree.h | 71 +++++++++++++++++++++------------------ 1 file changed, 38 insertions(+), 33 deletions(-)
fs/btrfs/extent-io-tree.h +38 -33
@@ -3,43 +3,48 @@#ifndef BTRFS_EXTENT_IO_TREE_H #define BTRFS_EXTENT_IO_TREE_H +#include "misc.h" +struct extent_changeset ;struct io_failure_record ;/* Bits for the extent state */ -#define EXTENT_DIRTY (1U << 0) -#define EXTENT_UPTODATE (1U << 1) -#define EXTENT_LOCKED (1U << 2) -#define EXTENT_NEW (1U << 3) -#define EXTENT_DELALLOC (1U << 4) -#define EXTENT_DEFRAG (1U << 5) -#define EXTENT_BOUNDARY (1U << 6) -#define EXTENT_NODATASUM (1U << 7) -#define EXTENT_CLEAR_META_RESV (1U << 8) -#define EXTENT_NEED_WAIT (1U << 9) -#define EXTENT_NORESERVE (1U << 11) -#define EXTENT_QGROUP_RESERVED (1U << 12) -#define EXTENT_CLEAR_DATA_RESV (1U << 13) -/* -* Must be cleared only during ordered extent completion or on error paths if we -* did not manage to submit bios and create the ordered extents for the range. -* Should not be cleared during page release and page invalidation (if there is -* an ordered extent in flight), that is left for the ordered extent completion. -*/ -#define EXTENT_DELALLOC_NEW (1U << 14) -/* -* When an ordered extent successfully completes for a region marked as a new -* delalloc range, use this flag when clearing a new delalloc range to indicate -* that the VFS' inode number of bytes should be incremented and the inode's new -* delalloc bytes decremented, in an atomic way to prevent races with stat(2). -*/ -#define EXTENT_ADD_INODE_BYTES (1U << 15) - -/* -* Set during truncate when we're clearing an entire range and we just want the -* extent states to go away. -*/ -#define EXTENT_CLEAR_ALL_BITS (1U << 16) +enum { + ENUM_BIT(EXTENT_DIRTY), + ENUM_BIT(EXTENT_UPTODATE), + ENUM_BIT(EXTENT_LOCKED), + ENUM_BIT(EXTENT_NEW), + ENUM_BIT(EXTENT_DELALLOC), + ENUM_BIT(EXTENT_DEFRAG), + ENUM_BIT(EXTENT_BOUNDARY), + ENUM_BIT(EXTENT_NODATASUM), + ENUM_BIT(EXTENT_CLEAR_META_RESV), + ENUM_BIT(EXTENT_NEED_WAIT), + ENUM_BIT(EXTENT_NORESERVE), + ENUM_BIT(EXTENT_QGROUP_RESERVED), + ENUM_BIT(EXTENT_CLEAR_DATA_RESV), +/* +* Must be cleared only during ordered extent completion or on error +* paths if we did not manage to submit bios and create the ordered +* extents for the range. Should not be cleared during page release +* and page invalidation (if there is an ordered extent in flight), +* that is left for the ordered extent completion. +*/ + ENUM_BIT(EXTENT_DELALLOC_NEW), +/* +* When an ordered extent successfully completes for a region marked as +* a new delalloc range, use this flag when clearing a new delalloc +* range to indicate that the VFS' inode number of bytes should be +* incremented and the inode's new delalloc bytes decremented, in an +* atomic way to prevent races with stat(2). +*/ + ENUM_BIT(EXTENT_ADD_INODE_BYTES), +/* +* Set during truncate when we're clearing an entire range and we just +* want the extent states to go away. +*/ + ENUM_BIT(EXTENT_CLEAR_ALL_BITS), +};#define EXTENT_DO_ACCOUNTING (EXTENT_CLEAR_META_RESV | \ EXTENT_CLEAR_DATA_RESV)
Signature · 1 line
2.37.3
David Sterba
maintainerPATCH 5/6 btrfs: convert QGROUP_* defines to enum bits
In reply to David SterbaThe defines/enums are used only for tracepoints and are not part of the on-disk format.
--- fs/btrfs/qgroup.h | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-)
fs/btrfs/qgroup.h +6 -3
@@ -11,6 +11,7 @@#include <linux/kobject.h> #include "ulist.h" #include "delayed-ref.h" +#include "misc.h" /* * Btrfs qgroup overview
@@ -242,9 +243,11 @@ static inline u64 btrfs_qgroup_subvolid(u64 qgroupid)/* * For qgroup event trace points only */ -#define QGROUP_RESERVE (1<<0) -#define QGROUP_RELEASE (1<<1) -#define QGROUP_FREE (1<<2) +enum { + ENUM_BIT(QGROUP_RESERVE), + ENUM_BIT(QGROUP_RELEASE), + ENUM_BIT(QGROUP_FREE), +};int btrfs_quota_enable (struct btrfs_fs_info *fs_info);int btrfs_quota_disable (struct btrfs_fs_info *fs_info);
Signature · 1 line
2.37.3
David Sterba
maintainerPATCH 6/6 btrfs: convert __TRANS_* defines to enum bits
In reply to David SterbaThe base transaction bits can be defined as bits in a contiguous sequence, although right now there's a hole from bit 1 to 8.
The bits are used for btrfs_trans_handle::type, and there's another set of TRANS_STATE_* defines that are for btrfs_transaction::state. They are mutually exclusive though the hole in the sequence looks like was made for the states.
--- fs/btrfs/transaction.h | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-)
fs/btrfs/transaction.h +10 -8
@@ -10,6 +10,7 @@#include "btrfs_inode.h" #include "delayed-ref.h" #include "ctree.h" +#include "misc.h" enum btrfs_trans_state {TRANS_STATE_RUNNING ,
@@ -98,14 +99,15 @@ struct btrfs_transaction {struct list_head releasing_ebs; }; -#define __TRANS_FREEZABLE (1U << 0) - -#define __TRANS_START (1U << 9) -#define __TRANS_ATTACH (1U << 10) -#define __TRANS_JOIN (1U << 11) -#define __TRANS_JOIN_NOLOCK (1U << 12) -#define __TRANS_DUMMY (1U << 13) -#define __TRANS_JOIN_NOSTART (1U << 14) +enum { + ENUM_BIT(__TRANS_FREEZABLE), + ENUM_BIT(__TRANS_START), + ENUM_BIT(__TRANS_ATTACH), + ENUM_BIT(__TRANS_JOIN), + ENUM_BIT(__TRANS_JOIN_NOLOCK), + ENUM_BIT(__TRANS_DUMMY), + ENUM_BIT(__TRANS_JOIN_NOSTART), +};#define TRANS_START (__TRANS_START | __TRANS_FREEZABLE)#define TRANS_ATTACH (__TRANS_ATTACH)
Signature · 1 line
2.37.3
Quoted 12 lines · David Sterba
With some macro magic it's possible to let enum autoincrement define all bits without manually specifying the value. How it's done is described in the first patch, the rest are example conversions.
David Sterba (6):
btrfs: add helper for bit enumeration
btrfs: convert BTRFS_ILOCK-* defines to enum bit
btrfs: convertextent_iopage op defines to enum bits
btrfs: convert EXTENT_* bits to enums
btrfs: convert QGROUP_* defines to enum bits
btrfs: convert __TRANS_* defines to enum bits
Quoted 9 lines
fs/btrfs/ctree.h | 9 +++-- fs/btrfs/extent-io-tree.h | 71 +++++++++++++++++++++------------------ fs/btrfs/extent_io.h | 17 ++++++---- fs/btrfs/misc.h | 8 +++++ fs/btrfs/qgroup.h | 9 +++-- fs/btrfs/transaction.h | 18 +++++----- 6 files changed, 78 insertions(+), 54 deletions(-)
I love it,
Thanks,
Josef