Documentation/ABI/testing/debugfs-pfo-nx-crypto GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

PowerPC NX crypto debugfs ABI

PowerPC nx-crypto driver가 제공하는 H_COP_OP error count·last error·PID와 AES·SHA-256·SHA-512 hardware bytes·operation counters를 설명합니다.

Source pathDocumentation/ABI/testing/debugfs-pfo-nx-crypto
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.

1. 요약·해설

원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.

H_COP_OP error detection

debugfs-pfo-nx-crypto:1-23

errors는 driver load 이후 H_COP_OP hcall이 반환한 error 수를 세고, last_error와 last_error_pid는 최신 non-zero code와 이를 받은 process를 기록합니다. 재시도되는 -EBUSY는 기록하지 않습니다.

AES·SHA hardware usage counters

debugfs-pfo-nx-crypto:25-45

AES encryption과 SHA-256·SHA-512 hashing에 대해 hardware가 처리한 총 bytes와 제출된 operation 수를 각각 누적합니다.

2. 영어 원문 전체

번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.

원문 전체 펼치기
1 What: /sys/kernel/debug/nx-crypto/*
2 Date: March 2012
3 KernelVersion: 3.4
4 Contact: Kent Yoder <[email protected]>
5 Description:
6
7 These debugfs interfaces are built by the nx-crypto driver, built in
8 arch/powerpc/crypto/nx.
9
10 Error Detection
11 ===============
12
13 errors:
14 A u32 providing a total count of errors since the driver was loaded. The
15 only errors counted here are those returned from the hcall, H_COP_OP.
16
17 last_error:
18 The most recent non-zero return code from the H_COP_OP hcall. -EBUSY is not
19 recorded here (the hcall will retry until -EBUSY goes away).
20
21 last_error_pid:
22 The process ID of the process who received the most recent error from the
23 hcall.
24
25 Device Use
26 ==========
27
28 aes_bytes:
29 The total number of bytes encrypted using AES in any of the driver's
30 supported modes.
31
32 aes_ops:
33 The total number of AES operations submitted to the hardware.
34
35 sha256_bytes:
36 The total number of bytes hashed by the hardware using SHA-256.
37
38 sha256_ops:
39 The total number of SHA-256 operations submitted to the hardware.
40
41 sha512_bytes:
42 The total number of bytes hashed by the hardware using SHA-512.
43
44 sha512_ops:
45 The total number of SHA-512 operations submitted to the hardware.
46

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.

NX crypto error detection

1-23
항목내용
What/sys/kernel/debug/nx-crypto/*
Date2012년 3월
KernelVersion3.4
ContactKent Yoder <[email protected]>
Description이 debugfs interface들은 arch/powerpc/crypto/nx에 있는 nx-crypto driver가 만듭니다.
파일전문 번역
errorsDriver가 load된 뒤 발생한 error의 총수를 제공하는 u32입니다. 여기서 세는 error는 H_COP_OP hcall이 반환한 것뿐입니다.
last_errorH_COP_OP hcall이 가장 최근에 반환한 non-zero return code입니다. -EBUSY는 여기에 기록하지 않습니다. -EBUSY가 사라질 때까지 hcall이 재시도하기 때문입니다.
last_error_pidHcall에서 가장 최근 error를 받은 process의 process ID입니다.

NX crypto device 사용량

25-45
파일전문 번역
aes_bytesDriver가 지원하는 mode 중 어느 것이든 AES로 암호화한 총 byte 수입니다.
aes_opsHardware에 제출한 AES operation의 총수입니다.
sha256_bytesHardware가 SHA-256으로 hash한 총 byte 수입니다.
sha256_opsHardware에 제출한 SHA-256 operation의 총수입니다.
sha512_bytesHardware가 SHA-512로 hash한 총 byte 수입니다.
sha512_opsHardware에 제출한 SHA-512 operation의 총수입니다.
NX crypto operation과 debugfs 계수
AES requestNX crypto hardwareaes_bytes plus aes_ops
SHA-256 requestNX crypto hardwaresha256_bytes plus sha256_ops
SHA-512 requestNX crypto hardwaresha512_bytes plus sha512_ops
H_COP_OP nonzero return-EBUSY retries and is not recordedOther error updates errors, last_error, last_error_pid

Hardware operation은 algorithm별 bytes·ops에 누적되고 H_COP_OP failure는 별도 error state로 기록된다.