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