fix(bindgen): expand the Fix753 workaround for any type and document it

[bcachefs-tools-debian] / bch_bindgen / src / libbcachefs_wrapper.h

diff --git a/bch_bindgen/src/libbcachefs_wrapper.h b/bch_bindgen/src/libbcachefs_wrapper.h
index 141b083590389f71ca8e2d77fa5d6b70792810cc..5dac92bc7ccd33db68e048653777f0453ecadd01 100644 (file)
--- a/bch_bindgen/src/libbcachefs_wrapper.h
+++ b/bch_bindgen/src/libbcachefs_wrapper.h
@@ -14,9 +14,22 @@
 #include "cmds.h"
 #include "raid/raid.h"
 
+/* Fix753 is a workaround for https://github.com/rust-lang/rust-bindgen/issues/753
+ * Functional macro are not expanded with bindgen, e.g. ioctl are automatically ignored
+ * from the generation
+ *
+ * To avoid this, use `MARK_FIX_753` to force the synthesis of your macro constant.
+ * It will appear in Rust with its proper name and not Fix753_{name}.
+ */
 
-#define MARK_FIX_753(req_name) const blk_mode_t Fix753_##req_name = req_name;
+/* MARK_FIX_753: force generate a macro constant in Rust
+ *
+ * @type_name   - a type for this constant
+ * @req_name    - a name for this constant which will be used inside of Rust
+ */
+#define MARK_FIX_753(type_name, req_name) const type_name Fix753_##req_name = req_name;
+
+MARK_FIX_753(blk_mode_t, BLK_OPEN_READ);
+MARK_FIX_753(blk_mode_t, BLK_OPEN_WRITE);
+MARK_FIX_753(blk_mode_t, BLK_OPEN_EXCL);
 
-MARK_FIX_753(BLK_OPEN_READ);
-MARK_FIX_753(BLK_OPEN_WRITE);
-MARK_FIX_753(BLK_OPEN_EXCL);