.\" -*- coding: UTF-8 -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH lxc-console 1 2024-09-16 "" ""
.SH NAME
lxc-console \- 指定したコンテナのコンソールの起動 
.SH SYNOPSIS
'nh
.fi
.ad l
\fBlxc-console\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
{-n \fIname\fR} [-e \fIescape character\fR] [-t \fIttynum\fR]
'in \n(.iu-\nxu
.ad b
'hy
.SH 説明
パラメータで指定したコンテナで tty サービスが設定され、利用可能である場合、このコマンドはコンテナにログイン出来るコンソールを起動します。
.PP
利用可能な tty は、このコマンドが取得した空いている tty です。
これは、コンテナに 4 つの利用可能な tty がある場合、コマンドは 4 個までそれぞれ異なる tty を取得して開きます。5 回目のコマンドは利用可能なコンソールがないため、失敗します。
.PP
コマンドは tty に接続します。
もし、接続が失われたり、切断された場合、コマンドは再度起動し、切断前の状態で tty の再取得をしようとします。
.PP
\fIttynum\fR を 0 に設定すると、dev/tty<\fIttynum\fR>の代わりにコンテナの /dev/console に接続します。
.PP
tty からの接続を切断し、lxc-console を抜ける時に、キーボードのエスケープシーケンスを使います。
デフォルトのエスケープシーケンスは <Ctrl+a q> です。
.SH オプション
.TP 
\*(T<\fB\-e, \-\-escape \fR\*(T>\fIescape character\fR 
<Ctrl a> の代わりに使用するエスケープシーケンスのプレフィックスを指定します。
これは '^文字' または単なる '文字' で指定します。
例えば、<Ctrl+b q> をエスケープシーケンスとして使うには -e '^b' とします。
.TP 
\*(T<\fB\-t, \-\-tty \fR\*(T>\fIttynum\fR 
接続する tty の番号か、コンソールに接続するために 0 を指定します。
指定しない場合は、次に利用可能な tty 番号を自動的にコンテナが選択します。
.SH 共通オプション
ここで紹介するオプションは lxc コマンドの大部分で共通のものです。
.TP 
\*(T<\fB\-?, \-h, \-\-help\fR\*(T>
通常より長い使い方のメッセージを表示します。
.TP 
\*(T<\fB\-\-usage\fR\*(T>
使い方を表示します。
.TP 
\*(T<\fB\-q, \-\-quiet\fR\*(T>
出力を抑制します。
.TP 
\*(T<\fB\-P, \-\-lxcpath=\fR\*(T>\fIPATH\fR
デフォルトと別のコンテナパスを使用します。デフォルトは /var/lib/lxc です。
.TP 
\*(T<\fB\-o, \-\-logfile=\fR\*(T>\fIFILE\fR
追加のログを \fIFILE\fR に出力します。デフォルトは出力しません。
.TP 
\*(T<\fB\-l, \-\-logpriority=\fR\*(T>\fILEVEL\fR
ログの優先度を \fILEVEL\fR に設定します。デフォルトの優先度は \*(T<ERROR\*(T> です。以下の値を設定可能です:
\*(T<FATAL\*(T>, \*(T<ALERT\*(T>,
\*(T<CRIT\*(T>,
\*(T<WARN\*(T>, \*(T<ERROR\*(T>,
\*(T<NOTICE\*(T>, \*(T<INFO\*(T>,
\*(T<DEBUG\*(T>, \*(T<TRACE\*(T>。

このオプションは追加のログファイルへのイベントログの優先度の設定である事に注意してください。stderr への ERROR イベントのログには影響しません。
.TP 
\*(T<\fB\-n, \-\-name=\fR\*(T>\fINAME\fR
\fINAME\fR という名前でコンテナを識別します。コンテナ識別子のフォーマットは英数字の文字列です。
.TP 
\*(T<\fB\-\-rcfile=\fR\*(T>\fIFILE\fR
コンテナの仮想化、隔離機能の設定のための設定ファイルを指定します。

(lxc-create 経由で) 前もってコンテナが作られた際の設定ファイルが既にあった場合でも、このオプションが指定された場合は、指定した設定ファイルが使用されます。
.TP 
\*(T<\fB\-\-version\fR\*(T>
バージョン番号を表示します。
.SH 診断
.TP 
tty service denied
利用可能な tty がないか、コンソールを使うのに十分な権限がありません。
例えば、コンテナが "foo" ユーザの所有であるのに、"bar" ユーザがコンソールを開こうとしている場合などです。
.SH "SEE ALSO"
\fBlxc\fR(7),
\fBlxc-create\fR(1),
\fBlxc-copy\fR(1),
\fBlxc-destroy\fR(1),
\fBlxc-start\fR(1),
\fBlxc-stop\fR(1),
\fBlxc-execute\fR(1),
\fBlxc-console\fR(1),
\fBlxc-monitor\fR(1),
\fBlxc-wait\fR(1),
\fBlxc-cgroup\fR(1),
\fBlxc-ls\fR(1),
\fBlxc-info\fR(1),
\fBlxc-freeze\fR(1),
\fBlxc-unfreeze\fR(1),
\fBlxc-attach\fR(1),
\fBlxc.conf\fR(5)