mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-09-15 23:25:07 +00:00
54a19b4d3f
There are some ABI documents that, while they don't generate any warnings, they have issues when parsed by get_abi.pl script on its output result. Address them, in order to provide a clean output. Reviewed-by: Tom Rix <trix@redhat.com> # for fpga-manager Reviewed-By: Kajol Jain<kjain@linux.ibm.com> # for sysfs-bus-event_source-devices-hv_gpci and sysfs-bus-event_source-devices-hv_24x7 Acked-by: Jonathan Cameron <Jonathan.Cameron@huawei.com> #for IIO Acked-by: Oded Gabbay <oded.gabbay@gmail.com> # for Habanalabs Acked-by: Vaibhav Jain <vaibhav@linux.ibm.com> # for sysfs-bus-papr-pmem Acked-by: Cezary Rojewski <cezary.rojewski@intel.com> # for catpt Acked-by: Suzuki K Poulose <suzuki.poulose@arm.com> Acked-by: Ilya Dryomov <idryomov@gmail.com> # for rbd Acked-by: Jonathan Corbet <corbet@lwn.net> Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org> Link: https://lore.kernel.org/r/5bc78e5b68ed1e9e39135173857cb2e753be868f.1604042072.git.mchehab+huawei@kernel.org Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
97 lines
3.2 KiB
Text
97 lines
3.2 KiB
Text
sysfs interface
|
|
---------------
|
|
The pktcdvd module (packet writing driver) creates the following files in the
|
|
sysfs: (<devid> is in the format major:minor)
|
|
|
|
What: /sys/class/pktcdvd/add
|
|
What: /sys/class/pktcdvd/remove
|
|
What: /sys/class/pktcdvd/device_map
|
|
Date: Oct. 2006
|
|
KernelVersion: 2.6.20
|
|
Contact: Thomas Maier <balagi@justmail.de>
|
|
Description:
|
|
|
|
========== ==============================================
|
|
add (WO) Write a block device id (major:minor) to
|
|
create a new pktcdvd device and map it to the
|
|
block device.
|
|
|
|
remove (WO) Write the pktcdvd device id (major:minor)
|
|
to remove the pktcdvd device.
|
|
|
|
device_map (RO) Shows the device mapping in format:
|
|
pktcdvd[0-7] <pktdevid> <blkdevid>
|
|
========== ==============================================
|
|
|
|
|
|
What: /sys/class/pktcdvd/pktcdvd[0-7]/dev
|
|
What: /sys/class/pktcdvd/pktcdvd[0-7]/uevent
|
|
Date: Oct. 2006
|
|
KernelVersion: 2.6.20
|
|
Contact: Thomas Maier <balagi@justmail.de>
|
|
Description:
|
|
dev: (RO) Device id
|
|
|
|
uevent: (WO) To send a uevent
|
|
|
|
|
|
What: /sys/class/pktcdvd/pktcdvd[0-7]/stat/packets_started
|
|
What: /sys/class/pktcdvd/pktcdvd[0-7]/stat/packets_finished
|
|
What: /sys/class/pktcdvd/pktcdvd[0-7]/stat/kb_written
|
|
What: /sys/class/pktcdvd/pktcdvd[0-7]/stat/kb_read
|
|
What: /sys/class/pktcdvd/pktcdvd[0-7]/stat/kb_read_gather
|
|
What: /sys/class/pktcdvd/pktcdvd[0-7]/stat/reset
|
|
Date: Oct. 2006
|
|
KernelVersion: 2.6.20
|
|
Contact: Thomas Maier <balagi@justmail.de>
|
|
Description:
|
|
packets_started: (RO) Number of started packets.
|
|
|
|
packets_finished: (RO) Number of finished packets.
|
|
|
|
kb_written: (RO) kBytes written.
|
|
|
|
kb_read: (RO) kBytes read.
|
|
|
|
kb_read_gather: (RO) kBytes read to fill write packets.
|
|
|
|
reset: (WO) Write any value to it to reset
|
|
pktcdvd device statistic values, like
|
|
bytes read/written.
|
|
|
|
|
|
What: /sys/class/pktcdvd/pktcdvd[0-7]/write_queue/size
|
|
What: /sys/class/pktcdvd/pktcdvd[0-7]/write_queue/congestion_off
|
|
What: /sys/class/pktcdvd/pktcdvd[0-7]/write_queue/congestion_on
|
|
Date: Oct. 2006
|
|
KernelVersion: 2.6.20
|
|
Contact: Thomas Maier <balagi@justmail.de>
|
|
Description:
|
|
============== ================================================
|
|
size (RO) Contains the size of the bio write queue.
|
|
|
|
congestion_off (RW) If bio write queue size is below this mark,
|
|
accept new bio requests from the block layer.
|
|
|
|
congestion_on (RW) If bio write queue size is higher as this
|
|
mark, do no longer accept bio write requests
|
|
from the block layer and wait till the pktcdvd
|
|
device has processed enough bio's so that bio
|
|
write queue size is below congestion off mark.
|
|
A value of <= 0 disables congestion control.
|
|
============== ================================================
|
|
|
|
|
|
Example:
|
|
--------
|
|
To use the pktcdvd sysfs interface directly, you can do::
|
|
|
|
# create a new pktcdvd device mapped to /dev/hdc
|
|
echo "22:0" >/sys/class/pktcdvd/add
|
|
cat /sys/class/pktcdvd/device_map
|
|
# assuming device pktcdvd0 was created, look at stat's
|
|
cat /sys/class/pktcdvd/pktcdvd0/stat/kb_written
|
|
# print the device id of the mapped block device
|
|
fgrep pktcdvd0 /sys/class/pktcdvd/device_map
|
|
# remove device, using pktcdvd0 device id 253:0
|
|
echo "253:0" >/sys/class/pktcdvd/remove
|