Re: [virtio-comment] [PATCH v4 2/7] transport-fabrics: introduce Virtio-oF Qualified Name

[Raphael Norwitz <raphael.norwitz@nutanix.com>]

> On Jun 26, 2023, at 3:25 AM, zhenwei pi <pizhenwei@bytedance.com> wrote:
> 
> Add VQN section. The VQN is a little different from iSCSI/NVMe-oF on
> style limitation. Because iSCSI/NVMe-of is storage specific protocol,
> the full string IQN(for iSCSI/iSER) and NQN(for NVMe-oF) represents
> a "storage access address". However, Virtio Over Fabrics works as
> transport layer rather than device layer, a URL style string is better
> to Virtio Over Fabrics. For example:
> virtio-rdma://192.168.1.100:8549/blk-device/nvme-pool/849a39ad-8d7b-4a7a-adb6-e7407ace532c
> virtio-tcpip://192.168.1.110/blk-device/hdd-pool/238151a7-acd7-4621-bbdf-382ddbccb6a1
> virtio-tcpip://192.168.1.100:8549/crypto-device/25307f22-e5a8-4ea2-b7ca-79f5c3bebc3c
> ...
> 
> A hunam readable VQN is helpful to maintain/debug/distinguish.

s/hunam/human

> Note that this section only defines the "VQN" schema.
> For a process, the following two are both fine:
> ~# ./foo --full-url virtio-rdma://192.168.1.100:8549/blk-device/nvme-pool/849a39ad-8d7b-4a7a-adb6-e7407ace532c
> ~# ./foo --transport rdma --address 192.168.1.100 --port 8549
>  --tvqn blk-device/hdd-pool/238151a7-acd7-4621-bbdf-382ddbccb6a1
> 
> Signed-off-by: zhenwei pi <pizhenwei@bytedance.com>
> ---
> transport-fabrics.tex | 15 +++++++++++++++
> 1 file changed, 15 insertions(+)
> 
> diff --git a/transport-fabrics.tex b/transport-fabrics.tex
> index d10be2a..54d7558 100644
> --- a/transport-fabrics.tex
> +++ b/transport-fabrics.tex
> @@ -30,3 +30,18 @@ \section{Virtio Over Fabrics}\label{sec:Virtio Transport Options / Virtio Over F
> which executes the bulk data transport on virtio devices.
> \item The arrival of data on the Virtio-oF queue indicates that a notification has arrived.
> \end{itemize}
> +
> +
> +\subsection{Virtio-oF Qualified Name}\label{sec:Virtio Transport Options / Virtio Over Fabrics / Virtio-oF Qualified Name}
> +Virtio-oF Qualified Names (VQNs) are used to uniquely describe a Virtio-oF initiator
> +or a Virtio-oF target for identification.
> +
> +A VQN is encoded as a string of Unicode characters with the following properties:
> +
> +\begin{itemize}
> +\item The encoding is UTF-8 (refer to RFC 3629).
> +\item The characters dash('-'), dot ('.') and slash('/') are used in formatting.
> +\item The string is NUL terminated.
> +\item The maximum name is 256 bytes in length, including the NUL character.
> +\item There is no strict style limitation.
> +\end{itemize}
> -- 
> 2.25.1
> 
> 
> This publicly archived list offers a means to provide input to the
> OASIS Virtual I/O Device (VIRTIO) TC.
> 
> In order to verify user consent to the Feedback License terms and
> to minimize spam in the list archive, subscription is required
> before posting.
> 
> Subscribe: virtio-comment-subscribe@lists.oasis-open.org
> Unsubscribe: virtio-comment-unsubscribe@lists.oasis-open.org
> List help: virtio-comment-help@lists.oasis-open.org
> List archive: https://lists.oasis-open.org/archives/virtio-comment/
> Feedback License: https://www.oasis-open.org/who/ipr/feedback_license.pdf
> List Guidelines: https://www.oasis-open.org/policies-guidelines/mailing-lists
> Committee: https://www.oasis-open.org/committees/virtio/
> Join OASIS: https://www.oasis-open.org/join/
> 
>