요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Operation과 shared-memory slot timeout
sysfs-fs-orangefs:43-60Service operation과 kernel module–user-space 통신 slot을 기다리는 최대 시간을 초 단위로 설정합니다.
OrangeFS cache configuration
sysfs-fs-orangefs:62-87Attribute, name, capability와 credential cache별 configurable setting을 제공합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/fs/orangefs/perf_counters/*
2
Date: Jun 2015
3
Contact: Mike Marshall <hubcap@omnibond.com>
4
Description:
5
Counters and settings for various caches.
6
Read only.
9
What: /sys/fs/orangefs/perf_counter_reset
10
Date: June 2015
11
Contact: Mike Marshall <hubcap@omnibond.com>
12
Description:
13
echo a 0 or a 1 into perf_counter_reset to
14
reset all the counters in
15
/sys/fs/orangefs/perf_counters
16
except ones with PINT_PERF_PRESERVE set.
19
What: /sys/fs/orangefs/perf_time_interval_secs
20
Date: Jun 2015
21
Contact: Mike Marshall <hubcap@omnibond.com>
22
Description:
23
Length of perf counter intervals in
24
seconds.
27
What: /sys/fs/orangefs/perf_history_size
28
Date: Jun 2015
29
Contact: Mike Marshall <hubcap@omnibond.com>
30
Description:
31
The perf_counters cache statistics have N, or
32
perf_history_size, samples. The default is
33
one.
35
Every perf_time_interval_secs the (first)
36
samples are reset.
38
If N is greater than one, the "current" set
39
of samples is reset, and the samples from the
40
other N-1 intervals remain available.
43
What: /sys/fs/orangefs/op_timeout_secs
44
Date: Jun 2015
45
Contact: Mike Marshall <hubcap@omnibond.com>
46
Description:
47
Service operation timeout in seconds.
50
What: /sys/fs/orangefs/slot_timeout_secs
51
Date: Jun 2015
52
Contact: Mike Marshall <hubcap@omnibond.com>
53
Description:
54
"Slot" timeout in seconds. A "slot"
55
is an indexed buffer in the shared
56
memory segment used for communication
57
between the kernel module and userspace.
58
Slots are requested and waited for,
59
the wait times out after slot_timeout_secs.
62
What: /sys/fs/orangefs/acache/*
63
Date: Jun 2015
64
Contact: Mike Marshall <hubcap@omnibond.com>
65
Description:
66
Attribute cache configurable settings.
69
What: /sys/fs/orangefs/ncache/*
70
Date: Jun 2015
71
Contact: Mike Marshall <hubcap@omnibond.com>
72
Description:
73
Name cache configurable settings.
76
What: /sys/fs/orangefs/capcache/*
77
Date: Jun 2015
78
Contact: Mike Marshall <hubcap@omnibond.com>
79
Description:
80
Capability cache configurable settings.
83
What: /sys/fs/orangefs/ccache/*
84
Date: Jun 2015
85
Contact: Mike Marshall <hubcap@omnibond.com>
86
Description:
87
Credential cache configurable settings.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Cache performance counter와 reset
1-25이 문서의 모든 ABI는 2015년 6월에 도입됐고 Mike Marshall <hubcap@omnibond.com>이 담당한다.
| 경로 | 설명 |
|---|---|
| /sys/fs/orangefs/perf_counters/* | 여러 cache의 counter와 setting을 제공하는 read-only group이다. |
| /sys/fs/orangefs/perf_counter_reset | 0 또는 1을 쓰면 /sys/fs/orangefs/perf_counters의 모든 counter를 reset한다. 단, PINT_PERF_PRESERVE가 설정된 counter는 제외한다. |
| /sys/fs/orangefs/perf_time_interval_secs | Performance-counter interval 길이를 초 단위로 정한다. |
Performance sample history depth
27-41| 항목 | 내용 |
|---|---|
| What | /sys/fs/orangefs/perf_history_size |
| Default | 1 sample |
| Meaning | perf_counters cache statistic이 유지하는 sample 수 N |
매 perf_time_interval_secs마다 첫 번째 또는 현재 sample set을 reset한다. N이 1보다 크면 current sample set만 reset하고 다른 N-1 interval의 sample은 계속 조회할 수 있다.
Interval 경계Current sample이전 sample
01
t0Counter 누적 시작없음
02
t1새 current를 0으로 resett0 보존
03
t2다음 current를 0으로 resett1, t0 보존
04
N개 초과새 current 생성가장 오래된 sample 제거
Interval 경계마다 current bucket만 초기화되고 이전 N-1 bucket은 history로 남는다.
Service operation과 communication slot timeout
43-60| 경로 | 단위 | 설명 |
|---|---|---|
| /sys/fs/orangefs/op_timeout_secs | 초 | Service operation timeout이다. |
| /sys/fs/orangefs/slot_timeout_secs | 초 | Slot request를 기다리는 timeout이다. Slot은 kernel module과 user space가 통신할 때 사용하는 shared-memory segment 안의 indexed buffer다. Slot을 요청해 기다리다가 이 시간이 지나면 timeout된다. |
Kernel module이 communication slot 요청→Shared-memory segment의 indexed buffer 대기→Slot 확보 시 user-space service와 통신→slot_timeout_secs가 지나면 wait timeout
Kernel module과 user-space service 사이 요청은 indexed shared-memory slot을 확보해야 진행된다.
Cache별 configurable setting group
62-87| 경로 | 설정 대상 |
|---|---|
| /sys/fs/orangefs/acache/* | Attribute cache |
| /sys/fs/orangefs/ncache/* | Name cache |
| /sys/fs/orangefs/capcache/* | Capability cache |
| /sys/fs/orangefs/ccache/* | Credential cache |
이 ABI 문서는 각 group 안의 구체적인 파일 이름이나 값 범위를 추가로 정의하지 않고 configurable setting group이라는 범위만 명시한다.
Performance counter와 history window
sysfs-fs-orangefs:1-41Cache counter를 읽고 preserved 항목을 제외해 reset하며 interval 길이와 유지할 sample 수 N을 설정합니다.