aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/ABI
diff options
context:
space:
mode:
authorLinus Torvalds <torvalds@linux-foundation.org>2014-04-02 23:53:45 -0400
committerLinus Torvalds <torvalds@linux-foundation.org>2014-04-02 23:53:45 -0400
commitcd6362befe4cc7bf589a5236d2a780af2d47bcc9 (patch)
tree3bd4e13ec3f92a00dc4f6c3d65e820b54dbfe46e /Documentation/ABI
parent0f1b1e6d73cb989ce2c071edc57deade3b084dfe (diff)
parentb1586f099ba897542ece36e8a23c1a62907261ef (diff)
Merge git://git.kernel.org/pub/scm/linux/kernel/git/davem/net-next
Pull networking updates from David Miller: "Here is my initial pull request for the networking subsystem during this merge window: 1) Support for ESN in AH (RFC 4302) from Fan Du. 2) Add full kernel doc for ethtool command structures, from Ben Hutchings. 3) Add BCM7xxx PHY driver, from Florian Fainelli. 4) Export computed TCP rate information in netlink socket dumps, from Eric Dumazet. 5) Allow IPSEC SA to be dumped partially using a filter, from Nicolas Dichtel. 6) Convert many drivers to pci_enable_msix_range(), from Alexander Gordeev. 7) Record SKB timestamps more efficiently, from Eric Dumazet. 8) Switch to microsecond resolution for TCP round trip times, also from Eric Dumazet. 9) Clean up and fix 6lowpan fragmentation handling by making use of the existing inet_frag api for it's implementation. 10) Add TX grant mapping to xen-netback driver, from Zoltan Kiss. 11) Auto size SKB lengths when composing netlink messages based upon past message sizes used, from Eric Dumazet. 12) qdisc dumps can take a long time, add a cond_resched(), From Eric Dumazet. 13) Sanitize netpoll core and drivers wrt. SKB handling semantics. Get rid of never-used-in-tree netpoll RX handling. From Eric W Biederman. 14) Support inter-address-family and namespace changing in VTI tunnel driver(s). From Steffen Klassert. 15) Add Altera TSE driver, from Vince Bridgers. 16) Optimizing csum_replace2() so that it doesn't adjust the checksum by checksumming the entire header, from Eric Dumazet. 17) Expand BPF internal implementation for faster interpreting, more direct translations into JIT'd code, and much cleaner uses of BPF filtering in non-socket ocntexts. From Daniel Borkmann and Alexei Starovoitov" * git://git.kernel.org/pub/scm/linux/kernel/git/davem/net-next: (1976 commits) netpoll: Use skb_irq_freeable to make zap_completion_queue safe. net: Add a test to see if a skb is freeable in irq context qlcnic: Fix build failure due to undefined reference to `vxlan_get_rx_port' net: ptp: move PTP classifier in its own file net: sxgbe: make "core_ops" static net: sxgbe: fix logical vs bitwise operation net: sxgbe: sxgbe_mdio_register() frees the bus Call efx_set_channels() before efx->type->dimension_resources() xen-netback: disable rogue vif in kthread context net/mlx4: Set proper build dependancy with vxlan be2net: fix build dependency on VxLAN mac802154: make csma/cca parameters per-wpan mac802154: allow only one WPAN to be up at any given time net: filter: minor: fix kdoc in __sk_run_filter netlink: don't compare the nul-termination in nla_strcmp can: c_can: Avoid led toggling for every packet. can: c_can: Simplify TX interrupt cleanup can: c_can: Store dlc private can: c_can: Reduce register access can: c_can: Make the code readable ...
Diffstat (limited to 'Documentation/ABI')
-rw-r--r--Documentation/ABI/testing/sysfs-bus-mdio20
-rw-r--r--Documentation/ABI/testing/sysfs-class-net199
-rw-r--r--Documentation/ABI/testing/sysfs-class-net-mesh9
-rw-r--r--Documentation/ABI/testing/sysfs-ptp20
4 files changed, 248 insertions, 0 deletions
diff --git a/Documentation/ABI/testing/sysfs-bus-mdio b/Documentation/ABI/testing/sysfs-bus-mdio
index 6349749ebc29..491baaf4285f 100644
--- a/Documentation/ABI/testing/sysfs-bus-mdio
+++ b/Documentation/ABI/testing/sysfs-bus-mdio
@@ -7,3 +7,23 @@ Description:
7 by the device during bus enumeration, encoded in hexadecimal. 7 by the device during bus enumeration, encoded in hexadecimal.
8 This ID is used to match the device with the appropriate 8 This ID is used to match the device with the appropriate
9 driver. 9 driver.
10
11What: /sys/bus/mdio_bus/devices/.../phy_interface
12Date: February 2014
13KernelVersion: 3.15
14Contact: netdev@vger.kernel.org
15Description:
16 This attribute contains the PHY interface as configured by the
17 Ethernet driver during bus enumeration, encoded in string.
18 This interface mode is used to configure the Ethernet MAC with the
19 appropriate mode for its data lines to the PHY hardware.
20
21What: /sys/bus/mdio_bus/devices/.../phy_has_fixups
22Date: February 2014
23KernelVersion: 3.15
24Contact: netdev@vger.kernel.org
25Description:
26 This attribute contains the boolean value whether a given PHY
27 device has had any "fixup" workaround running on it, encoded as
28 a boolean. This information is provided to help troubleshooting
29 PHY configurations.
diff --git a/Documentation/ABI/testing/sysfs-class-net b/Documentation/ABI/testing/sysfs-class-net
new file mode 100644
index 000000000000..d922060e455d
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-class-net
@@ -0,0 +1,199 @@
1What: /sys/class/net/<iface>/addr_assign_type
2Date: July 2010
3KernelVersion: 3.2
4Contact: netdev@vger.kernel.org
5Description:
6 Indicates the address assignment type. Possible values are:
7 0: permanent address
8 1: randomly generated
9 2: stolen from another device
10 3: set using dev_set_mac_address
11
12What: /sys/class/net/<iface>/addr_len
13Date: April 2005
14KernelVersion: 2.6.12
15Contact: netdev@vger.kernel.org
16Description:
17 Indicates the hardware address size in bytes.
18 Values vary based on the lower-level protocol used by the
19 interface (Ethernet, FDDI, ATM, IEEE 802.15.4...). See
20 include/uapi/linux/if_*.h for actual values.
21
22What: /sys/class/net/<iface>/address
23Date: April 2005
24KernelVersion: 2.6.12
25Contact: netdev@vger.kernel.org
26Description:
27 Hardware address currently assigned to this interface.
28 Format is a string, e.g: 00:11:22:33:44:55 for an Ethernet MAC
29 address.
30
31What: /sys/class/net/<iface>/broadcast
32Date: April 2005
33KernelVersion: 2.6.12
34Contact: netdev@vger.kernel.org
35Description:
36 Hardware broadcast address for this interface. Format is a
37 string, e.g: ff:ff:ff:ff:ff:ff for an Ethernet broadcast MAC
38 address.
39
40What: /sys/class/net/<iface>/carrier
41Date: April 2005
42KernelVersion: 2.6.12
43Contact: netdev@vger.kernel.org
44Description:
45 Indicates the current physical link state of the interface.
46 Posssible values are:
47 0: physical link is down
48 1: physical link is up
49
50 Note: some special devices, e.g: bonding and team drivers will
51 allow this attribute to be written to force a link state for
52 operating correctly and designating another fallback interface.
53
54What: /sys/class/net/<iface>/dev_id
55Date: April 2008
56KernelVersion: 2.6.26
57Contact: netdev@vger.kernel.org
58Description:
59 Indicates the device unique identifier. Format is an hexadecimal
60 value. This is used to disambiguate interfaces which might be
61 stacked (e.g: VLAN interfaces) but still have the same MAC
62 address as their parent device.
63
64What: /sys/class/net/<iface>/dormant
65Date: March 2006
66KernelVersion: 2.6.17
67Contact: netdev@vger.kernel.org
68Description:
69 Indicates whether the interface is in dormant state. Possible
70 values are:
71 0: interface is not dormant
72 1: interface is dormant
73
74 This attribute can be used by supplicant software to signal that
75 the device is not usable unless some supplicant-based
76 authentication is performed (e.g: 802.1x). 'link_mode' attribute
77 will also reflect the dormant state.
78
79What: /sys/clas/net/<iface>/duplex
80Date: October 2009
81KernelVersion: 2.6.33
82Contact: netdev@vger.kernel.org
83Description:
84 Indicates the interface latest or current duplex value. Possible
85 values are:
86 half: half duplex
87 full: full duplex
88
89 Note: This attribute is only valid for interfaces that implement
90 the ethtool get_settings method (mostly Ethernet).
91
92What: /sys/class/net/<iface>/flags
93Date: April 2005
94KernelVersion: 2.6.12
95Contact: netdev@vger.kernel.org
96Description:
97 Indicates the interface flags as a bitmask in hexadecimal. See
98 include/uapi/linux/if.h for a list of all possible values and
99 the flags semantics.
100
101What: /sys/class/net/<iface>/ifalias
102Date: September 2008
103KernelVersion: 2.6.28
104Contact: netdev@vger.kernel.org
105Description:
106 Indicates/stores an interface alias name as a string. This can
107 be used for system management purposes.
108
109What: /sys/class/net/<iface>/ifindex
110Date: April 2005
111KernelVersion: 2.6.12
112Contact: netdev@vger.kernel.org
113Description:
114 Indicates the system-wide interface unique index identifier as a
115 decimal number. This attribute is used for mapping an interface
116 identifier to an interface name. It is used throughout the
117 networking stack for specifying the interface specific
118 requests/events.
119
120What: /sys/class/net/<iface>/iflink
121Date: April 2005
122KernelVersion: 2.6.12
123Contact: netdev@vger.kernel.org
124Description:
125 Indicates the system-wide interface unique index identifier a
126 the interface is linked to. Format is decimal. This attribute is
127 used to resolve interfaces chaining, linking and stacking.
128 Physical interfaces have the same 'ifindex' and 'iflink' values.
129
130What: /sys/class/net/<iface>/link_mode
131Date: March 2006
132KernelVersion: 2.6.17
133Contact: netdev@vger.kernel.org
134Description:
135 Indicates the interface link mode, as a decimal number. This
136 attribute should be used in conjunction with 'dormant' attribute
137 to determine the interface usability. Possible values:
138 0: default link mode
139 1: dormant link mode
140
141What: /sys/class/net/<iface>/mtu
142Date: April 2005
143KernelVersion: 2.6.12
144Contact: netdev@vger.kernel.org
145Description:
146 Indicates the interface currently configured MTU value, in
147 bytes, and in decimal format. Specific values depends on the
148 lower-level interface protocol used. Ethernet devices will show
149 a 'mtu' attribute value of 1500 unless changed.
150
151What: /sys/calss/net/<iface>/netdev_group
152Date: January 2011
153KernelVersion: 2.6.39
154Contact: netdev@vger.kernel.org
155Description:
156 Indicates the interface network device group, as a decimal
157 integer. Default value is 0 which corresponds to the initial
158 network devices group. The group can be changed to affect
159 routing decisions (see: net/ipv4/fib_rules and
160 net/ipv6/fib6_rules.c).
161
162What: /sys/class/net/<iface>/operstate
163Date: March 2006
164KernelVersion: 2.6.17
165Contact: netdev@vger.kernel.org
166Description:
167 Indicates the interface RFC2863 operational state as a string.
168 Possible values are:
169 "unknown", "notpresent", "down", "lowerlayerdown", "testing",
170 "dormant", "up".
171
172What: /sys/class/net/<iface>/speed
173Date: October 2009
174KernelVersion: 2.6.33
175Contact: netdev@vger.kernel.org
176Description:
177 Indicates the interface latest or current speed value. Value is
178 an integer representing the link speed in Mbits/sec.
179
180 Note: this attribute is only valid for interfaces that implement
181 the ethtool get_settings method (mostly Ethernet ).
182
183What: /sys/class/net/<iface>/tx_queue_len
184Date: April 2005
185KernelVersion: 2.6.12
186Contact: netdev@vger.kernel.org
187Description:
188 Indicates the interface transmit queue len in number of packets,
189 as an integer value. Value depend on the type of interface,
190 Ethernet network adapters have a default value of 1000 unless
191 configured otherwise
192
193What: /sys/class/net/<iface>/type
194Date: April 2005
195KernelVersion: 2.6.12
196Contact: netdev@vger.kernel.org
197Description:
198 Indicates the interface protocol type as a decimal value. See
199 include/uapi/linux/if_arp.h for all possible values.
diff --git a/Documentation/ABI/testing/sysfs-class-net-mesh b/Documentation/ABI/testing/sysfs-class-net-mesh
index 4793d3dff6af..c46406296631 100644
--- a/Documentation/ABI/testing/sysfs-class-net-mesh
+++ b/Documentation/ABI/testing/sysfs-class-net-mesh
@@ -76,6 +76,15 @@ Description:
76 is used to classify clients as "isolated" by the 76 is used to classify clients as "isolated" by the
77 Extended Isolation feature. 77 Extended Isolation feature.
78 78
79What: /sys/class/net/<mesh_iface>/mesh/multicast_mode
80Date: Feb 2014
81Contact: Linus Lüssing <linus.luessing@web.de>
82Description:
83 Indicates whether multicast optimizations are enabled
84 or disabled. If set to zero then all nodes in the
85 mesh are going to use classic flooding for any
86 multicast packet with no optimizations.
87
79What: /sys/class/net/<mesh_iface>/mesh/network_coding 88What: /sys/class/net/<mesh_iface>/mesh/network_coding
80Date: Nov 2012 89Date: Nov 2012
81Contact: Martin Hundeboll <martin@hundeboll.net> 90Contact: Martin Hundeboll <martin@hundeboll.net>
diff --git a/Documentation/ABI/testing/sysfs-ptp b/Documentation/ABI/testing/sysfs-ptp
index 05aeedf17794..44806a678f12 100644
--- a/Documentation/ABI/testing/sysfs-ptp
+++ b/Documentation/ABI/testing/sysfs-ptp
@@ -54,6 +54,26 @@ Description:
54 This file contains the number of programmable periodic 54 This file contains the number of programmable periodic
55 output channels offered by the PTP hardware clock. 55 output channels offered by the PTP hardware clock.
56 56
57What: /sys/class/ptp/ptpN/n_pins
58Date: March 2014
59Contact: Richard Cochran <richardcochran@gmail.com>
60Description:
61 This file contains the number of programmable pins
62 offered by the PTP hardware clock.
63
64What: /sys/class/ptp/ptpN/pins
65Date: March 2014
66Contact: Richard Cochran <richardcochran@gmail.com>
67Description:
68 This directory contains one file for each programmable
69 pin offered by the PTP hardware clock. The file name
70 is the hardware dependent pin name. Reading from this
71 file produces two numbers, the assigned function (see
72 the PTP_PF_ enumeration values in linux/ptp_clock.h)
73 and the channel number. The function and channel
74 assignment may be changed by two writing numbers into
75 the file.
76
57What: /sys/class/ptp/ptpN/pps_avaiable 77What: /sys/class/ptp/ptpN/pps_avaiable
58Date: September 2010 78Date: September 2010
59Contact: Richard Cochran <richardcochran@gmail.com> 79Contact: Richard Cochran <richardcochran@gmail.com>