← Documents Documentation/ABI/testing/sysfs-driver-xen-blkback GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

Xen block-backend module parameters

Xen blkback buffer pages, persistent grants, idle timeout, memory-pressure squeeze와 persistent-grant feature policy를 설명합니다.

Source pathDocumentation/ABI/testing/sysfs-driver-xen-blkback
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

Backend buffer and grant retention

sysfs-driver-xen-blkback:1-46

Persistent grant limit 초과는 주기적 LRU reclaim을 유발하고 idle timeout과 memory pressure가 cache retention을 제한합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 What: /sys/module/xen_blkback/parameters/max_buffer_pages
2 Date: March 2013
3 KernelVersion: 3.11
4 Contact: Roger Pau Monné <[email protected]>
5 Description:
6 Maximum number of free pages to keep in each block
7 backend buffer.
8
9 What: /sys/module/xen_blkback/parameters/max_persistent_grants
10 Date: March 2013
11 KernelVersion: 3.11
12 Contact: Roger Pau Monné <[email protected]>
13 Description:
14 Maximum number of grants to map persistently in
15 blkback. If the frontend tries to use more than
16 max_persistent_grants, the LRU kicks in and starts
17 removing 5% of max_persistent_grants every 100ms.
18
19 What: /sys/module/xen_blkback/parameters/persistent_grant_unused_seconds
20 Date: August 2018
21 KernelVersion: 4.19
22 Contact: Roger Pau Monné <[email protected]>
23 Description:
24 How long a persistent grant is allowed to remain
25 allocated without being in use. The time is in
26 seconds, 0 means indefinitely long.
27 The default is 60 seconds.
28
29 What: /sys/module/xen_blkback/parameters/buffer_squeeze_duration_ms
30 Date: December 2019
31 KernelVersion: 5.6
32 Contact: Maximilian Heyne <[email protected]>
33 Description:
34 When memory pressure is reported to blkback this option
35 controls the duration in milliseconds that blkback will not
36 cache any page not backed by a grant mapping.
37 The default is 10ms.
38
39 What: /sys/module/xen_blkback/parameters/feature_persistent
40 Date: September 2020
41 KernelVersion: 5.10
42 Contact: Maximilian Heyne <[email protected]>
43 Description:
44 Whether to enable the persistent grants feature or not. Note
45 that this option only takes effect on newly connected backends.
46 The default is Y (enable).
47

3. 한국어 전문 번역

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

Xen blkback maximum cached buffer pages

1-8
항목한국어 전문 번역
What/sys/module/xen_blkback/parameters/max_buffer_pages
Date2013년 3월
KernelVersion3.11
ContactRoger Pau Monné <[email protected]>
Description각 block backend buffer에 유지할 maximum free-page count입니다.

Xen blkback persistent-grant limit

9-18
항목한국어 전문 번역
What/sys/module/xen_blkback/parameters/max_persistent_grants
Date2013년 3월
KernelVersion3.11
ContactRoger Pau Monné <[email protected]>
DescriptionBlkback에서 persistently map할 maximum grant count입니다. Frontend가 `max_persistent_grants`보다 많이 사용하려 하면 LRU가 작동해 100ms마다 limit의 5%를 제거하기 시작합니다.
Persistent-grant LRU pressure
ConditionAction
Frontend exceeds max_persistent_grantsRemove 5% every 100ms

Limit 초과 시 reclaim cadence입니다.

Xen blkback unused persistent-grant timeout

19-28
항목한국어 전문 번역
What/sys/module/xen_blkback/parameters/persistent_grant_unused_seconds
Date2018년 8월
KernelVersion4.19
ContactRoger Pau Monné <[email protected]>
DescriptionPersistent grant가 사용되지 않은 채 allocated 상태로 남을 수 있는 시간을 seconds 단위로 설정합니다. 0은 indefinitely long이고 default는 60 seconds입니다.
UnitSeconds
Default60

Xen blkback buffer-squeeze duration

29-38
항목한국어 전문 번역
What/sys/module/xen_blkback/parameters/buffer_squeeze_duration_ms
Date2019년 12월
KernelVersion5.6
ContactMaximilian Heyne <[email protected]>
DescriptionBlkback에 memory pressure가 보고되었을 때 grant mapping으로 backed되지 않은 page를 cache하지 않을 기간을 milliseconds로 제어합니다. Default는 10ms입니다.
UnitMilliseconds
Default10

Xen blkback persistent-grant feature

39-46
항목한국어 전문 번역
What/sys/module/xen_blkback/parameters/feature_persistent
Date2020년 9월
KernelVersion5.10
ContactMaximilian Heyne <[email protected]>
DescriptionPersistent-grants feature를 enable할지 결정합니다. Newly connected backends에만 effect가 있고 default는 Y(enabled)입니다.
DefaultY (enabled)