Release 0.1.1

README.md

@@ -10,10 +10,10 @@
  </a>
  <!-- latest release as of current commit -->
  <a href="https://github.com/albertofaria/bdus/releases">
- <img src="https://img.shields.io/badge/version-0.1.0-yellow.svg" />
+ <img src="https://img.shields.io/badge/version-0.1.1-yellow.svg" />
  </a>
  <!-- license -->
- <a href="https://bdus.readthedocs.io/en/v0.1.0/user-manual/licensing.html">
+ <a href="https://bdus.readthedocs.io/en/v0.1.1/user-manual/licensing.html">
  <img src="https://img.shields.io/badge/license-MIT%20%2F%20GPLv2-blue.svg" />
  </a>
 </h1>
@@ -27,27 +27,27 @@ It was introduced by the SYSTOR '21 paper ["BDUS: Implementing Block Devices in
 
  <dt>Documentation</dt>
  <dd>
- All documentation is hosted at <a href="https://bdus.readthedocs.io/en/v0.1.0">Read the Docs</a>.
- To get started, take a look at the <a href="https://bdus.readthedocs.io/en/v0.1.0/quick-start-guide.html">Quick Start Guide</a>.
- You might also be looking for the <a href="https://bdus.readthedocs.io/en/v0.1.0/user-manual/api-reference.html">API reference</a>.
+ All documentation is hosted at <a href="https://bdus.readthedocs.io/en/v0.1.1">Read the Docs</a>.
+ To get started, take a look at the <a href="https://bdus.readthedocs.io/en/v0.1.1/quick-start-guide.html">Quick Start Guide</a>.
+ You might also be looking for the <a href="https://bdus.readthedocs.io/en/v0.1.1/user-manual/api-reference.html">API reference</a>.
  </dd>
 
  <dt>Installation</dt>
  <dd>
- Download <a href="https://github.com/albertofaria/bdus/archive/v0.1.0.tar.gz">BDUS' latest release</a> and run <code>sudo make install</code>.
- For more details, see <a href="https://bdus.readthedocs.io/en/v0.1.0/user-manual/installation.html">Installation</a>.
+ Download <a href="https://github.com/albertofaria/bdus/archive/v0.1.1.tar.gz">BDUS' latest release</a> and run <code>sudo make install</code>.
+ For more details, see <a href="https://bdus.readthedocs.io/en/v0.1.1/user-manual/installation.html">Installation</a>.
  </dd>
 
  <dt>Licensing</dt>
  <dd>
  BDUS is distributed under the terms of the <a href="LICENSE-MIT.txt">MIT license</a>, with the exception of its kernel module which is distributed under the terms of the <a href="LICENSE-GPLv2.txt">GPLv2 license</a>.
- For more details, see <a href="https://bdus.readthedocs.io/en/v0.1.0/user-manual/licensing.html">Licensing</a>.
+ For more details, see <a href="https://bdus.readthedocs.io/en/v0.1.1/user-manual/licensing.html">Licensing</a>.
  </dd>
 
  <dt>Contributing</dt>
  <dd>
  To report bugs, suggest improvements, or propose new features, please use GitHub's <a href="https://github.com/albertofaria/bdus/issues">issue tracking system</a>.
- For information on how to contribute changes, see <a href="https://bdus.readthedocs.io/en/v0.1.0/developer-manual/contributing.html">Contributing</a>.
+ For information on how to contribute changes, see <a href="https://bdus.readthedocs.io/en/v0.1.1/developer-manual/contributing.html">Contributing</a>.
  </dd>
 
  <dt>Citing</dt>

docs/user-manual/versions.rst

@@ -55,6 +55,16 @@ Version history
 
 The following is a list of all releases up to BDUS |version|, in reverse chronological order.
 
+0.1.1 (2021-07-09)
+~~~~~~~~~~~~~~~~~~
+
+The following is a list of notable changes relative to version 0.1.0.
+See also the :diff:`git diff <v0.1.0...v0.1.1>`.
+
+- *kbdus*: Expose the major and minor numbers of devices through fields :member:`kbdus_device_config.major` and :member:`kbdus_device_config.minor`.
+
+- *libbdus*: Expose the major and minor numbers of devices through fields :member:`bdus_ctx.major` and :member:`bdus_ctx.minor`.
+
 0.1.0 (2021-05-08)
 ~~~~~~~~~~~~~~~~~~
 

kbdus/include/kbdus.h

@@ -11,7 +11,7 @@
  * The three components of the version of the `kbdus.h` header file that was
  * included.
  */
-#define KBDUS_HEADER_VERSION_PATCH 0
+#define KBDUS_HEADER_VERSION_PATCH 1
 
 /* -------------------------------------------------------------------------- */
 

libbdus/include/bdus.h

@@ -15,7 +15,7 @@
  * returned by `bdus_get_libbdus_version()`, which is only determined at run
  * time.
  */
-#define BDUS_HEADER_VERSION_PATCH 0
+#define BDUS_HEADER_VERSION_PATCH 1
 
 #if !defined(BDUS_REQUIRE_VERSION_MAJOR) \
  && !defined(BDUS_REQUIRE_VERSION_MINOR) \
@@ -50,9 +50,9 @@
 BDUS_REQUIRE_VERSION_MINOR, and BDUS_REQUIRE_VERSION_PATCH or none at all
 
 #elif BDUS_REQUIRE_VERSION_MAJOR != 0 || BDUS_REQUIRE_VERSION_MINOR != 1 \
- || BDUS_REQUIRE_VERSION_PATCH > 0
+ || BDUS_REQUIRE_VERSION_PATCH > 1
 
-#error bdus.h has version 0.1.0 but incompatible version was required
+#error bdus.h has version 0.1.1 but incompatible version was required
 
 #error
 
@@ -104,11 +104,16 @@ struct bdus_ctx
  */
  void *private_data;
 
+#if BDUS_REQUIRE_VERSION_MAJOR == 0 && BDUS_REQUIRE_VERSION_MINOR == 1 \
+ && BDUS_REQUIRE_VERSION_PATCH == 1
+
  /** \brief The device's major number. */
  const uint32_t major;
 
  /** \brief The device's minor number. */
  const uint32_t minor;
+
+#endif
 };
 
 /**
@@ -825,7 +830,12 @@ static inline bool bdus_run(
  const struct bdus_ops *ops, const struct bdus_attrs *attrs,
  void *private_data)
 {
+#if BDUS_REQUIRE_VERSION_MAJOR == 0 && BDUS_REQUIRE_VERSION_MINOR == 1 \
+ && BDUS_REQUIRE_VERSION_PATCH == 1
  return bdus_run_0_1_1_(ops, attrs, private_data);
+#else
+ return bdus_run_0_1_0_(ops, attrs, private_data);
+#endif
 }
 
 bool bdus_rerun_0_1_0_(
@@ -883,7 +893,12 @@ static inline bool bdus_rerun(
  uint64_t dev_id, const struct bdus_ops *ops, const struct bdus_attrs *attrs,
  void *private_data)
 {
+#if BDUS_REQUIRE_VERSION_MAJOR == 0 && BDUS_REQUIRE_VERSION_MINOR == 1 \
+ && BDUS_REQUIRE_VERSION_PATCH == 1
  return bdus_rerun_0_1_1_(dev_id, ops, attrs, private_data);
+#else
+ return bdus_rerun_0_1_0_(dev_id, ops, attrs, private_data);
+#endif
 }
 
 /* -------------------------------------------------------------------------- */