.\" -*- 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 2026-08-01 "" ""
.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 "توضیحات (DESCRIPTION)"
اگر سرویس tty برای کانتینر مشخص‌شده به عنوان پارامتر پیکربندی شده و در دسترس باشد، این دستور یک کنسول راه‌اندازی می‌کند که امکان ورود به کانتینر را فراهم می‌سازد.
.PP
موردهای tty در دسترس، اسلات‌های آزادی هستند که توسط این دستور اشغال می‌شوند. این بدان معناست که اگر کانتینر چهار tty در دسترس داشته باشد و این دستور چهار بار اجرا شده و هر بار یک tty متفاوت را اشغال کرده باشد، اجرای پنجم با خطا مواجه خواهد شد زیرا هیچ کنسولی در دسترس نخواهد بود.
.PP
این دستور به یک tty متصل می‌شود. در صورتی که اتصال قطع یا دچار اختلال شود، دستور می‌تواند دوباره اجرا شده و tty را در همان وضعیتی که پیش از قطع اتصال بود بازیابی کند.
.PP
می‌توان مقدار 0 را برای \fIttynum\fR تعیین کرد تا به جای dev/tty<\fIttynum\fR>، به /dev/console کانتینر متصل شود.
.PP
می‌توان از یک دنباله گریز (escape sequence) صفحه‌کلید برای قطع اتصال از tty و خروج از lxc-console استفاده کرد. دنباله گریز پیش‌فرض <Ctrl+a q> است.
.SH "گزینه‌ها (OPTIONS)"
.TP 
\*(T<\fB\-e, \-\-escape \fR\*(T>\fIescape character\fR 
پیشوند دنباله گریز را برای استفاده به جای <Ctrl a> مشخص می‌کند.
این مقدار می‌تواند به صورت \(aq^letter\(aq یا فقط \(aqletter\(aq داده شود. برای مثال
جهت استفاده از <Ctrl+b q> به عنوان دنباله گریز، از \-e \(aq^b\(aq استفاده کنید.
.TP 
\*(T<\fB\-t, \-\-tty \fR\*(T>\fIttynum\fR 
شماره tty را جهت اتصال یا 0 را برای کنسول مشخص می‌کند. در صورت عدم
تعیین، شماره tty در دسترس بعدی به طور خودکار توسط کانتینر انتخاب خواهد شد.
.SH "گزینه‌های عمومی (COMMON OPTIONS)"
این گزینه‌ها بین بیشتر دستورهای 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>.

توجه داشته باشید که این گزینه اولویت رویدادهای لاگ در فایل لاگ جایگزین را تنظیم می‌کند.
این گزینه تأثیری بر رویدادهای ERROR ثبت‌شده در stderr ندارد.
.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 "خطاها (DIAGNOSTICS)"
.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)