.. _sec-tutorial-s12:

======================
 Open-Channel SSD 1.2
======================

This introduction will go through how to retrieve device information, construct
physical addresses, issue vectorized IO, retrieve and mange media state, and
introduce the virtual block abstraction.

It will be using the command-line interface (CLI), and provide notes for the
corresponding parts of the C API. It is assumed throughout that an Open-Channel
SSD available at the path ``/dev/nvme0n1`` and that liblightnvm is installed on
the system.

NOTE: This tutorial was written prior to the release of the Open-Channel SSD
2.0 specification. Concept such as **planes/plane-mode**, thus, if you have a
2.0 drive you probably would prefer to read the 2.0 guide. Also, since it has
not been updated some of the command-line output might not reflect the latest
state of the library.

.. toctree::
   :hidden:

   nvm_dev.rst
   nvm_addr.rst
   nvm_addr_vio.rst
   nvm_vblk.rst
   nvm_bbt.rst