.TH "kitten-query-terminal" "1" "Jul 30, 2026" "0.48.2" "kitten Manual"
.SH "نام (NAME)"
kitten-query-terminal \- پرس‌وجوی ترمینال برای قابلیت‌های گوناگون
.SH "نحوه استفاده (USAGE)"
.SY "kitten query-terminal [options] [query1 query2 ...]"
.YS
.SH "توضیحات (DESCRIPTION)"
ترمینالی را که این kitten در آن اجرا می‌شود برای قابلیت‌های گوناگون پرس‌وجو می‌کند. این دستور کدهای گریز (escape codes) را به ترمینال ارسال کرده و بر اساس پاسخ آن، داده‌های مربوط به قابلیت‌های پشتیبانی‌شده را چاپ می‌کند. توجه داشته باشید که این یک عملیات مسدودکننده (blocking) است، زیرا باید منتظر پاسخی از سوی ترمینال بماند. می‌توانید بیشینه زمان انتظار را از طریق گزینه \-\-wait\-for کنترل کنید.

خروجی به صورت خطوطی با این ساختار است::


    query: data

اگر پرس‌وجوی خاصی توسط نسخه در حال اجرای kitty پشتیبانی نشود، داده خالی خواهد بود.

توجه داشته باشید هنگام فراخوانی این دستور از برنامه‌ای دیگر، بسیار دقت کنید تا پیش از خروج این kitten، هیچ عملیات ورودی/خروجی (I/O) روی دستگاه ترمینال انجام ندهید.

پرس‌وجوهای موجود عبارتند از:

name:
  نام ترمینال (مانند xterm\-kitty)

version:
  نسخه ترمینال (مانند 0.48.2)

allow_hyperlinks:
  گزینه پیکربندی 
.B allow_hyperlinks
در 
.I kitty.conf
برای مجاز بودن ابرپیوندها؛ می‌تواند yes، no یا ask باشد

font_family:
  نام PostScript قلم فعلی

bold_font:
  نام PostScript قلم پررنگ (bold) فعلی

italic_font:
  نام PostScript قلم مایل (italic) فعلی

bold_italic_font:
  نام PostScript قلم پررنگ\-مایل (bold\-italic) فعلی

font_size:
  اندازه قلم فعلی بر حسب pt

dpi_x:
  مقدار DPI فعلی در محور x

dpi_y:
  مقدار DPI فعلی در محور y

foreground:
  رنگ پیش‌زمینه فعلی به صورت یک کد رنگ ۲۴ بیتی با #

background:
  رنگ پس‌زمینه فعلی به صورت یک کد رنگ ۲۴ بیتی با #

background_opacity:
  میزان کدر بودن (opacity) پس‌زمینه فعلی به صورت عددی بین 0 و 1

clipboard_control:
  گزینه پیکربندی 
.B clipboard_control
در 
.I kitty.conf
برای اجازه خواندن/نوشتن از/به کلیپ‌بورد

os_name:
  نام سیستم‌عاملی که ترمینال روی آن در حال اجرا است. kitty این مقادیر را برمی‌گرداند: bsd، linux، macos، unknown




.SH "گزینه‌ها (OPTIONS)"
.TP
.BI "--wait-for" " [=10]"
مدت زمان (بر حسب ثانیه) برای انتظار جهت دریافت پاسخ از ترمینال، پس از پرس‌وجوی آن.
.TP
.BI "--help, -h" " [=no]"
نمایش راهنما برای این دستور