hc
2024-12-19 9370bb92b2d16684ee45cf24e879c93c509162da
kernel/Documentation/ABI/testing/sysfs-firmware-qemu_fw_cfg
....@@ -15,7 +15,7 @@
1515 to the fw_cfg device can be found in "docs/specs/fw_cfg.txt"
1616 in the QEMU source tree.
1717
18
- === SysFS fw_cfg Interface ===
18
+ **SysFS fw_cfg Interface**
1919
2020 The fw_cfg sysfs interface described in this document is only
2121 intended to display discoverable blobs (i.e., those registered
....@@ -31,7 +31,7 @@
3131
3232 /sys/firmware/qemu_fw_cfg/rev
3333
34
- --- Discoverable fw_cfg blobs by selector key ---
34
+ **Discoverable fw_cfg blobs by selector key**
3535
3636 All discoverable blobs listed in the fw_cfg file directory are
3737 displayed as entries named after their unique selector key
....@@ -45,24 +45,26 @@
4545 Each such fw_cfg sysfs entry has the following values exported
4646 as attributes:
4747
48
- name : The 56-byte nul-terminated ASCII string used as the
48
+ ==== ====================================================
49
+ name The 56-byte nul-terminated ASCII string used as the
4950 blob's 'file name' in the fw_cfg directory.
50
- size : The length of the blob, as given in the fw_cfg
51
+ size The length of the blob, as given in the fw_cfg
5152 directory.
52
- key : The value of the blob's selector key as given in the
53
+ key The value of the blob's selector key as given in the
5354 fw_cfg directory. This value is the same as used in
5455 the parent directory name.
55
- raw : The raw bytes of the blob, obtained by selecting the
56
+ raw The raw bytes of the blob, obtained by selecting the
5657 entry via the control register, and reading a number
5758 of bytes equal to the blob size from the data
5859 register.
60
+ ==== ====================================================
5961
60
- --- Listing fw_cfg blobs by file name ---
62
+ **Listing fw_cfg blobs by file name**
6163
6264 While the fw_cfg device does not impose any specific naming
6365 convention on the blobs registered in the file directory,
6466 QEMU developers have traditionally used path name semantics
65
- to give each blob a descriptive name. For example:
67
+ to give each blob a descriptive name. For example::
6668
6769 "bootorder"
6870 "genroms/kvmvapic.bin"
....@@ -81,7 +83,7 @@
8183 of directories matching the path name components of fw_cfg
8284 blob names, ending in symlinks to the by_key entry for each
8385 "basename", as illustrated below (assume current directory is
84
- /sys/firmware):
86
+ /sys/firmware)::
8587
8688 qemu_fw_cfg/by_name/bootorder -> ../by_key/38
8789 qemu_fw_cfg/by_name/etc/e820 -> ../../by_key/35