Merging upstream version 1.4.

Signed-off-by: Daniel Baumann <daniel@debian.org>

.github/cross/clang.txt

@@ -0,0 +1,5 @@
+[binaries]
+c = 'clang'
+cpp = 'clang++'
+strip = 'strip'
+pkgconfig = 'pkg-config'

.github/workflows/build.yml

@@ -0,0 +1,389 @@
+---
+name: build
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+  workflow_dispatch:
+
+jobs:
+  gcc-debug:
+    name: gcc debug
+    runs-on: ubuntu-latest
+    steps:
+      - name: install libraries
+        run: sudo apt-get install gcc pkg-config libjson-c-dev libssl-dev python3-dev
+      - uses: actions/checkout@v3
+      - uses: actions/setup-python@v4
+        with:
+          python-version: '3.x'
+      - uses: BSFishy/meson-build@v1.0.3
+        name: build
+        with:
+          action: build
+          setup-options: >
+            --werror
+            --buildtype=debug
+            --wrap-mode=nofallback
+          meson-version: 0.61.2
+      - uses: BSFishy/meson-build@v1.0.3
+        name: test
+        with:
+          action: test
+          meson-version: 0.61.2
+      - uses: actions/upload-artifact@v3
+        name: upload logs
+        if: failure()
+        with:
+          name: logs files
+          path: |
+            build/meson-logs/*.txt
+
+  gcc-release:
+    name: gcc release
+    runs-on: ubuntu-latest
+    steps:
+      - name: install libraries
+        run: sudo apt-get install gcc pkg-config libjson-c-dev libdbus-1-dev python3-dev
+      - uses: actions/checkout@v3
+      - uses: actions/setup-python@v4
+        with:
+          python-version: '3.x'
+      - uses: BSFishy/meson-build@v1.0.3
+        name: build
+        with:
+          action: build
+          setup-options: >
+            --werror
+            --buildtype=release
+            --wrap-mode=nofallback
+            -Dlibdbus=enabled
+          meson-version: 0.61.2
+      - uses: BSFishy/meson-build@v1.0.3
+        name: test
+        with:
+          action: test
+          meson-version: 0.61.2
+      - uses: actions/upload-artifact@v3
+        name: upload logs
+        if: failure()
+        with:
+          name: log files
+          path: |
+            build/meson-logs/*.txt
+
+  clang-release:
+    name: clang release
+    runs-on: ubuntu-latest
+    steps:
+      - name: install libraries
+        run: sudo apt-get install clang pkg-config libjson-c-dev libdbus-1-dev python3-dev
+      - uses: actions/checkout@v3
+      - uses: actions/setup-python@v4
+        with:
+          python-version: '3.x'
+      - uses: BSFishy/meson-build@v1.0.3
+        name: build
+        with:
+          action: build
+          setup-options: >
+            --werror
+            --buildtype=release
+            --wrap-mode=nofallback
+            --cross-file=.github/cross/clang.txt
+            -Dlibdbus=enabled
+          meson-version: 0.61.2
+      - uses: BSFishy/meson-build@v1.0.3
+        name: test
+        with:
+          action: test
+          meson-version: 0.61.2
+      - uses: actions/upload-artifact@v3
+        name: upload logs
+        if: failure()
+        with:
+          name: log files
+          path: |
+            build/meson-logs/*.txt
+
+  fallback-shared-libraries:
+    name: fallback shared libraries
+    runs-on: ubuntu-latest
+    steps:
+      - name: install libraries
+        run: sudo apt-get install libpam-dev libcap-ng-dev
+      - uses: actions/checkout@v3
+      - uses: actions/setup-python@v4
+        with:
+          python-version: '3.x'
+      - uses: BSFishy/meson-build@v1.0.3
+        name: build
+        with:
+          action: build
+          setup-options: >
+            --werror
+            --buildtype=release
+            --wrap-mode=forcefallback
+            -Dlibdbus=enabled
+            -Ddbus:werror=false
+            -Dopenssl:werror=false
+          meson-version: 0.61.2
+      - uses: BSFishy/meson-build@v1.0.3
+        name: test
+        with:
+          action: test
+          meson-version: 0.61.2
+      - uses: actions/upload-artifact@v3
+        if: failure()
+        with:
+          name: log files
+          path: |
+            build/meson-logs/*.txt
+
+  fallback-static-libraries:
+    name: fallback static libraries
+    runs-on: ubuntu-latest
+    steps:
+      - name: install libraries
+        run: sudo apt-get install libpam-dev libcap-ng-dev
+      - uses: actions/checkout@v3
+      - uses: actions/setup-python@v4
+        with:
+          python-version: '3.x'
+      - uses: BSFishy/meson-build@v1.0.3
+        name: build
+        with:
+          action: build
+          setup-options: >
+            --werror
+            --buildtype=release
+            --wrap-mode=forcefallback
+            --default-library=static
+            -Dlibdbus=enabled
+            -Ddbus:werror=false
+            -Dopenssl:werror=false
+          meson-version: 0.61.2
+      - uses: BSFishy/meson-build@v1.0.3
+        name: test
+        with:
+          action: test
+          meson-version: 0.61.2
+      - uses: actions/upload-artifact@v3
+        name: upload logs
+        if: failure()
+        with:
+          name: log files
+          path: |
+            build/meson-logs/*.txt
+
+  fallback-all-static:
+    name: fallback all static
+    runs-on: ubuntu-latest
+    steps:
+      - name: install libraries
+        run: sudo apt-get install libpam-dev libcap-ng-dev
+      - uses: actions/checkout@v3
+      - uses: actions/setup-python@v4
+        with:
+          python-version: '3.x'
+      - uses: BSFishy/meson-build@v1.0.3
+        name: build
+        with:
+          action: build
+          setup-options: >
+            --werror
+            --buildtype=release
+            --wrap-mode=forcefallback
+            --default-library=static
+            --cross-file=.github/cross/ubuntu-static.txt
+            -Dlibdbus=enabled
+            -Ddbus:werror=false
+            -Dopenssl:werror=false
+          meson-version: 0.61.2
+      - uses: BSFishy/meson-build@v1.0.3
+        name: test
+        with:
+          action: test
+          meson-version: 0.61.2
+      - uses: actions/upload-artifact@v3
+        name: upload logs
+        if: failure()
+        with:
+          name: log files
+          path: |
+            build/meson-logs/*.txt
+
+  cross-armhf:
+    name: cross armhf
+    runs-on: ubuntu-latest
+    steps:
+      - name: set up arm architecture
+        run: |
+          export release=$(lsb_release -c -s)
+          sudo dpkg --add-architecture armhf
+          sudo sed -i -e 's/deb http/deb [arch=amd64] http/g' /etc/apt/sources.list
+          sudo dd of=/etc/apt/sources.list.d/armhf.list <<EOF
+          deb [arch=armhf] http://ports.ubuntu.com/ $release main universe restricted"
+          deb [arch=armhf] http://ports.ubuntu.com/ $release-updates main universe restricted"
+          EOF
+          sudo apt update
+      - name: install armhf compiler
+        run: sudo apt install gcc-arm-linux-gnueabihf pkg-config qemu-user-static
+      - name: install libraries
+        run: sudo apt install libjson-c-dev:armhf
+      - uses: actions/checkout@v3
+      - uses: BSFishy/meson-build@v1.0.3
+        name: build
+        with:
+          action: build
+          setup-options: >
+            --werror
+            --buildtype=release
+            --wrap-mode=nofallback
+            --cross-file=.github/cross/ubuntu-armhf.txt
+            -Dpython=disabled
+          meson-version: 0.61.2
+      - uses: BSFishy/meson-build@v1.0.3
+        name: test
+        with:
+          action: test
+          meson-version: 0.61.2
+      - uses: actions/upload-artifact@v3
+        name: upload logs
+        if: failure()
+        with:
+          name: log files
+          path: |
+            build/meson-logs/*.txt
+
+  cross-ppc64le:
+    name: cross ppc64le
+    runs-on: ubuntu-latest
+    steps:
+      - name: set up ppc64le architecture
+        run: |
+          export release=$(lsb_release -c -s)
+          sudo dpkg --add-architecture ppc64el
+          sudo sed -i -e 's/deb http/deb [arch=amd64] http/g' /etc/apt/sources.list
+          sudo dd of=/etc/apt/sources.list.d/ppc64el.list <<EOF
+          deb [arch=ppc64el] http://ports.ubuntu.com/ $release main universe restricted"
+          deb [arch=ppc64el] http://ports.ubuntu.com/ $release-updates main universe restricted"
+          EOF
+          sudo apt update
+      - name: install powerpc64le compiler
+        run: sudo apt install gcc-powerpc64le-linux-gnu pkg-config qemu-user-static
+      - name: install libraries
+        run: sudo apt install libjson-c-dev:ppc64el
+      - uses: actions/checkout@v3
+      - uses: BSFishy/meson-build@v1.0.3
+        name: build
+        with:
+          action: build
+          setup-options: >
+            --werror
+            --buildtype=release
+            --wrap-mode=nofallback
+            --cross-file=.github/cross/ubuntu-ppc64le.txt
+            -Dpython=disabled
+          meson-version: 0.61.2
+      - uses: BSFishy/meson-build@v1.0.3
+        name: test
+        with:
+          action: test
+          meson-version: 0.61.2
+      - uses: actions/upload-artifact@v3
+        name: upload logs
+        if: failure()
+        with:
+          name: log files
+          path: |
+            build/meson-logs/*.txt
+
+  cross-s390x:
+    name: cross s390x
+    runs-on: ubuntu-latest
+    steps:
+      - name: set up s390x architecture
+        run: |
+          export release=$(lsb_release -c -s)
+          sudo dpkg --add-architecture s390x
+          sudo sed -i -e 's/deb http/deb [arch=amd64] http/g' /etc/apt/sources.list
+          sudo dd of=/etc/apt/sources.list.d/s390x.list <<EOF
+          deb [arch=s390x] http://ports.ubuntu.com/ $release main universe restricted"
+          deb [arch=s390x] http://ports.ubuntu.com/ $release-updates main universe restricted"
+          EOF
+          sudo apt update
+      - name: install s390x compiler
+        run: sudo apt install gcc-s390x-linux-gnu pkg-config qemu-user-static
+      - name: install libraries
+        run: sudo apt install libjson-c-dev:s390x
+      - uses: actions/checkout@v3
+      - uses: BSFishy/meson-build@v1.0.3
+        name: build
+        with:
+          action: build
+          setup-options: >
+            --werror
+            --buildtype=release
+            --wrap-mode=nofallback
+            --cross-file=.github/cross/ubuntu-s390x.txt
+            -Dpython=disabled
+          meson-version: 0.61.2
+      - uses: BSFishy/meson-build@v1.0.3
+        name: test
+        with:
+          action: test
+          meson-version: 0.61.2
+      - uses: actions/upload-artifact@v3
+        name: upload logs
+        if: failure()
+        with:
+          name: log files
+          path: |
+            build/meson-logs/*.txt
+
+  build-muon:
+    name: muon minimal
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - name: build muon and samurai build-tool
+        run: |
+          mkdir build-tools
+          cd build-tools
+          git clone --depth 1 https://git.sr.ht/~lattis/muon
+          cd muon
+
+          export CC=gcc
+          export ninja=build/samu
+
+          ./tools/bootstrap_ninja.sh build
+          ./bootstrap.sh build
+
+          build/muon setup           \
+              -Dlibcurl=disabled     \
+              -Dlibarchive=disabled  \
+              -Ddocs=disabled        \
+              -Dsamurai=disabled     \
+              build
+          build/samu -C build
+          build/muon -C build test
+      - name: build
+        run: |
+          export PATH=$(pwd)/build-tools/muon/build:$PATH
+
+          muon setup                \
+              -Dpython=disabled     \
+              -Dopenssl=disabled    \
+              -Dlibdbus=disabled    \
+              -Djson-c=disabled     \
+              build
+          samu -C build
+      - name: test
+        run: |
+          export PATH=$(pwd)/build-tools/muon/build:$PATH
+
+          muon -C build test

.github/workflows/coverage.yml

@@ -0,0 +1,38 @@
+---
+name: coverage
+
+on:
+  push:
+    branches: [master]
+
+jobs:
+  code-coverage:
+    name: code coverage
+    runs-on: ubuntu-latest
+    steps:
+      - name: install libraries
+        run: sudo apt-get install libjson-c-dev libdbus-1-dev lcov
+      - uses: actions/checkout@v3
+      - uses: actions/setup-python@v4
+        with:
+          python-version: '3.x'
+      - uses: BSFishy/meson-build@v1.0.3
+        with:
+          # Can't use 'coverage' here, see
+          # https://github.com/BSFishy/meson-build/issues/4
+          action: test
+          options: --verbose
+          setup-options: >
+            --werror
+            --buildtype=release
+            --wrap-mode=nofallback
+            -Dlibdbus=enabled
+            -Db_coverage=true
+          meson-version: 0.61.2
+      - name: Generate Coverage Report
+        # Can't use meson here, see
+        # https://github.com/mesonbuild/meson/issues/7895
+        run: ninja -C build coverage --verbose
+      - uses: codecov/codecov-action@v3
+        with:
+          fail_ci_if_error: false

.github/workflows/meson.yml

@@ -1,209 +0,0 @@
-name: libnvme meson CI
-
-on:
-  push:
-    branches: [ master ]
-  pull_request:
-    branches: [ master ]
-
-  workflow_dispatch:
-
-jobs:
-  build-disto:
-    runs-on: ubuntu-latest
-    steps:
-      - name: install libraries
-        run: sudo apt-get install libjson-c-dev libdbus-1-dev
-      - uses: actions/checkout@v3
-      - uses: actions/setup-python@v4
-        with:
-          python-version: '3.x'
-      - uses: BSFishy/meson-build@v1.0.3
-        with:
-          setup-options: --werror
-          options: --verbose
-          action: test
-      # Preserve meson's log file on failure
-      - uses: actions/upload-artifact@v3
-        if: failure()
-        with:
-          name: Linux_Meson_Testlog
-          path: build/meson-logs/testlog.txt
-
-  build-cross-armhf:
-    runs-on: ubuntu-latest
-    steps:
-      - name: set up arm architecture
-        run: |
-          export release=$(lsb_release -c -s)
-          sudo dpkg --add-architecture armhf
-          sudo sed -i -e 's/deb http/deb [arch=amd64] http/g' /etc/apt/sources.list
-          sudo dd of=/etc/apt/sources.list.d/armhf.list <<EOF
-          deb [arch=armhf] http://ports.ubuntu.com/ $release main universe restricted"
-          deb [arch=armhf] http://ports.ubuntu.com/ $release-updates main universe restricted"
-          EOF
-          sudo apt update
-      - name: install armhf compiler
-        run: sudo apt install gcc-arm-linux-gnueabihf pkg-config qemu-user-static
-      - name: install libraries
-        run: sudo apt install libjson-c-dev:armhf
-      - uses: actions/checkout@v3
-      - uses: BSFishy/meson-build@v1.0.3
-        with:
-          # suppress python for now; the python headers currently assume native
-          setup-options: --werror --cross-file=.github/cross/ubuntu-armhf.txt --wrap-mode=nofallback -Dpython=false
-          options: --verbose
-          action: test
-      - uses: actions/upload-artifact@v3
-        if: failure()
-        with:
-          name: Linux_Meson_Testlog
-          path: build/meson-logs/testlog.txt
-
-  build-cross-ppc64le:
-    runs-on: ubuntu-latest
-    steps:
-      - name: set up ppc64le architecture
-        run: |
-          export release=$(lsb_release -c -s)
-          sudo dpkg --add-architecture ppc64el
-          sudo sed -i -e 's/deb http/deb [arch=amd64] http/g' /etc/apt/sources.list
-          sudo dd of=/etc/apt/sources.list.d/ppc64el.list <<EOF
-          deb [arch=ppc64el] http://ports.ubuntu.com/ $release main universe restricted"
-          deb [arch=ppc64el] http://ports.ubuntu.com/ $release-updates main universe restricted"
-          EOF
-          sudo apt update
-      - name: install powerpc64le compiler
-        run: sudo apt install gcc-powerpc64le-linux-gnu pkg-config qemu-user-static
-      - name: install libraries
-        run: sudo apt install libjson-c-dev:ppc64el
-      - uses: actions/checkout@v3
-      - uses: BSFishy/meson-build@v1.0.3
-        with:
-          # suppress python for now; the python headers currently assume native
-          setup-options: --werror --cross-file=.github/cross/ubuntu-ppc64le.txt --wrap-mode=nofallback -Dpython=false
-          options: --verbose
-          action: test
-      - uses: actions/upload-artifact@v3
-        if: failure()
-        with:
-          name: Linux_Meson_Testlog
-          path: build/meson-logs/testlog.txt
-
-  build-cross-s390x:
-    runs-on: ubuntu-latest
-    steps:
-      - name: set up s390x architecture
-        run: |
-          export release=$(lsb_release -c -s)
-          sudo dpkg --add-architecture s390x
-          sudo sed -i -e 's/deb http/deb [arch=amd64] http/g' /etc/apt/sources.list
-          sudo dd of=/etc/apt/sources.list.d/s390x.list <<EOF
-          deb [arch=s390x] http://ports.ubuntu.com/ $release main universe restricted"
-          deb [arch=s390x] http://ports.ubuntu.com/ $release-updates main universe restricted"
-          EOF
-          sudo apt update
-      - name: install s390x compiler
-        run: sudo apt install gcc-s390x-linux-gnu pkg-config qemu-user-static
-      - name: install libraries
-        run: sudo apt install libjson-c-dev:s390x
-      - uses: actions/checkout@v3
-      - uses: BSFishy/meson-build@v1.0.3
-        with:
-          # suppress python for now; the python headers currently assume native
-          setup-options: --werror --cross-file=.github/cross/ubuntu-s390x.txt --wrap-mode=nofallback -Dpython=false
-          options: --verbose
-          action: test
-      - uses: actions/upload-artifact@v3
-        if: failure()
-        with:
-          name: Linux_Meson_Testlog
-          path: build/meson-logs/testlog.txt
-
-  build-fallback:
-    runs-on: ubuntu-latest
-    steps:
-      - name: install libraries
-        run: sudo apt-get install -y libpam-dev libcap-ng-dev
-      - uses: actions/checkout@v3
-      - uses: actions/setup-python@v4
-        with:
-          python-version: '3.x'
-      - uses: BSFishy/meson-build@v1.0.3
-        with:
-          setup-options: --wrap-mode=forcefallback
-          options: --verbose
-          action: test
-          meson-version: 0.61.2
-      # Preserve meson's log file on failure
-      - uses: actions/upload-artifact@v3
-        if: failure()
-        with:
-          name: Linux_Meson_log
-          path: build/meson-logs/meson-log.txt
-
-  build-with-libray-static:
-    runs-on: ubuntu-latest
-    steps:
-      - name: install libraries
-        run: sudo apt-get install -y libpam-dev libcap-ng-dev
-      - uses: actions/checkout@v3
-      - uses: actions/setup-python@v4
-        with:
-          python-version: '3.x'
-      - uses: BSFishy/meson-build@v1.0.3
-        with:
-          setup-options: --wrap-mode=forcefallback --default-library=static
-          options: --verbose
-          action: test
-          meson-version: 0.61.2
-      # Preserve meson's log file on failure
-      - uses: actions/upload-artifact@v3
-        if: failure()
-        with:
-          name: Linux_Meson_log
-          path: build/meson-logs/meson-log.txt
-
-  build-static:
-    runs-on: ubuntu-latest
-    steps:
-      - name: install libraries
-        run: sudo apt-get install -y libpam-dev libcap-ng-dev
-      - uses: actions/checkout@v3
-      - uses: actions/setup-python@v4
-        with:
-          python-version: '3.x'
-      - uses: BSFishy/meson-build@v1.0.3
-        with:
-          setup-options: --wrap-mode=forcefallback --cross-file=.github/cross/ubuntu-static.txt --default-library=static
-          options: --verbose
-          action: test
-          meson-version: 0.61.2
-      # Preserve meson's log file on failure
-      - uses: actions/upload-artifact@v3
-        if: failure()
-        with:
-          name: Linux_Meson_log
-          path: build/meson-logs/meson-log.txt
-
-  code-coverage:
-    runs-on: ubuntu-latest
-    steps:
-      - name: install libraries
-        run: sudo apt-get install libjson-c-dev libdbus-1-dev lcov
-      - uses: actions/checkout@v3
-      - uses: actions/setup-python@v4
-        with:
-          python-version: '3.x'
-      - uses: BSFishy/meson-build@v1.0.3
-        with:
-          setup-options: -Db_coverage=true --werror
-          options: --verbose
-          # Can't use 'coverage' here, see https://github.com/BSFishy/meson-build/issues/4
-          action: test
-      - name: Generate Coverage Report
-        # Can't use meson here, see https://github.com/mesonbuild/meson/issues/7895
-        run: ninja -C build coverage --verbose
-      - uses: codecov/codecov-action@v3
-        with:
-          fail_ci_if_error: false

.github/workflows/release-python.yml

@@ -1,12 +1,14 @@
-name: Build and upload to PyPI
+---
+name: release python
 
 on:
   push:
-    branches: [ master ]
+    branches: [master]
     tags:
       - '**'
   pull_request:
-    branches: [ master ]
+    branches: [master]
+
   workflow_dispatch:
 
 jobs:

.github/workflows/release.yml

@@ -1,8 +1,9 @@
-name: Releases
+---
+name: release
 
 on:
   push:
-    branches: [ master ]
+    branches: [master]
     tags:
       - '**'
 
@@ -13,7 +14,7 @@ jobs:
     permissions:
       contents: write
     steps:
-    - uses: actions/checkout@v3
-    - uses: ncipollo/release-action@v1
-      with:
-        token: ${{ secrets.GITHUB_TOKEN }}
+      - uses: actions/checkout@v3
+      - uses: ncipollo/release-action@v1
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}

README.md

@@ -85,13 +85,13 @@ Using meson is similar to projects that use a `configure` script before running
 To `configure` the project:
 
 ```
-meson .build
+meson setup .build
 ```
 
 Which will default to build a shared library. To configure for static libraries call
 
 ```
-meson .build --default-library=static
+meson setup .build --default-library=static
 ```
 
 One nice feature of meson is that it doesn't mix build artifacts
@@ -160,10 +160,10 @@ rm -rf .build
 
 A few build options can be specified on the command line when invoking meson.
 
-| Option | Values [default]    | Description                                                  |
-| ------ | ------------------- | ------------------------------------------------------------ |
-| man    | true, [false]       | Instruct meson to configure the project to build the `libnvme` documentation. <br />Example: `meson .build -Dman=true` |
-| python | [auto], true, false | Whether to build the Python bindings. When set to `auto`, the default, meson will check for the presence of the  tools and libraries (e.g. `swig`) required to build the Python bindings. If found, meson will configure the project to build the Python bindings. If a tool or library is missing, then the Python bindings won't be built. Setting this to `true`, forces the Python bindings to be built. When set to `false`, meson will configure the project to not build the Python bindings.<br />Example: `meson .build -Dpython=false` |
+| Option | Values [default]          | Description                                                  |
+| ------ | ------------------------- | ------------------------------------------------------------ |
+| man    | true, [false]             | Instruct meson to configure the project to build the `libnvme` documentation. <br />Example: `meson .build -Dman=true` |
+| python | [auto], enabled, disabled | Whether to build the Python bindings. When set to `auto`, the default, meson will check for the presence of the  tools and libraries (e.g. `swig`) required to build the Python bindings. If found, meson will configure the project to build the Python bindings. If a tool or library is missing, then the Python bindings won't be built. Setting this to `enabled`, forces the Python bindings to be built. When set to `disabled`, meson will configure the project to not build the Python bindings.<br />Example: `meson setup .build -Dpython=disabled` |
 
 ### Changing the build options from the command-line (i.e. w/o modifying any files)
 
@@ -171,19 +171,19 @@ To configure a build for debugging purposes (i.e. optimization turned
 off and debug symbols enabled):
 
 ```bash
-meson .build -Dbuildtype=debug
+meson setup .build --buildtype=debug
 ```
 
 To enable address sanitizer (advanced debugging of memory issues):
 
 ```bash
-meson .build -Db_sanitize=address
+meson setup .build -Db_sanitize=address
 ```
 
 This option adds `-fsanitize=address` to the gcc options. Note that when using the sanitize feature, the library `libasan.so` must be available and must be the very first library loaded when running an executable. Ensuring that `libasan.so` gets loaded first can be achieved with the `LD_PRELOAD` environment variable as follows: 
 
 ```
-meson .build -Db_sanitize=address && LD_PRELOAD=/lib64/libasan.so.6 ninja -C .build test 
+meson setup .build -Db_sanitize=address && LD_PRELOAD=/lib64/libasan.so.6 ninja -C .build test 
 ```
 
 To list configuration options that are available and possible values:

doc/conf.py

@@ -12,7 +12,7 @@ copyright = '2020, Keith Busch'
 author = 'Keith Busch <kbusch@kernel.org>'
 master_doc = 'index'
 
-release = '1.3'
+release = '1.4'
 
 
 # -- General configuration ---------------------------------------------------

doc/man/nvme_admin_opcode.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "enum nvme_admin_opcode" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "enum nvme_admin_opcode" "March 2023" "API Manual" LINUX
 .SH NAME
 enum nvme_admin_opcode \- Known NVMe admin opcodes
 .SH SYNOPSIS

doc/man/nvme_admin_passthru.2

@@ -1,4 +1,4 @@
-.TH "nvme_admin_passthru" 9 "nvme_admin_passthru" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_admin_passthru" 9 "nvme_admin_passthru" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_admin_passthru \- Submit an nvme passthrough command
 .SH SYNOPSIS

doc/man/nvme_admin_passthru64.2

@@ -1,4 +1,4 @@
-.TH "nvme_admin_passthru64" 9 "nvme_admin_passthru64" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_admin_passthru64" 9 "nvme_admin_passthru64" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_admin_passthru64 \- Submit a 64-bit nvme passthrough command
 .SH SYNOPSIS

doc/man/nvme_ae_info_css_nvm.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "enum nvme_ae_info_css_nvm" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "enum nvme_ae_info_css_nvm" "March 2023" "API Manual" LINUX
 .SH NAME
 enum nvme_ae_info_css_nvm \- Asynchronous Event Information - I/O Command Specific Status
 .SH SYNOPSIS

doc/man/nvme_ae_info_error.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "enum nvme_ae_info_error" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "enum nvme_ae_info_error" "March 2023" "API Manual" LINUX
 .SH NAME
 enum nvme_ae_info_error \- Asynchronous Event Information - Error Status
 .SH SYNOPSIS

doc/man/nvme_ae_info_notice.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "enum nvme_ae_info_notice" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "enum nvme_ae_info_notice" "March 2023" "API Manual" LINUX
 .SH NAME
 enum nvme_ae_info_notice \- Asynchronous Event Information - Notice
 .SH SYNOPSIS

doc/man/nvme_ae_info_smart.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "enum nvme_ae_info_smart" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "enum nvme_ae_info_smart" "March 2023" "API Manual" LINUX
 .SH NAME
 enum nvme_ae_info_smart \- Asynchronous Event Information - SMART / Health Status
 .SH SYNOPSIS

doc/man/nvme_ae_type.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "enum nvme_ae_type" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "enum nvme_ae_type" "March 2023" "API Manual" LINUX
 .SH NAME
 enum nvme_ae_type \- Asynchronous Event Type
 .SH SYNOPSIS

doc/man/nvme_aggregate_endurance_group_event.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "struct nvme_aggregate_endurance_group_event" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "struct nvme_aggregate_endurance_group_event" "March 2023" "API Manual" LINUX
 .SH NAME
 struct nvme_aggregate_endurance_group_event \- Endurance Group Event Aggregate
 .SH SYNOPSIS

doc/man/nvme_aggregate_predictable_lat_event.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "struct nvme_aggregate_predictable_lat_event" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "struct nvme_aggregate_predictable_lat_event" "March 2023" "API Manual" LINUX
 .SH NAME
 struct nvme_aggregate_predictable_lat_event \- Predictable Latency Event Aggregate Log Page
 .SH SYNOPSIS

doc/man/nvme_ana_group_desc.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "struct nvme_ana_group_desc" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "struct nvme_ana_group_desc" "March 2023" "API Manual" LINUX
 .SH NAME
 struct nvme_ana_group_desc \- ANA Group Descriptor
 .SH SYNOPSIS

doc/man/nvme_ana_log.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "struct nvme_ana_log" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "struct nvme_ana_log" "March 2023" "API Manual" LINUX
 .SH NAME
 struct nvme_ana_log \- Asymmetric Namespace Access Log
 .SH SYNOPSIS

doc/man/nvme_ana_state.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "enum nvme_ana_state" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "enum nvme_ana_state" "March 2023" "API Manual" LINUX
 .SH NAME
 enum nvme_ana_state \- ANA Group Descriptor - Asymmetric Namespace Access State
 .SH SYNOPSIS

doc/man/nvme_apst_entry.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "enum nvme_apst_entry" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "enum nvme_apst_entry" "March 2023" "API Manual" LINUX
 .SH NAME
 enum nvme_apst_entry \- Autonomous Power State Transition
 .SH SYNOPSIS

doc/man/nvme_boot_partition.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "struct nvme_boot_partition" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "struct nvme_boot_partition" "March 2023" "API Manual" LINUX
 .SH NAME
 struct nvme_boot_partition \- Boot Partition Log
 .SH SYNOPSIS

doc/man/nvme_capacity_config_desc.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "struct nvme_capacity_config_desc" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "struct nvme_capacity_config_desc" "March 2023" "API Manual" LINUX
 .SH NAME
 struct nvme_capacity_config_desc \- Capacity Configuration structure definitions
 .SH SYNOPSIS

doc/man/nvme_capacity_mgmt.2

@@ -1,4 +1,4 @@
-.TH "nvme_capacity_mgmt" 9 "nvme_capacity_mgmt" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_capacity_mgmt" 9 "nvme_capacity_mgmt" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_capacity_mgmt \- Capacity management command
 .SH SYNOPSIS

doc/man/nvme_change_ns_event.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "struct nvme_change_ns_event" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "struct nvme_change_ns_event" "March 2023" "API Manual" LINUX
 .SH NAME
 struct nvme_change_ns_event \- Change Namespace Event Data
 .SH SYNOPSIS

doc/man/nvme_channel_config_desc.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "struct nvme_channel_config_desc" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "struct nvme_channel_config_desc" "March 2023" "API Manual" LINUX
 .SH NAME
 struct nvme_channel_config_desc \- Channel Configuration Descriptor
 .SH SYNOPSIS

doc/man/nvme_cmb_size.2

@@ -1,4 +1,4 @@
-.TH "nvme_cmb_size" 9 "nvme_cmb_size" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_cmb_size" 9 "nvme_cmb_size" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_cmb_size \- Calculate size of the controller memory buffer
 .SH SYNOPSIS

doc/man/nvme_cmd_effects.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "enum nvme_cmd_effects" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "enum nvme_cmd_effects" "March 2023" "API Manual" LINUX
 .SH NAME
 enum nvme_cmd_effects \- Commands Supported and Effects
 .SH SYNOPSIS

doc/man/nvme_cmd_effects_log.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "struct nvme_cmd_effects_log" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "struct nvme_cmd_effects_log" "March 2023" "API Manual" LINUX
 .SH NAME
 struct nvme_cmd_effects_log \- Commands Supported and Effects Log
 .SH SYNOPSIS

doc/man/nvme_cmd_format_mset.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "enum nvme_cmd_format_mset" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "enum nvme_cmd_format_mset" "March 2023" "API Manual" LINUX
 .SH NAME
 enum nvme_cmd_format_mset \- Format NVM - Metadata Settings
 .SH SYNOPSIS

doc/man/nvme_cmd_format_pi.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "enum nvme_cmd_format_pi" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "enum nvme_cmd_format_pi" "March 2023" "API Manual" LINUX
 .SH NAME
 enum nvme_cmd_format_pi \- Format NVM - Protection Information
 .SH SYNOPSIS

doc/man/nvme_cmd_format_pil.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "enum nvme_cmd_format_pil" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "enum nvme_cmd_format_pil" "March 2023" "API Manual" LINUX
 .SH NAME
 enum nvme_cmd_format_pil \- Format NVM - Protection Information Location
 .SH SYNOPSIS

doc/man/nvme_cmd_format_ses.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "enum nvme_cmd_format_ses" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "enum nvme_cmd_format_ses" "March 2023" "API Manual" LINUX
 .SH NAME
 enum nvme_cmd_format_ses \- Format NVM - Secure Erase Settings
 .SH SYNOPSIS

doc/man/nvme_cmd_get_log_lid.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "enum nvme_cmd_get_log_lid" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "enum nvme_cmd_get_log_lid" "March 2023" "API Manual" LINUX
 .SH NAME
 enum nvme_cmd_get_log_lid \- Get Log Page -Log Page Identifiers
 .SH SYNOPSIS

doc/man/nvme_cmd_get_log_telemetry_host_lsp.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "enum nvme_cmd_get_log_telemetry_host_lsp" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "enum nvme_cmd_get_log_telemetry_host_lsp" "March 2023" "API Manual" LINUX
 .SH NAME
 enum nvme_cmd_get_log_telemetry_host_lsp \- Telemetry Host-Initiated log specific field
 .SH SYNOPSIS

doc/man/nvme_compare.2

@@ -1,4 +1,4 @@
-.TH "nvme_compare" 9 "nvme_compare" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_compare" 9 "nvme_compare" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_compare \- Submit an nvme user compare command
 .SH SYNOPSIS

doc/man/nvme_connect_err.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "enum nvme_connect_err" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "enum nvme_connect_err" "March 2023" "API Manual" LINUX
 .SH NAME
 enum nvme_connect_err \- nvme connect error codes
 .SH SYNOPSIS

doc/man/nvme_constants.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "enum nvme_constants" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "enum nvme_constants" "March 2023" "API Manual" LINUX
 .SH NAME
 enum nvme_constants \- A place to stash various constant nvme values
 .SH SYNOPSIS

doc/man/nvme_copy.2

@@ -1,4 +1,4 @@
-.TH "nvme_copy" 9 "nvme_copy" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_copy" 9 "nvme_copy" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_copy \- Copy command
 .SH SYNOPSIS

doc/man/nvme_copy_range.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "struct nvme_copy_range" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "struct nvme_copy_range" "March 2023" "API Manual" LINUX
 .SH NAME
 struct nvme_copy_range \- Copy - Source Range Entries Descriptor Format
 .SH SYNOPSIS
@@ -14,10 +14,10 @@ struct nvme_copy_range {
 .br
 .BI "    __le32 eilbrt;"
 .br
-.BI "    __le16 elbatm;"
-.br
 .BI "    __le16 elbat;"
 .br
+.BI "    __le16 elbatm;"
+.br
 .BI "
 };
 .br
@@ -34,7 +34,7 @@ Reserved
 .IP "eilbrt" 12
 Expected Initial Logical Block Reference Tag /
 Expected Logical Block Storage Tag
-.IP "elbatm" 12
-Expected Logical Block Application Tag Mask
 .IP "elbat" 12
 Expected Logical Block Application Tag
+.IP "elbatm" 12
+Expected Logical Block Application Tag Mask

doc/man/nvme_copy_range_f1.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "struct nvme_copy_range_f1" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "struct nvme_copy_range_f1" "March 2023" "API Manual" LINUX
 .SH NAME
 struct nvme_copy_range_f1 \- Copy - Source Range Entries Descriptor Format 1h
 .SH SYNOPSIS
@@ -14,10 +14,10 @@ struct nvme_copy_range_f1 {
 .br
 .BI "    __u8 elbt[10];"
 .br
-.BI "    __le16 elbatm;"
-.br
 .BI "    __le16 elbat;"
 .br
+.BI "    __le16 elbatm;"
+.br
 .BI "
 };
 .br
@@ -34,7 +34,7 @@ Reserved
 .IP "elbt" 12
 Expected Initial Logical Block Reference Tag /
 Expected Logical Block Storage Tag
-.IP "elbatm" 12
-Expected Logical Block Application Tag Mask
 .IP "elbat" 12
 Expected Logical Block Application Tag
+.IP "elbatm" 12
+Expected Logical Block Application Tag Mask

doc/man/nvme_create_ctrl.2

@@ -1,4 +1,4 @@
-.TH "nvme_create_ctrl" 9 "nvme_create_ctrl" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_create_ctrl" 9 "nvme_create_ctrl" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_create_ctrl \- Allocate an unconnected NVMe controller
 .SH SYNOPSIS

doc/man/nvme_create_root.2

@@ -1,4 +1,4 @@
-.TH "nvme_create_root" 9 "nvme_create_root" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_create_root" 9 "nvme_create_root" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_create_root \- Initialize root object
 .SH SYNOPSIS

doc/man/nvme_csi.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "enum nvme_csi" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "enum nvme_csi" "March 2023" "API Manual" LINUX
 .SH NAME
 enum nvme_csi \- Defined command set indicators
 .SH SYNOPSIS

doc/man/nvme_ctrl_first_ns.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_first_ns" 9 "nvme_ctrl_first_ns" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_first_ns" 9 "nvme_ctrl_first_ns" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_first_ns \- Start namespace iterator
 .SH SYNOPSIS

doc/man/nvme_ctrl_first_path.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_first_path" 9 "nvme_ctrl_first_path" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_first_path" 9 "nvme_ctrl_first_path" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_first_path \- Start path iterator
 .SH SYNOPSIS

doc/man/nvme_ctrl_for_each_ns.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_for_each_ns" 9 "nvme_ctrl_for_each_ns" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_for_each_ns" 9 "nvme_ctrl_for_each_ns" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_for_each_ns \- Traverse namespaces
 .SH SYNOPSIS

doc/man/nvme_ctrl_for_each_ns_safe.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_for_each_ns_safe" 9 "nvme_ctrl_for_each_ns_safe" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_for_each_ns_safe" 9 "nvme_ctrl_for_each_ns_safe" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_for_each_ns_safe \- Traverse namespaces
 .SH SYNOPSIS

doc/man/nvme_ctrl_for_each_path.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_for_each_path" 9 "nvme_ctrl_for_each_path" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_for_each_path" 9 "nvme_ctrl_for_each_path" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_for_each_path \- Traverse paths
 .SH SYNOPSIS

doc/man/nvme_ctrl_for_each_path_safe.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_for_each_path_safe" 9 "nvme_ctrl_for_each_path_safe" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_for_each_path_safe" 9 "nvme_ctrl_for_each_path_safe" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_for_each_path_safe \- Traverse paths
 .SH SYNOPSIS

doc/man/nvme_ctrl_get_address.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_get_address" 9 "nvme_ctrl_get_address" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_get_address" 9 "nvme_ctrl_get_address" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_get_address \- Address string of a controller
 .SH SYNOPSIS

doc/man/nvme_ctrl_get_config.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_get_config" 9 "nvme_ctrl_get_config" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_get_config" 9 "nvme_ctrl_get_config" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_get_config \- Fabrics configuration of a controller
 .SH SYNOPSIS

doc/man/nvme_ctrl_get_dhchap_host_key.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_get_dhchap_host_key" 9 "nvme_ctrl_get_dhchap_host_key" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_get_dhchap_host_key" 9 "nvme_ctrl_get_dhchap_host_key" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_get_dhchap_host_key \- Return host key
 .SH SYNOPSIS

doc/man/nvme_ctrl_get_dhchap_key.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_get_dhchap_key" 9 "nvme_ctrl_get_dhchap_key" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_get_dhchap_key" 9 "nvme_ctrl_get_dhchap_key" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_get_dhchap_key \- Return controller key
 .SH SYNOPSIS

doc/man/nvme_ctrl_get_fd.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_get_fd" 9 "nvme_ctrl_get_fd" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_get_fd" 9 "nvme_ctrl_get_fd" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_get_fd \- Get associated file descriptor
 .SH SYNOPSIS

doc/man/nvme_ctrl_get_firmware.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_get_firmware" 9 "nvme_ctrl_get_firmware" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_get_firmware" 9 "nvme_ctrl_get_firmware" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_get_firmware \- Firmware string of a controller
 .SH SYNOPSIS

doc/man/nvme_ctrl_get_host_iface.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_get_host_iface" 9 "nvme_ctrl_get_host_iface" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_get_host_iface" 9 "nvme_ctrl_get_host_iface" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_get_host_iface \- Host interface name of a controller
 .SH SYNOPSIS

doc/man/nvme_ctrl_get_host_traddr.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_get_host_traddr" 9 "nvme_ctrl_get_host_traddr" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_get_host_traddr" 9 "nvme_ctrl_get_host_traddr" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_get_host_traddr \- Host transport address of a controller
 .SH SYNOPSIS

doc/man/nvme_ctrl_get_model.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_get_model" 9 "nvme_ctrl_get_model" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_get_model" 9 "nvme_ctrl_get_model" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_get_model \- Model of a controller
 .SH SYNOPSIS

doc/man/nvme_ctrl_get_name.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_get_name" 9 "nvme_ctrl_get_name" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_get_name" 9 "nvme_ctrl_get_name" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_get_name \- sysfs name of a controller
 .SH SYNOPSIS

doc/man/nvme_ctrl_get_numa_node.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_get_numa_node" 9 "nvme_ctrl_get_numa_node" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_get_numa_node" 9 "nvme_ctrl_get_numa_node" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_get_numa_node \- NUMA node of a controller
 .SH SYNOPSIS

doc/man/nvme_ctrl_get_queue_count.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_get_queue_count" 9 "nvme_ctrl_get_queue_count" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_get_queue_count" 9 "nvme_ctrl_get_queue_count" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_get_queue_count \- Queue count of a controller
 .SH SYNOPSIS

doc/man/nvme_ctrl_get_serial.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_get_serial" 9 "nvme_ctrl_get_serial" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_get_serial" 9 "nvme_ctrl_get_serial" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_get_serial \- Serial number of a controller
 .SH SYNOPSIS

doc/man/nvme_ctrl_get_sqsize.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_get_sqsize" 9 "nvme_ctrl_get_sqsize" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_get_sqsize" 9 "nvme_ctrl_get_sqsize" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_get_sqsize \- SQ size of a controller
 .SH SYNOPSIS

doc/man/nvme_ctrl_get_state.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_get_state" 9 "nvme_ctrl_get_state" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_get_state" 9 "nvme_ctrl_get_state" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_get_state \- Running state of an controller
 .SH SYNOPSIS

doc/man/nvme_ctrl_get_subsysnqn.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_get_subsysnqn" 9 "nvme_ctrl_get_subsysnqn" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_get_subsysnqn" 9 "nvme_ctrl_get_subsysnqn" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_get_subsysnqn \- Subsystem NQN of a controller
 .SH SYNOPSIS

doc/man/nvme_ctrl_get_subsystem.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_get_subsystem" 9 "nvme_ctrl_get_subsystem" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_get_subsystem" 9 "nvme_ctrl_get_subsystem" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_get_subsystem \- Parent subsystem of a controller
 .SH SYNOPSIS

doc/man/nvme_ctrl_get_sysfs_dir.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_get_sysfs_dir" 9 "nvme_ctrl_get_sysfs_dir" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_get_sysfs_dir" 9 "nvme_ctrl_get_sysfs_dir" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_get_sysfs_dir \- sysfs directory of a controller
 .SH SYNOPSIS

doc/man/nvme_ctrl_get_traddr.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_get_traddr" 9 "nvme_ctrl_get_traddr" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_get_traddr" 9 "nvme_ctrl_get_traddr" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_get_traddr \- Transport address of a controller
 .SH SYNOPSIS

doc/man/nvme_ctrl_get_transport.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_get_transport" 9 "nvme_ctrl_get_transport" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_get_transport" 9 "nvme_ctrl_get_transport" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_get_transport \- Transport type of a controller
 .SH SYNOPSIS

doc/man/nvme_ctrl_get_trsvcid.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_get_trsvcid" 9 "nvme_ctrl_get_trsvcid" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_get_trsvcid" 9 "nvme_ctrl_get_trsvcid" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_get_trsvcid \- Transport service identifier of a controller
 .SH SYNOPSIS

doc/man/nvme_ctrl_identify.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_identify" 9 "nvme_ctrl_identify" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_identify" 9 "nvme_ctrl_identify" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_identify \- Issues an 'identify controller' command
 .SH SYNOPSIS

doc/man/nvme_ctrl_is_discovered.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_is_discovered" 9 "nvme_ctrl_is_discovered" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_is_discovered" 9 "nvme_ctrl_is_discovered" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_is_discovered \- Returns the value of the 'discovered' flag
 .SH SYNOPSIS

doc/man/nvme_ctrl_is_discovery_ctrl.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_is_discovery_ctrl" 9 "nvme_ctrl_is_discovery_ctrl" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_is_discovery_ctrl" 9 "nvme_ctrl_is_discovery_ctrl" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_is_discovery_ctrl \- Check the 'discovery_ctrl' flag
 .SH SYNOPSIS

doc/man/nvme_ctrl_is_persistent.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_is_persistent" 9 "nvme_ctrl_is_persistent" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_is_persistent" 9 "nvme_ctrl_is_persistent" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_is_persistent \- Returns the value of the 'persistent' flag
 .SH SYNOPSIS

doc/man/nvme_ctrl_is_unique_discovery_ctrl.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_is_unique_discovery_ctrl" 9 "nvme_ctrl_is_unique_discovery_ctrl" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_is_unique_discovery_ctrl" 9 "nvme_ctrl_is_unique_discovery_ctrl" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_is_unique_discovery_ctrl \- Check the 'unique_discovery_ctrl' flag
 .SH SYNOPSIS

doc/man/nvme_ctrl_list.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "struct nvme_ctrl_list" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "struct nvme_ctrl_list" "March 2023" "API Manual" LINUX
 .SH NAME
 struct nvme_ctrl_list \- Controller List
 .SH SYNOPSIS

doc/man/nvme_ctrl_metadata_type.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "enum nvme_ctrl_metadata_type" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "enum nvme_ctrl_metadata_type" "March 2023" "API Manual" LINUX
 .SH NAME
 enum nvme_ctrl_metadata_type \- Controller Metadata Element Types
 .SH SYNOPSIS

doc/man/nvme_ctrl_next_ns.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_next_ns" 9 "nvme_ctrl_next_ns" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_next_ns" 9 "nvme_ctrl_next_ns" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_next_ns \- Next namespace iterator
 .SH SYNOPSIS

doc/man/nvme_ctrl_next_path.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_next_path" 9 "nvme_ctrl_next_path" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_next_path" 9 "nvme_ctrl_next_path" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_next_path \- Next path iterator
 .SH SYNOPSIS

doc/man/nvme_ctrl_reset.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_reset" 9 "nvme_ctrl_reset" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_reset" 9 "nvme_ctrl_reset" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_reset \- Initiate a controller reset
 .SH SYNOPSIS

doc/man/nvme_ctrl_set_dhchap_host_key.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_set_dhchap_host_key" 9 "nvme_ctrl_set_dhchap_host_key" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_set_dhchap_host_key" 9 "nvme_ctrl_set_dhchap_host_key" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_set_dhchap_host_key \- Set host key
 .SH SYNOPSIS

doc/man/nvme_ctrl_set_dhchap_key.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_set_dhchap_key" 9 "nvme_ctrl_set_dhchap_key" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_set_dhchap_key" 9 "nvme_ctrl_set_dhchap_key" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_set_dhchap_key \- Set controller key
 .SH SYNOPSIS

doc/man/nvme_ctrl_set_discovered.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_set_discovered" 9 "nvme_ctrl_set_discovered" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_set_discovered" 9 "nvme_ctrl_set_discovered" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_set_discovered \- Set the 'discovered' flag
 .SH SYNOPSIS

doc/man/nvme_ctrl_set_discovery_ctrl.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_set_discovery_ctrl" 9 "nvme_ctrl_set_discovery_ctrl" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_set_discovery_ctrl" 9 "nvme_ctrl_set_discovery_ctrl" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_set_discovery_ctrl \- Set the 'discovery_ctrl' flag
 .SH SYNOPSIS

doc/man/nvme_ctrl_set_persistent.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_set_persistent" 9 "nvme_ctrl_set_persistent" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_set_persistent" 9 "nvme_ctrl_set_persistent" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_set_persistent \- Set the 'persistent' flag
 .SH SYNOPSIS

doc/man/nvme_ctrl_set_unique_discovery_ctrl.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrl_set_unique_discovery_ctrl" 9 "nvme_ctrl_set_unique_discovery_ctrl" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrl_set_unique_discovery_ctrl" 9 "nvme_ctrl_set_unique_discovery_ctrl" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrl_set_unique_discovery_ctrl \- Set the 'unique_discovery_ctrl' flag
 .SH SYNOPSIS

doc/man/nvme_ctrls_filter.2

@@ -1,4 +1,4 @@
-.TH "nvme_ctrls_filter" 9 "nvme_ctrls_filter" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_ctrls_filter" 9 "nvme_ctrls_filter" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_ctrls_filter \- Filter for controllers
 .SH SYNOPSIS

doc/man/nvme_data_tfr.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "enum nvme_data_tfr" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "enum nvme_data_tfr" "March 2023" "API Manual" LINUX
 .SH NAME
 enum nvme_data_tfr \- Data transfer direction of the command
 .SH SYNOPSIS

doc/man/nvme_default_host.2

@@ -1,4 +1,4 @@
-.TH "nvme_default_host" 9 "nvme_default_host" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_default_host" 9 "nvme_default_host" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_default_host \- Initializes the default host
 .SH SYNOPSIS

doc/man/nvme_describe_key_serial.2

@@ -0,0 +1,15 @@
+.TH "nvme_describe_key_serial" 9 "nvme_describe_key_serial" "March 2023" "libnvme API manual" LINUX
+.SH NAME
+nvme_describe_key_serial \- Return key description
+.SH SYNOPSIS
+.B "char *" nvme_describe_key_serial
+.BI "(long key_id "  ");"
+.SH ARGUMENTS
+.IP "key_id" 12
+Key serial number
+.SH "DESCRIPTION"
+Fetches the description of the key or keyring identified
+by the serial number \fIkey_id\fP.
+.SH "RETURN"
+The description of \fIkey_id\fP or NULL on failure.
+The returned string needs to be freed by the caller.

doc/man/nvme_dev_self_test.2

@@ -1,4 +1,4 @@
-.TH "nvme_dev_self_test" 9 "nvme_dev_self_test" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_dev_self_test" 9 "nvme_dev_self_test" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_dev_self_test \- Start or abort a self test
 .SH SYNOPSIS

doc/man/nvme_directive_dtype.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "enum nvme_directive_dtype" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "enum nvme_directive_dtype" "March 2023" "API Manual" LINUX
 .SH NAME
 enum nvme_directive_dtype \- Directive Types
 .SH SYNOPSIS

doc/man/nvme_directive_receive_doper.2

@@ -1,4 +1,4 @@
-.TH "libnvme" 9 "enum nvme_directive_receive_doper" "January 2023" "API Manual" LINUX
+.TH "libnvme" 9 "enum nvme_directive_receive_doper" "March 2023" "API Manual" LINUX
 .SH NAME
 enum nvme_directive_receive_doper \- Directive Receive Directive Operation
 .SH SYNOPSIS

doc/man/nvme_directive_recv.2

@@ -1,4 +1,4 @@
-.TH "nvme_directive_recv" 9 "nvme_directive_recv" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_directive_recv" 9 "nvme_directive_recv" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_directive_recv \- Receive directive specific data
 .SH SYNOPSIS

doc/man/nvme_directive_recv_identify_parameters.2

@@ -1,4 +1,4 @@
-.TH "nvme_directive_recv_identify_parameters" 9 "nvme_directive_recv_identify_parameters" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_directive_recv_identify_parameters" 9 "nvme_directive_recv_identify_parameters" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_directive_recv_identify_parameters \- Directive receive identifier parameters
 .SH SYNOPSIS

doc/man/nvme_directive_recv_stream_allocate.2

@@ -1,4 +1,4 @@
-.TH "nvme_directive_recv_stream_allocate" 9 "nvme_directive_recv_stream_allocate" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_directive_recv_stream_allocate" 9 "nvme_directive_recv_stream_allocate" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_directive_recv_stream_allocate \- Directive receive stream allocate
 .SH SYNOPSIS

doc/man/nvme_directive_recv_stream_parameters.2

@@ -1,4 +1,4 @@
-.TH "nvme_directive_recv_stream_parameters" 9 "nvme_directive_recv_stream_parameters" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_directive_recv_stream_parameters" 9 "nvme_directive_recv_stream_parameters" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_directive_recv_stream_parameters \- Directive receive stream parameters
 .SH SYNOPSIS

doc/man/nvme_directive_recv_stream_status.2

@@ -1,4 +1,4 @@
-.TH "nvme_directive_recv_stream_status" 9 "nvme_directive_recv_stream_status" "January 2023" "libnvme API manual" LINUX
+.TH "nvme_directive_recv_stream_status" 9 "nvme_directive_recv_stream_status" "March 2023" "libnvme API manual" LINUX
 .SH NAME
 nvme_directive_recv_stream_status \- Directive receive stream status
 .SH SYNOPSIS