xref: /OK3568_Linux_fs/kernel/Documentation/ABI/stable/sysfs-bus-firewire (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593SmuzhiyunWhat:		/sys/bus/firewire/devices/fw[0-9]+/
2*4882a593SmuzhiyunDate:		May 2007
3*4882a593SmuzhiyunKernelVersion:	2.6.22
4*4882a593SmuzhiyunContact:	linux1394-devel@lists.sourceforge.net
5*4882a593SmuzhiyunDescription:
6*4882a593Smuzhiyun		IEEE 1394 node device attributes.
7*4882a593Smuzhiyun		Read-only.  Mutable during the node device's lifetime.
8*4882a593Smuzhiyun		See IEEE 1212 for semantic definitions.
9*4882a593Smuzhiyun
10*4882a593Smuzhiyun		config_rom
11*4882a593Smuzhiyun			Contents of the Configuration ROM register.
12*4882a593Smuzhiyun			Binary attribute; an array of host-endian u32.
13*4882a593Smuzhiyun
14*4882a593Smuzhiyun		guid
15*4882a593Smuzhiyun			The node's EUI-64 in the bus information block of
16*4882a593Smuzhiyun			Configuration ROM.
17*4882a593Smuzhiyun			Hexadecimal string representation of an u64.
18*4882a593Smuzhiyun
19*4882a593Smuzhiyun
20*4882a593SmuzhiyunWhat:		/sys/bus/firewire/devices/fw[0-9]+/units
21*4882a593SmuzhiyunDate:		June 2009
22*4882a593SmuzhiyunKernelVersion:	2.6.31
23*4882a593SmuzhiyunContact:	linux1394-devel@lists.sourceforge.net
24*4882a593SmuzhiyunDescription:
25*4882a593Smuzhiyun		IEEE 1394 node device attribute.
26*4882a593Smuzhiyun		Read-only.  Mutable during the node device's lifetime.
27*4882a593Smuzhiyun		See IEEE 1212 for semantic definitions.
28*4882a593Smuzhiyun
29*4882a593Smuzhiyun		units
30*4882a593Smuzhiyun			Summary of all units present in an IEEE 1394 node.
31*4882a593Smuzhiyun			Contains space-separated tuples of specifier_id and
32*4882a593Smuzhiyun			version of each unit present in the node.  Specifier_id
33*4882a593Smuzhiyun			and version are hexadecimal string representations of
34*4882a593Smuzhiyun			u24 of the respective unit directory entries.
35*4882a593Smuzhiyun			Specifier_id and version within each tuple are separated
36*4882a593Smuzhiyun			by a colon.
37*4882a593Smuzhiyun
38*4882a593SmuzhiyunUsers:		udev rules to set ownership and access permissions or ACLs of
39*4882a593Smuzhiyun		/dev/fw[0-9]+ character device files
40*4882a593Smuzhiyun
41*4882a593Smuzhiyun
42*4882a593SmuzhiyunWhat:		/sys/bus/firewire/devices/fw[0-9]+/is_local
43*4882a593SmuzhiyunDate:		July 2012
44*4882a593SmuzhiyunKernelVersion:	3.6
45*4882a593SmuzhiyunContact:	linux1394-devel@lists.sourceforge.net
46*4882a593SmuzhiyunDescription:
47*4882a593Smuzhiyun		IEEE 1394 node device attribute.
48*4882a593Smuzhiyun		Read-only and immutable.
49*4882a593SmuzhiyunValues:		1: The sysfs entry represents a local node (a controller card).
50*4882a593Smuzhiyun
51*4882a593Smuzhiyun		0: The sysfs entry represents a remote node.
52*4882a593Smuzhiyun
53*4882a593Smuzhiyun
54*4882a593SmuzhiyunWhat:		/sys/bus/firewire/devices/fw[0-9]+[.][0-9]+/
55*4882a593SmuzhiyunDate:		May 2007
56*4882a593SmuzhiyunKernelVersion:	2.6.22
57*4882a593SmuzhiyunContact:	linux1394-devel@lists.sourceforge.net
58*4882a593SmuzhiyunDescription:
59*4882a593Smuzhiyun		IEEE 1394 unit device attributes.
60*4882a593Smuzhiyun		Read-only.  Immutable during the unit device's lifetime.
61*4882a593Smuzhiyun		See IEEE 1212 for semantic definitions.
62*4882a593Smuzhiyun
63*4882a593Smuzhiyun		modalias
64*4882a593Smuzhiyun			Same as MODALIAS in the uevent at device creation.
65*4882a593Smuzhiyun
66*4882a593Smuzhiyun		rom_index
67*4882a593Smuzhiyun			Offset of the unit directory within the parent device's
68*4882a593Smuzhiyun			(node device's) Configuration ROM, in quadlets.
69*4882a593Smuzhiyun			Decimal string representation.
70*4882a593Smuzhiyun
71*4882a593Smuzhiyun
72*4882a593SmuzhiyunWhat:		/sys/bus/firewire/devices/*/
73*4882a593SmuzhiyunDate:		May 2007
74*4882a593SmuzhiyunKernelVersion:	2.6.22
75*4882a593SmuzhiyunContact:	linux1394-devel@lists.sourceforge.net
76*4882a593SmuzhiyunDescription:
77*4882a593Smuzhiyun		Attributes common to IEEE 1394 node devices and unit devices.
78*4882a593Smuzhiyun		Read-only.  Mutable during the node device's lifetime.
79*4882a593Smuzhiyun		Immutable during the unit device's lifetime.
80*4882a593Smuzhiyun		See IEEE 1212 for semantic definitions.
81*4882a593Smuzhiyun
82*4882a593Smuzhiyun		These attributes are only created if the root directory of an
83*4882a593Smuzhiyun		IEEE 1394 node or the unit directory of an IEEE 1394 unit
84*4882a593Smuzhiyun		actually contains according entries.
85*4882a593Smuzhiyun
86*4882a593Smuzhiyun		hardware_version
87*4882a593Smuzhiyun			Hexadecimal string representation of an u24.
88*4882a593Smuzhiyun
89*4882a593Smuzhiyun		hardware_version_name
90*4882a593Smuzhiyun			Contents of a respective textual descriptor leaf.
91*4882a593Smuzhiyun
92*4882a593Smuzhiyun		model
93*4882a593Smuzhiyun			Hexadecimal string representation of an u24.
94*4882a593Smuzhiyun
95*4882a593Smuzhiyun		model_name
96*4882a593Smuzhiyun			Contents of a respective textual descriptor leaf.
97*4882a593Smuzhiyun
98*4882a593Smuzhiyun		specifier_id
99*4882a593Smuzhiyun			Hexadecimal string representation of an u24.
100*4882a593Smuzhiyun			Mandatory in unit directories according to IEEE 1212.
101*4882a593Smuzhiyun
102*4882a593Smuzhiyun		vendor
103*4882a593Smuzhiyun			Hexadecimal string representation of an u24.
104*4882a593Smuzhiyun			Mandatory in the root directory according to IEEE 1212.
105*4882a593Smuzhiyun
106*4882a593Smuzhiyun		vendor_name
107*4882a593Smuzhiyun			Contents of a respective textual descriptor leaf.
108*4882a593Smuzhiyun
109*4882a593Smuzhiyun		version
110*4882a593Smuzhiyun			Hexadecimal string representation of an u24.
111*4882a593Smuzhiyun			Mandatory in unit directories according to IEEE 1212.
112*4882a593Smuzhiyun
113*4882a593Smuzhiyun
114*4882a593SmuzhiyunWhat:		/sys/bus/firewire/drivers/sbp2/fw*/host*/target*/*:*:*:*/ieee1394_id
115*4882a593Smuzhiyun		formerly
116*4882a593Smuzhiyun		/sys/bus/ieee1394/drivers/sbp2/fw*/host*/target*/*:*:*:*/ieee1394_id
117*4882a593SmuzhiyunDate:		Feb 2004
118*4882a593SmuzhiyunKernelVersion:	2.6.4
119*4882a593SmuzhiyunContact:	linux1394-devel@lists.sourceforge.net
120*4882a593SmuzhiyunDescription:
121*4882a593Smuzhiyun		SCSI target port identifier and logical unit identifier of a
122*4882a593Smuzhiyun		logical unit of an SBP-2 target.  The identifiers are specified
123*4882a593Smuzhiyun		in SAM-2...SAM-4 annex A.  They are persistent and world-wide
124*4882a593Smuzhiyun		unique properties the SBP-2 attached target.
125*4882a593Smuzhiyun
126*4882a593Smuzhiyun		Read-only attribute, immutable during the target's lifetime.
127*4882a593Smuzhiyun		Format, as exposed by firewire-sbp2 since 2.6.22, May 2007:
128*4882a593Smuzhiyun		Colon-separated hexadecimal string representations of
129*4882a593Smuzhiyun
130*4882a593Smuzhiyun			u64 EUI-64 : u24 directory_ID : u16 LUN
131*4882a593Smuzhiyun
132*4882a593Smuzhiyun		without 0x prefixes, without whitespace.  The former sbp2 driver
133*4882a593Smuzhiyun		(removed in 2.6.37 after being superseded by firewire-sbp2) used
134*4882a593Smuzhiyun		a somewhat shorter format which was not as close to SAM.
135*4882a593Smuzhiyun
136*4882a593SmuzhiyunUsers:		udev rules to create /dev/disk/by-id/ symlinks
137