요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/devices/system/memory/soft_offline_page
2
Date: Sep 2009
3
KernelVersion: 2.6.33
4
Contact: andi@firstfloor.org
5
Description:
6
Soft-offline the memory page containing the physical address
7
written into this file. Input is a hex number specifying the
8
physical address of the page. The kernel will then attempt
9
to soft-offline it, by moving the contents elsewhere or
10
dropping it if possible. The kernel will then be placed
11
on the bad page list and never be reused.
13
The offlining is done in kernel specific granularity.
14
Normally it's the base page size of the kernel, but
15
this might change.
17
The page must be still accessible, not poisoned. The
18
kernel will never kill anything for this, but rather
19
fail the offline. Return value is the size of the
20
number, or a error when the offlining failed. Reading
21
the file is not allowed.
23
What: /sys/devices/system/memory/hard_offline_page
24
Date: Sep 2009
25
KernelVersion: 2.6.33
26
Contact: andi@firstfloor.org
27
Description:
28
Hard-offline the memory page containing the physical
29
address written into this file. Input is a hex number
30
specifying the physical address of the page. The
31
kernel will then attempt to hard-offline the page, by
32
trying to drop the page or killing any owner or
33
triggering IO errors if needed. Note this may kill
34
any processes owning the page. The kernel will avoid
35
to access this page assuming it's poisoned by the
36
hardware.
38
The offlining is done in kernel specific granularity.
39
Normally it's the base page size of the kernel, but
40
this might change.
42
Return value is the size of the number, or a error when
43
the offlining failed.
44
Reading the file is not allowed.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Memory page offline sysfs ABI: soft offline page
1-22| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/system/memory/soft_offline_page |
| Date | 2009년 9월 |
| KernelVersion | 2.6.33 |
| Contact | andi@firstfloor.org |
| Description | `/sys/devices/system/memory/soft_offline_page`에 physical address를 hexadecimal number로 쓰면 그 address를 포함하는 memory page를 soft-offline합니다. Kernel은 contents를 다른 곳으로 옮기거나 가능하면 drop하고, page를 bad-page list에 넣어 다시 사용하지 않습니다. Offlining granularity는 kernel별로 정하며 보통 base page size지만 달라질 수 있습니다. Page는 여전히 accessible하고 poisoned되지 않은 상태여야 합니다. Kernel은 이 작업 때문에 process를 kill하지 않고 대신 offline을 실패시킵니다. Return value는 입력 number의 size이며 offlining 실패 시 error입니다. 이 file은 read할 수 없습니다. |
ModeRecovery actionMay kill ownerPage assumption
soft_offline_pageMove contents or drop pageNo; fail insteadAccessible and not poisoned
hard_offline_pageDrop page, kill owner or trigger I/O errorYesHardware-poisoned
두 write-only interfaces는 같은 physical-address 입력을 받지만 failure policy와 process 영향이 다릅니다.
Memory page offline sysfs ABI: hard offline page
23-44| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/system/memory/hard_offline_page |
| Date | 2009년 9월 |
| KernelVersion | 2.6.33 |
| Contact | andi@firstfloor.org |
| Description | `/sys/devices/system/memory/hard_offline_page`에 physical address를 hexadecimal number로 쓰면 그 address를 포함하는 memory page를 hard-offline합니다. Kernel은 page를 drop하려 하고, 필요하면 owner를 kill하거나 I/O errors를 발생시킵니다. 따라서 page를 소유한 processes가 종료될 수 있습니다. Kernel은 hardware가 page를 poison한 것으로 간주해 해당 page에 접근하지 않습니다. Offlining granularity는 kernel별로 정하며 보통 base page size지만 달라질 수 있습니다. Return value는 입력 number의 size이며 offlining 실패 시 error입니다. 이 file은 read할 수 없습니다. |
Soft와 hard page isolation
sysfs-memory-page-offline:1-44Soft offline은 process를 죽이지 않는 migration 중심 경로이고, hard offline은 poisoned page 격리를 위해 owner 종료나 I/O error까지 허용합니다.