요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
===========================
2
Documentation for /proc/sys
3
===========================
5
Copyright (c) 1998, 1999, Rik van Riel <[email protected]>
7
------------------------------------------------------------------------------
9
'Why', I hear you ask, 'would anyone even _want_ documentation
10
for them sysctl files? If anybody really needs it, it's all in
11
the source...'
13
Well, this documentation is written because some people either
14
don't know they need to tweak something, or because they don't
15
have the time or knowledge to read the source code.
17
Furthermore, the programmers who built sysctl have built it to
18
be actually used, not just for the fun of programming it :-)
20
------------------------------------------------------------------------------
22
Legal blurb:
24
As usual, there are two main things to consider:
26
1. you get what you pay for
27
2. it's free
29
The consequences are that I won't guarantee the correctness of
30
this document, and if you come to me complaining about how you
31
screwed up your system because of wrong documentation, I won't
32
feel sorry for you. I might even laugh at you...
34
But of course, if you _do_ manage to screw up your system using
35
only the sysctl options used in this file, I'd like to hear of
36
it. Not only to have a great laugh, but also to make sure that
37
you're the last RTFMing person to screw up.
39
In short, e-mail your suggestions, corrections and / or horror
40
stories to: <[email protected]>
42
Rik van Riel.
44
--------------------------------------------------------------
46
Introduction
47
============
49
Sysctl is a means of configuring certain aspects of the kernel
50
at run-time, and the /proc/sys/ directory is there so that you
51
don't even need special tools to do it!
52
In fact, there are only four things needed to use these config
53
facilities:
55
- a running Linux system
56
- root access
57
- common sense (this is especially hard to come by these days)
58
- knowledge of what all those values mean
60
As a quick 'ls /proc/sys' will show, the directory consists of
61
several (arch-dependent?) subdirs. Each subdir is mainly about
62
one part of the kernel, so you can do configuration on a piece
63
by piece basis, or just some 'thematic frobbing'.
65
This documentation is about:
67
=============== ===============================================================
68
abi/ execution domains & personalities
69
<$ARCH> tuning controls for various CPU architecture (e.g. csky, s390)
70
crypto/ <undocumented>
71
debug/ <undocumented>
72
dev/ device specific information (e.g. dev/cdrom/info)
73
fs/ specific filesystems
74
filehandle, inode, dentry and quota tuning
75
binfmt_misc <Documentation/admin-guide/binfmt-misc.rst>
76
kernel/ global kernel info / tuning
77
miscellaneous stuff
78
some architecture-specific controls
79
security (LSM) stuff
80
net/ networking stuff, for documentation look in:
81
<Documentation/networking/>
82
proc/ <empty>
83
sunrpc/ SUN Remote Procedure Call (NFS)
84
user/ Per user namespace limits
85
vm/ memory management tuning
86
buffer and cache management
87
xen/ <undocumented>
88
=============== ===============================================================
90
These are the subdirs I have on my system or have been discovered by
91
searching through the source code. There might be more or other subdirs
92
in another setup. If you see another dir, I'd really like to hear about
93
it :-)
95
.. toctree::
96
:maxdepth: 1
98
abi
99
fs
100
kernel
101
net
102
sunrpc
103
user
104
vm
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
문서가 필요한 이유
1-20이 문서는 Rik van Riel이 작성한 `/proc/sys` 설명서입니다. 모든 내용이 소스에 있더라도 어떤 값을 조정해야 하는지 모르는 사용자와 소스를 읽을 시간이나 지식이 없는 사용자를 위해 작성되었습니다. sysctl은 실제로 사용하라고 만든 기능입니다.
법적·운영 주의 사항
21-44문서는 무료로 제공되며 정확성을 보증하지 않습니다. 잘못 이해해 시스템을 망가뜨린 책임은 사용자에게 있습니다. 다만 이 문서에 나온 sysctl만으로 문제가 생겼다면 다음 사용자가 같은 일을 겪지 않도록 제안·수정·실패 사례를 `<[email protected]>`로 보내 달라고 요청합니다.
sysctl 소개
45-64sysctl은 실행 중 커널의 특정 측면을 설정하는 수단입니다. `/proc/sys/`를 통해 별도 도구 없이 값을 다룰 수 있습니다.
필요한 것은 실행 중인 Linux 시스템, root 접근 권한, 상식, 각 값의 의미에 대한 지식입니다. `ls /proc/sys`로 보면 여러 아키텍처 의존 하위 디렉터리가 있고, 각 디렉터리가 대체로 커널의 한 영역을 맡으므로 부분별 또는 주제별로 조정할 수 있습니다.
하위 디렉터리
65-94| 디렉터리 | 담당 영역 |
|---|---|
| `abi/` | 실행 도메인과 personality |
| `<$ARCH>` | csky, s390 등 CPU 아키텍처별 조정 제어 |
| `crypto/` | 문서화되지 않음 |
| `debug/` | 문서화되지 않음 |
| `dev/` | `dev/cdrom/info` 같은 장치별 정보 |
| `fs/` | 파일 시스템, file handle·inode·dentry·quota 및 `binfmt_misc` 조정. 관련 문서는 `Documentation/admin-guide/binfmt-misc.rst` |
| `kernel/` | 전역 커널 정보·조정, 기타 기능, 일부 아키텍처 제어, 보안 LSM |
| `net/` | 네트워킹 설정. 문서는 `Documentation/networking/` 참조 |
| `proc/` | 비어 있음 |
| `sunrpc/` | SUN Remote Procedure Call(NFS) |
| `user/` | 사용자 네임스페이스별 한도 |
| `vm/` | 메모리, 버퍼, 캐시 관리 조정 |
| `xen/` | 문서화되지 않음 |
이 목록은 작성자의 시스템에서 본 항목과 소스 검색으로 발견한 항목입니다. 다른 구성에는 더 많거나 다른 디렉터리가 있을 수 있습니다.
문서 목차
95-104이 문서 모음은 `abi`, `fs`, `kernel`, `net`, `sunrpc`, `user`, `vm` 순서로 각 하위 디렉터리 설명서에 연결합니다. 목차 깊이는 1입니다.
요약과 해설
index.rst:1-104`/proc/sys`는 root가 실행 중 커널 정책과 한도를 직접 바꾸는 인터페이스입니다. 별도 도구가 필요 없다는 장점만큼 잘못된 값의 영향도 즉시 나타나므로 문서와 소스를 함께 확인해야 합니다.