Skip to content

Commit

Permalink
doc: Regenerate all docs for v1.3
Browse files Browse the repository at this point in the history
Signed-off-by: Daniel Wagner <dwagner@suse.de>
  • Loading branch information
igaw committed Jan 30, 2023
1 parent 4174de5 commit 94dd6d0
Show file tree
Hide file tree
Showing 763 changed files with 25,528 additions and 721 deletions.
32 changes: 32 additions & 0 deletions doc/conf.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
# Configuration file for the Sphinx documentation builder.
#
# This file only contains a selection of the most common options. For a full
# list see the documentation:
# https://www.sphinx-doc.org/en/master/usage/configuration.html


# -- Project information -----------------------------------------------------

project = 'libnvme'
copyright = '2020, Keith Busch'
author = 'Keith Busch <kbusch@kernel.org>'
master_doc = 'index'

release = '1.3'


# -- General configuration ---------------------------------------------------

# Add any Sphinx extension module names here, as strings. They can be
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
# ones.
extensions = [
]

# Add any paths that contain templates here, relative to this directory.
templates_path = ['_templates']

# List of patterns, relative to source directory, that match files and
# directories to ignore when looking for source files.
# This pattern also affects html_static_path and html_extra_path.
exclude_patterns = ['html', 'man', 'Thumbs.db', '.DS_Store']
172 changes: 172 additions & 0 deletions doc/config-schema.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,172 @@
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://github.com/linux-nvme/libnvme/doc/config-schema.json",
"title": "config.json",
"description": "libnvme JSON configuration",
"type": "object",
"properties": {
"hosts": {
"description": "Array of NVMe Host properties",
"type": "array",
"items": { "$ref": "#/$defs/host" }
}
},
"$defs": {
"host": {
"description": "NVMe Host properties",
"type": "object",
"properties": {
"hostnqn": {
"description": "NVMe host NQN",
"type": "string",
"maxLength": 223
},
"hostid": {
"description": "NVMe host ID",
"type": "string"
},
"dhchap_key": {
"description": "Host DH-HMAC-CHAP key",
"type": "string"
},
"hostsymname": {
"description": "NVMe host symbolic name",
"type": "string"
},
"persistent_discovery_ctrl": {
"description": "Enable/disable Persistent Discovery Controller",
"type": "boolean"
},
"required": [ "hostnqn" ],
"subsystems": {
"description": "Array of NVMe subsystem properties",
"type": "array",
"items": { "$ref": "#/$defs/subsystem" }
}
}
},
"subsystem": {
"description": "NVMe subsystem properties",
"type": "object",
"properties": {
"nqn": {
"description": "Subsystem NQN",
"type": "string",
"maxLength": 223
},
"ports": {
"description": "Array of NVMe subsystem ports",
"type": "array",
"items": { "$ref": "#/$defs/port" }
},
"required": [ "nqn" ]
}
},
"port": {
"description": "NVMe subsystem port",
"type": "object",
"properties": {
"transport": {
"description": "Transport type",
"type": "string"
},
"traddr": {
"description": "Transport address",
"type": "string"
},
"host_traddr": {
"description": "Host transport address",
"type": "string"
},
"host_iface": {
"description": "Host interface name",
"type": "string"
},
"trsvcid": {
"description": "Transport service identifier",
"type": "string"
},
"dhchap_key": {
"description": "Host DH-HMAC-CHAP key",
"type": "string"
},
"dhchap_ctrl_key": {
"description": "Controller DH-HMAC-CHAP key",
"type": "string"
},
"nr_io_queues": {
"description": "Number of I/O queues",
"type": "integer"
},
"nr_write_queues": {
"description": "Number of write queues",
"type": "integer"
},
"nr_poll_queues": {
"description": "Number of poll queues",
"type": "integer"
},
"queue_size": {
"description": "Queue size",
"type": "integer"
},
"keep_alive_tmo": {
"description": "Keep-Alive timeout (in seconds)",
"type": "integer"
},
"reconnect_delay": {
"description": "Reconnect delay (in seconds)",
"type": "integer"
},
"ctrl_loss_tmo": {
"description": "Controller loss timeout (in seconds)",
"type": "integer"
},
"fast_io_fail_tmo": {
"description": "Fast I/O Fail timeout (in seconds)",
"type": "integer",
"default": 600
},
"tos": {
"description": "Type of service",
"type": "integer",
"default": -1
},
"duplicate_connect": {
"description": "Allow duplicate connections",
"type": "boolean",
"default": false
},
"disable_sqflow": {
"description": "Explicitly disable SQ flow control",
"type": "boolean",
"default": false
},
"hdr_digest": {
"description": "Enable header digest",
"type": "boolean",
"default": false
},
"data_digest": {
"description": "Enable data digest",
"type": "boolean",
"default": false
},
"tls": {
"description": "Enable TLS encryption",
"type": "boolean",
"default": false
},
"persistent": {
"description": "Create persistent discovery connection",
"type": "boolean"
},
"discovery": {
"description": "Connect to a discovery controller",
"type": "boolean"
}
},
"required": [ "transport" ]
}
}
}
23 changes: 23 additions & 0 deletions doc/index.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
Welcome to libnvme's documentation!
===================================

