← Documents Documentation/ABI/testing/sysfs-block-aoe GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

Ata over Ethernet block device sysfs ABI

AoE block device의 remote Ethernet address, 사용 중인 local network interfaces, I/O state와 command retry 상태, target firmware version, command별 payload size를 설명합니다.

Source pathDocumentation/ABI/testing/sysfs-block-aoe
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

Remote AoE device Ethernet address

sysfs-block-aoe:1-7

/sys/block/etherd*/mac은 remote Ata over Ethernet device의 Ethernet address를 read-only로 제공합니다.

Local network interfaces

sysfs-block-aoe:9-16

/sys/block/etherd*/netif는 remote AoE device와 통신하는 localhost network interface 이름을 comma-separated list로 제공합니다.

Device I/O와 retry state

sysfs-block-aoe:18-30

state는 I/O 가능 여부뿐 아니라 open reference 때문에 복구할 수 없는 closewait와 outstanding command limit 때문에 periodic timer kick을 기다리는 kickme 상태를 함께 보고합니다.

Target firmware version

sysfs-block-aoe:32-37

/sys/block/etherd*/firmware-version은 AoE target에 설치된 firmware version을 read-only로 보여 줍니다.

AoE command payload size

sysfs-block-aoe:39-45

payload는 network header를 제외하고 각 AoE command 안에서 전송되는 user data의 byte 수입니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 What: /sys/block/etherd*/mac
2 Date: Apr, 2005
3 KernelVersion: v2.6.12
4 Contact: Ed L. Cashin <ed.cashin@acm.org>
5 Description:
6 (RO) The ethernet address of the remote Ata over Ethernet (AoE)
7 device.
8
9 What: /sys/block/etherd*/netif
10 Date: Apr, 2005
11 KernelVersion: v2.6.12
12 Contact: Ed L. Cashin <ed.cashin@acm.org>
13 Description:
14 (RO) The names of the network interfaces on the localhost (comma
15 separated) through which we are communicating with the remote
16 AoE device.
17
18 What: /sys/block/etherd*/state
19 Date: Apr, 2005
20 KernelVersion: v2.6.12
21 Contact: Ed L. Cashin <ed.cashin@acm.org>
22 Description:
23 (RO) Device status. The state attribute is "up" when the device
24 is ready for I/O and "down" if detected but unusable. The
25 "down,closewait" state shows that the device is still open and
26 cannot come up again until it has been closed. The "up,kickme"
27 state means that the driver wants to send more commands to the
28 target but found out there were already the max number of
29 commands waiting for a response. It will retry again after being
30 kicked by the periodic timer handler routine.
31
32 What: /sys/block/etherd*/firmware-version
33 Date: Apr, 2005
34 KernelVersion: v2.6.12
35 Contact: Ed L. Cashin <ed.cashin@acm.org>
36 Description:
37 (RO) Version of the firmware in the target.
38
39 What: /sys/block/etherd*/payload
40 Date: Dec, 2012
41 KernelVersion: v3.10
42 Contact: Ed L. Cashin <ed.cashin@acm.org>
43 Description:
44 (RO) The amount of user data transferred (in bytes) inside each AoE
45 command on the network, network headers excluded.
46

3. 한국어 전문 번역

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

Remote AoE device의 Ethernet address

1-7
항목전문 번역
What/sys/block/etherd*/mac
Date2005년 4월
KernelVersionv2.6.12
ContactEd L. Cashin <ed.cashin@acm.org>
Description(RO) Remote Ata over Ethernet(AoE) device의 Ethernet address입니다.

AoE 통신에 사용하는 local network interfaces

9-16
항목전문 번역
What/sys/block/etherd*/netif
Date2005년 4월
KernelVersionv2.6.12
ContactEd L. Cashin <ed.cashin@acm.org>
Description(RO) Remote AoE device와 통신할 때 거치는 localhost의 network interface 이름입니다. 여러 이름은 comma로 구분합니다.

AoE device status와 command retry

18-30
항목전문 번역
What/sys/block/etherd*/state
Date2005년 4월
KernelVersionv2.6.12
ContactEd L. Cashin <ed.cashin@acm.org>
Description(RO) Device status입니다. Device가 I/O를 수행할 준비가 되었으면 state attribute는 "up"이고, 감지되었지만 사용할 수 없으면 "down"입니다. "down,closewait" state는 device가 아직 open되어 있어 close될 때까지 다시 up 상태가 될 수 없음을 나타냅니다. "up,kickme" state는 driver가 target에 command를 더 보내려 했지만 response를 기다리는 command 수가 이미 maximum에 도달했음을 알아냈다는 뜻입니다. Periodic timer handler routine이 driver를 kick한 뒤 다시 시도합니다.
State의미
upDevice가 I/O를 수행할 준비가 됨
downDevice를 감지했지만 사용할 수 없음
down,closewaitDevice가 아직 open되어 있으며 close되기 전에는 다시 up이 될 수 없음
up,kickmeResponse를 기다리는 command가 maximum에 도달해 periodic timer handler의 kick 뒤 전송을 재시도함

AoE target firmware version

32-37
항목전문 번역
What/sys/block/etherd*/firmware-version
Date2005년 4월
KernelVersionv2.6.12
ContactEd L. Cashin <ed.cashin@acm.org>
Description(RO) Target 안에 있는 firmware의 version입니다.

AoE command별 user payload

39-45
항목전문 번역
What/sys/block/etherd*/payload
Date2012년 12월
KernelVersionv3.10
ContactEd L. Cashin <ed.cashin@acm.org>
Description(RO) Network에서 각 AoE command 안에 전송되는 user data의 양을 byte 단위로 나타냅니다. Network header는 제외합니다.
AoE block device의 sysfs 관찰 지점
Local etherd block devicenetif: local interfacesEthernet networkmac: remote AoE target
Driver command queuestate: up or downOutstanding limitup,kickmePeriodic timer retry
AoE commandpayload bytesNetwork headers excluded
Remote targetfirmware-version

Local network interface를 통해 remote AoE target과 통신하며, sysfs attributes가 endpoint, runtime state와 command payload를 각각 노출한다.