[virtio-dev] Re: [PATCH v1 1/2] transport-pci: Introduce legacy registers access commands

[Parav Pandit <parav@nvidia.com>]

On 5/3/2023 1:42 AM, Michael S. Tsirkin wrote:
> On Wed, May 03, 2023 at 06:26:58AM +0300, Parav Pandit wrote:

>> diff --git a/transport-pci-vf-regs.tex b/transport-pci-vf-regs.tex
>> new file mode 100644
>> index 0000000..16ced32
>> --- /dev/null
>> +++ b/transport-pci-vf-regs.tex
> 
> I'd like the name to reflect "legacy". Also I don't think this has
> to be SRIOV generally. It's just legacy PCI over admin commands.
> Except for virtio_admin_cmd_lq_notify_query_result
> which refers to PCI? But that
> one I can't say for sure what it does.
> 
It is for legacy now, in future it can be renamed if this is supported.
We already discussed in v0 that non legacy should not involve hypervisor 
mediation. May be you still it should be. In such case lets park that 
discussion for future. This proposal is not limiting it.

> 
>> @@ -0,0 +1,84 @@
>> +\subsection{SR-IOV VFs Legacy Registers Access}\label{sec:Virtio Transport Options / Virtio Over PCI Bus / SR-IOV Legacy Registers Access}
>> +
>> +As described in PCIe base specification \hyperref[intro:PCIe]{[PCIe]} PCI VFs
>> +do not support IOBAR. A PCI PF device can optionally enable driver to access
>> +its member PCI VFs devices legacy common configuration and device configuration
>> +registers using an administration virtqueue. A PCI PF group owner device that
>> +supports its member VFs legacy registers access via the administration
>> +virtqueue should supports following commands.
> 
> As above. It actually can work for any group if we want to.
True. As defined by the PCIe spec, for virtualized VFs and SFs devices, 
VI is not necessary, and many devices in PCI space are avoiding 
hypervisor mediation, so whether to tunnel or not is really a question 
for future for non legacy registers.

> 
> 
>> +
>> +\begin{enumerate}
>> +\item Legacy Registers Write
>> +\item Legacy Registers Read
>> +\item Legacy Queue Notify Offset Query
>> +\end{enumerate}
>> +
> 
> Pls add some theory of operation. How can all this be used?
> 
ok. I will add in this section.

>> +\begin{lstlisting}
>> +struct virtio_admin_cmd_lreg_rd_result {
>> +	u8 registers[];
>> +};
>> +\end{lstlisting}
>> +
>> +\subsubsection{Legacy Queue Notify Offset Query}\label{sec:Virtio Transport Options / Virtio Over PCI Bus / SR-IOV Legacy Registers Access / Legacy Queue Notify Offset Query}
>> +
>> +This command returns the notify offset of the member VF for queue
>> +notifications.
> 
> What is this notify offset? It's never explained.
> 
ok. will add it.
It is the notification offset where a hypervisor driver can perform 
driver notifications.

>> This command follows \field{struct virtio_admin_cmd}.
>> +Driver sets command opcode \field{opcode} to VIRTIO_ADMIN_CMD_LQ_NOTIFY_QUERY.
>> +There is no command specific data for this command.
>> +Driver sets \field{group_type} to 1.
>> +Driver sets \field{group_member_id} to a valid VF number.
> 
> I think ATM the limitation for this is that the member must be a pci
> device, otherwise BAR is not well defined. We will have to
> find a way to extend this for SIOV. 

SIOV device will also have the BAR and offset of the parent PF.
The limitation of current AQ is currently is it indicates the BAR of the 
member device (and does not allow group owner for SIOV), but we can 
craft it via SIOV device BAR and it will be fine. SIOV spec is not yet 
released for this details at all. So we can wait.

> But that is all, please do
> not repeat documentation about virtio_admin_cmd header, we have that in
> a central place.
> 
Make sense. I will omit it here.

>> +
>> +When command completes successfully, command result contains the queue
>> +notification address in the listed format:
>> +
>> +\begin{lstlisting}
>> +struct virtio_admin_cmd_lq_notify_query_result {
>> +	u8 bar; /* PCI BAR number of the member VF */
>> +	u8 reserved[7];
>> +	le64 offset; /* Byte offset within the BAR */
>> +};
>> +\end{lstlisting}
>> diff --git a/transport-pci.tex b/transport-pci.tex
>> index ff889d3..b187576 100644
>> --- a/transport-pci.tex
>> +++ b/transport-pci.tex
>> @@ -1179,3 +1179,5 @@ \subsubsection{Driver Handling Interrupts}\label{sec:Virtio Transport Options /
>>           re-examine the configuration space to see what changed.
>>       \end{itemize}
>>   \end{itemize}
>> +
>> +\input{transport-pci-vf-regs.tex}
> 
> As simple as it is, I feel this falls far short of describing how
> a device should operate.
> Some issues:
> 	- legacy device config offset changes as msi is enabled/disabled
> 	  suggest separate commands for device/common config
This is fine and covered here. The one who is making msix enable/disable 
knows which registers to access before/after disable/enable and device 
also knows it as it is supplying the register.
So they just follow the standard legacy register access behavior.

> 	- legacy device endian-ness changes with guest
> 	  suggest commands to enable LE and BE mode
guest endianeness is not known to the device. Currently it is only for 
the LE guests who had some legacy requirement.
and PCIe is LE anyway.

> 	- legacy guests often assume INT#x support
> 	  suggest a way to tunnel that too;
INT#x is present on the PCI device itself. So no need to tunnel it.
Also INT#x is very narrow case. When MSI-X is not supported, a 
hypervisor can choose not to even connect such device to the guest VM.

> 	  though supporting ISR is going to be a challenge :(
> 	- I presume admin command is not the way to do kicks? Or is it ok?
> 	- there's some kind of notify thing here?
> 
Right.
We already discussed this in v0.
Summary of it is: admin command can, but it wont work any performant 
way. The device and driver uses the notification region already present 
on the PCI VF device, which is queried using NOTIFY_QUERY command.

> I expected to see more statements along the lines of
>          command ABC has the same effect as access
>          to register DEF of the member through the legacy pci interface
> 
Yes, good point. I will add it in the theory of operation section for 
this mapping detail.

---------------------------------------------------------------------
To unsubscribe, e-mail: virtio-dev-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: virtio-dev-help@lists.oasis-open.org