Skip to content

Commit 103847d

Browse files
virtio-msg: recommend RFC4122 version 4 device_uuid values (Manos Pitsidianakis)
Manos Pitsidianakis asked whether GET_DEVICE_INFO should align with the existing UUID guidance elsewhere in the virtio spec. Reference [RFC4122] in the GET_DEVICE_INFO description for the nil UUID definition, and recommend in the device normative text that non-nil device_uuid values use version 4 UUIDs as specified by [RFC4122]. Signed-off-by: Bertrand Marquis <bertrand.marquis@arm.com>
1 parent 188b0c3 commit 103847d

1 file changed

Lines changed: 7 additions & 3 deletions

File tree

transport-msg.tex

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1212,9 +1212,10 @@ \subsubsection{Overview}
12121212

12131213
The driver issues \msgref{GET_DEVICE_INFO} to discover static identification
12141214
data and limits for a device. The response includes \field{device_uuid}, a
1215-
16-byte UUID value. The nil UUID (all bytes set to zero) indicates that no
1216-
UUID is provided. \msgref{GET_DEVICE_INFO} is the only transport message
1217-
permitted before the device transitions out of the inactive state.
1215+
16-byte UUID value. The nil UUID defined by
1216+
\hyperref[intro:rfc4122]{[RFC4122]} indicates that no UUID is provided.
1217+
\msgref{GET_DEVICE_INFO} is the only transport message permitted before the
1218+
device transitions out of the inactive state.
12181219

12191220
\begin{lstlisting}
12201221
struct virtio_msg_get_device_info_req {
@@ -1240,6 +1241,9 @@ \subsubsection{Overview}
12401241
count, configuration size, and virtqueue limits.
12411242
\item A device MAY set \field{device_uuid} to a UUID value that can be used
12421243
as a unique identifier.
1244+
\item If a device sets \field{device_uuid} to a non-nil value, it SHOULD use
1245+
a version 4 UUID as specified by
1246+
\hyperref[intro:rfc4122]{[RFC4122]}.
12431247
\item If a device does not support UUID reporting or does not have an
12441248
identifier, it MUST set \field{device_uuid} to the nil UUID.
12451249
\end{itemize}

0 commit comments

Comments
 (0)