← Documents Documentation/ABI/testing/sysfs-class-net-phydev GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

MDIO PHY device sysfs ABI

MDIO PHY의 attached network device, fixup 여부, C22·C45 identifier, interface mode, standalone 상태와 internal driver flags를 설명합니다.

Source pathDocumentation/ABI/testing/sysfs-class-net-phydev
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

Attachment and fixups

sysfs-class-net-phydev:1-17

PHY가 연결된 network device symbolic link와 configuration troubleshooting용 fixup boolean을 제공합니다.

C22 and C45 PHY identifiers

sysfs-class-net-phydev:19-37

Bus enumeration에서 보고된 32-bit hexadecimal PHY ID와 C45 MMD별 device ID를 driver matching에 사용합니다.

PHY interface mode

sysfs-class-net-phydev:39-54

Ethernet driver가 구성한 PHY data-line interface mode와 원문이 열거한 가능한 문자열을 제공합니다.

Standalone mode and driver flags

sysfs-class-net-phydev:56-75

PHYLINK standalone 상태와 kernel 내부용 consumer-to-driver configuration flag bitmask를 구분합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 What: /sys/class/mdio_bus/<bus>/<device>/attached_dev
2 Date: May 2017
3 KernelVersion: 4.13
4 Contact: netdev@vger.kernel.org
5 Description:
6 Symbolic link to the network device this PHY device is
7 attached to.
8
9 What: /sys/class/mdio_bus/<bus>/<device>/phy_has_fixups
10 Date: February 2014
11 KernelVersion: 3.15
12 Contact: netdev@vger.kernel.org
13 Description:
14 This attribute contains the boolean value whether a given PHY
15 device has had any "fixup" workaround running on it, encoded as
16 a boolean. This information is provided to help troubleshooting
17 PHY configurations.
18
19 What: /sys/class/mdio_bus/<bus>/<device>/phy_id
20 Date: November 2012
21 KernelVersion: 3.8
22 Contact: netdev@vger.kernel.org
23 Description:
24 This attribute contains the 32-bit PHY Identifier as reported
25 by the device during bus enumeration, encoded in hexadecimal.
26 This ID is used to match the device with the appropriate
27 driver.
28
29 What: /sys/class/mdio_bus/<bus>/<device>/c45_phy_ids/mmd<n>_device_id
30 Date: June 2025
31 KernelVersion: 6.17
32 Contact: netdev@vger.kernel.org
33 Description:
34 This attribute contains the 32-bit PHY Identifier as reported
35 by the device during bus enumeration, encoded in hexadecimal.
36 These C45 IDs are used to match the device with the appropriate
37 driver. These files are invisible to the C22 device.
38
39 What: /sys/class/mdio_bus/<bus>/<device>/phy_interface
40 Date: February 2014
41 KernelVersion: 3.15
42 Contact: netdev@vger.kernel.org
43 Description:
44 This attribute contains the PHY interface as configured by the
45 Ethernet driver during bus enumeration, encoded in string.
46 This interface mode is used to configure the Ethernet MAC with the
47 appropriate mode for its data lines to the PHY hardware.
48
49 Possible values are:
50
51 <empty> (not available), mii, gmii, sgmii, tbi, rev-mii,
52 rmii, rgmii, rgmii-id, rgmii-rxid, rgmii-txid, rtbi, smii
53 xgmii, moca, qsgmii, trgmii, 1000base-x, 2500base-x, rxaui,
54 xaui, 10gbase-kr, unknown
55
56 What: /sys/class/mdio_bus/<bus>/<device>/phy_standalone
57 Date: May 2019
58 KernelVersion: 5.3
59 Contact: netdev@vger.kernel.org
60 Description:
61 Boolean value indicating whether the PHY device is used in
62 standalone mode, without a net_device associated, by PHYLINK.
63 Attribute created only when this is the case.
64
65 What: /sys/class/mdio_bus/<bus>/<device>/phy_dev_flags
66 Date: March 2021
67 KernelVersion: 5.13
68 Contact: netdev@vger.kernel.org
69 Description:
70 32-bit hexadecimal number representing a bit mask of the
71 configuration bits passed from the consumer of the PHY
72 (Ethernet MAC, switch, etc.) to the PHY driver. The flags are
73 only used internally by the kernel and their placement are
74 not meant to be stable across kernel versions. This is intended
75 for facilitating the debugging of PHY drivers.
76

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

Attached network device

1-7
항목한국어 전문 번역
What/sys/class/mdio_bus/<bus>/<device>/attached_dev
Date2017년 5월
KernelVersion4.13
Contactnetdev@vger.kernel.org
Description이 PHY device가 연결된 network device를 가리키는 symbolic link입니다.

