Skip to contentSkip to conversation

btrfs-progs: ctree.h: Deprecate unused limit flags

PATCH In review Qu Wenruo 3 participants 4 messages Nov 13, 2018 Btrfs file system

lore
Share & tools
lore

Qu Wenruo

author
#0 lore raw

PATCH 1/2 btrfs-progs: ctree.h: Deprecate unused limit flags

BTRFS_QGROUP_LIMIT_RSV_RFER/EXCL are never used by btrfs-progs. And kernel only do the basic assignment but don't really make use of them.

So deprecate these two flags in btrfs-progs.
Also, add some comment for all the used flags.

---
 ctree.h              | 12 ++++++------
 libbtrfsutil/btrfs.h | 12 ++++++------
 2 files changed, 12 insertions(+), 12 deletions(-)
ctree.h +6 -6
index 5d9ba3c555f1..1bbc5a2e9dee 100644
@@ -1038,12 +1038,12 @@ struct btrfs_qgroup_info_item {
 } __attribute__ ((__packed__));
 
 /* flags definition for qgroup limits */
-#define BTRFS_QGROUP_LIMIT_MAX_RFER	(1ULL << 0)
-#define BTRFS_QGROUP_LIMIT_MAX_EXCL	(1ULL << 1)
-#define BTRFS_QGROUP_LIMIT_RSV_RFER	(1ULL << 2)
-#define BTRFS_QGROUP_LIMIT_RSV_EXCL	(1ULL << 3)
-#define BTRFS_QGROUP_LIMIT_RFER_CMPR	(1ULL << 4)
-#define BTRFS_QGROUP_LIMIT_EXCL_CMPR	(1ULL << 5)
+#define BTRFS_QGROUP_LIMIT_MAX_RFER	(1ULL << 0) /* reference (rfer) limit */
+#define BTRFS_QGROUP_LIMIT_MAX_EXCL	(1ULL << 1) /* exclusive (excl) limit */
+#define __BTRFS_QGROUP_LIMIT_RSV_RFER	(1ULL << 2) /* deprecated */
+#define __BTRFS_QGROUP_LIMIT_RSV_EXCL	(1ULL << 3) /* deprecated */
+#define BTRFS_QGROUP_LIMIT_RFER_CMPR	(1ULL << 4) /* compressed rfer limit */
+#define BTRFS_QGROUP_LIMIT_EXCL_CMPR	(1ULL << 5) /* compressed excl limit */
 
 struct btrfs_qgroup_limit_item {
 	__le64 flags;
libbtrfsutil/btrfs.h +6 -6
index 1893c5a2172e..4e58a3cd167b 100644
@@ -54,12 +54,12 @@ struct btrfs_ioctl_vol_args {
  * struct btrfs_qgroup_limit.flags
  * struct btrfs_qgroup_limit_item.flags
  */
-#define BTRFS_QGROUP_LIMIT_MAX_RFER	(1ULL << 0)
-#define BTRFS_QGROUP_LIMIT_MAX_EXCL	(1ULL << 1)
-#define BTRFS_QGROUP_LIMIT_RSV_RFER	(1ULL << 2)
-#define BTRFS_QGROUP_LIMIT_RSV_EXCL	(1ULL << 3)
-#define BTRFS_QGROUP_LIMIT_RFER_CMPR	(1ULL << 4)
-#define BTRFS_QGROUP_LIMIT_EXCL_CMPR	(1ULL << 5)
+#define BTRFS_QGROUP_LIMIT_MAX_RFER	(1ULL << 0) /* reference (rfer) limit */
+#define BTRFS_QGROUP_LIMIT_MAX_EXCL	(1ULL << 1) /* exclusive (excl) limit */
+#define __BTRFS_QGROUP_LIMIT_RSV_RFER	(1ULL << 2) /* deprecated */
+#define __BTRFS_QGROUP_LIMIT_RSV_EXCL	(1ULL << 3) /* deprecated */
+#define BTRFS_QGROUP_LIMIT_RFER_CMPR	(1ULL << 4) /* compressed rfer limit */
+#define BTRFS_QGROUP_LIMIT_EXCL_CMPR	(1ULL << 5) /* compressed excl limit */
 
 struct btrfs_qgroup_limit {
 	__u64	flags;
Signature · 1 line
2.19.1
author
#1 lore raw

PATCH 2/2 btrfs-progs: gitignore: Ignore compressed man pages

Just to Make "git status" more clean.

---
 .gitignore | 1 +
 1 file changed, 1 insertion(+)
.gitignore +1 -0
index 82620f3cf603..ae4dce545a7b 100644
@@ -67,6 +67,7 @@
 
 /Documentation/Makefile
 /Documentation/*.html
+/Documentation/*.gz
 /Documentation/btrfs-balance.8
 /Documentation/btrfs-check.8
 /Documentation/btrfs-convert.8
Signature · 1 line
2.19.1
#2 lore raw

Re: [PATCH 2/2] btrfs-progs: gitignore: Ignore compressed man pages

Quoted 3 lines · Qu Wenruo

Just to Make "git status" more clean.

Please discard this one patch, as now we don't build .gz man pages anymore.

Quoted 17 lines
---
 .gitignore | 1 +
 1 file changed, 1 insertion(+)
.gitignore +1 -0
index 82620f3cf603..ae4dce545a7b 100644
@@ -67,6 +67,7 @@
 
 /Documentation/Makefile
 /Documentation/*.html
+/Documentation/*.gz
 /Documentation/btrfs-balance.8
 /Documentation/btrfs-check.8
 /Documentation/btrfs-convert.8
#3 lore raw
In reply to Qu Wenruo
Quoted 44 lines · Qu Wenruo

BTRFS_QGROUP_LIMIT_RSV_RFER/EXCL are never used by btrfs-progs. And kernel only do the basic assignment but don't really make use of them.

So deprecate these two flags in btrfs-progs.
Also, add some comment for all the used flags.

---
 ctree.h              | 12 ++++++------
 libbtrfsutil/btrfs.h | 12 ++++++------
 2 files changed, 12 insertions(+), 12 deletions(-)
ctree.h +6 -6
index 5d9ba3c555f1..1bbc5a2e9dee 100644
@@ -1038,12 +1038,12 @@ struct btrfs_qgroup_info_item {
 } __attribute__ ((__packed__));
 
 /* flags definition for qgroup limits */
-#define BTRFS_QGROUP_LIMIT_MAX_RFER	(1ULL << 0)
-#define BTRFS_QGROUP_LIMIT_MAX_EXCL	(1ULL << 1)
-#define BTRFS_QGROUP_LIMIT_RSV_RFER	(1ULL << 2)
-#define BTRFS_QGROUP_LIMIT_RSV_EXCL	(1ULL << 3)
-#define BTRFS_QGROUP_LIMIT_RFER_CMPR	(1ULL << 4)
-#define BTRFS_QGROUP_LIMIT_EXCL_CMPR	(1ULL << 5)
+#define BTRFS_QGROUP_LIMIT_MAX_RFER	(1ULL << 0) /* reference (rfer) limit */
+#define BTRFS_QGROUP_LIMIT_MAX_EXCL	(1ULL << 1) /* exclusive (excl) limit */
+#define __BTRFS_QGROUP_LIMIT_RSV_RFER	(1ULL << 2) /* deprecated */
+#define __BTRFS_QGROUP_LIMIT_RSV_EXCL	(1ULL << 3) /* deprecated */
+#define BTRFS_QGROUP_LIMIT_RFER_CMPR	(1ULL << 4) /* compressed rfer limit */
+#define BTRFS_QGROUP_LIMIT_EXCL_CMPR	(1ULL << 5) /* compressed excl limit */
 
 struct btrfs_qgroup_limit_item {
 	__le64 flags;
libbtrfsutil/btrfs.h +0 -0
index 1893c5a2172e..4e58a3cd167b 100644
@@ -54,12 +54,12 @@ struct btrfs_ioctl_vol_args {
  * struct btrfs_qgroup_limit.flags
  * struct btrfs_qgroup_limit_item.flags
  */

libbtrfsutil/btrfs.h struct btrfs_ioctl_vol_args { · line 60

Quoted 10 lines
libbtrfsutil/btrfs.h +4 -6
-#define BTRFS_QGROUP_LIMIT_MAX_RFER	(1ULL << 0)
-#define BTRFS_QGROUP_LIMIT_MAX_EXCL	(1ULL << 1)
-#define BTRFS_QGROUP_LIMIT_RSV_RFER	(1ULL << 2)
-#define BTRFS_QGROUP_LIMIT_RSV_EXCL	(1ULL << 3)
-#define BTRFS_QGROUP_LIMIT_RFER_CMPR	(1ULL << 4)
-#define BTRFS_QGROUP_LIMIT_EXCL_CMPR	(1ULL << 5)
+#define BTRFS_QGROUP_LIMIT_MAX_RFER	(1ULL << 0) /* reference (rfer) limit */
+#define BTRFS_QGROUP_LIMIT_MAX_EXCL	(1ULL << 1) /* exclusive (excl) limit */
+#define __BTRFS_QGROUP_LIMIT_RSV_RFER	(1ULL << 2) /* deprecated */
+#define __BTRFS_QGROUP_LIMIT_RSV_EXCL	(1ULL << 3) /* deprecated */

Same feedback as the kernel counterpart - just put the /* deprecated */ comment, let the kernel warning settle for a few releases (removing it in the next one might be a bit optimistic) and then just remove it.

Quoted 6 lines
libbtrfsutil/btrfs.h +2 -0
+#define BTRFS_QGROUP_LIMIT_RFER_CMPR	(1ULL << 4) /* compressed rfer limit */
+#define BTRFS_QGROUP_LIMIT_EXCL_CMPR	(1ULL << 5) /* compressed excl limit */
 
 struct btrfs_qgroup_limit {
 	__u64	flags;