Skip to content

Commit 3113a29

Browse files
Jason J. HerneAlexander Gordeev
authored andcommitted
docs: Update s390 vfio-ap doc for ap_config sysfs attribute
A new sysfs attribute, ap_config, for the vfio_ap driver is documented. Signed-off-by: "Jason J. Herne" <jjherne@linux.ibm.com> Reviewed-by: Tony Krowiak <akrowiak@linux.ibm.com> Link: https://lore.kernel.org/r/20240415152555.13152-6-jjherne@linux.ibm.com Signed-off-by: Alexander Gordeev <agordeev@linux.ibm.com>
1 parent 8fb456b commit 3113a29

File tree

1 file changed

+30
-0
lines changed

1 file changed

+30
-0
lines changed

Documentation/arch/s390/vfio-ap.rst

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -380,6 +380,36 @@ matrix device.
380380
control_domains:
381381
A read-only file for displaying the control domain numbers assigned to the
382382
vfio_ap mediated device.
383+
ap_config:
384+
A read/write file that, when written to, allows all three of the
385+
vfio_ap mediated device's ap matrix masks to be replaced in one shot.
386+
Three masks are given, one for adapters, one for domains, and one for
387+
control domains. If the given state cannot be set then no changes are
388+
made to the vfio-ap mediated device.
389+
390+
The format of the data written to ap_config is as follows:
391+
{amask},{dmask},{cmask}\n
392+
393+
\n is a newline character.
394+
395+
amask, dmask, and cmask are masks identifying which adapters, domains,
396+
and control domains should be assigned to the mediated device.
397+
398+
The format of a mask is as follows:
399+
0xNN..NN
400+
401+
Where NN..NN is 64 hexadecimal characters representing a 256-bit value.
402+
The leftmost (highest order) bit represents adapter/domain 0.
403+
404+
For an example set of masks that represent your mdev's current
405+
configuration, simply cat ap_config.
406+
407+
Setting an adapter or domain number greater than the maximum allowed for
408+
the system will result in an error.
409+
410+
This attribute is intended to be used by automation. End users would be
411+
better served using the respective assign/unassign attributes for
412+
adapters, domains, and control domains.
383413

384414
* functions:
385415

0 commit comments

Comments
 (0)