This is the libnvme development C library. libnvme provides type definitions for
NVMe specification structures, enumerations, and bit fields,
helper functions to construct, dispatch, and decode commands and payloads,
and utilities to connect, scan, and manage nvme devices on a Linux system.

.. toctree::
:maxdepth: 2
:caption: Contents:

installation.rst
quickstart.rst
mi.rst
api.rst

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`
2 changes: 1 addition & 1 deletion doc/man/nvme_admin_opcode.2
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.TH "libnvme" 9 "enum nvme_admin_opcode" "October 2022" "API Manual" LINUX
.TH "libnvme" 9 "enum nvme_admin_opcode" "January 2023" "API Manual" LINUX
.SH NAME
enum nvme_admin_opcode \- Known NVMe admin opcodes
.SH SYNOPSIS
Expand Down
2 changes: 1 addition & 1 deletion doc/man/nvme_admin_passthru.2
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.TH "nvme_admin_passthru" 9 "nvme_admin_passthru" "October 2022" "libnvme API manual" LINUX
.TH "nvme_admin_passthru" 9 "nvme_admin_passthru" "January 2023" "libnvme API manual" LINUX
.SH NAME
nvme_admin_passthru \- Submit an nvme passthrough command
.SH SYNOPSIS
Expand Down
2 changes: 1 addition & 1 deletion doc/man/nvme_admin_passthru64.2
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.TH "nvme_admin_passthru64" 9 "nvme_admin_passthru64" "October 2022" "libnvme API manual" LINUX
.TH "nvme_admin_passthru64" 9 "nvme_admin_passthru64" "January 2023" "libnvme API manual" LINUX
.SH NAME
nvme_admin_passthru64 \- Submit a 64-bit nvme passthrough command
.SH SYNOPSIS
Expand Down
2 changes: 1 addition & 1 deletion doc/man/nvme_ae_info_css_nvm.2
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.TH "libnvme" 9 "enum nvme_ae_info_css_nvm" "October 2022" "API Manual" LINUX
.TH "libnvme" 9 "enum nvme_ae_info_css_nvm" "January 2023" "API Manual" LINUX
.SH NAME
enum nvme_ae_info_css_nvm \- Asynchronous Event Information - I/O Command Specific Status
.SH SYNOPSIS
Expand Down
2 changes: 1 addition & 1 deletion doc/man/nvme_ae_info_error.2
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.TH "libnvme" 9 "enum nvme_ae_info_error" "October 2022" "API Manual" LINUX
.TH "libnvme" 9 "enum nvme_ae_info_error" "January 2023" "API Manual" LINUX
.SH NAME
enum nvme_ae_info_error \- Asynchronous Event Information - Error Status
.SH SYNOPSIS
Expand Down
2 changes: 1 addition & 1 deletion doc/man/nvme_ae_info_notice.2
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.TH "libnvme" 9 "enum nvme_ae_info_notice" "October 2022" "API Manual" LINUX
.TH "libnvme" 9 "enum nvme_ae_info_notice" "January 2023" "API Manual" LINUX
.SH NAME
enum nvme_ae_info_notice \- Asynchronous Event Information - Notice
.SH SYNOPSIS
Expand Down
2 changes: 1 addition & 1 deletion doc/man/nvme_ae_info_smart.2
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.TH "libnvme" 9 "enum nvme_ae_info_smart" "October 2022" "API Manual" LINUX
.TH "libnvme" 9 "enum nvme_ae_info_smart" "January 2023" "API Manual" LINUX
.SH NAME
enum nvme_ae_info_smart \- Asynchronous Event Information - SMART / Health Status
.SH SYNOPSIS
Expand Down
2 changes: 1 addition & 1 deletion doc/man/nvme_ae_type.2
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.TH "libnvme" 9 "enum nvme_ae_type" "October 2022" "API Manual" LINUX
.TH "libnvme" 9 "enum nvme_ae_type" "January 2023" "API Manual" LINUX
.SH NAME
enum nvme_ae_type \- Asynchronous Event Type
.SH SYNOPSIS
Expand Down
2 changes: 1 addition & 1 deletion doc/man/nvme_aggregate_endurance_group_event.2
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.TH "libnvme" 9 "struct nvme_aggregate_endurance_group_event" "October 2022" "API Manual" LINUX
.TH "libnvme" 9 "struct nvme_aggregate_endurance_group_event" "January 2023" "API Manual" LINUX
.SH NAME
struct nvme_aggregate_endurance_group_event \- Endurance Group Event Aggregate
.SH SYNOPSIS
Expand Down
2 changes: 1 addition & 1 deletion doc/man/nvme_aggregate_predictable_lat_event.2
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.TH "libnvme" 9 "struct nvme_aggregate_predictable_lat_event" "October 2022" "API Manual" LINUX
.TH "libnvme" 9 "struct nvme_aggregate_predictable_lat_event" "January 2023" "API Manual" LINUX
.SH NAME
struct nvme_aggregate_predictable_lat_event \- Predictable Latency Event Aggregate Log Page
.SH SYNOPSIS
Expand Down
2 changes: 1 addition & 1 deletion doc/man/nvme_ana_group_desc.2
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.TH "libnvme" 9 "struct nvme_ana_group_desc" "October 2022" "API Manual" LINUX
.TH "libnvme" 9 "struct nvme_ana_group_desc" "January 2023" "API Manual" LINUX
.SH NAME
struct nvme_ana_group_desc \- ANA Group Descriptor
.SH SYNOPSIS
Expand Down
2 changes: 1 addition & 1 deletion doc/man/nvme_ana_log.2
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.TH "libnvme" 9 "struct nvme_ana_log" "October 2022" "API Manual" LINUX
.TH "libnvme" 9 "struct nvme_ana_log" "January 2023" "API Manual" LINUX
.SH NAME
struct nvme_ana_log \- Asymmetric Namespace Access Log
.SH SYNOPSIS
Expand Down
2 changes: 1 addition & 1 deletion doc/man/nvme_ana_state.2
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.TH "libnvme" 9 "enum nvme_ana_state" "October 2022" "API Manual" LINUX
.TH "libnvme" 9 "enum nvme_ana_state" "January 2023" "API Manual" LINUX
.SH NAME
enum nvme_ana_state \- ANA Group Descriptor - Asymmetric Namespace Access State
.SH SYNOPSIS
Expand Down
2 changes: 1 addition & 1 deletion doc/man/nvme_apst_entry.2
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.TH "libnvme" 9 "enum nvme_apst_entry" "October 2022" "API Manual" LINUX
.TH "libnvme" 9 "enum nvme_apst_entry" "January 2023" "API Manual" LINUX
.SH NAME
enum nvme_apst_entry \- Autonomous Power State Transition
.SH SYNOPSIS
Expand Down
2 changes: 1 addition & 1 deletion doc/man/nvme_boot_partition.2
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.TH "libnvme" 9 "struct nvme_boot_partition" "October 2022" "API Manual" LINUX
.TH "libnvme" 9 "struct nvme_boot_partition" "January 2023" "API Manual" LINUX
.SH NAME
struct nvme_boot_partition \- Boot Partition Log
.SH SYNOPSIS
Expand Down
2 changes: 1 addition & 1 deletion doc/man/nvme_capacity_config_desc.2
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.TH "libnvme" 9 "struct nvme_capacity_config_desc" "October 2022" "API Manual" LINUX
.TH "libnvme" 9 "struct nvme_capacity_config_desc" "January 2023" "API Manual" LINUX
.SH NAME
struct nvme_capacity_config_desc \- Capacity Configuration structure definitions
.SH SYNOPSIS
Expand Down
2 changes: 1 addition & 1 deletion doc/man/nvme_capacity_mgmt.2
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.TH "nvme_capacity_mgmt" 9 "nvme_capacity_mgmt" "October 2022" "libnvme API manual" LINUX
.TH "nvme_capacity_mgmt" 9 "nvme_capacity_mgmt" "January 2023" "libnvme API manual" LINUX
.SH NAME
nvme_capacity_mgmt \- Capacity management command
.SH SYNOPSIS
Expand Down
2 changes: 1 addition & 1 deletion doc/man/nvme_change_ns_event.2
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.TH "libnvme" 9 "struct nvme_change_ns_event" "October 2022" "API Manual" LINUX
.TH "libnvme" 9 "struct nvme_change_ns_event" "January 2023" "API Manual" LINUX
.SH NAME
struct nvme_change_ns_event \- Change Namespace Event Data
.SH SYNOPSIS
Expand Down
2 changes: 1 addition & 1 deletion doc/man/nvme_channel_config_desc.2
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.TH "libnvme" 9 "struct nvme_channel_config_desc" "October 2022" "API Manual" LINUX
.TH "libnvme" 9 "struct nvme_channel_config_desc" "January 2023" "API Manual" LINUX
.SH NAME
struct nvme_channel_config_desc \- Channel Configuration Descriptor
.SH SYNOPSIS
Expand Down
2 changes: 1 addition & 1 deletion doc/man/nvme_cmb_size.2
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.TH "nvme_cmb_size" 9 "nvme_cmb_size" "October 2022" "libnvme API manual" LINUX
.TH "nvme_cmb_size" 9 "nvme_cmb_size" "January 2023" "libnvme API manual" LINUX
.SH NAME
nvme_cmb_size \- Calculate size of the controller memory buffer
.SH SYNOPSIS
Expand Down
2 changes: 1 addition & 1 deletion doc/man/nvme_cmd_effects.2
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.TH "libnvme" 9 "enum nvme_cmd_effects" "October 2022" "API Manual" LINUX
.TH "libnvme" 9 "enum nvme_cmd_effects" "January 2023" "API Manual" LINUX
.SH NAME
enum nvme_cmd_effects \- Commands Supported and Effects
.SH SYNOPSIS
Expand Down
2 changes: 1 addition & 1 deletion doc/man/nvme_cmd_effects_log.2
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.TH "libnvme" 9 "struct nvme_cmd_effects_log" "October 2022" "API Manual" LINUX
.TH "libnvme" 9 "struct nvme_cmd_effects_log" "January 2023" "API Manual" LINUX
.SH NAME
struct nvme_cmd_effects_log \- Commands Supported and Effects Log
.SH SYNOPSIS
Expand Down
2 changes: 1 addition & 1 deletion doc/man/nvme_cmd_format_mset.2
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.TH "libnvme" 9 "enum nvme_cmd_format_mset" "October 2022" "API Manual" LINUX
.TH "libnvme" 9 "enum nvme_cmd_format_mset" "January 2023" "API Manual" LINUX
.SH NAME
enum nvme_cmd_format_mset \- Format NVM - Metadata Settings
.SH SYNOPSIS
Expand Down
2 changes: 1 addition & 1 deletion doc/man/nvme_cmd_format_pi.2
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.TH "libnvme" 9 "enum nvme_cmd_format_pi" "October 2022" "API Manual" LINUX
.TH "libnvme" 9 "enum nvme_cmd_format_pi" "January 2023" "API Manual" LINUX
.SH NAME
enum nvme_cmd_format_pi \- Format NVM - Protection Information
.SH SYNOPSIS
Expand Down
2 changes: 1 addition & 1 deletion doc/man/nvme_cmd_format_pil.2
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.TH "libnvme" 9 "enum nvme_cmd_format_pil" "October 2022" "API Manual" LINUX
.TH "libnvme" 9 "enum nvme_cmd_format_pil" "January 2023" "API Manual" LINUX
.SH NAME
enum nvme_cmd_format_pil \- Format NVM - Protection Information Location
.SH SYNOPSIS
Expand Down
2 changes: 1 addition & 1 deletion doc/man/nvme_cmd_format_ses.2
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
.TH "libnvme" 9 "enum nvme_cmd_format_ses" "October 2022" "API Manual" LINUX
.TH "libnvme" 9 "enum nvme_cmd_format_ses" "January 2023" "API Manual" LINUX
.SH NAME
enum nvme_cmd_format_ses \- Format NVM - Secure Erase Settings
.SH SYNOPSIS
Expand Down
Loading

0 comments on commit 94dd6d0

Please sign in to comment.