요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Memory reservation target과 통계
sysfs-devices-system-xen_memory:41-77Domain의 목표 reservation을 page 또는 KiB로 설정하고 현재 reservation 및 balloon의 high·low memory 양을 조회합니다.
반환 page scrubbing
sysfs-devices-system-xen_memory:79-86다른 domain이 재사용하기 전에 Xen으로 반환할 page를 지울지 제어합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/devices/system/xen_memory/xen_memory0/max_retry_count
2
Date: May 2011
3
KernelVersion: 2.6.39
4
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
5
Description:
6
The maximum number of times the balloon driver will
7
attempt to increase the balloon before giving up. See
8
also 'retry_count' below.
9
A value of zero means retry forever and is the default one.
11
What: /sys/devices/system/xen_memory/xen_memory0/max_schedule_delay
12
Date: May 2011
13
KernelVersion: 2.6.39
14
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
15
Description:
16
The limit that 'schedule_delay' (see below) will be
17
increased to. The default value is 32 seconds.
19
What: /sys/devices/system/xen_memory/xen_memory0/retry_count
20
Date: May 2011
21
KernelVersion: 2.6.39
22
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
23
Description:
24
The current number of times that the balloon driver
25
has attempted to increase the size of the balloon.
26
The default value is one. With max_retry_count being
27
zero (unlimited), this means that the driver will attempt
28
to retry with a 'schedule_delay' delay.
30
What: /sys/devices/system/xen_memory/xen_memory0/schedule_delay
31
Date: May 2011
32
KernelVersion: 2.6.39
33
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
34
Description:
35
The time (in seconds) to wait between attempts to
36
increase the balloon. Each time the balloon cannot be
37
increased, 'schedule_delay' is increased (until
38
'max_schedule_delay' is reached at which point it
39
will use the max value).
41
What: /sys/devices/system/xen_memory/xen_memory0/target
42
Date: April 2008
43
KernelVersion: 2.6.26
44
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
45
Description:
46
The target number of pages to adjust this domain's
47
memory reservation to.
49
What: /sys/devices/system/xen_memory/xen_memory0/target_kb
50
Date: April 2008
51
KernelVersion: 2.6.26
52
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
53
Description:
54
As target above, except the value is in KiB.
56
What: /sys/devices/system/xen_memory/xen_memory0/info/current_kb
57
Date: April 2008
58
KernelVersion: 2.6.26
59
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
60
Description:
61
Current size (in KiB) of this domain's memory
62
reservation.
64
What: /sys/devices/system/xen_memory/xen_memory0/info/high_kb
65
Date: April 2008
66
KernelVersion: 2.6.26
67
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
68
Description:
69
Amount (in KiB) of high memory in the balloon.
71
What: /sys/devices/system/xen_memory/xen_memory0/info/low_kb
72
Date: April 2008
73
KernelVersion: 2.6.26
74
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
75
Description:
76
Amount (in KiB) of low (or normal) memory in the
77
balloon.
79
What: /sys/devices/system/xen_memory/xen_memory0/scrub_pages
80
Date: September 2018
81
KernelVersion: 4.20
82
Contact: xen-devel@lists.xenproject.org
83
Description:
84
Control scrubbing pages before returning them to Xen for others domains
85
use. Can be set with xen_scrub_pages cmdline
86
parameter. Default value controlled with CONFIG_XEN_SCRUB_PAGES_DEFAULT.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Balloon 증가의 재시도 횟수와 backoff
1-39이 절의 네 ABI는 2011년 5월 kernel 2.6.39에 도입됐고 Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>가 담당한다.
| 경로 | 기본값 | 설명 |
|---|---|---|
| /sys/devices/system/xen_memory/xen_memory0/max_retry_count | 0 | Balloon driver가 포기하기 전에 balloon 크기 증가를 시도할 최대 횟수다. 0은 무한히 재시도한다는 뜻이며 기본값이다. 현재 횟수는 retry_count를 참조한다. |
| /sys/devices/system/xen_memory/xen_memory0/max_schedule_delay | 32초 | schedule_delay가 증가할 수 있는 상한이다. |
| /sys/devices/system/xen_memory/xen_memory0/retry_count | 1 | Balloon driver가 현재까지 balloon 크기 증가를 시도한 횟수다. max_retry_count가 0이면 driver는 schedule_delay만큼 기다린 뒤 계속 재시도한다. |
| /sys/devices/system/xen_memory/xen_memory0/schedule_delay | 원문에 별도 값 없음 | Balloon 증가 시도 사이에 기다릴 시간이며 단위는 초다. Balloon을 늘리지 못할 때마다 증가하고 max_schedule_delay에 도달하면 이후에는 그 최댓값을 사용한다. |
Balloon 크기 증가 시도→실패하면 retry_count 증가→max_retry_count가 0이거나 아직 상한 미만이면 재시도 유지→schedule_delay만큼 대기→delay를 증가시키되 max_schedule_delay에서 고정→다음 balloon 증가 시도
횟수 제한과 delay 상한은 서로 독립적으로 재시도 종료 여부와 대기 시간을 결정한다.
Domain memory reservation target
41-54| 경로 | 도입 | 설명 |
|---|---|---|
| /sys/devices/system/xen_memory/xen_memory0/target | 2008년 4월 · kernel 2.6.26 | 이 domain의 memory reservation을 조정할 목표 page 수다. |
| /sys/devices/system/xen_memory/xen_memory0/target_kb | 2008년 4월 · kernel 2.6.26 | target과 같은 목표를 나타내지만 값의 단위가 KiB다. |
두 항목의 담당자는 Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>다.
현재 reservation과 balloon memory 구성
56-77이 절의 세 ABI는 2008년 4월 kernel 2.6.26에 도입됐고 Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>가 담당한다. 값의 단위는 모두 KiB다.
| 경로 | 설명 |
|---|---|
| /sys/devices/system/xen_memory/xen_memory0/info/current_kb | 현재 이 domain에 예약된 memory의 크기다. |
| /sys/devices/system/xen_memory/xen_memory0/info/high_kb | Balloon에 포함된 high memory의 양이다. |
| /sys/devices/system/xen_memory/xen_memory0/info/low_kb | Balloon에 포함된 low memory 또는 normal memory의 양이다. |
Xen 반환 전 page scrubbing
79-86| 항목 | 내용 |
|---|---|
| What | /sys/devices/system/xen_memory/xen_memory0/scrub_pages |
| Date | 2018년 9월 |
| KernelVersion | 4.20 |
| Contact | xen-devel@lists.xenproject.org |
다른 domain이 사용할 수 있도록 page를 Xen에 반환하기 전에 해당 page를 scrub할지 제어한다. Kernel command line의 xen_scrub_pages parameter로도 설정할 수 있으며, 기본값은 CONFIG_XEN_SCRUB_PAGES_DEFAULT가 결정한다.
Balloon 증가 재시도
sysfs-devices-system-xen_memory:1-39재시도 횟수와 시도 간 delay, delay 상한을 통해 balloon 증가 실패 뒤의 반복 정책을 제어합니다.