draft/man7/capabilities.7

   1 .\" Copyright (c) 2002 by Michael Kerrisk <mtk.manpages@gmail.com>
   2 .\"
   3 .\" %%%LICENSE_START(VERBATIM)
   4 .\" Permission is granted to make and distribute verbatim copies of this
   5 .\" manual provided the copyright notice and this permission notice are
   6 .\" preserved on all copies.
   7 .\"
   8 .\" Permission is granted to copy and distribute modified versions of this
   9 .\" manual under the conditions for verbatim copying, provided that the
  10 .\" entire resulting derived work is distributed under the terms of a
  11 .\" permission notice identical to this one.
  12 .\"
  13 .\" Since the Linux kernel and libraries are constantly changing, this
  14 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  15 .\" responsibility for errors or omissions, or for damages resulting from
  16 .\" the use of the information contained herein.  The author(s) may not
  17 .\" have taken the same level of care in the production of this manual,
  18 .\" which is licensed free of charge, as they might when working
  19 .\" professionally.
  20 .\"
  21 .\" Formatted or processed versions of this manual, if unaccompanied by
  22 .\" the source, must acknowledge the copyright and authors of this work.
  23 .\" %%%LICENSE_END
  24 .\"
  25 .\" 6 Aug 2002 - Initial Creation
  26 .\" Modified 2003-05-23, Michael Kerrisk, <mtk.manpages@gmail.com>
  27 .\" Modified 2004-05-27, Michael Kerrisk, <mtk.manpages@gmail.com>
  28 .\" 2004-12-08, mtk Added O_NOATIME for CAP_FOWNER
  29 .\" 2005-08-16, mtk, Added CAP_AUDIT_CONTROL and CAP_AUDIT_WRITE
  30 .\" 2008-07-15, Serge Hallyn <serue@us.bbm.com>
  31 .\"     Document file capabilities, per-process capability
  32 .\"     bounding set, changed semantics for CAP_SETPCAP,
  33 .\"     and other changes in 2.6.2[45].
  34 .\"     Add CAP_MAC_ADMIN, CAP_MAC_OVERRIDE, CAP_SETFCAP.
  35 .\" 2008-07-15, mtk
  36 .\"     Add text describing circumstances in which CAP_SETPCAP
  37 .\"     (theoretically) permits a thread to change the
  38 .\"     capability sets of another thread.
  39 .\"     Add section describing rules for programmatically
  40 .\"     adjusting thread capability sets.
  41 .\"     Describe rationale for capability bounding set.
  42 .\"     Document "securebits" flags.
  43 .\"     Add text noting that if we set the effective flag for one file
  44 .\"     capability, then we must also set the effective flag for all
  45 .\"     other capabilities where the permitted or inheritable bit is set.
  46 .\" 2011-09-07, mtk/Serge hallyn: Add CAP_SYSLOG
  47 .\"
  48 .\"*******************************************************************
  49 .\"
  50 .\" This file was generated with po4a. Translate the source file.
  51 .\"
  52 .\"*******************************************************************
  53 .TH CAPABILITIES 7 2013\-07\-21 Linux "Linux Programmer's Manual"
  54 .SH 名前
  55 capabilities \- Linux のケーパビリティ (capability) の概要
  56 .SH 説明
  57 権限のチェックを行う観点から見ると、伝統的な UNIX の実装では プロセスは二つのカテゴリに分類できる: \fI特権\fP プロセス (実効ユーザID が
  58 0 のプロセス。ユーザID 0 は スーパーユーザや root と呼ばれる) と \fI非特権\fP プロセス (実効ユーザID が 0 以外のプロセス)
  59 である。 非特権プロセスでは、プロセスの資格情報 (通常は、実効UID 、実効GID と追加のグループリスト) に基づく権限チェックが行われるのに対し、
  60 特権プロセスでは全てのカーネルの権限チェックがバイパスされる。
  61
  62 .\"
  63 バージョン 2.2 以降の Linux では、 これまでスーパーユーザに結び付けられてきた権限を、 いくつかのグループに分割している。これらのグループは
  64 \fIケーパビリティ\fP(capability)  と呼ばれ、グループ毎に独立に有効、無効を設定できる。 ケーパビリティはスレッド単位の属性である。
  65 .SS ケーパビリティのリスト
  66 以下のリストは、 Linux で実装されているケーパビリティと 各ケーパビリティが許可する操作と動作をまとめたものである。
  67 .TP
  68 \fBCAP_AUDIT_CONTROL\fP (Linux 2.6.11 以降)
  69 カーネル監査 (audit) の有効無効の切り替え、 監査のフィルタルールの変更、 監査の状況やフィルタルールの取得ができる。
  70 .TP
  71 \fBCAP_AUDIT_WRITE\fP (Linux 2.6.11 以降)
  72 カーネル監査のログにレコードを書き込む。
  73 .TP
  74 \fBCAP_BLOCK_SUSPEND\fP (Linux 3.5 以降)
  75 システムのサスペンドをブロックできる機能を使用する (\fBepoll\fP(7)  \fBEPOLLWAKEUP\fP,
  76 \fI/proc/sys/wake_lock\fP)。
  77 .TP
  78 \fBCAP_CHOWN\fP
  79 ファイルの UID とGID を任意に変更する (\fBchown\fP(2)  参照)。
  80 .TP
  81 \fBCAP_DAC_OVERRIDE\fP
  82 ファイルの読み出し、書き込み、実行の権限チェックをバイパスする (DAC は "discretionary access control
  83 (任意のアクセス制御)" の略である)。
  84 .TP
  85 \fBCAP_DAC_READ_SEARCH\fP
  86 .PD 0
  87 .RS
  88 .IP * 2
  89 ファイルの読み出し権限のチェックとディレクトリの読み出しと実行 の権限チェックをバイパスする。
  90 .IP *
  91 \fBopen_by_handle_at\fP(2) を起動する。
  92 .RE
  93 .PD
  94
  95 .TP
  96 \fBCAP_FOWNER\fP
  97 .PD 0
  98 .RS
  99 .IP * 2
 100 通常、プロセスのファイルシステム UID がファイルの UID に一致することが 要求される操作 (例えば \fBchmod\fP(2),
 101 \fButime\fP(2))  における権限チェックをバイパスする。 但し、 \fBCAP_DAC_OVERRIDE\fP か
 102 \fBCAP_DAC_READ_SEARCH\fP によりチェックが行われる操作は除く。
 103 .IP *
 104 任意のファイルに対して拡張ファイル属性を設定する (\fBchattr\fP(1)  参照)。
 105 .IP *
 106 任意のファイルに対してアクセス制御リスト (ACL) を設定する。
 107 .IP *
 108 ファイルの削除の際にディレクトリのスティッキービットを無視する。
 109 .IP *
 110 \fBopen\fP(2)  や \fBfcntl\fP(2)  で任意のファイルに対して \fBO_NOATIME\fP を指定する。
 111 .RE
 112 .PD
 113 .TP
 114 \fBCAP_FSETID\fP
 115 ファイルが変更されたときに set\-user\-ID とset\-group\-ID の許可ビットをクリア しない。呼び出し元プロセスのファイルシステム
 116 GID と追加の GID のいずれとも GID が一致しないファイルに対して set\-group\-ID ビットを設定する。
 117 .TP
 118 \fBCAP_IPC_LOCK\fP
 119 .\" FIXME As at Linux 3.2, there are some strange uses of this capability
 120 .\" in other places; they probably should be replaced with something else.
 121 メモリーのロック (\fBmlock\fP(2), \fBmlockall\fP(2), \fBmmap\fP(2), \fBshmctl\fP(2))  を行う。
 122 .TP
 123 \fBCAP_IPC_OWNER\fP
 124 System V IPC オブジェクトに対する操作に関して権限チェックをバイパスする。
 125 .TP
 126 \fBCAP_KILL\fP
 127 .\" FIXME CAP_KILL also has an effect for threads + setting child
 128 .\"       termination signal to other than SIGCHLD: without this
 129 .\"       capability, the termination signal reverts to SIGCHLD
 130 .\"       if the child does an exec().  What is the rationale
 131 .\"       for this?
 132 シグナルを送信する際に権限チェックをバイパスする (\fBkill\fP(2)  参照)。これには \fBioctl\fP(2)  の \fBKDSIGACCEPT\fP
 133 操作の使用も含まれる。
 134 .TP
 135 \fBCAP_LEASE\fP (Linux 2.4 以降)
 136 任意のファイルに対して ファイルリースを設定する (\fBfcntl\fP(2)  参照)。
 137 .TP
 138 \fBCAP_LINUX_IMMUTABLE\fP
 139 .\" These attributes are now available on ext2, ext3, Reiserfs, XFS, JFS
 140 拡張ファイル属性 \fBFS_APPEND_FL\fP と \fBFS_IMMUTABLE_FL\fP を設定する (\fBchattr\fP(1)  参照)。
 141 .TP
 142 \fBCAP_MAC_ADMIN\fP (Linux 2.6.25 以降)
 143 強制アクセス制御 (MAC) を上書きする。 Smack Linux Security Module (LSM) 用に実装されている。
 144 .TP
 145 \fBCAP_MAC_OVERRIDE\fP (Linux 2.6.25 以降)
 146 MAC の設定や状態を変更する。 Smack LSM 用に実装されている。
 147 .TP
 148 \fBCAP_MKNOD\fP (Linux 2.4 以降)
 149 (Linux 2.4 以降)  \fBmknod\fP(2)  を使用してスペシャルファイルを作成する。
 150 .TP
 151 \fBCAP_NET_ADMIN\fP
 152 各種のネットワーク関係の操作を実行する:
 153 .PD 0
 154 .RS
 155 .IP * 2
 156 インターフェースの設定
 157 .IP *
 158 IP のファイアウォール、マスカレード、アカウンティング
 159 .IP *
 160 ルーティングテーブルの変更
 161 .IP *
 162 透過的プロキシでの任意のアドレスの割り当て (bind)
 163 .IP *
 164 サービス種別 (type\-of\-service; TOS) のセット
 165 .IP *
 166 ドライバの統計情報のクリア
 167 .IP *
 168 promiscuous モードをセットする
 169 .IP *
 170 マルチキャストを有効にする
 171 .IP *
 172 \fBsetsockopt\fP(2) を使って以下のソケットオプションを設定する:
 173 \fBSO_DEBUG\fP, \fBSO_MARK\fP,
 174 \fBSO_PRIORITY\fP (優先度を 0 から 6 以外に設定する場合),
 175 \fBSO_RCVBUFFORCE\fP, and \fBSO_SNDBUFFORCE\fP
 176 .RE
 177 .PD
 178 .TP
 179 \fBCAP_NET_BIND_SERVICE\fP
 180 インターネットドメインの特権ポート (ポート番号が 1024 番未満)  をバインドできる。
 181 .TP
 182 \fBCAP_NET_BROADCAST\fP
 183 (未使用) ソケットのブロードキャストと、マルチキャストの待ち受けを行う。
 184 .TP
 185 \fBCAP_NET_RAW\fP
 186 .PD 0
 187 .RS
 188 .IP * 2
 189 RAW ソケットと PACKET ソケットを使用する。
 190 .IP *
 191 透過的プロキシでの任意のアドレスの割り当て (bind)
 192 .RE
 193 .PD
 194 .\" Also various IP options and setsockopt(SO_BINDTODEVICE)
 195 .TP
 196 \fBCAP_SETGID\fP
 197 プロセスの GID と追加の GID リストに対する任意の操作を行う。 UNIX ドメインソケット経由でソケットの資格情報 (credential)
 198 を渡す際に 偽の GID を渡すことができる。
 199 .TP
 200 \fBCAP_SETFCAP\fP (Linux 2.6.24 以降)
 201 ファイルケーパビリティを設定する。
 202 .TP
 203 \fBCAP_SETPCAP\fP
 204 ファイルケーパビリティがサポートされていない場合: 呼び出し元が許可されているケーパビリティセットに含まれる任意のケーパビリティを、
 205 他のプロセスに付与したり、削除したりできる。 (カーネルがファイルケーパビリティをサポートしている場合、 \fBCAP_SETPCAP\fP
 206 はこの役割を持たない。 なぜなら、ファイルケーパビリティをサポートしているカーネルでは \fBCAP_SETPCAP\fP は全く別の意味を持つからである。)
 207
 208 ファイルケーパビリティがサポートされている場合: 呼び出し元スレッドのバウンディングセットの任意のケーパビリティを
 209 自身の継承可能ケーパビリティセットに追加できる。 (\fBprctl\fP(2)  \fBPR_CAPBSET_DROP\fP を使って)
 210 バウンディングセットからケーパビリティを削除できる。 \fIsecurebits\fP フラグを変更できる。
 211 .TP
 212 \fBCAP_SETUID\fP
 213 .\" FIXME CAP_SETUID also an effect in exec(); document this.
 214 プロセスの UID に対する任意の操作 (\fBsetuid\fP(2), \fBsetreuid\fP(2), \fBsetresuid\fP(2),
 215 \fBsetfsuid\fP(2))  を行う。 UNIX ドメインソケット経由でソケットの資格情報 (credential) を渡す際に 偽の UID
 216 を渡すことができる。
 217 .TP
 218 \fBCAP_SYS_ADMIN\fP
 219 .PD 0
 220 .RS
 221 .IP * 2
 222 以下のシステム管理用の操作を実行する: \fBquotactl\fP(2), \fBmount\fP(2), \fBumount\fP(2), \fBswapon\fP(2),
 223 \fBswapoff\fP(2), \fBsethostname\fP(2), \fBsetdomainname\fP(2).
 224 .IP *
 225 特権が必要な \fBsyslog\fP(2) の操作を実行する
 226 (Linux 2.6.37 以降では、このような操作を許可するには
 227 \fBCAP_SYSLOG\fP を使うべきである)
 228 .IP *
 229 \fBVM86_REQUEST_IRQ\fP \fBvm86\fP(2) コマンドを実行する。
 230 .IP *
 231 任意の System V IPC オブジェクトに対する \fBIPC_SET\fP と \fBIPC_RMID\fP 操作を実行する。
 232 .IP *
 233 拡張属性 \fItrusted\fP と \fIsecurity\fP に対する操作を実行する (\fBattr\fP(5)  参照)。
 234 .IP *
 235 \fBlookup_dcookie\fP(2)  を呼び出す。
 236 .IP *
 237 \fBioprio_set\fP(2)  を使って I/O スケジューリングクラス \fBIOPRIO_CLASS_RT\fP,
 238 \fBIOPRIO_CLASS_IDLE\fP を割り当てる (\fBIOPRIO_CLASS_IDLE\fP は Linux 2.6.25
 239 より前のバージョンのみ)。
 240 .IP *
 241 ソケットの資格情報 (credential) を渡す際に偽の UID を渡す。
 242 .IP *
 243 ファイルをオープンするシステムコール (例えば \fBaccept\fP(2), \fBexecve\fP(2), \fBopen\fP(2), \fBpipe\fP(2))
 244 でシステム全体でオープンできるファイル数の上限 \fI/proc/sys/fs/file\-max\fP を超過する。
 245 .IP *
 246 \fBclone\fP(2) と \fBunshare\fP(2) で新しい名前空間を作成する \fBCLONE_*\fP
 247 フラグを利用する。
 248 .IP *
 249 \fBperf_event_open\fP(2) を呼び出す。
 250 .IP *
 251 特権が必要な \fIperf\fP イベントの情報にアクセスする。
 252 .IP *
 253 \fBsetns\fP(2) を呼び出す。
 254 .IP *
 255 \fBfanotify_init\fP(2) を呼び出す。
 256 .IP *
 257 \fBkeyctl\fP(2)  の \fBKEYCTL_CHOWN\fP と \fBKEYCTL_SETPERM\fP 操作を実行する。
 258 .IP *
 259 \fBmadvise\fP(2)  の \fBMADV_HWPOISON\fP 操作を実行する。
 260 .IP *
 261 \fBTIOCSTI\fP \fBioctl\fP(2) を使って、
 262 呼び出し元の制御端末以外の端末の入力キューに文字を挿入する。
 263 .IP *
 264 廃止予定の \fBnfsservctl\fP(2) システムコールを使用する。
 265 .IP *
 266 廃止予定の \fBbdflush\fP(2) システムコールを使用する。
 267 .IP *
 268 特権が必要なブロックデバイスに対する各種の \fBioctl\fP(2) 操作を
 269 実行する。
 270 .IP *
 271 特権が必要なファイルシステムに対する各種の \fBioctl\fP(2) 操作を
 272 実行する。
 273 .IP *
 274 多くのデバイスドライバに対する管理命令を実行する。
 275 .RE
 276 .PD
 277 .TP
 278 \fBCAP_SYS_BOOT\fP
 279 \fBreboot\fP(2)  と \fBkexec_load\fP(2)  を呼び出す。
 280 .TP
 281 \fBCAP_SYS_CHROOT\fP
 282 \fBchroot\fP(2).  を呼び出す。
 283 .TP
 284 \fBCAP_SYS_MODULE\fP
 285 カーネルモジュールのロード、アンロードを行う (\fBinit_module\fP(2)  と \fBdelete_module\fP(2)  を参照のこと)。
 286 バージョン 2.6.25 より前のカーネルで、 システム全体のケーパビリティバウンディングセット (capability bounding set)
 287 からケーパビリティを外す。
 288 .TP
 289 \fBCAP_SYS_NICE\fP
 290 .PD 0
 291 .RS
 292 .IP * 2
 293 プロセスの nice 値の引き上げ (\fBnice\fP(2), \fBsetpriority\fP(2))  や、任意のプロセスの nice 値の変更を行う。
 294 .IP *
 295 呼び出し元プロセスに対するリアルタイムスケジューリングポリシーと、 任意のプロセスに対するスケジューリングポリシーと優先度を設定する
 296 (\fBsched_setscheduler\fP(2), \fBsched_setparam\fP(2))。
 297 .IP *
 298 任意のプロセスに対する CPU affinity を設定できる (\fBsched_setaffinity\fP(2))。
 299 .IP *
 300 任意のプロセスに対して I/O スケジューリングクラスと優先度を設定できる (\fBioprio_set\fP(2))。
 301 .IP *
 302 .\" FIXME CAP_SYS_NICE also has the following effect for
 303 .\" migrate_pages(2):
 304 .\"     do_migrate_pages(mm, &old, &new,
 305 .\"         capable(CAP_SYS_NICE) ? MPOL_MF_MOVE_ALL : MPOL_MF_MOVE);
 306 \fBmigrate_pages\fP(2)  を任意のプロセスに適用し、プロセスを任意のノードに移動する。
 307 .IP *
 308 \fBmove_pages\fP(2)  を任意のプロセスに対して行う。
 309 .IP *
 310 \fBmbind\fP(2)  と \fBmove_pages\fP(2)  で \fBMPOL_MF_MOVE_ALL\fP フラグを使用する。
 311 .RE
 312 .PD
 313 .TP
 314 \fBCAP_SYS_PACCT\fP
 315 \fBacct\fP(2)  を呼び出す。
 316 .TP
 317 \fBCAP_SYS_PTRACE\fP
 318 \fBptrace\fP(2)  を使って任意のプロセスをトレースする。 任意のプロセスに \fBget_robust_list\fP(2)  を適用する。
 319 \fBkcmp\fP(2) を使ってプロセス内部を調査する。
 320 .TP
 321 \fBCAP_SYS_RAWIO\fP
 322 .PD 0
 323 .RS
 324 .IP * 2
 325 I/O ポート操作を実行する (\fBiopl\fP(2)、 \fBioperm\fP(2))。
 326 .IP *
 327 \fI/proc/kcore\fP にアクセスする。
 328 .IP *
 329 \fBFIBMAP\fP \fBioctl\fP(2) 操作を使用する。
 330 .IP *
 331 x86 モデルに固有のレジスタ (MSR レジスタ群、 \fBmsr\fP(4) 参照) にアクセスするためのデバイスをオープンする。
 332 .IP *
 333 \fI/proc/sys/vm/mmap_min_addr\fP を更新する。
 334 .IP *
 335 \fI/proc/sys/vm/mmap_min_addr\fP で指定された値よりも小さなアドレスにメモリマッピングを作成する。
 336 .IP *
 337 \fI/proc/bus/pci\fP にあるファイルをマップする。
 338 .IP *
 339 \fI/dev/mem\fP や \fI/dev/kmem\fP をオープンする。
 340 .IP *
 341 各種の SCSI デバイスコマンドを実行する。
 342 .IP *
 343 \fBhpsa\fP(4) デバイスや \fBcciss\fP(4) デバイスの特定の操作を実行する。
 344 .IP *
 345 他のデバイスに対して各種のデバイス固有命令を実行する。
 346 .RE
 347 .PD
 348 .TP
 349 \fBCAP_SYS_RESOURCE\fP
 350 .PD 0
 351 .RS
 352 .IP * 2
 353 ext2 ファイルシステム上の予約されている領域を使用する。
 354 .IP *
 355 ext3 のジャーナル機能を制御する \fBioctl\fP(2)  を使用する。
 356 .IP *
 357 ディスク quota の上限を上書きする。
 358 .IP *
 359 リソース上限を増やす (\fBsetrlimit\fP(2))。
 360 .IP *
 361 \fBRLIMIT_NPROC\fP リソース制限を上書きする。
 362 .IP *
 363 コンソール割り当てにおいてコンソールの最大数を上書きする。
 364 .IP *
 365 キーマップの最大数を上書きする。
 366 .IP *
 367 リアルタイムクロックから秒間 64 回を越える回数の割り当てが許可する。
 368 .IP *
 369 メッセージキューに関する上限 \fImsg_qbytes\fP を
 370 \fI/proc/sys/kernel/msgmnb\fP に指定されている上限よりも大きく設定する
 371 (\fBmsgop\fP(2) と \fBmsgctl\fP(2) 参照)。
 372 .IP *
 373 \fBF_SETPIPE_SZ\fP \fBfcntl\fP(2) を使ってパイプの容量を設定する際に
 374 上限 \fI/proc/sys/fs/pipe\-size\-max\fP を上書きする。
 375 .IP *
 376 \fI/proc/sys/fs/pipe\-max\-size\fP に指定されている上限を超えてパイプの容量
 377 を増やすのに \fBF_SETPIPE_SZ\fP を使用する。
 378 .IP *
 379 POSIX メッセージキューを作成する際に、
 380 上限 \fI/proc/sys/fs/mqueue/queues_max\fP を上書きする
 381 (\fBmq_overview\fP(7) 参照)。
 382 .IP *
 383 \fBprctl\fP(2) \fBPR_SET_MM\fP 操作を使用する。
 384 .IP *
 385 \fBCAP_SYS_RESOURCE\fP を持ったプロセスによって最後に設定された値よりも小さな値を \fI/proc/PID/oom_score_adj\fP
 386 に設定する。
 387 .RE
 388 .PD
 389 .TP
 390 \fBCAP_SYS_TIME\fP
 391 システムクロックを変更する (\fBsettimeofday\fP(2), \fBstime\fP(2), \fBadjtimex\fP(2))。 リアルタイム
 392 (ハードウェア) クロックを変更する。
 393 .TP
 394 \fBCAP_SYS_TTY_CONFIG\fP
 395 \fBvhangup\fP(2) を使用する。
 396 特権が必要な仮想端末に関する各種の \fBioctl\fP(2) 操作を利用できる。
 397 .TP
 398 \fBCAP_SYSLOG\fP (Linux 2.6.37 以降)
 399 .IP * 3
 400 特権が必要な \fBsyslog\fP(2) 操作を実行できる。
 401 どの操作が特権が必要かについての情報は \fBsyslog\fP(2) を参照。
 402 .IP *
 403 \fI/proc/sys/kernel/kptr_restrict\fP の値が 1 の場合、 \fI/proc\fP
 404 や他のインターフェース経由で公開されているカーネルアドレスを参照する (\fBproc\fP(5) の \fIkptr_restrict\fP の議論を参照)。
 405 .TP
 406 \fBCAP_WAKE_ALARM\fP (Linux 3.0 以降)
 407 .\"
 408 システムを起こすトリガーを有効にする (タイマー \fBCLOCK_REALTIME_ALARM\fP
 409 や \fBCLOCK_BOOTTIME_ALARM\fP を設定する)。
 410 .SS 過去と現在の実装
 411 完全な形のケーパビリティを実装するには、以下の要件を満たす必要がある：
 412 .IP 1. 3
 413 全ての特権操作について、カーネルはそのスレッドの実効ケーパビリティセットに 必要なケーパビリティがあるかを確認する。
 414 .IP 2.
 415 カーネルで、あるスレッドのケーパビリティセットを変更したり、 取得したりできるシステムコールが提供される。
 416 .IP 3.
 417 ファイルシステムが、実行可能ファイルにケーパビリティを付与でき、ファイル 実行時にそのケーパビリティをプロセスが取得できるような機能をサポートする。
 418 .PP
 419 .\"
 420 カーネル 2.6.24 より前では、最初の 2つの要件のみが満たされている。 カーネル 2.6.24 以降では、3つの要件すべてが満たされている。
 421 .SS スレッドケーパビリティセット
 422 各スレッドは以下の 3種類のケーパビリティセットを持つ。各々のケーパビリティセットは 上記のケーパビリティの組み合わせである
 423 (全てのケーパビリティが無効でもよい)。
 424 .TP
 425 \fI許可 (permitted)\fP:
 426 そのスレッドが持つことになっている実効ケーパビリティの 限定的なスーパーセットである。 これは、実効ケーパビリティセットに \fBCAP_SETPCAP\fP
 427 ケーパビリティを持っていないスレッドが継承可能ケーパビリティセットに 追加可能なケーパビリティの限定的なスーパーセットでもある。
 428
 429 許可ケーパビリティセットから削除してしまったケーパビリティは、 (set\-user\-ID\-root プログラムか、
 430 そのケーパビリティをファイルケーパビリティで許可しているプログラムを \fBexecve\fP(2)  しない限りは) もう一度獲得することはできない。
 431 .TP
 432 \fI継承可能 (inheritable)\fP:
 433 \fBexecve\fP(2)  を前後で保持されるケーパビリティセットである。 この仕組みを使うことで、あるプロセスが \fBexecve\fP(2)
 434 を行う際に新しいプログラムの許可ケーパビリティセットとして 割り当てるケーパビリティを指定することができる。
 435 .TP
 436 \fI実効 (effective)\fP:
 437 カーネルがスレッドの権限 (permission) をチェックするときに 使用するケーパビリティセットである。
 438 .PP
 439 \fBfork\fP(2)  で作成される子プロセスは、親のケーパビリティセットのコピーを継承する。 \fBexecve\fP(2)
 440 中のケーパビリティの扱いについては下記を参照のこと。
 441 .PP
 442 \fBcapset\fP(2)  を使うと、プロセスは自分自身のケーパビリティセット を操作することができる (下記参照)。
 443 .PP
 444 .\" commit 73efc0394e148d0e15583e13712637831f926720
 445 .\"
 446 Linux 3.2 以降では、 ファイル \fI/proc/sys/kernel/cap_last_cap\fP で、
 447 実行中のカーネルでサポートされているケーパビリティの最大値を参照できる。 この情報を使って、
 448 ケーパビリティセットに設定される可能性がある最上位ビットを判定することができる。
 449 .SS ファイルケーパビリティ
 450 カーネル 2.6.24 以降では、 \fBsetcap\fP(8)  を使って実行ファイルにケーパビリティセットを対応付けることができる。
 451 ファイルケーパビリティセットは \fIsecurity.capability\fP という名前の拡張属性に保存される (\fBsetxattr\fP(2)
 452 参照)。この拡張属性への書き込みには \fBCAP_SETFCAP\fP ケーパビリティが必要である。
 453 ファイルケーパビリティセットとスレッドのケーパビリティセットの両方が 考慮され、 \fBexecve\fP(2)
 454 後のスレッドのケーパビリティセットが決定される。
 455
 456 3 つのファイルケーパビリティセットが定義されている。
 457 .TP
 458 \fI許可 (Permitted)\fP (以前の\fI強制 (Forced)\fP):
 459 スレッドの継承可能ケーパビリティに関わらず、そのスレッドに自動的に 認められるケーパビリティ。
 460 .TP
 461 \fI継承可能 (Inheritable)\fP (以前の \fI許容 (Allowed)\fP):
 462 このセットと、スレッドの継承可能ケーパビリティセットとの 論理積 (AND) がとられ、 \fBexecve\fP(2)
 463 の後にそのスレッドの許可ケーパビリティセットで有効となる 継承可能ケーパビリティが決定される。
 464 .TP
 465 \fI実効 (effective)\fP:
 466 これは集合ではなく、1 ビットの情報である。 このビットがセットされていると、 \fBexecve\fP(2)
 467 実行中に、そのスレッドの新しい許可ケーパビリティが全て 実効ケーパビリティ集合においてもセットされる。 このビットがセットされていない場合、
 468 \fBexecve\fP(2)  後には新しい許可ケーパビリティのどれも新しい実効ケーパビリティ集合 にセットされない。
 469
 470 .\"
 471 ファイルの実効ケーパビリティビットを有効にするというのは、 \fBexecve\fP(2)
 472 実行時に、ファイルの許可ケーパビリティと継承ケーパビリティに対応するものが スレッドの許可ケーパビリティセットとしてセットされるが、
 473 これが実効ケーパビリティセットにもセットされるということである (ケーパビリティの変換ルールは下記参照)。
 474 したがって、ファイルにケーパビリティを割り当てる際 (\fBsetcap\fP(8), \fBcap_set_file\fP(3),
 475 \fBcap_set_fd\fP(3))、 いずれかのケーパビリティに対して実効フラグを有効と指定する場合、
 476 許可フラグや継承可能フラグを有効にした他の全てのケーパビリティ についても実効フラグを有効と指定しなければならない。
 477 .SS "execve() 中のケーパビリティの変換"
 478 .PP
 479 \fBexecve\fP(2)  実行時に、カーネルはプロセスの新しいケーパビリティを次の アルゴリズムを用いて計算する：
 480 .in +4n
 481 .nf
 482
 483 P'(permitted) = (P(inheritable) & F(inheritable)) |
 484                 (F(permitted) & cap_bset)
 485
 486 P'(effective) = F(effective) ? P'(permitted) : 0
 487
 488 P'(inheritable) = P(inheritable)    [つまり、変更されない]
 489
 490 .fi
 491 .in
 492 各変数の意味は以下の通り:
 493 .RS 4
 494 .IP P 10
 495 \fBexecve\fP(2)  前のスレッドのケーパビリティセットの値
 496 .IP P'
 497 \fBexecve\fP(2)  後のスレッドのケーパビリティセットの値
 498 .IP F
 499 ファイルケーパビリティセットの値
 500 .IP cap_bset
 501 ケーパビリティバウンディングセットの値 (下記参照)
 502 .RE
 503 .\"
 504 .SS ケーパビリティと、ルートによるプログラムの実行
 505 \fBexecve\fP(2)  時に、ケーパビリティセットを使って、全ての権限を持った \fIroot\fP を実現するには、以下のようにする。
 506 .IP 1. 3
 507 set\-user\-ID\-root プログラムが実行される場合、 またはプロセスの実ユーザ ID が 0 (root) の場合、
 508 ファイルの継承可能セットと許可セットを全て 1 (全てのケーパビリティが有効) に定義する。
 509 .IP 2.
 510 set\-user\-ID\-root プログラムが実行される場合、 ファイルの実効ケーパビリティビットを 1 (enabled) に定義する。
 511 .PP
 512 .\" If a process with real UID 0, and nonzero effective UID does an
 513 .\" exec(), then it gets all capabilities in its
 514 .\" permitted set, and no effective capabilities
 515 上記のルールにケーパビリティ変換を適用した結果をまとめると、 プロセスが set\-user\-ID\-root プログラムを \fBexecve\fP(2)
 516 する場合、または実効 UID が 0 のプロセスがプログラムを \fBexecve\fP(2)  する場合、許可と実効のケーパビリティセットの全ケーパビリティ
 517 (正確には、ケーパビリティバウンディングセットによるマスクで除外されるもの 以外の全てのケーパビリティ) を取得するということである。
 518 これにより、伝統的な UNIX システムと同じ振る舞いができるようになっている。
 519 .SS ケーパビリティ・バウンディングセット
 520 ケーパビリティ・バウンディングセット (capability bounding set) は、 \fBexecve\fP(2)
 521 時に獲得できるケーパビリティを制限するために使われる セキュリティ機構である。 バウンディングセットは以下のように使用される。
 522 .IP * 2
 523 \fBexecve\fP(2)  実行時に、ケーパビリティ・バウンディングセットと ファイルの許可ケーパビリティセットの論理和 (AND) を取ったものが、
 524 そのスレッドの許可ケーパビリティセットに割り当てられる。 つまり、ケーパビリティ・バウンディングセットは、
 525 実行ファイルが認めている許可ケーパビリティに対して 制限を課す働きをする。
 526 .IP *
 527 (Linux 2.6.25 以降)  ケーパビリティ・バウンディングセットは、スレッドが \fBcapset\fP(2)
 528 により自身の継承可能セットに追加可能なケーパビリティの母集団を 制限する役割を持つ。
 529 スレッドに許可されたケーパビリティであっても、バウンディングセットに 含まれていなければ、スレッドはそのケーパビリティは自身の継承可能セットに
 530 追加できず、その結果、継承可能セットにそのケーパビリティを含むファイルを \fBexecve\fP(2)
 531 する場合、そのケーパビリティを許可セットに持ち続けることができない、 ということである。
 532 .PP
 533 バウンディングセットがマスクを行うのは、継承可能ケーパビリティではなく、 ファイルの許可ケーパビリティのマスクを行う点に注意すること。
 534 あるスレッドの継承可能セットにそのスレッドのバウンディングセットに 存在しないケーパビリティが含まれている場合、そのスレッドは、
 535 継承可能セットに含まれるケーパビリティを持つファイルを実行することにより、 許可セットに含まれるケーパビリティも獲得できるということである。
 536 .PP
 537 カーネルのバージョンにより、ケーパビリティ・バウンディングセットは システム共通の属性の場合と、プロセス単位の属性の場合がある。
 538 .PP
 539 \fBLinux 2.6.25 より前のケーパビリティ・バウンディングセット\fP
 540 .PP
 541 2.6.25 より前のカーネルでは、ケーパビリティ・バウンディングセットは システム共通の属性で、システム上の全てのスレッドに適用される。
 542 バウンディングセットは \fI/proc/sys/kernel/cap\-bound\fP ファイル経由で参照できる。
 543 (間違えやすいが、このビットマスク形式のパラメータは、 \fI/proc/sys/kernel/cap\-bound\fP では符号付きの十進数で表現される。)
 544
 545 \fBinit\fP プロセスだけがケーパビリティ・バウンディングセットで ケーパビリティをセットすることができる。 それ以外では、スーパーユーザ
 546 (より正確には、 \fBCAP_SYS_MODULE\fP ケーパビリティを持ったプログラム) が、
 547 ケーパビリティ・バウンディングセットのケーパビリティのクリアが できるだけである。
 548
 549 通常のシステムでは、ケーパビリティ・バウンディングセットは、 \fBCAP_SETPCAP\fP が無効になっている。 この制限を取り去るには
 550 (取り去るのは危険!)、 \fIinclude/linux/capability.h\fP 内の \fBCAP_INIT_EFF_SET\fP
 551 の定義を修正し、カーネルを再構築する必要がある。
 552
 553 .\"
 554 システム共通のケーパビリティ・バウンディングセット機能は、 カーネル 2.2.11 以降で Linux に追加された。
 555 .PP
 556 \fBLinux 2.6.25 以降のケーパビリティ・バウンディングセット\fP
 557 .PP
 558 Linux 2.6.25 以降では、 「ケーパビリティ・バウンディングセット」はスレッド単位の属性である
 559 (システム共通のケーパビリティ・バウンディングセットはもはや存在しない)。
 560
 561 バウンディングセットは \fBfork\fP(2)  時にはスレッドの親プロセスから継承され、 \fBexecve\fP(2)  の前後では保持される。
 562
 563 スレッドが \fBCAP_SETPCAP\fP ケーパビリティを持っている場合、そのスレッドは \fBprctl\fP(2)  の
 564 \fBPR_CAPBSET_DROP\fP 操作を使って自身のケーパビリティ・バウンディングセットから ケーパビリティを削除することができる。
 565 いったんケーパビリティをバウンディングセットから削除してしまうと、 スレッドはそのケーパビリティを再度セットすることはできない。 \fBprctl\fP(2)
 566 の \fBPR_CAPBSET_READ\fP 操作を使うことで、スレッドがあるケーパビリティが自身のバウンディングセット
 567 に含まれているかを知ることができる。
 568
 569 バウンディングセットからのケーパビリティの削除がサポートされるのは、
 570 カーネルのコンパイル時にファイルケーパビリティが有効になっている場合
 571 だけである。Linux 2.6.33 より前のカーネルでは、ファイルケーパビリティは
 572 設定オプション CONFIG_SECURITY_FILE_CAPABILITIES で切り替えられる追加の
 573 機能であった。Linux 2.6.33 以降では、この設定オプションは削除され、
 574 ファイルケーパビリティは常にカーネルに組込まれるようになった。
 575 ファイルケーパビリティがカーネルにコンパイル時に組み込まれている場合、
 576 (全てのプロセスの先祖である) \fIinit\fP プロセスはバウンディングセットで
 577 全てのケーパビリティが セットされた状態で開始する。ファイルケーパビリティ
 578 が有効になっていない場合には、 \fIinit\fP はバウンディングセットで
 579 \fBCAP_SETPCAP\fP 以外の全てのケーパビリティがセットされた状態で開始する。
 580 このようになっているのは、 \fBCAP_SETPCAP\fP ケーパビリティがファイルケー
 581 パビリティがサポートされていない場合には 違った意味を持つからである。
 582
 583 .\"
 584 .\"
 585 バウンディングセットからケーパビリティを削除しても、 スレッドの継承可能セットからはそのケーパビリティは削除されない。
 586 しかしながら、バウンディングセットからの削除により、 この先そのケーパビリティをスレッドの継承可能セットに追加すること はできなくなる。
 587 .SS "ユーザ ID 変更のケーパビリティへの影響"
 588 ユーザ ID が 0 と 0 以外の間で変化する際の振る舞いを従来と同じにするため、 スレッドの実 UID、実効 UID、保存
 589 set\-user\-ID、ファイルシステム UID が (\fBsetuid\fP(2), \fBsetresuid\fP(2)  などを使って)
 590 変更された際に、カーネルはそのスレッドのケーパビリティセットに 以下の変更を行う:
 591 .IP 1. 3
 592 UID の変更前には実 UID、実効 UID、保存 set\-user\-ID のうち 少なくとも一つが 0 で、変更後に実 UID、実効 UID、保存
 593 set\-user\-ID が すべて 0 以外の値になった場合、許可と実効のケーパビリティセットの 全ケーパビリティをクリアする。
 594 .IP 2.
 595 実効 UID が 0 から 0 以外に変更された場合、 実効ケーパビリティセットの全ケーパビリティをクリアする。
 596 .IP 3.
 597 実効 UID が 0 以外から 0 に変更された場合、 許可ケーパビリティセットの内容を実効ケーパビリティセットにコピーする。
 598 .IP 4.
 599 ファイルシステム UID が 0 から 0 以外に変更された場合 (\fBsetfsuid\fP(2)
 600 参照)、実効ケーパビリティセットの以下のケーパビリティがクリアされる: \fBCAP_CHOWN\fP, \fBCAP_DAC_OVERRIDE\fP,
 601 \fBCAP_DAC_READ_SEARCH\fP, \fBCAP_FOWNER\fP, \fBCAP_FSETID\fP, \fBCAP_LINUX_IMMUTABLE\fP
 602 (Linux 2.2.30 以降), \fBCAP_MAC_OVERRIDE\fP, \fBCAP_MKNOD\fP (Linux 2.2.30 以降)。
 603 ファイルシステム UID が 0 以外から 0 に変更された場合、 上記のケーパビリティのうち許可ケーパビリティセットで有効になっているものが
 604 実効ケーパビリティセットで有効にされる。
 605 .PP
 606 .\"
 607 各種 UID のうち少なくとも一つが 0 であるスレッドが、 その UID の全てが 0 以外になったときに許可ケーパビリティセットが
 608 クリアされないようにしたい場合には、 \fBprctl\fP(2)  の \fBPR_SET_KEEPCAPS\fP 操作を使えばよい。
 609 .SS プログラムでケーパビリティセットを調整する
 610 各スレッドは、 \fBcapget\fP(2)  や \fBcapset\fP(2)  を使って、自身のケーパビリティセットを取得したり変更したりできる。
 611 ただし、これを行うには、 \fIlibcap\fP パッケージで提供されている \fBcap_get_proc\fP(3)  や
 612 \fBcap_set_proc\fP(3)  を使うのが望ましい。 スレッドのケーパビリティセットの変更には以下のルールが適用される。
 613 .IP 1. 3
 614 呼び出し側が \fBCAP_SETPCAP\fP ケーパビリティを持っていない場合、新しい継承可能セットは、 既存の継承可能セットと許可セットの積集合
 615 (AND) の部分集合で なければならない。
 616 .IP 2.
 617 (Linux 2.6.25 以降)  新しい継承可能セットは、既存の継承可能セットとケーパビリティ・ バウンディングセットの積集合 (AND)
 618 の部分集合でなければならない。
 619 .IP 3.
 620 新しい許可セットは、既存の許可セットの部分集合でなければならない (つまり、そのスレッドが現在持っていない許可ケーパビリティを
 621 獲得することはできない)。
 622 .IP 4.
 623 新しい実効ケーパビリティセットは新しい許可ケーパビリティセットの 部分集合になっていなければならない。
 624 .SS "securebits フラグ: ケーパビリティだけの環境を構築する"
 625 .\" For some background:
 626 .\"       see http://lwn.net/Articles/280279/ and
 627 .\"       http://article.gmane.org/gmane.linux.kernel.lsm/5476/
 628 カーネル 2.6.26 以降で、 ファイルケーパビリティが有効になったカーネルでは、 スレッド単位の \fIsecurebits\fP
 629 フラグが実装されており、このフラグを使うと UID 0 (\fIroot\fP)  に対するケーパビリティの特別扱いを無効することができる。
 630 以下のようなフラグがある。
 631 .TP
 632 \fBSECBIT_KEEP_CAPS\fP
 633 このフラグをセットされている場合、UID が 0 のスレッドの UID が 0 以外の値に
 634 切り替わる際に、そのスレッドはケーパビリティを維持することができる。 このフラグがセットされていない場合には、UID が 0 から 0 以外の値に
 635 切り替わると、そのスレッドは全てのケーパビリティを失う。 このフラグは \fBexecve\fP(2)  時には全てクリアされる (このフラグは、以前の
 636 \fBprctl\fP(2)  の \fBPR_SET_KEEPCAPS\fP 操作と同じ機能を提供するものである)。
 637 .TP
 638 \fBSECBIT_NO_SETUID_FIXUP\fP
 639 このフラグをセットすると、スレッドの実効 UID とファイルシステム UID が 0 と 0 以外の間で切り替わった場合に、
 640 カーネルはケーパビリティセットの調整を行わなくなる (「ユーザ ID 変更のケーパビリティへの影響」の節を参照)。
 641 .TP
 642 \fBSECBIT_NOROOT\fP
 643 このビットがセットされている場合、 set\-user\-ID\-root プログラムの実行時や、 実効 UID か 実 UID が 0 のプロセスが
 644 \fBexecve\fP(2)  を呼び出した時に、カーネルはケーパビリティを許可しない (「ケーパビリティと、ルートによるプログラムの実行」の節を参照)。
 645 .PP
 646 上記の "base" フラグの各々には対応する "locked" フラグが存在する。 いずれの "locked"
 647 フラグも一度セットされると戻すことはできず、 それ以降は対応する "base" フラグを変更することができなくなる。 "locked" フラグは
 648 \fBSECBIT_KEEP_CAPS_LOCKED\fP, \fBSECBIT_NO_SETUID_FIXUP_LOCKED\fP,
 649 \fBSECBIT_NOROOT_LOCKED\fP という名前である。
 650 .PP
 651 \fIsecurebits\fP フラグは、 \fBprctl\fP(2)  の操作 \fBPR_SET_SECUREBITS\fP や
 652 \fBPR_GET_SECUREBITS\fP を使うことで変更したり取得したりできる。 フラグを変更するには \fBCAP_SETPCAP\fP
 653 ケーパビリティが必要である。
 654
 655 \fIsecurebits\fP フラグは子プロセスに継承される。 \fBexecve\fP(2) においては、
 656 \fBSECBIT_KEEP_CAPS\fP が常にクリアされる以外は、全てのフラグが保持される。
 657
 658 アプリケーションは、以下の呼び出しを行うことにより、 自分自身および子孫となるプロセス全てに対して、
 659 必要なファイルケーパビリティを持ったプログラムを実行しない限り、 対応するケーパビリティを獲得できないような状況に閉じこめることができる。
 660 .in +4n
 661 .nf
 662
 663 prctl(PR_SET_SECUREBITS,
 664         SECBIT_KEEP_CAPS_LOCKED |
 665         SECBIT_NO_SETUID_FIXUP |
 666         SECBIT_NO_SETUID_FIXUP_LOCKED |
 667         SECBIT_NOROOT |
 668         SECBIT_NOROOT_LOCKED);
 669 .fi
 670 .in
 671 .SH 準拠
 672 .PP
 673 ケーパビリティに関する標準はないが、 Linux のケーパビリティは廃案になった POSIX.1e 草案に基づいて実装されている。
 674 .UR http://wt.xpilot.org\:/publications\:/posix.1e/
 675 .UE
 676 を参照。
 677 .SH 注意
 678 カーネル 2.5.27 以降、ケーパビリティは選択式のカーネルコンポーネント となっており、カーネル設定オプション
 679 CONFIG_SECURITY_CAPABILITIES により有効/無効を切り替えることができる。
 680
 681 .\" 7b9a7ec565505699f503b4fcf61500dceb36e744
 682 \fI/proc/PID/task/TID/status\fP ファイルを使うと、スレッドのケーパビリティセットを見ることができる。
 683 \fI/proc/PID/status\fP ファイルには、プロセスのメインスレッドのケーパビリティセットが表示される。 Linux 3.8 より前では、
 684 これらのケーパビリティセットの表示で、 存在しないケーパビリティはすべて有効 (1) として表示される。 Linux 3.8 以降では、
 685 存在しないケーパビリティはすべて無効 (0) として表示される。 (\fBCAP_LAST_CAP\fP
 686 より大きい値を持つケーパビリティが存在しないケーパビリティである)。
 687
 688 \fIlibcap\fP パッケージは、ケーパビリティを設定・取得するための ルーチン群を提供している。これらのインタフェースは、 \fBcapset\fP(2)
 689 と \fBcapget\fP(2)  が提供するインターフェースと比べて、より使いやすく、変更される可能性が少ない。 このパッケージでは、
 690 \fBsetcap\fP(8), \fBgetcap\fP(8)  というプログラムも提供されている。 パッケージは以下で入手できる。
 691 .br
 692 .UR http://www.kernel.org\:/pub\:/linux\:/libs\:/security\:/linux\-privs
 693 .UE .
 694
 695 バージョン 2.6.24 より前、およびファイルケーパビリティが 有効になっていない2.6.24 以降のカーネルでは、 \fBCAP_SETPCAP\fP
 696 ケーパビリティを持ったスレッドは自分以外のスレッドの ケーパビリティを操作できる。 しかしながら、これは理論的に可能というだけである。
 697 以下のいずれかの場合においても、どのスレッドも \fBCAP_SETPCAP\fP ケーパビリティを持つことはないからである。
 698 .IP * 2
 699 2.6.25 より前の実装では、システム共通のケーパビリティ・バウンディングセット \fI/proc/sys/kernel/cap\-bound\fP
 700 ではこのケーパビリティは常に無効になっており、 ソースを変更してカーネルを再コンパイルしない限り、 これを変更することはできない。
 701 .IP *
 702 現在の実装ではファイルケーパビリティが無効になっている場合、 プロセス毎のバウンディングセットからこのケーパビリティを抜いて \fBinit\fP
 703 は開始され、 システム上で生成される他の全てのプロセスでこのバウンディングセットが 継承される。
 704 .SH 関連項目
 705 \fBcapget\fP(2), \fBprctl\fP(2), \fBsetfsuid\fP(2), \fBcap_clear\fP(3),
 706 \fBcap_copy_ext\fP(3), \fBcap_from_text\fP(3), \fBcap_get_file\fP(3),
 707 \fBcap_get_proc\fP(3), \fBcap_init\fP(3), \fBcapgetp\fP(3), \fBcapsetp\fP(3),
 708 \fBlibcap\fP(3), \fBcredentials\fP(7), \fBpthreads\fP(7), \fBgetcap\fP(8), \fBsetcap\fP(8)
 709 .PP
 710 Linux カーネルソース内の \fIinclude/linux/capability.h\fP
 711 .SH この文書について
 712 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
 713 である。プロジェクトの説明とバグ報告に関する情報は
 714 http://www.kernel.org/doc/man\-pages/ に書かれている。