SETTERM(1) أوامر المستخدم SETTERM(1)

الاسم

setterm - ضبط سمات الطرفية

موجز

setterm [خيارات]

الوصف

يكتب setterm إلى المخرجات القياسية سلسلة محارف تستدعي إمكانيات الطرفية المحددة. حيثما أمكن، يُستشار terminfo للعثور على السلسلة المستخدمة. بعض الخيارات (المعلمة بـ "وحدات التحكم الافتراضية فقط" أدناه) لا تتوافق مع إمكانيات terminfo(5). في هذه الحالات، إذا كان نوع الطرفية هو "con" أو "linux"، فستُخرج السلسلة التي تستدعي الإمكانية المحددة على وحدة التحكم الافتراضية PC Minix. تُتجاهل الخيارات التي لا تدعمها الطرفية.

الخيارات

للخيارات المنطقية (on أو off)، الوضع المبدئي هو on.

أدناه، يمكن أن يكون 8-color هو black، red، green، yellow، blue، magenta، cyan، أو white.

يمكن أن يكون 16-color هو 8-color، أو grey، أو bright متبوعاً بـ red، green، yellow، blue، magenta، cyan، أو white.

يمكن ضبط خيارات الألوان المتنوعة بشكل مستقل، على الأقل في وحدات التحكم الافتراضية، على الرغم من أن نتائج ضبط أوضاع متعددة (على سبيل المثال، --underline و --half-bright) تعتمد على العتاد.

يوصى باستخدام الوسائط الاختيارية مع علامة '=' (علامة التساوي) وليس مسافة بين الخيار والوسيط. على سبيل المثال --option=argument. يمكن لـ setterm تفسير الوسيط التالي الذي ليس خياراً كوسيط اختياري أيضاً.

--appcursorkeys on|off

