'\" t
.\"     Title: setterm
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-05-18
.\"    Manual: أوامر المستخدم
.\"    Source: util-linux 2.42.1
.\"  Language: English
.\"
.TH "SETTERM" "1" "2026-05-18" "util\-linux 2.42.1" "أوامر المستخدم"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "الاسم"
setterm \- ضبط سمات الطرفية
.SH "موجز"
.sp
\fBsetterm\fP [خيارات]
.SH "الوصف"
.sp
يكتب \fBsetterm\fP إلى المخرجات القياسية سلسلة محارف تستدعي إمكانيات الطرفية المحددة. حيثما أمكن، يُستشار \fIterminfo\fP للعثور على السلسلة المستخدمة. بعض الخيارات (المعلمة بـ "وحدات التحكم الافتراضية فقط" أدناه) لا تتوافق مع إمكانيات \fBterminfo\fP(5). في هذه الحالات، إذا كان نوع الطرفية هو "con" أو "linux"، فستُخرج السلسلة التي تستدعي الإمكانية المحددة على وحدة التحكم الافتراضية PC Minix. تُتجاهل الخيارات التي لا تدعمها الطرفية.
.SH "الخيارات"
.sp
للخيارات المنطقية (\fBon\fP أو \fBoff\fP)، الوضع المبدئي هو \fBon\fP.
.sp
أدناه، يمكن أن يكون \fI8\-color\fP هو \fBblack\fP، \fBred\fP، \fBgreen\fP، \fByellow\fP، \fBblue\fP، \fBmagenta\fP، \fBcyan\fP، أو \fBwhite\fP.
.sp
يمكن أن يكون \fI16\-color\fP هو \fI8\-color\fP، أو \fBgrey\fP، أو \fBbright\fP متبوعاً بـ \fBred\fP، \fBgreen\fP، \fByellow\fP، \fBblue\fP، \fBmagenta\fP، \fBcyan\fP، أو \fBwhite\fP.
.sp
يمكن ضبط خيارات الألوان المتنوعة بشكل مستقل، على الأقل في وحدات التحكم الافتراضية، على الرغم من أن نتائج ضبط أوضاع متعددة (على سبيل المثال، \fB\-\-underline\fP و \fB\-\-half\-bright\fP) تعتمد على العتاد.
.sp
يوصى باستخدام الوسائط الاختيارية مع علامة \*(Aq=\*(Aq (علامة التساوي) وليس مسافة بين الخيار والوسيط. على سبيل المثال \-\-option=argument. يمكن لـ \fBsetterm\fP تفسير الوسيط التالي الذي ليس خياراً كوسيط اختياري أيضاً.
.sp
\fB\-\-appcursorkeys\fP \fBon\fP|\fBoff\fP
.RS 4
يضبط وضع تطبيق مفتاح المؤشر على التشغيل أو الإيقاف. عند التشغيل، ستُرسل ESC O A و ESC O B وما إلى ذلك لمفاتيح المؤشر بدلاً من ESC [ A و ESC [ B وما إلى ذلك. راجع قسم \fIvi and Cursor\-Keys\fP في \fIText\-Terminal\-HOWTO\fP لمعرفة كيف يمكن أن يسبب هذا مشاكل لمستخدمي \fBvi\fP. وحدات التحكم الافتراضية فقط.
.RE
.sp
\fB\-\-append\fP \fIرقم_الطرفية\fP
.RS 4
مثل \fB\-\-dump\fP، ولكن يلحق بملف اللقطة بدلاً من الكتابة فوقه. يعمل فقط إذا لم تُعطَ أي خيارات \fB\-\-dump\fP.
.RE
.sp
\fB\-\-background\fP \fI8\-color\fP|\fBdefault\fP
.RS 4
يضبط لون خلفية النص.
.RE
.sp
\fB\-\-blank\fP[\fB=0\fP\-\fB60\fP|\fBforce\fP|\fBpoke\fP]
.RS 4
يضبط فاصل عدم النشاط، بالدقائق، والذي سيتم بعده إخلاء الشاشة آلياً (باستخدام APM إذا كان متاحاً). دون وسيط، فإنه يحصل على حالة الإخلاء (يعيد أي vt أُخليت، أو صفراً لـ vt غير مخلاة). وحدات التحكم الافتراضية فقط.
.sp
وسيط \fBforce\fP يبقي الشاشة مخلاة حتى لو ضُغط على مفتاح.
.sp
وسيط \fBpoke\fP يلغي إخلاء الشاشة.
.RE
.sp
\fB\-\-bfreq\fP[\fB=\fP\fIرقم\fP]
.RS 4
يضبط تردد الجرس بالهيرتز. دون وسيطة، القيمة المبدئية هي \fB0\fP. للمحطات الطرفية الافتراضية فقط.
.RE
.sp
\fB\-\-blength\fP[\fB=0\fP\-\fB2000\fP]
.RS 4
يضبط مدة الجرس بالملي ثانية. دون وسيطة، القيمة المبدئية هي \fB0\fP. للمحطات الطرفية الافتراضية فقط.
.RE
.sp
\fB\-\-blink\fP \fBon\fP|\fBoff\fP
.RS 4
يُفعل وضع الوميض أو يعطله. باستثناء المحطة الطرفية الافتراضية، يؤدي الخيار \fB\-\-blink off\fP إلى تعطيل كافة السمات (الخط العريض، نصف السطوع، الوميض، العكسي).
.RE
.sp
\fB\-\-bold\fP \fBon\fP|\fBoff\fP
.RS 4
يُفعل وضع الخط العريض (السطوع الزائد) أو يعطله. باستثناء المحطة الطرفية الافتراضية، يؤدي الخيار \fB\-\-bold off\fP إلى تعطيل كافة السمات (الخط العريض، نصف السطوع، الوميض، العكسي).
.RE
.sp
\fB\-\-clear\fP[\fB=all\fP|\fBrest\fP]
.RS 4
دون وسيط أو مع الوسيط \fBall\fP، تُمسح الشاشة بأكملها ويُعاد المؤشر إلى الموضع الرئيسي، تماماً كما يفعل أمر \fBclear\fP(1). مع الوسيط \fBrest\fP، تُمسح الشاشة من موضع المؤشر الحالي وحتى النهاية.
.RE
.sp
\fB\-\-clrtabs\fP[\fB=\fP\fItab1 tab2 tab3\fP .\|.\|.]
.RS 4
يمسح علامات الجدولة من مواضع المؤشر الأفقية المعطاة، في النطاق \fB1\fP\-\fB160\fP. دون وسيطات، يمسح كافة علامات الجدولة. للمحطات الطرفية الافتراضية فقط.
.RE
.sp
\fB\-\-cursor\fP \fBon\fP|\fBoff\fP
.RS 4
يشغل مؤشر الطرفية أو يطفئه.
.RE
.sp
\fB\-\-default\fP
.RS 4
يضبط خيارات صيرورة الطرفية إلى القيم المبدئية.
.RE
.sp
\fB\-\-dump\fP[\fB=\fP\fIرقم_الطرفية\fP]
.RS 4
يكتب لقطة للمحطة الطرفية الافتراضية ذات الرقم المعطى في الملف المحدد عبر الخيار \fB\-\-file\fP، مع استبدال محتوياته؛ الملف المبدئي هو \fIscreen.dump\fP. دون وسيطة، يُفرغ محتوى المحطة الطرفية الافتراضية الحالية. هذا يتجاوز الخيار \fB\-\-append\fP.
.RE
.sp
\fB\-\-file\fP \fIاسم_ملف\fP
.RS 4
يضبط اسم ملف اللقطة لأي من خيارات \fB\-\-dump\fP أو \fB\-\-append\fP في نفس سطر الأوامر. إذا لم يتوفر هذا الخيار، فإن القيمة المبدئية هي \fIscreen.dump\fP في المجلد الحالي. سيُبتر اسم المسار الذي يتجاوز الحد الأقصى للنظام، راجع \fBPATH_MAX\fP في \fIlinux/limits.h\fP لمعرفة القيمة.
.RE
.sp
\fB\-\-foreground\fP \fI8\-color\fP|\fBdefault\fP
.RS 4
يضبط لون نص الواجهة.
.RE
.sp
\fB\-\-half\-bright\fP \fBon\fP|\fBoff\fP
.RS 4
يُشغل وضع الخفوت (نصف السطوع) أو يوقفه. باستثناء الطرفية الافتراضية، يوقف \fB\-\-half\-bright off\fP كل السمات (الخط العريض، ونصف السطوع، والوميض، والمعكوس).
.RE
.sp
\fB\-\-hbcolor\fP \fI16\-color\fP
.RS 4
يضبط لون المحارف بنصف السطوع.
.RE
.sp
\fB\-\-initialize\fP
.RS 4
يعرض سلسلة تهيئة الطرفية، والتي تضبط عادةً خيارات إخراج الطرفية، والسمات الأخرى إلى القيم المبدئية.
.RE
.sp
\fB\-\-inversescreen\fP \fBon\fP|\fBoff\fP
.RS 4
يقلب ألوان الواجهة والخلفية للشاشة بأكملها.
.RE
.sp
\fB\-\-linewrap\fP \fBon\fP|\fBoff\fP
.RS 4
يجعل الطرفية تستمر في سطر جديد عندما يمتلئ السطر.
.RE
.sp
\fB\-\-msg\fP \fBon\fP|\fBoff\fP
.RS 4
يُفعل أو يُعطل إرسال رسائل \fBprintk\fP() الخاصة بالنواة إلى الكونسول. للطرفيات الافتراضية فقط.
.RE
.sp
\fB\-\-msglevel\fP \fB0\fP\-\fB8\fP
.RS 4
يضبط مستوى تسجيل الكونسول لرسائل \fBprintk\fP(9) الخاصة بالنواة. ستُطبع كل الرسائل التي تزيد أهميتها عن هذا المستوى، لذا فإن مستوى التسجيل \fB0\fP له نفس تأثير \fB\-\-msg on\fP ومستوى التسجيل \fB8\fP سيطبع كل رسائل النواة. قد يكون \fBklogd\fP(8) واجهة أكثر ملاءمة لتسجيل رسائل النواة.
.sp
للطرفيات الافتراضية فقط.
.RE
.sp
\fB\-\-powerdown\fP[\fB=0\fP\-\fB60\fP]
.RS 4
يضبط فاصل إيقاف الطاقة VESA بالدقائق. دون معطى، يكون المبدئي هو \fB0\fP (تعطيل إيقاف الطاقة). إذا كانت الشاشة فارغة أو في وضع التعليق، فستنتقل الشاشة إلى وضع تعليق vsync أو وضع إيقاف الطاقة على التوالي بعد انقضاء هذه المدة الزمنية.
.RE
.sp
\fB\-\-powersave\fP \fIوضع\fP
.RS 4
القيم الصالحة لـ \fIوضع\fP هي:
.sp
\fBvsync\fP|\fBon\fP
.RS 4
يضع الشاشة في وضع تعليق VESA vsync.
.RE
.sp
\fBhsync\fP
.RS 4
يضع الشاشة في وضع تعليق VESA hsync.
.RE
.sp
\fBpowerdown\fP
.RS 4
يضع الشاشة في وضع إيقاف الطاقة VESA.
.RE
.sp
\fBoff\fP
.RS 4
يوقف ميزات توفير الطاقة في الشاشة.
.RE
.RE
.sp
\fB\-\-regtabs\fP[\fB=1\fP\-\fB160\fP]
.RS 4
يمسح كل علامات الجدولة، ثم يضبط نمط علامات جدولة منتظم، مع علامة واحدة كل عدد محدد من المواضع. دون معطى، يكون المبدئي \fB8\fP. للطرفيات الافتراضية فقط.
.RE
.sp
\fB\-\-repeat\fP \fBon\fP|\fBoff\fP
.RS 4
يُشغل تكرار لوحة المفاتيح أو يوقفه. للطرفيات الافتراضية فقط.
.RE
.sp
\fB\-\-reset\fP
.RS 4
يعرض سلسلة إعادة ضبط الطرفية، والتي تعيد الطرفية عادةً إلى حالة التشغيل الأولى.
.RE
.sp
\fB\-\-resize\fP
.RS 4
أُعيد ضبط حجم الطرفية عبر تقييم الحد الأقصى للصف والعمود. هذا مفيد عندما لا يكون التخطيط الفعلي وسائق طرفية النواة متزامنين. أبرز حالات الاستخدام هي مع الكونسول التسلسلي، الذي لا يستخدم \fBioctl\fP(2) بل مجرد تدفقات بايتات وفواصل.
.RE
.sp
\fB\-\-reverse\fP \fBon\fP|\fBoff\fP
.RS 4
يُشغل وضع الفيديو المعكوس أو يوقفه. باستثناء الطرفية الافتراضية، يوقف \fB\-\-reverse off\fP كل السمات (الخط العريض، ونصف السطوع، والوميض، والمعكوس).
.RE
.sp
\fB\-\-store\fP
.RS 4
يخزن خيارات إخراج الطرفية الحالية (ألوان الواجهة والخلفية) لتكون القيم المستخدمة عند إعادة الضبط للمبدئي. للطرفيات الافتراضية فقط.
.RE
.sp
\fB\-\-tabs\fP[\fB=\fP\fItab1 tab2 tab3\fP .\|.\|.]
.RS 4
يضبط علامات الجدولة عند مواضع المؤشر الأفقية المعطاة، في النطاق \fB1\fP\-\fB160\fP. دون معطيات، يعرض إعدادات علامات الجدولة الحالية.
.RE
.sp
\fB\-\-term\fP \fIاسم_الطرفية\fP
.RS 4
يتجاوز متغير البيئة \fBTERM\fP.
.RE
.sp
\fB\-\-ulcolor\fP \fI16\-color\fP
.RS 4
يضبط لون المحارف التي تحتها خط. للطرفيات الافتراضية فقط.
.RE
.sp
\fB\-\-underline\fP \fBon\fP|\fBoff\fP
.RS 4
يُشغل وضع التسطير أو يوقفه.
.RE
.sp
\fB\-\-help\fP
.RS 4
اعرض نص المساعدة ثم اخرج.
.RE
.sp
\fB\-\-version\fP
.RS 4
اعرض الإصدار واخرج.
.RE
.SH "تحذير"
.sp
قد يؤدي استخدام \fBsetterm\fP مع إعادة توجيه stdout إلى نتائج غير متوقعة، لأن بعض الخيارات تعمل على stdin. لمنع المشكلات، أعد توجيه كل من stdin وstdout دائماً إلى نفس الجهاز.
.SH "التوافقية"
.sp
منذ الإصدار 2.25، يدعم \fBsetterm\fP الخيارات الطويلة بشرطتين، مثل \fB\-\-help\fP، بجانب الخيارات الطويلة التاريخية بشرطة واحدة، مثل \fB\-help\fP. في السكربتات، يُفضل استخدام الشرطة الواحدة المتوافقة مع الإصدارات السابقة بدلاً من الشرطة المزدوجة. حالياً لا توجد خطط ولا أسباب وجيهة لإيقاف التوافق مع الشرطة الواحدة.
.SH "العلل"
.sp
الفروقات بين نسختي Minix و لينكس غير موثقة.
.SH "انظر أيضاً"
.sp
\fBstty\fP(1)، \fBtput\fP(1)، \fBtty\fP(4)، \fBterminfo\fP(5)
.SH "التبليغ عن الأخطاء"
.sp
لتقارير العِلل، استخدم \c
.URL "https://github.com/util\-linux/util\-linux/issues" "مُتتبع المشكلات" "."
.SH "التوفر"
.sp
الأمر \fBsetterm\fP جزء من حزمة util\-linux التي يمكن تنزيلها من \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "أرشيف نواة لينكس" "."