~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

TOMOYO Linux Cross Reference
Linux/Documentation/ABI/testing/sysfs-class-pktcdvd

Version: ~ [ linux-6.12-rc7 ] ~ [ linux-6.11.7 ] ~ [ linux-6.10.14 ] ~ [ linux-6.9.12 ] ~ [ linux-6.8.12 ] ~ [ linux-6.7.12 ] ~ [ linux-6.6.60 ] ~ [ linux-6.5.13 ] ~ [ linux-6.4.16 ] ~ [ linux-6.3.13 ] ~ [ linux-6.2.16 ] ~ [ linux-6.1.116 ] ~ [ linux-6.0.19 ] ~ [ linux-5.19.17 ] ~ [ linux-5.18.19 ] ~ [ linux-5.17.15 ] ~ [ linux-5.16.20 ] ~ [ linux-5.15.171 ] ~ [ linux-5.14.21 ] ~ [ linux-5.13.19 ] ~ [ linux-5.12.19 ] ~ [ linux-5.11.22 ] ~ [ linux-5.10.229 ] ~ [ linux-5.9.16 ] ~ [ linux-5.8.18 ] ~ [ linux-5.7.19 ] ~ [ linux-5.6.19 ] ~ [ linux-5.5.19 ] ~ [ linux-5.4.285 ] ~ [ linux-5.3.18 ] ~ [ linux-5.2.21 ] ~ [ linux-5.1.21 ] ~ [ linux-5.0.21 ] ~ [ linux-4.20.17 ] ~ [ linux-4.19.323 ] ~ [ linux-4.18.20 ] ~ [ linux-4.17.19 ] ~ [ linux-4.16.18 ] ~ [ linux-4.15.18 ] ~ [ linux-4.14.336 ] ~ [ linux-4.13.16 ] ~ [ linux-4.12.14 ] ~ [ linux-4.11.12 ] ~ [ linux-4.10.17 ] ~ [ linux-4.9.337 ] ~ [ linux-4.4.302 ] ~ [ linux-3.10.108 ] ~ [ linux-2.6.32.71 ] ~ [ linux-2.6.0 ] ~ [ linux-2.4.37.11 ] ~ [ unix-v6-master ] ~ [ ccs-tools-1.8.12 ] ~ [ policy-sample ] ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

  1 sysfs interface
  2 ---------------
  3 The pktcdvd module (packet writing driver) creates the following files in the
  4 sysfs: (<devid> is in the format major:minor)
  5 
  6 What:           /sys/class/pktcdvd/add
  7 What:           /sys/class/pktcdvd/remove
  8 What:           /sys/class/pktcdvd/device_map
  9 Date:           Oct. 2006
 10 KernelVersion:  2.6.20
 11 Contact:        Thomas Maier <balagi@justmail.de>
 12 Description:
 13 
 14                 ==========      ==============================================
 15                 add             (WO) Write a block device id (major:minor) to
 16                                 create a new pktcdvd device and map it to the
 17                                 block device.
 18 
 19                 remove          (WO) Write the pktcdvd device id (major:minor)
 20                                 to remove the pktcdvd device.
 21 
 22                 device_map      (RO) Shows the device mapping in format:
 23                                 pktcdvd[0-7] <pktdevid> <blkdevid>
 24                 ==========      ==============================================
 25 
 26 
 27 What:           /sys/class/pktcdvd/pktcdvd[0-7]/dev
 28 What:           /sys/class/pktcdvd/pktcdvd[0-7]/uevent
 29 Date:           Oct. 2006
 30 KernelVersion:  2.6.20
 31 Contact:        Thomas Maier <balagi@justmail.de>
 32 Description:
 33                 dev:    (RO) Device id
 34 
 35                 uevent: (WO) To send a uevent
 36 
 37 
 38 What:           /sys/class/pktcdvd/pktcdvd[0-7]/stat/packets_started
 39 What:           /sys/class/pktcdvd/pktcdvd[0-7]/stat/packets_finished
 40 What:           /sys/class/pktcdvd/pktcdvd[0-7]/stat/kb_written
 41 What:           /sys/class/pktcdvd/pktcdvd[0-7]/stat/kb_read
 42 What:           /sys/class/pktcdvd/pktcdvd[0-7]/stat/kb_read_gather
 43 What:           /sys/class/pktcdvd/pktcdvd[0-7]/stat/reset
 44 Date:           Oct. 2006
 45 KernelVersion:  2.6.20
 46 Contact:        Thomas Maier <balagi@justmail.de>
 47 Description:
 48                 packets_started:        (RO) Number of started packets.
 49 
 50                 packets_finished:       (RO) Number of finished packets.
 51 
 52                 kb_written:             (RO) kBytes written.
 53 
 54                 kb_read:                (RO) kBytes read.
 55 
 56                 kb_read_gather:         (RO) kBytes read to fill write packets.
 57 
 58                 reset:                  (WO) Write any value to it to reset
 59                                         pktcdvd device statistic values, like
 60                                         bytes read/written.
 61 
 62 
 63 What:           /sys/class/pktcdvd/pktcdvd[0-7]/write_queue/size
 64 What:           /sys/class/pktcdvd/pktcdvd[0-7]/write_queue/congestion_off
 65 What:           /sys/class/pktcdvd/pktcdvd[0-7]/write_queue/congestion_on
 66 Date:           Oct. 2006
 67 KernelVersion:  2.6.20
 68 Contact:        Thomas Maier <balagi@justmail.de>
 69 Description:
 70                 ==============  ================================================
 71                 size            (RO) Contains the size of the bio write queue.
 72 
 73                 congestion_off  (RW) If bio write queue size is below this mark,
 74                                 accept new bio requests from the block layer.
 75 
 76                 congestion_on   (RW) If bio write queue size is higher as this
 77                                 mark, do no longer accept bio write requests
 78                                 from the block layer and wait till the pktcdvd
 79                                 device has processed enough bio's so that bio
 80                                 write queue size is below congestion off mark.
 81                                 A value of <= 0 disables congestion control.
 82                 ==============  ================================================
 83 
 84 
 85 Example:
 86 --------
 87 To use the pktcdvd sysfs interface directly, you can do::
 88 
 89     # create a new pktcdvd device mapped to /dev/hdc
 90     echo "22:0" >/sys/class/pktcdvd/add
 91     cat /sys/class/pktcdvd/device_map
 92     # assuming device pktcdvd0 was created, look at stat's
 93     cat /sys/class/pktcdvd/pktcdvd0/stat/kb_written
 94     # print the device id of the mapped block device
 95     fgrep pktcdvd0 /sys/class/pktcdvd/device_map
 96     # remove device, using pktcdvd0 device id   253:0
 97     echo "253:0" >/sys/class/pktcdvd/remove

~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

kernel.org | git.kernel.org | LWN.net | Project Home | SVN repository | Mail admin

Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.

sflogo.php