PHY fixup workaround state

9-17
항목한국어 전문 번역
What/sys/class/mdio_bus/<bus>/<device>/phy_has_fixups
Date2014년 2월
KernelVersion3.15
Contactnetdev@vger.kernel.org
Description주어진 PHY device에서 "fixup" workaround가 실행된 적이 있는지를 boolean 값으로 담습니다. PHY configuration troubleshooting을 돕기 위해 제공하는 정보입니다.

Clause 22 PHY identifier

19-27
항목한국어 전문 번역
What/sys/class/mdio_bus/<bus>/<device>/phy_id
Date2012년 11월
KernelVersion3.8
Contactnetdev@vger.kernel.org
DescriptionBus enumeration 중 device가 보고한 32-bit PHY Identifier를 hexadecimal로 담습니다. 이 ID는 device를 적절한 driver와 match하는 데 사용합니다.

Clause 45 MMD device identifiers

29-37
항목한국어 전문 번역
What/sys/class/mdio_bus/<bus>/<device>/c45_phy_ids/mmd<n>_device_id
Date2025년 6월
KernelVersion6.17
Contactnetdev@vger.kernel.org
DescriptionBus enumeration 중 device가 보고한 32-bit PHY Identifier를 hexadecimal로 담습니다. 이 C45 ID는 device를 적절한 driver와 match하는 데 사용합니다. 이 file들은 C22 device에는 보이지 않습니다.
PHY identifier attributes
속성범위형식Visibility
phy_idPHY device32-bit hexadecimalC22 device
c45_phy_ids/mmd<n>_device_id각 MMD32-bit hexadecimalC22 device에는 invisible

Clause 22의 단일 PHY ID와 Clause 45의 MMD별 device ID를 비교합니다.

Configured PHY interface mode

39-54
항목한국어 전문 번역
What/sys/class/mdio_bus/<bus>/<device>/phy_interface
Date2014년 2월
KernelVersion3.15
Contactnetdev@vger.kernel.org
DescriptionBus enumeration 중 Ethernet driver가 구성한 PHY interface를 문자열로 담습니다. Ethernet MAC이 PHY hardware로 이어지는 data line에 적절한 mode를 사용하도록 구성할 때 이 interface mode를 사용합니다. 가능한 값은 <empty>(사용 불가), mii, gmii, sgmii, tbi, rev-mii, rmii, rgmii, rgmii-id, rgmii-rxid, rgmii-txid, rtbi, smii, xgmii, moca, qsgmii, trgmii, 1000base-x, 2500base-x, rxaui, xaui, 10gbase-kr, unknown입니다.
PHY interface mode strings
계열가능한 문자열
Unavailable<empty>
MII variantsmii, gmii, rev-mii, rmii, smii
RGMII variantsrgmii, rgmii-id, rgmii-rxid, rgmii-txid
Serial and reducedsgmii, tbi, rtbi, qsgmii, trgmii
High speedxgmii, 1000base-x, 2500base-x, rxaui, xaui, 10gbase-kr
Othermoca, unknown

원문에 열거된 sysfs 문자열을 계열별로 정리합니다.

PHYLINK standalone mode

56-63
항목한국어 전문 번역
What/sys/class/mdio_bus/<bus>/<device>/phy_standalone
Date2019년 5월
KernelVersion5.3
Contactnetdev@vger.kernel.org
DescriptionPHYLINK가 net_device 연결 없이 PHY device를 standalone mode로 사용하는지를 나타내는 boolean 값입니다. 이 속성은 그러한 경우에만 생성됩니다.

PHY consumer configuration flags

65-75
항목한국어 전문 번역
What/sys/class/mdio_bus/<bus>/<device>/phy_dev_flags
Date2021년 3월
KernelVersion5.13
Contactnetdev@vger.kernel.org
DescriptionPHY consumer(Ethernet MAC, switch 등)가 PHY driver에 전달한 configuration bit를 나타내는 32-bit hexadecimal bitmask입니다. 이 flag는 kernel 내부에서만 사용하며 bit 배치는 kernel version 사이에서 stable하도록 의도하지 않았습니다. PHY driver debugging을 쉽게 하려는 속성입니다.
PHY consumer flags
PHY consumer: Ethernet MAC, switch, etc.32-bit configuration bitmask 전달PHY driver가 kernel 내부에서 사용Bit placement는 kernel version 사이에서 stable하지 않음

Consumer가 전달한 internal configuration bitmask의 범위와 안정성입니다.