Debian Codegraph @

doc/ja/lxc-execute.sgml.in

raw
1 <!-- SPDX-License-Identifier: LGPL-2.1+ -->
2
3 <!DOCTYPE refentry PUBLIC @docdtd@ [
4
5 <!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">
6 <!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
7 ]>
8
9 <refentry>
10
11 <docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>
12
13 <refmeta>
14 <refentrytitle>lxc-execute</refentrytitle>
15 <manvolnum>1</manvolnum>
16 </refmeta>
17
18 <refnamediv>
19 <refname>lxc-execute</refname>
20
21 <refpurpose>
22 <!--
23 run an application inside a container.
24 -->
25 コンテナ内でのアプリケーションの実行
26 </refpurpose>
27 </refnamediv>
28
29 <refsynopsisdiv>
30 <cmdsynopsis>
31 <command>lxc-execute</command>
32 <arg choice="req">-n <replaceable>name</replaceable></arg>
33 <arg choice="opt">-d</arg>
34 <arg choice="opt">-f <replaceable>config_file</replaceable></arg>
35 <arg choice="opt">-s KEY=VAL</arg>
36 <arg choice="opt">-u, --uid <replaceable>uid</replaceable></arg>
37 <arg choice="opt">-g, --gid <replaceable>gid</replaceable></arg>
38 <arg choice="opt">-- <replaceable>command</replaceable></arg>
39 </cmdsynopsis>
40 </refsynopsisdiv>
41
42 <refsect1>
43 <title><!-- Description -->説明</title>
44
45 <para>
46 <!--
47 <command>lxc-execute</command> runs the specified
48 <replaceable>command</replaceable> inside the container
49 specified by <replaceable>name</replaceable>.
50 -->
51 <command>lxc-execute</command> は指定した <replaceable>command</replaceable> を、<replaceable>name</replaceable> で指定したコンテナ内で実行します。
52 </para>
53 <para>
54 <!--
55 It will setup the container
56 according to the configuration previously defined with the
57 lxc-create command or with the configuration file parameter.
58 If no configuration is
59 defined, the default isolation is used.
60 -->
61 このコマンドは、lxc-create コマンドであらかじめ定義した設定、もしくはパラメータとして与えた設定ファイルを元にコンテナをセットアップします。
62 もし設定が定義されていない場合、デフォルトの隔離を使用します。
63 </para>
64 <para>
65 <!--
66 This command is mainly used when you want to quickly launch an
67 application in an isolated environment.
68 -->
69 このコマンドは主に、素早く単一のアプリケーションを隔離された環境で動作させたい時に使います。
70 </para>
71 <para>
72 <!--
73 <command>lxc-execute</command> command will run the
74 specified command into the container via an intermediate
75 process, <command>lxc-init</command>.
76 This lxc-init after launching the specified command,
77 will wait for its end and all other reparented processes.
78 (to support daemons in the container).
79 In other words, in the
80 container, <command>lxc-init</command> has the pid 1 and the
81 first process of the application has the pid 2.
82 -->
83 <command>lxc-execute</command> は、<command>lxc-init</command> を間にはさんで、コンテナ内で特定のコマンドを実行します。
84 lxc-init は、指定されたコマンドが実行された後は、そのコマンドの終了と、そのコマンドから生成された全てのプロセスの終了を待ちます (これにより、コンテナ内でデーモンのサポートが可能になります)。
85 言いかえると、コンテナ内では <command>lxc-init</command> が pid 1 となり、アプリケーションの最初のプロセスの pid が 2 となります。
86 </para>
87 <para>
88 <!--
89 The above <command>lxc-init</command> is designed to forward received
90 signals to the started command.
91 -->
92 前述の <command>lxc-init</command> は、受け取ったシグナルを開始したコマンドに送るように設計されています。
93 </para>
94 </refsect1>
95
96 <refsect1>
97 <title><!-- Options -->オプション</title>
98 <variablelist>
99
100 <varlistentry>
101 <term>
102 <option>-f, --rcfile <replaceable>config_file</replaceable></option>
103 </term>
104 <listitem>
105 <para>
106 <!--
107 Specify the configuration file to configure the virtualization
108 and isolation functionalities for the container.
109 -->
110 コンテナに設定したい仮想化および隔離機能の設定を行う設定ファイルを指定します。
111 </para>
112 <para>
113 <!--
114 This configuration file if present will be used even if there is
115 already a configuration file present in the previously created
116 container (via lxc-create).
117 -->
118 もしコンテナ作成前に (lxc-create によって) あらかじめ設定ファイルが指定されている場合であっても、指定した設定ファイルが使われます。
119 </para>
120 </listitem>
121 </varlistentry>
122 <varlistentry>
123 <term>
124 <option>-s, --define <replaceable>KEY=VAL</replaceable></option>
125 </term>
126 <listitem>
127 <para>
128 <!--
129 Assign value <replaceable>VAL</replaceable> to configuration
130 variable <replaceable>KEY</replaceable>. This overrides any
131 assignment done in <replaceable>config_file</replaceable>.
132 -->
133 設定変数 <replaceable>KEY</replaceable> の値を <replaceable>VAL</replaceable> に設定します。この設定は <replaceable>config_file</replaceable> で設定された値を上書きします。
134 </para>
135 </listitem>
136 </varlistentry>
137
138 <varlistentry>
139 <term>
140 <option>-d, --daemon</option>
141 </term>
142 <listitem>
143 <para>
144 <!--
145 Run the container as a daemon. As the container has no
146 more tty, if an error occurs nothing will be displayed,
147 the log file can be used to check the error.
148 -->
149 コンテナをデーモンとして実行します。コンテナには TTY がありませんので、エラーが発生した場合は何も表示されません。エラーのチェックにはログファイルを使用すると良いでしょう。
150 </para>
151 </listitem>
152 </varlistentry>
153
154 <varlistentry>
155 <term>
156 <option>-u, --uid <replaceable>uid</replaceable></option>
157 </term>
158 <listitem>
159 <para>
160 <!--
161 Executes the <replaceable>command</replaceable> with user ID (use numerical value)
162 <replaceable>uid</replaceable> inside the container.
163 -->
164 コンテナ内で、ユーザ ID <replaceable>uid</replaceable> で <replaceable>command</replaceable> を実行します(数値で指定)。
165 </para>
166 </listitem>
167 </varlistentry>
168
169 <varlistentry>
170 <term>
171 <option>--g, --gid <replaceable>gid</replaceable></option>
172 </term>
173 <listitem>
174 <para>
175 <!--
176 Executes the <replaceable>command</replaceable> with group ID (use numerical value)
177 <replaceable>gid</replaceable> inside the container.
178 -->
179 コンテナ内で、グループ ID <replaceable>gid</replaceable> で <replaceable>command</replaceable> を実行します(数値で指定)。
180 </para>
181 </listitem>
182 </varlistentry>
183
184 <varlistentry>
185 <term><option>--</option></term>
186 <listitem>
187 <para>
188 <!--
189 Signal the end of options and disables further option
190 processing. Any arguments after the &#045;&#045; are treated as
191 arguments to <replaceable>command</replaceable>.
192 -->
193 オプション指定の最後の印で、それ以上のオプションの処理を止めます。
194 -- の後の引数は実行する <replaceable>command</replaceable> の引数として扱われます。
195 </para>
196 <para>
197 <!--
198 This option is useful when you want specify options
199 to <replaceable>command</replaceable> and don't want
200 <command>lxc-execute</command> to interpret them.
201 -->
202 このオプションは、<replaceable>command</replaceable> にオプションを指定したいときに、<command>lxc-execute</command> がそのオプションを読み取ってほしくないときに役に立ちます。
203 </para>
204 </listitem>
205 </varlistentry>
206
207 </variablelist>
208
209 </refsect1>
210
211 &commonoptions;
212
213 <refsect1>
214 <title><!-- Diagnostic -->診断</title>
215
216 <variablelist>
217
218 <varlistentry>
219 <term>The container is busy</term>
220 <listitem>
221 <para>
222 <!--
223 The specified container is already running an
224 application. You should stop it before reuse this
225 container or create a new one.
226 -->
227 指定したコンテナが既にアプリケーションを実行中の場合。コンテナを再使用したり、新しく作成する前にコンテナを止める必要があります。
228 </para>
229 </listitem>
230 </varlistentry>
231
232 </variablelist>
233
234 </refsect1>
235
236 &seealso;
237
238 </refentry>
239
240 <!-- Keep this comment at the end of the file
241 Local variables:
242 mode: sgml
243 sgml-omittag:t
244 sgml-shorttag:t
245 sgml-minimize-attributes:nil
246 sgml-always-quote-attributes:t
247 sgml-indent-step:2
248 sgml-indent-data:t
249 sgml-parent-document:nil
250 sgml-default-dtd-file:nil
251 sgml-exposed-tags:nil
252 sgml-local-catalogs:nil
253 sgml-local-ecat-files:nil
254 End:
255 -->