draft/man2/setns.2

   1 .\" Copyright (C) 2011, Eric Biederman <ebiederm@xmission.com>
   2 .\" and Copyright (C) 2011, 2012, Michael Kerrisk <mtk.manpages@gamil.com>
   3 .\"
   4 .\" %%%LICENSE_START(GPLv2_ONELINE)
   5 .\" Licensed under the GPLv2
   6 .\" %%%LICENSE_END
   7 .\"
   8 .\"*******************************************************************
   9 .\"
  10 .\" This file was generated with po4a. Translate the source file.
  11 .\"
  12 .\"*******************************************************************
  13 .TH SETNS 2 2013\-01\-01 Linux "Linux Programmer's Manual"
  14 .SH 名前
  15 setns \- スレッドに名前空間を関連付けしなおす
  16 .SH 書式
  17 .nf
  18 \fB#define _GNU_SOURCE\fP             /* feature_test_macros(7) 参照 */
  19 \fB#include <sched.h>\fP
  20 .sp
  21 \fBint setns(int \fP\fIfd\fP\fB, int \fP\fInstype\fP\fB);\fP
  22 .fi
  23 .SH 説明
  24 名前空間を参照するファイルディスクリプタを指定すると、
  25 呼び出したスレッドにその名前空間を関連付けしなおす。
  26
  27 \fIfd\fP 引き数は、 \fI/proc/[pid]/ns/\fP ディレクトリ内の名前空間エントリ
  28 のいずれかを参照するファイルディスクリプタである。
  29 \fI/proc/[pid]/ns/\fP の詳細は \fBproc\fP(5) を参照。
  30 \fInstype\fP 引き数で指定された制限の範囲内で、
  31 呼び出したスレッドに \fIfd\fP に対応する名前空間を関連付けしなおす。
  32
  33 \fInstype\fP 引き数は、呼び出したスレッドがどのタイプの名前空間を
  34 関連付けしなおすことができるかを指定する。
  35 この引き数には以下のいずれかの値を指定できる。
  36 .TP
  37 \fB0\fP
  38 どのタイプの名前空間も関連付けることができる。
  39 .TP
  40 \fBCLONE_NEWIPC\fP
  41 \fIfd\fP は IPC 名前空間を参照していなければならない。
  42 .TP
  43 \fBCLONE_NEWNET\fP
  44 \fIfd\fP はネットワーク名前空間を参照していなければならない。
  45 .TP
  46 \fBCLONE_NEWUTS\fP
  47 \fIfd\fP は UTS 名前空間を参照していなければならない。
  48 .PP
  49 呼び出し側が \fIfd\fP がどのタイプの名前空間を参照しているかを知っている
  50 (もしくは気にする必要がない) 場合には、 \fInstype\fP に 0 を指定すれば十分
  51 である。呼び出し側が \fIfd\fP がどのタイプの名前空間を参照しているかを
  52 知っておらず、かつ、特定のタイプの名前空間であることを保証したい場合、
  53 \fInstype\fP に 0 以外の値を指定するとよい。 (ファイルディスクリプタが別の
  54 プロセスによりオープンされ、例えば、UNIX ドメインソケット経由で呼び出し
  55 側に渡された場合などでは、呼び出し側が \fIfd\fP がどのタイプの名前空間を
  56 参照しているかを知らない可能性がある。)
  57 .SH 返り値
  58 成功すると \fIsetns\fP() は 0 を返す。
  59 失敗すると、 \-1 が返され、 \fIerrno\fP にエラーを示す値が設定される。
  60 .SH エラー
  61 .TP
  62 \fBEBADF\fP
  63 \fIfd\fP が有効なファイルディスクリプタではない。
  64 .TP
  65 \fBEINVAL\fP
  66 \fIfd\fP が \fInstype\fP で指定されたタイプと一致しない名前空間を参照している。
  67 または、指定された名前空間をそのスレッドに関連付けし直す際に問題
  68 があった。
  69 .TP
  70 \fBENOMEM\fP
  71 指定された名前空間に変更するのに必要なメモリが割り当てられない。
  72 .TP
  73 \fBEPERM\fP
  74 呼び出したスレッドがこの操作を行うのに必要な特権 (\fBCAP_SYS_ADMIN\fP) を
  75 持っていなかった。
  76 .SH バージョン
  77 \fBsetns\fP() システムコールはカーネル 3.0 で Linux に初めて登場した。
  78 ライブラリによるサポートは glibc バージョン 2.14 を追加された。
  79 .SH 準拠
  80 \fBsetns\fP() システムコールは Linux 固有である。
  81 .SH 注意
  82 新しいスレッドが \fBclone\fP(2) を使って作成された際に共有できる全ての属性を、
  83 \fBsetns\fP() を使って変更できるわけではない。
  84 .SH 例
  85 以下のプログラムは 2 つ以上の引き数を取る。 最初の引き数には、 既存の \fI/proc/[pid]/ns/\fP
  86 ディレクトリの名前空間ファイルのパス名を指定する。 残りの引き数は、コマンドとその引き数を指定する。 このプログラムは名前空間ファイルをオープンし、
  87 \fBsetns\fP() を使って名前空間に参加し、 指定されたコマンドをその名前空間内で実行する。
  88
  89 以下のシェルセッションでは、 このプログラム (\fIns_exec\fP という名前のバイナリとしてコンパイルされている)を、 \fBclone\fP(2)
  90 のマニュアルページの \fBCLONE_NEWUTS\fP のサンプルプログラムと組み合わせて使っている。
  91
  92 まず、 \fBclone\fP(2) のサンプルプログラムをバックグラウンドで実行する。 このプログラムは、 別の UTS 名前空間で子プロセスを作成する。
  93 子プロセスは自分の名前空間内でホスト名を変更する。 それから、 親プロセスと子プロセスの両方でそれぞれの UTS 名前空間のホスト名を表示し、 2
  94 つのホスト名が違うことが確認できる。
  95
  96 .nf
  97 .in +4n
  98 $ \fBsu\fP                   # 名前空間の操作には特権が必要
  99 Password:
 100 # \fB./newuts bizarro &\fP
 101 [1] 3549
 102 clone() returned 3550
 103 uts.nodename in child:  bizarro
 104 uts.nodename in parent: antero
 105 # \fBuname \-n\fP             # シェルでホスト名を確認
 106 antero
 107 .in
 108 .fi
 109
 110 次に、以下のプログラムを使ってシェルを実行する。
 111 このシェルの中では、ホスト名が最初のプログラムで作成された子プロセスが設定したホスト名になっていることを確認できる。
 112
 113 .nf
 114 .in +4n
 115 # \fB./ns_exec /proc/3550/ns/uts /bin/bash\fP
 116 # \fBuname \-n\fP             #  ns_exec で起動されたシェル内で実行
 117 bizarro
 118 .in
 119 .fi
 120 .SS プログラムのソース
 121 .nf
 122 #define _GNU_SOURCE
 123 #include <fcntl.h>
 124 #include <sched.h>
 125 #include <unistd.h>
 126 #include <stdlib.h>
 127 #include <stdio.h>
 128
 129 #define errExit(msg)    do { perror(msg); exit(EXIT_FAILURE); \e
 130                         } while (0)
 131
 132 int
 133 main(int argc, char *argv[])
 134 {
 135     int fd;
 136
 137     if (argc < 3) {
 138         fprintf(stderr, "%s /proc/PID/ns/FILE cmd args...\en", argv[0]);
 139         exit(EXIT_FAILURE);
 140     }
 141
 142     fd = open(argv[1], O_RDONLY);   /* 名前空間のディスクリプタを取得 */
 143     if (fd == \-1)
 144         errExit("open");
 145
 146     if (setns(fd, 0) == \-1)         /* 名前空間に参加 */
 147         errExit("setns");
 148
 149     execvp(argv[2], &argv[2]);      /* 名前空間内でコマンドを実行 */
 150     errExit("execvp");
 151 }
 152 .fi
 153 .SH 関連項目
 154 \fBclone\fP(2), \fBfork\fP(2), \fBvfork\fP(2), \fBproc\fP(5), \fBunix\fP(7)
 155 .SH この文書について
 156 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
 157 である。プロジェクトの説明とバグ報告に関する情報は
 158 http://www.kernel.org/doc/man\-pages/ に書かれている。