يضبط وضع تطبيق مفتاح المؤشر على التشغيل أو الإيقاف. عند التشغيل، ستُرسل ESC O A و ESC O B وما إلى ذلك لمفاتيح المؤشر بدلاً من ESC [ A و ESC [ B وما إلى ذلك. راجع قسم vi and Cursor-Keys في Text-Terminal-HOWTO لمعرفة كيف يمكن أن يسبب هذا مشاكل لمستخدمي vi. وحدات التحكم الافتراضية فقط.

--append رقم_الطرفية

مثل --dump، ولكن يلحق بملف اللقطة بدلاً من الكتابة فوقه. يعمل فقط إذا لم تُعطَ أي خيارات --dump.

--background 8-color|default

يضبط لون خلفية النص.

--blank[=0-60|force|poke]

يضبط فاصل عدم النشاط، بالدقائق، والذي سيتم بعده إخلاء الشاشة آلياً (باستخدام APM إذا كان متاحاً). دون وسيط، فإنه يحصل على حالة الإخلاء (يعيد أي vt أُخليت، أو صفراً لـ vt غير مخلاة). وحدات التحكم الافتراضية فقط.

وسيط force يبقي الشاشة مخلاة حتى لو ضُغط على مفتاح.

وسيط poke يلغي إخلاء الشاشة.

--bfreq[=رقم]

يضبط تردد الجرس بالهيرتز. دون وسيطة، القيمة المبدئية هي 0. للمحطات الطرفية الافتراضية فقط.

--blength[=0-2000]

يضبط مدة الجرس بالملي ثانية. دون وسيطة، القيمة المبدئية هي 0. للمحطات الطرفية الافتراضية فقط.

--blink on|off

يُفعل وضع الوميض أو يعطله. باستثناء المحطة الطرفية الافتراضية، يؤدي الخيار --blink off إلى تعطيل كافة السمات (الخط العريض، نصف السطوع، الوميض، العكسي).

--bold on|off

يُفعل وضع الخط العريض (السطوع الزائد) أو يعطله. باستثناء المحطة الطرفية الافتراضية، يؤدي الخيار --bold off إلى تعطيل كافة السمات (الخط العريض، نصف السطوع، الوميض، العكسي).

--clear[=all|rest]

دون وسيط أو مع الوسيط all، تُمسح الشاشة بأكملها ويُعاد المؤشر إلى الموضع الرئيسي، تماماً كما يفعل أمر clear(1). مع الوسيط rest، تُمسح الشاشة من موضع المؤشر الحالي وحتى النهاية.

--clrtabs[=tab1 tab2 tab3 ...]

يمسح علامات الجدولة من مواضع المؤشر الأفقية المعطاة، في النطاق 1-160. دون وسيطات، يمسح كافة علامات الجدولة. للمحطات الطرفية الافتراضية فقط.

--cursor on|off

يشغل مؤشر الطرفية أو يطفئه.

--default

يضبط خيارات صيرورة الطرفية إلى القيم المبدئية.

--dump[=رقم_الطرفية]

يكتب لقطة للمحطة الطرفية الافتراضية ذات الرقم المعطى في الملف المحدد عبر الخيار --file، مع استبدال محتوياته؛ الملف المبدئي هو screen.dump. دون وسيطة، يُفرغ محتوى المحطة الطرفية الافتراضية الحالية. هذا يتجاوز الخيار --append.

--file اسم_ملف

يضبط اسم ملف اللقطة لأي من خيارات --dump أو --append في نفس سطر الأوامر. إذا لم يتوفر هذا الخيار، فإن القيمة المبدئية هي screen.dump في المجلد الحالي. سيُبتر اسم المسار الذي يتجاوز الحد الأقصى للنظام، راجع PATH_MAX في linux/limits.h لمعرفة القيمة.

--foreground 8-color|default

يضبط لون نص الواجهة.

--half-bright on|off

يُشغل وضع الخفوت (نصف السطوع) أو يوقفه. باستثناء الطرفية الافتراضية، يوقف --half-bright off كل السمات (الخط العريض، ونصف السطوع، والوميض، والمعكوس).

--hbcolor 16-color

يضبط لون المحارف بنصف السطوع.

--initialize

يعرض سلسلة تهيئة الطرفية، والتي تضبط عادةً خيارات إخراج الطرفية، والسمات الأخرى إلى القيم المبدئية.

--inversescreen on|off

يقلب ألوان الواجهة والخلفية للشاشة بأكملها.

--linewrap on|off

يجعل الطرفية تستمر في سطر جديد عندما يمتلئ السطر.

--msg on|off

يُفعل أو يُعطل إرسال رسائل printk() الخاصة بالنواة إلى الكونسول. للطرفيات الافتراضية فقط.

--msglevel 0-8

يضبط مستوى تسجيل الكونسول لرسائل printk(9) الخاصة بالنواة. ستُطبع كل الرسائل التي تزيد أهميتها عن هذا المستوى، لذا فإن مستوى التسجيل 0 له نفس تأثير --msg on ومستوى التسجيل 8 سيطبع كل رسائل النواة. قد يكون klogd(8) واجهة أكثر ملاءمة لتسجيل رسائل النواة.

للطرفيات الافتراضية فقط.

--powerdown[=0-60]

يضبط فاصل إيقاف الطاقة VESA بالدقائق. دون معطى، يكون المبدئي هو 0 (تعطيل إيقاف الطاقة). إذا كانت الشاشة فارغة أو في وضع التعليق، فستنتقل الشاشة إلى وضع تعليق vsync أو وضع إيقاف الطاقة على التوالي بعد انقضاء هذه المدة الزمنية.

--powersave وضع

القيم الصالحة لـ وضع هي:

vsync|on

يضع الشاشة في وضع تعليق VESA vsync.

hsync

يضع الشاشة في وضع تعليق VESA hsync.

powerdown

يضع الشاشة في وضع إيقاف الطاقة VESA.

off

يوقف ميزات توفير الطاقة في الشاشة.

--regtabs[=1-160]

يمسح كل علامات الجدولة، ثم يضبط نمط علامات جدولة منتظم، مع علامة واحدة كل عدد محدد من المواضع. دون معطى، يكون المبدئي 8. للطرفيات الافتراضية فقط.

--repeat on|off

يُشغل تكرار لوحة المفاتيح أو يوقفه. للطرفيات الافتراضية فقط.

--reset

يعرض سلسلة إعادة ضبط الطرفية، والتي تعيد الطرفية عادةً إلى حالة التشغيل الأولى.

--resize

أُعيد ضبط حجم الطرفية عبر تقييم الحد الأقصى للصف والعمود. هذا مفيد عندما لا يكون التخطيط الفعلي وسائق طرفية النواة متزامنين. أبرز حالات الاستخدام هي مع الكونسول التسلسلي، الذي لا يستخدم ioctl(2) بل مجرد تدفقات بايتات وفواصل.

--reverse on|off

يُشغل وضع الفيديو المعكوس أو يوقفه. باستثناء الطرفية الافتراضية، يوقف --reverse off كل السمات (الخط العريض، ونصف السطوع، والوميض، والمعكوس).

--store

يخزن خيارات إخراج الطرفية الحالية (ألوان الواجهة والخلفية) لتكون القيم المستخدمة عند إعادة الضبط للمبدئي. للطرفيات الافتراضية فقط.

--tabs[=tab1 tab2 tab3 ...]

يضبط علامات الجدولة عند مواضع المؤشر الأفقية المعطاة، في النطاق 1-160. دون معطيات، يعرض إعدادات علامات الجدولة الحالية.

--term اسم_الطرفية

يتجاوز متغير البيئة TERM.

--ulcolor 16-color

يضبط لون المحارف التي تحتها خط. للطرفيات الافتراضية فقط.

--underline on|off

يُشغل وضع التسطير أو يوقفه.

--help

اعرض نص المساعدة ثم اخرج.

--version

اعرض الإصدار واخرج.

تحذير

قد يؤدي استخدام setterm مع إعادة توجيه stdout إلى نتائج غير متوقعة، لأن بعض الخيارات تعمل على stdin. لمنع المشكلات، أعد توجيه كل من stdin وstdout دائماً إلى نفس الجهاز.

التوافقية

منذ الإصدار 2.25، يدعم setterm الخيارات الطويلة بشرطتين، مثل --help، بجانب الخيارات الطويلة التاريخية بشرطة واحدة، مثل -help. في السكربتات، يُفضل استخدام الشرطة الواحدة المتوافقة مع الإصدارات السابقة بدلاً من الشرطة المزدوجة. حالياً لا توجد خطط ولا أسباب وجيهة لإيقاف التوافق مع الشرطة الواحدة.

العلل

الفروقات بين نسختي Minix و لينكس غير موثقة.

انظر أيضاً

stty(1)، tput(1)، tty(4)، terminfo(5)

التبليغ عن الأخطاء

لتقارير العِلل، استخدم مُتتبع المشكلات https://github.com/util-linux/util-linux/issues.

التوفر

الأمر setterm جزء من حزمة util-linux التي يمكن تنزيلها من أرشيف نواة لينكس https://www.kernel.org/pub/linux/utils/util-linux/.

2026-05-18 util-linux 2.42.1