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

Linux 6.18.37 · ABI / testing

Device Mapper block device sysfs ABI

Device Mapper device의 mapped name·DM-UUID·suspend state, request-based sequential I/O merge deadline과 blk-mq I/O path mode를 설명합니다.

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

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

1. 요약·해설

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

Mapped device name과 UUID

sysfs-block-dm:1-16

Read-only name과 uuid는 util-linux와 device-mapper udev rules가 mapped device identity를 확인하는 ABI이며, DM-UUID가 없으면 uuid는 empty string입니다.

Device suspend state

sysfs-block-dm:18-25

suspended는 device가 suspend된 동안 1, 그 밖에는 0을 제공하는 read-only state입니다.

Request merge candidate deadline

sysfs-block-dm:27-39

rq_based_seq_io_merge_deadline은 request-based DM merge candidate가 queue에 머무를 수 있는 시간을 1–100000µs로 제어하며, 0은 heuristic과 extra accounting을 disable합니다.

Request-based blk-mq I/O path

sysfs-block-dm:41-47

use_blk_mq는 request-based Device Mapper device가 blk-mq I/O path를 사용하면 1, 아니면 0을 보고합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 What: /sys/block/dm-<num>/dm/name
2 Date: January 2009
3 KernelVersion: 2.6.29
4 Contact: dm-devel@redhat.com
5 Description: Device-mapper device name.
6 Read-only string containing mapped device name.
7 Users: util-linux, device-mapper udev rules
8
9 What: /sys/block/dm-<num>/dm/uuid
10 Date: January 2009
11 KernelVersion: 2.6.29
12 Contact: dm-devel@redhat.com
13 Description: Device-mapper device UUID.
14 Read-only string containing DM-UUID or empty string
15 if DM-UUID is not set.
16 Users: util-linux, device-mapper udev rules
17
18 What: /sys/block/dm-<num>/dm/suspended
19 Date: June 2009
20 KernelVersion: 2.6.31
21 Contact: dm-devel@redhat.com
22 Description: Device-mapper device suspend state.
23 Contains the value 1 while the device is suspended.
24 Otherwise it contains 0. Read-only attribute.
25 Users: util-linux, device-mapper udev rules
26
27 What: /sys/block/dm-<num>/dm/rq_based_seq_io_merge_deadline
28 Date: March 2015
29 KernelVersion: 4.1
30 Contact: dm-devel@redhat.com
31 Description: Allow control over how long a request that is a
32 reasonable merge candidate can be queued on the request
33 queue. The resolution of this deadline is in
34 microseconds (ranging from 1 to 100000 usecs).
35 Setting this attribute to 0 (the default) will disable
36 request-based DM's merge heuristic and associated extra
37 accounting. This attribute is not applicable to
38 bio-based DM devices so it will only ever report 0 for
39 them.
40
41 What: /sys/block/dm-<num>/dm/use_blk_mq
42 Date: March 2015
43 KernelVersion: 4.1
44 Contact: dm-devel@redhat.com
45 Description: Request-based Device-mapper blk-mq I/O path mode.
46 Contains the value 1 if the device is using blk-mq.
47 Otherwise it contains 0. Read-only attribute.
48

3. 한국어 전문 번역

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

Device Mapper name과 DM-UUID

1-16
WhatDateKernelVersionContactDescription 전문 번역Users
/sys/block/dm-<num>/dm/name2009년 1월2.6.29dm-devel@redhat.comDevice-mapper device name입니다. Mapped device name을 담은 read-only string입니다.util-linux, device-mapper udev rules
/sys/block/dm-<num>/dm/uuid2009년 1월2.6.29dm-devel@redhat.comDevice-mapper device UUID입니다. DM-UUID를 담은 read-only string이며, DM-UUID를 설정하지 않았다면 empty string입니다.util-linux, device-mapper udev rules

Device Mapper suspend state

18-25
항목전문 번역
What/sys/block/dm-<num>/dm/suspended
Date2009년 6월
KernelVersion2.6.31
Contactdm-devel@redhat.com
DescriptionDevice-mapper device의 suspend state입니다. Device가 suspended인 동안 값 1을 담습니다. 그 밖의 경우에는 0을 담습니다. Read-only attribute입니다.
Usersutil-linux, device-mapper udev rules
값의미
0Device가 suspended 상태가 아님
1Device가 suspended 상태임

Request-based sequential I/O merge deadline

27-39
항목전문 번역
What/sys/block/dm-<num>/dm/rq_based_seq_io_merge_deadline
Date2015년 3월
KernelVersion4.1
Contactdm-devel@redhat.com
Description합리적인 merge candidate인 request가 request queue에 얼마나 오래 queued될 수 있는지 제어합니다. 이 deadline의 resolution은 microseconds이고 범위는 1부터 100000usecs입니다. 이 attribute를 0으로 설정하면(default) request-based DM의 merge heuristic과 그에 연관된 extra accounting을 disable합니다. 이 attribute는 bio-based DM device에는 적용되지 않으므로 그런 device에서는 항상 0만 보고합니다.
값Request-based DMBio-based DM
0Merge heuristic과 extra accounting disable(default)항상 0을 보고함
1..100000µsMerge candidate queue deadline적용되지 않음

Request-based Device Mapper blk-mq mode

41-47
항목전문 번역
What/sys/block/dm-<num>/dm/use_blk_mq
Date2015년 3월
KernelVersion4.1
Contactdm-devel@redhat.com
DescriptionRequest-based Device-mapper의 blk-mq I/O path mode입니다. Device가 blk-mq를 사용하면 값 1을 담고, 그렇지 않으면 0을 담습니다. Read-only attribute입니다.
Device Mapper I/O mode별 sysfs 의미
Request-based DMrq_based_seq_io_merge_deadline0 disables merge heuristic1..100000 usecs queues merge candidates
Request-based DMuse_blk_mq1 for blk-mq or 0 otherwise
Bio-based DMMerge deadline not applicableAlways reports 0

Request-based와 bio-based DM device에서 merge deadline과 blk-mq state의 적용 범위를 구분한다.