Skip to content

Commit

Permalink
admin: Extend resource objects for sr-iov group type
Browse files Browse the repository at this point in the history
occasionally the group owner device accesses the device parts
of the member device. Extend the usage of resource objects
for member device parts access.

Fixes: oasis-tcs#176
Signed-off-by: Parav Pandit <[email protected]>
  • Loading branch information
paravmellanox committed Jul 11, 2024
1 parent 2caf025 commit 742e296
Showing 1 changed file with 11 additions and 5 deletions.
16 changes: 11 additions & 5 deletions admin-cmds-resource-objects.tex
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,9 @@ \subsubsection{Device resource objects}\label{sec:Basic Facilities of a Virtio D
all resource objects created by the driver are destroyed within the device.

Following administration commands control device resource objects,
they are only supported for the self group type:
they are supported for the self group type, occasionally some resource
objects can be created for the SR-IOV group type as well. Such sr-iov group
type specific resource objects are listed where such objects is defined.

\begin{enumerate}
\item VIRTIO_ADMIN_CMD_RESOURCE_OBJ_CREATE
Expand Down Expand Up @@ -102,7 +104,8 @@ \subsubsection{Device resource objects}\label{sec:Basic Facilities of a Virtio D
for the resource for the specified \field{type}.

For the command VIRTIO_ADMIN_CMD_RESOURCE_OBJ_CREATE, \field{opcode} is set to 0xa.
\field{group_member_id} is set to zero.
\field{group_member_id} is set to zero for self-group type and set to
the member device to be accessed for the SR-IOV group type.
The \field{command_specific_data} is in the format
\field{struct virtio_admin_cmd_resource_obj_create_data}.
\field{resource_obj_specific_data} refers to the resource object specific data.
Expand Down Expand Up @@ -132,7 +135,8 @@ \subsubsection{Device resource objects}\label{sec:Basic Facilities of a Virtio D
For the command VIRTIO_ADMIN_CMD_RESOURCE_OBJ_MODIFY, \field{opcode} is set to 0xb.
The \field{command_specific_data} is in the format
\field{struct virtio_admin_cmd_resource_modify_data}.
\field{group_member_id} is set to zero.
\field{group_member_id} is set to zero for self-group type and set to
the member device to be accessed for the SR-IOV group type.
\field{id} identifies the resource object of type \field{type} whose attributes
to modify.
This command modifies the attributes supplied in \field{resource_obj_specific_data}.
Expand All @@ -154,7 +158,8 @@ \subsubsection{Device resource objects}\label{sec:Basic Facilities of a Virtio D

This command queries attributes of the existing resource object.
For the command VIRTIO_ADMIN_CMD_RESOURCE_OBJ_QUERY, \field{opcode} is set to 0xc.
\field{group_member_id} is set to zero.
\field{group_member_id} is set to zero for self-group type and set to
the member device to be accessed for the SR-IOV group type.
The \field{command_specific_data} is in the format
\field{struct virtio_admin_cmd_resource_obj_query_data}.
\field{id} identifies the existing resource object of type \field{type} whose
Expand Down Expand Up @@ -186,7 +191,8 @@ \subsubsection{Device resource objects}\label{sec:Basic Facilities of a Virtio D
For the command VIRTIO_ADMIN_CMD_RESOURCE_OBJ_DESTROY, \field{opcode} is set to 0xd.
The \field{command_specific_data} is in the format
\field{struct virtio_admin_cmd_resource_obj_cmd_hdr}.
\field{group_member_id} is set to zero.
\field{group_member_id} is set to zero for self-group type and set to
the member device to be accessed for the SR-IOV group type.
\field{id} identifies the existing resource object of type \field{type}.

This command destroys the specified resource object of \field{type} identified
Expand Down

0 comments on commit 742e296

Please sign in to comment.