forked from Azure/azure-vm-utils
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
build(doc): generate manpages only with GENERATE_MANPAGES=1
As pointed out by Noah in Azure#15, Debian packaging lints issues in the generated manpage due to formatting emitted by older versions of pandoc: jgm/pandoc#9020 While changes in recent versions of pandoc have improved the output, let's just take the generated output from pandoc 3.2 as a starting point and maintain it manually for the time being. This reduces friction for packaging and gives us flexibility if we wanted to do something in the manpage that pandoc doesn't support. Allow manpages to be generated at build-time with -DGENERATE_MANPAGES=1 which will make it easy to sync. Signed-off-by: Chris Patterson <[email protected]>
- Loading branch information
Showing
3 changed files
with
94 additions
and
19 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,54 @@ | ||
.TH "azure\-nvme\-id" "1" "@TODAY@" "azure-nvme-id\ @VERSION@" "User Manual" | ||
.SH NAME | ||
azure\-nvme\-id \- Identify Azure NVMe devices. | ||
.SH SYNOPSIS | ||
\f[B]azure\-nvme\-id\f[R] [\-\-debug] [\-\-help | \-\-version | | ||
\-\-udev] | ||
.SH DESCRIPTION | ||
\f[B]azure\-nvme\-id\f[R] is a utility to identify Azure NVMe devices. | ||
.PP | ||
It performs an Identify Namespace command on the NVMe namespaces, | ||
parsing metadata available in the vendor\-specific (vs) field which | ||
contains various identification details with a comma\-separated, | ||
key=value format. | ||
.SH OPTIONS | ||
.TP | ||
\f[CR]\-\-help\f[R] | ||
Show usage information and exit. | ||
.TP | ||
\f[CR]\-\-version\f[R] | ||
Show version information and exit. | ||
.TP | ||
\f[CR]\-\-udev\f[R] | ||
Run in udev mode, printing a set of \f[CR]<key>=<value>\f[R] variables | ||
consumed by udev rules. | ||
Requires DEVNAME to be set in environment. | ||
.SH EXAMPLES | ||
Identify NVMe namespaces: | ||
.IP | ||
.EX | ||
$ sudo azure\-nvme\-id | ||
/dev/nvme0n1: | ||
/dev/nvme1n1: type=local,index=1,name=nvme\-110G\-1 | ||
.EE | ||
.PP | ||
Parse device identifiers for udev consumption: | ||
.IP | ||
.EX | ||
$ sudo env DEVNAME=/dev/nvme1n1 azure\-nvme\-id \-\-udev | ||
AZURE_NVME_VS=type=local,index=1,name=nvme\-110G\-1 | ||
AZURE_NVME_TYPE=local | ||
AZURE_NVME_INDEX=1 | ||
AZURE_NVME_NAME=nvme\-110G\-1 | ||
.EE | ||
.PP | ||
Check \f[CR]azure\-nvme\-id\f[R] version: | ||
.IP | ||
.EX | ||
$ azure\-nvme\-id \-\-version | ||
azure\-nvme\-id 0.1.2 | ||
.EE | ||
.SH SEE ALSO | ||
Source and documentation available at: \c | ||
.UR https://github.com/Azure/azure-nvme-utils | ||
.UE \c |