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