요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Dump metadata, payload와 acknowledge
sysfs-firmware-opal-dump:25-46각 instance의 id·type과 binary dump를 읽고 회수 완료 뒤 acknowledge하여 firmware resource를 제거합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
What: /sys/firmware/opal/dump
Date: Feb 2014
Contact: Stewart Smith <[email protected]>
Description:
This directory exposes interfaces for interacting with
the FSP and platform dumps through OPAL firmware interface.
This is only for the powerpc/powernv platform.
=============== ===============================================
initiate_dump: When '1' is written to it,
we will initiate a dump.
Read this file for supported commands.
0xXX-0xYYYY: A directory for dump of type 0xXX and
id 0xYYYY (in hex). The name of this
directory should not be relied upon to
be in this format, only that it's unique
among all dumps. For determining the type
and ID of the dump, use the id and type files.
Do not rely on any particular size of dump
type or dump id.
=============== ===============================================
Each dump has the following files:
=============== ===============================================
id: An ASCII representation of the dump ID
in hex (e.g. '0x01')
type: An ASCII representation of the type of
dump in the format "0x%x %s" with the ID
in hex and a description of the dump type
(or 'unknown').
Type '0xffffffff unknown' is used when
we could not get the type from firmware.
e.g. '0x02 System/Platform Dump'
dump: A binary file containing the dump.
The size of the dump is the size of this file.
acknowledge: When 'ack' is written to this, we will
acknowledge that we've retrieved the
dump to the service processor. It will
then remove it, making the dump
inaccessible.
Reading this file will get a list of
supported actions.
=============== ===============================================
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
OPAL dump interface의 범위
1-9| 항목 | 내용 |
|---|---|
| What | /sys/firmware/opal/dump |
| Date | 2014년 2월 |
| Contact | Stewart Smith <[email protected]> |
| Platform | powerpc/powernv 전용 |
이 directory는 OPAL firmware interface를 통해 FSP dump와 platform dump를 다루는 interface를 노출한다.
Dump 시작과 고유 instance directory
10-24| Entry | 동작과 제약 |
|---|---|
| initiate_dump | 1을 쓰면 dump를 시작한다. 읽으면 지원되는 command 목록을 반환한다. |
| 0xXX-0xYYYY | Type 0xXX, ID 0xYYYY인 dump를 나타내는 directory 이름의 예다. 이름은 모든 dump 사이에서 고유하다는 사실만 보장되며 이 형식 자체에 의존하면 안 된다. |
Dump type과 ID는 directory name을 parse하지 말고 각각 type과 id 파일에서 읽어야 한다. Dump type이나 dump ID가 특정 bit width 또는 문자열 길이를 가진다고 가정해서도 안 된다.
Dump instance의 metadata와 binary payload
25-38| 파일 | 형식과 의미 |
|---|---|
| id | Dump ID의 hexadecimal ASCII 표현이다. 예: 0x01. |
| type | 0x%x %s 형식의 ASCII 문자열이다. Hexadecimal type ID와 dump-type description 또는 unknown을 함께 표시한다. Firmware에서 type을 얻지 못하면 0xffffffff unknown을 사용한다. 예: 0x02 System/Platform Dump. |
| dump | 실제 dump를 담은 binary file이다. Dump 크기는 이 파일의 size와 같다. |
회수 완료 acknowledge와 resource 제거
39-46acknowledge 파일에 ack를 쓰면 dump를 회수했다는 사실을 service processor에 알린다. Service processor는 그 dump를 제거하고 이후에는 접근할 수 없게 만든다. 이 파일을 읽으면 지원되는 action 목록을 얻는다.
Binary payload를 안전하게 저장하기 전에 acknowledge하면 원본 dump가 제거되므로 순서를 지켜야 한다.
Dump initiation과 instance discovery
sysfs-firmware-opal-dump:1-24Dump를 시작하고 고유 directory로 생성된 dump instance를 찾되 directory name의 형식이나 숫자 크기에 의존하지 않습니다.