2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoolxc: linux Container library
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo(C) Copyright IBM Corp. 2007, 2008
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae YooDaniel Lezcano <daniel.lezcano at free.fr>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae YooThis library is free software; you can redistribute it and/or
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoomodify it under the terms of the GNU Lesser General Public
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae YooLicense as published by the Free Software Foundation; either
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yooversion 2.1 of the License, or (at your option) any later version.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae YooThis library is distributed in the hope that it will be useful,
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoobut WITHOUT ANY WARRANTY; without even the implied warranty of
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae YooMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae YooLesser General Public License for more details.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae YooYou should have received a copy of the GNU Lesser General Public
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae YooLicense along with this library; if not, write to the Free Software
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae YooFoundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae YooTranslated into Korean
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yooby Sungbae Yoo <sungbae.yoo at samsung.com>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <refnamediv>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <refpurpose>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo run an application inside a container.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo </refpurpose>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo </refnamediv>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <refsynopsisdiv>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <cmdsynopsis>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <arg choice="req">-n <replaceable>name</replaceable></arg>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <arg choice="opt">-f <replaceable>config_file</replaceable></arg>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <arg choice="opt">-c <replaceable>console_device</replaceable></arg>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <arg choice="opt">-L <replaceable>console_logfile</replaceable></arg>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <arg choice="opt">-p <replaceable>pid_file</replaceable></arg>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <arg choice="opt">--share-[net|ipc|uts] <replaceable>name|pid</replaceable></arg>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo </cmdsynopsis>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo </refsynopsisdiv>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <command>lxc-start</command> runs the specified
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <replaceable>command</replaceable> inside the container
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo specified by <replaceable>name</replaceable>.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <command>lxc-start</command>는 지정된 <replaceable>command</replaceable>를 <replaceable>name</replaceable>이라는 이름의 컨테이너 내에서 실행한다.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo (역주 : 컨테이너를 시작한다)
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo It will setup the container
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo according to the configuration previously defined with the
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo lxc-create command or with the configuration file parameter.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo If no configuration is
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo defined, the default isolation is used.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo 이 명령어는 <command>lxc-create</command> 정의했던 설정을 토대로 또는 인수를 통해 넘긴 설정파일을 토대로 컨테이너를 세팅한다.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo 만약 정의된 설정이 없다면, 기본 고립 환경을 사용한다.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo If no command is specified, <command>lxc-start</command> will
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo use the command defined in lxc.init_cmd or if not set, the default
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <command>"/sbin/init"</command> command to run a system
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo 만약 명령어가 지정되지 않았다면, <command>lxc-start</command>는 lxc.init_cmd에 정의된 명령어를 사용한다. 만약 그마저도 없다면 <command>"/sbin/init"</command>명령어를 사용한다.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <variablelist>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <varlistentry>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo Run the container as a daemon. As the container has no
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo more tty, if an error occurs nothing will be displayed,
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo the log file can be used to check the error.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo 컨테이너를 데몬으로 실행한다.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo 에러가 발생하더라도 컨테이너가 tty를 가지지 않기 때문에 에러는 표시되지 않는다.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo 대신 로그 파일을 에러를 확인하는데 사용할 수 있다.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo </varlistentry>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <varlistentry>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo Run the container in the foreground. In this mode, the container
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo console will be attached to the current tty and signals will be routed
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo directly to the container.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo 컨테이너를 포그라운드로 실행한다. 이 모드에서는 컨테이너의 콘솔은 현재 tty에 붙는다. 그리고 시그널들은 컨테이너로 직접 보내지게 된다.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo </varlistentry>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <varlistentry>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <option>-p, --pidfile <replaceable>pid_file</replaceable></option>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo Create a file with the process id.
4ff8fb6cae48bc4cd376fffa70c69a7cd72425bcSungbae Yoo 프로세스 ID를 넣은 파일을 생성한다.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo (역주 : systemd의 PIDFile= 옵션 등에 유용하게 사용가능하다)
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo </varlistentry>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <varlistentry>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <option>-f, --rcfile <replaceable>config_file</replaceable></option>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo Specify the configuration file to configure the virtualization
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo and isolation functionalities for the container.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo 컨테이너의 가상화나 고립 기능을 설정할 때 쓰일 설정파일을 지정한다.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo This configuration file if present will be used even if there is
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo already a configuration file present in the previously created
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo container (via lxc-create).
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo 지정한 설정파일이 존재한다면, 이전에 생성된(lxc-create를 통해) 컨테
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo이너에 설정파일이 이미 존재한다고 하더라도 지정한 설정파일을 사용한다.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo </varlistentry>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <varlistentry>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo --console <replaceable>console_device</replaceable></option>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo Specify a device to use for the container's console, for example
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo /dev/tty8. If this option is not specified the current terminal
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo will be used unless <option>-d</option> is specified.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo 컨테이너의 콘솔로 사용할 디바이스를 지정한다. 예를 들어 /dev/tty8과 같이 지정가능하다. 만약 이 옵션이 지정되지 않았고 <option>-d</option>가 지정되이 않았다면, 현재 터미널이 사용된다.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo </varlistentry>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <varlistentry>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo --console-log <replaceable>console_logfile</replaceable></option>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo Specify a file to log the container's console output to.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo 컨테이너의 콘솔 출력을 기록할 파일을 지정한다.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo </varlistentry>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <varlistentry>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <option>-s, --define <replaceable>KEY=VAL</replaceable></option>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo Assign value <replaceable>VAL</replaceable> to configuration
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo variable <replaceable>KEY</replaceable>. This overrides any
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo assignment done in <replaceable>config_file</replaceable>.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo 지정한 설정 변수 <replaceable>KEY</replaceable>에 <replaceable>VAL</replaceable>값을 지정한다.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo 이 것은 이전에 <replaceable>config_file</replaceable>에서 지정했던 값들을 덮어쓴다.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo </varlistentry>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <varlistentry>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo --close-all-fds</option>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo If any file descriptors are inherited, close them. If this option
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo is not specified, then <command>lxc-start</command> will exit with
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo failure instead. Note: <replaceable>--daemon</replaceable> implies
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <replaceable>--close-all-fds</replaceable>.
4ff8fb6cae48bc4cd376fffa70c69a7cd72425bcSungbae Yoo 상속 받는 파일 디스크립터가 있다면, 전부 닫는다. 만약 이 옵션이 지정되지 않았을 경우 <command>lxc-start</command>는 실패와 함께 종료된다. 주의 : <replaceable>--daemon</replaceable>는 <replaceable>--close-all-fds</replaceable>를 포함하고 있다.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo </varlistentry>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <varlistentry>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <option>--share-net <replaceable>name|pid</replaceable></option>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo Inherit a network namespace from
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo a <replaceable>name</replaceable> container or
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo a <replaceable>pid</replaceable>. The network namespace
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo will continue to be managed by the original owner. The
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo network configuration of the starting container is ignored
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo and the up/down scripts won't be executed.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <replaceable>name</replaceable> 컨테이너 또는 <replaceable>pid</replaceable>로부터 네트워크 네임스페이스를 상속받는다. 네트워크 네임스페이스는 원래 소유자가 계속 관리하게 된다. 시작하는 컨테이너의 네트워크 설정은 무시되고 up/down 스크립트는 실행되지 않는다.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo </varlistentry>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <varlistentry>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <option>--share-ipc <replaceable>name|pid</replaceable></option>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo Inherit an IPC namespace from
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo a <replaceable>name</replaceable> container or
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo a <replaceable>pid</replaceable>.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <replaceable>name</replaceable> 컨테이너 또는 <replaceable>pid</replaceable>로부터 IPC 네임스페이스를 상속받는다.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo </varlistentry>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <varlistentry>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <option>--share-uts <replaceable>name|pid</replaceable></option>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo Inherit a UTS namespace from
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo a <replaceable>name</replaceable> container or
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo a <replaceable>pid</replaceable>. The starting LXC will
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo not set the hostname, but the container OS may do it
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <replaceable>name</replaceable> 컨테이너 또는 <replaceable>pid</replaceable>로부터 UTS 네임스페이스를 상속받는다. LXC는 시작할 때 호스트이름을 설정하지 않는다. 다만, 컨테이너 OS가 설정할 수 있다.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo </varlistentry>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo </variablelist>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo &commonoptions;
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <variablelist>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <varlistentry>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo The specified container is already running an
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo application. You should stop it before reuse this
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo container or create a new one.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo 지정한 컨테이너가 이미 실행중인 경우이다. 컨테이너를 사용하고 싶다면
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo 컨테이너를 중지시켜야 한다. 또는 새로운 컨테이너를 만들 수도 있다.
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo </varlistentry>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo </variablelist>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo <para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoo<!-- Keep this comment at the end of the file
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae YooLocal variables:
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoosgml-omittag:t
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoosgml-shorttag:t
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoosgml-minimize-attributes:nil
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoosgml-always-quote-attributes:t
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoosgml-indent-step:2
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoosgml-indent-data:t
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoosgml-parent-document:nil
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoosgml-default-dtd-file:nil
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoosgml-exposed-tags:nil
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoosgml-local-catalogs:nil
2b371b262f7272266ff18cc2aff65176a2c16383Sungbae Yoosgml-local-ecat-files:nil