docs: note node device fields that are read-only

As noted by Erik Skultety, we use the same XML schema to report
existing devices and to define new devices. However, some schema
elements are "read-only". In other words, they are used to report
information from the node device driver and cannot be used to define a
new device. Note these in the documentation.

Signed-off-by: Jonathon Jongsma <jjongsma@redhat.com>
Reviewed-by: Erik Skultety <eskultet@redhat.com>
Reviewed-by: Michal Privoznik <mprivozn@redhat.com>
This commit is contained in:
Jonathon Jongsma 2020-06-18 16:06:04 -05:00 committed by Erik Skultety
parent 872c9b97c2
commit ed783e5ecd

View File

@ -31,11 +31,16 @@
name is just the bus type and address, as in
"pci_0000_00_02_1" or "usb_1_5_3", but some devices are able
to provide more specific names, such as
"net_eth1_00_27_13_6a_fe_00".
"net_eth1_00_27_13_6a_fe_00". This is a read-only field that is
reported by the device driver. If this element is set when defining a
new device, it will be ignored.
</dd>
<dt><code>path</code></dt>
<dd>
Fully qualified sysfs path to the device.
Fully qualified sysfs path to the device. This is a read-only field
that is reported by the device driver. If this element is set when
defining a new device, it will be ignored.
</dd>
<dt><code>parent</code></dt>
<dd>