tests: Fix fw log check

Had the return check inverted (0 is success).

Signed-off-by: Keith Busch <kbusch@kernel.org>

util: Fix default log transfer length typo

Transfer lengths are 4k, not 4086 bytes.

Signed-off-by: Keith Busch <kbusch@kernel.org>

Add README

Signed-off-by: Keith Busch <kbusch@kernel.org>

Add license information

Added LGPL licence via:

  wget https://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt -O COPYING

Signed-off-by: Keith Busch <kbusch@kernel.org>

tests: Remove some of the output

Remove parts made redundant with the examples/display programs.

Signed-off-by: Keith Busch <kbusch@kernel.org>

Add documentation

Experimenting with documentation generation:

Initialize sphinx documentation building.

Use linux's 'scripts/kernel-doc' to extract documentation comments from
source and format as .rst file.

Signed-off-by: Keith Busch <kbusch@kernel.org>

examples: Add loop discover example

A basic fabrics example discoverying loop nvme fabric targets. Apply
fixes and updates to lib code as needed from testing.

Signed-off-by: Keith Busch <kbusch@kernel.org>

examples: Add column disaply of topology

Pretty print nvme topology in detailed columns.

Signed-off-by: Keith Busch <kbusch@kernel.org>

examples/telemetry: Fix scanning uevent file

Continue to the next line if current one does not contain async event
information.

Signed-off-by: Keith Busch <kbusch@kernel.org>

Add nvme display tree example

Simple visual demonstration of an nvme topology.

Signed-off-by: Keith Busch <kbusch@kernel.org>

Add exported symbols to libnvme.map

And add the kernel-doc style comments in all exported functions.

This is just a capture of what currently exists and may change prior to tagging
as a stable release.

Signed-off-by: Keith Busch <kbusch@kernel.org>

Add a telemetry scan example

Copy the liburing directory structure and start adding examples. The first
example monitors all devices for telemetry events, and if available will write
out the telemetry log to a file in /var/log/.

While developing the example, some other misc fixes and updates were added to
the library code.

Signed-off-by: Keith Busch <kbusch@kernel.org>

Initial libnvme commit

Most of the planned features are developed, however many of the interfaces have
only been lighlty touched as the features they implement are not broadly
supported in hardware.

The remaining gaps in command support from 1.4 are:

  Management Interface Send/Recieve OOB support
  Persistent Event Logs

There is no plan to support Abort, AER, IO SQ/CQ Create/Delete, or Doorbell
Buffer Config since that has high risk to abuse and interfere with the
stability of a running system.

Signed-off-by: Keith Busch <kbusch@kernel.org>