رجل - قيادة لينكس - قيادة يونيكس

اسم

رجل - شكل وعرض صفحات دليل على الانترنت
manpath - تحديد مسار بحث المستخدم لصفحات man

موجز

man [ -acdfFhkKtwW ] [- path ] [ -m system ] [ -p string ] [ -C config_file ] [ -Mmlistlist ] [ -P pager ] [ -S section_list ] [ section ] name ...

وصف

يقوم الرجل بتنسيق ويعرض الصفحات اليدوية على الإنترنت. إذا حددت القسم ، سيظهر الرجل في قسم الدليل فقط. الاسم هو عادةً اسم الصفحة اليدوية ، وهو عادة اسم أمر أو وظيفة أو ملف. ومع ذلك ، إذا كان الاسم يحتوي على شرطة مائلة ( / ) ، فسيقوم الرجل بتفسيرها كمواصفات للملف ، بحيث يمكنك القيام بالرجل. / foo.5 أو حتى man /cd/foo/bar.1.gz .

انظر أدناه للحصول على وصف أين يبحث الرجل عن ملفات الصفحات اليدوية.

خيارات

-C config_file

حدد ملف التكوين المطلوب استخدامه ؛ الافتراضي هو /etc/man.config . (انظر man.conf (5).)

مسار -M

حدد قائمة الدلائل للبحث عن صفحات man. فصل الدلائل مع colons. قائمة فارغة هي نفسها عدم تحديد -M على الإطلاق. انظر PATH SEALCH FOR MANUAL PAGES .

-P بيجر

تحديد أي جهاز نداء لاستخدامه. يتجاوز هذا الخيار متغير بيئة MANPAGER ، والذي بدوره يتجاوز متغير PAGER . بشكل افتراضي ، يستخدم الرجل / usr / bin / less -isr .

-S section_list

القائمة هي قائمة بنقطتين مفصولتين بالأقسام اليدوية للبحث. يلغي هذا الخيار متغير بيئة MANSECT .

-ا

بشكل افتراضي ، سيخرج الرجل بعد عرض أول صفحة يدوية يعثر عليها. يؤدي استخدام هذا الخيار إلى إجبار الرجل على عرض جميع الصفحات اليدوية التي تطابق الاسم ، وليس فقط الأول.

-c

أعد تهيئة صفحة مصدر المصدر ، حتى عند وجود صفحة قطة محدثة. قد يكون ذلك مفيدًا إذا تمت تهيئة صفحة cat لشاشة تحتوي على عدد مختلف من الأعمدة ، أو إذا كانت الصفحة المنسّقة مسبقًا تالفة.

-د

لا تعرض في الواقع صفحات الرجل ، ولكن قم بطباعة gobs من معلومات التصحيح.

-د

كل من عرض وطباعة معلومات التصحيح.

-F

أي ما يعادل ما.

-F أو - preformat

شكل فقط - لا تقم بعرض.

-h

اطبع رسالة مساعدة من سطر واحد وقم بالخروج.

-ك

ما يعادل إلى apropos .

-ك

ابحث عن السلسلة المحددة في * all * man pages. تحذير: من المحتمل أن يكون هذا بطيئًا جدًا! يساعد على تحديد قسم. (فقط لإعطاء فكرة تقريبية ، على جهازي هذا يستغرق حوالي دقيقة لكل 500 صفحة رجل.)

م نظام

حدد مجموعة بديلة من صفحات man للبحث استنادًا إلى اسم النظام المعطى.

-p السلسلة

حدد تسلسل المعالجات التمهيدية للتشغيل قبل nroff أو troff . لن تحتوي جميع التركيبات على مجموعة كاملة من المعالجات المسبقة. بعض المعاملات المسبقة والحروف المستخدمة لتعيينها هي: eqn (e)، grap (g)، pic (p)، tbl (t)، vgrind (v)، refer (r). يتجاوز هذا الخيار متغير البيئة MANROFFSEQ .

-t

استخدم / usr / bin / groff -Tps -mandoc لتنسيق الصفحة اليدوية ، وتمرير الإخراج إلى stdout. قد يلزم تمرير الإخراج من / usr / bin / groff -Tps -mandoc خلال فلتر أو آخر قبل طباعته.

-w أو - path

لا تعرض بالفعل صفحات الرجل ، ولكن قم بطباعة موقع (مواقع) الملفات التي سيتم تنسيقها أو عرضها. إذا لم يتم إعطاء أي حجة: عرض (على stdout) قائمة الدلائل التي يتم البحث عنها من قبل رجل لصفحات الرجل. إذا كان manpath هو رابط للإنسان ، فإن "manpath" يعادل "man -path".

-W

مثل -w ، ولكن اسم ملف الطباعة واحد في كل سطر ، دون معلومات إضافية. هذا مفيد في أوامر shell مثل man -aW man | xargs ls -l

صفحات CAT

سيحاول الرجل حفظ صفحات الرجل المنسقة ، من أجل حفظ وقت التنسيق في المرة التالية التي تكون فيها هذه الصفحات مطلوبة. تقليديا ، يتم حفظ إصدارات منسقة من الصفحات في DIR / manX في DIR / catX ، ولكن يمكن تحديد تعيينات أخرى من رجل dir إلى cat dir في /etc/man.config . لا يتم حفظ صفحات القطط عندما لا يكون دليل القط المطلوب موجودًا. يتم حفظ أي صفحات القطط عندما يتم تنسيقها لطول خط مختلف عن 80. لا يتم حفظ صفحات القط عندما يحتوي man.conf على السطر NOCACHE.

من الممكن أن تجعل الرجل يتقاعس من رجل مستخدم. ثم ، إذا كان دليل القط لديه مالك الرجل والوضع 0755 (فقط قابل للكتابة من قبل الرجل) ، وملفات القطة لها مالك الرجل والوضع 0644 أو 0444 (قابل للكتابة فقط من قبل الرجل ، أو غير قابل للكتابة على الإطلاق) ، لا يمكن لأي مستخدم عادي تغيير صفحات القط أو وضع ملفات أخرى في دليل القط. إذا لم يكن الرجل مرغما ، فيجب أن يكون دليل القطط واسطة مود إذا كان جميع المستخدمين قادرين على ترك صفحات القط هناك.

تقوم قوى الخيار -c بإعادة تهيئة صفحة ، حتى إذا كانت هناك صفحة قطة حديثة.

البحث عن مسار للصفحات دليل

يستخدم الإنسان طريقة معقدة للعثور على ملفات الصفحات اليدوية ، استنادًا إلى خيارات الاستحضار ومتغيرات البيئة وملف التكوين /etc/man.config وبعض الاتفاقيات والإستراتيجيات المستخدمة .

أولاً وقبل كل شيء ، عندما تحتوي حجة الاسم للرجل على شرطة مائلة ( / ) ، يفترض الرجل أنه محدد للملف نفسه ، ولا يوجد أي بحث.

ولكن في الحالة العادية التي لا يحتوي الاسم فيها على شرطة مائلة ، يبحث الإنسان عن مجموعة متنوعة من الأدلة لملف يمكن أن يكون صفحة يدوية للموضوع المسمى.

إذا حددت خيار قائمة المسارات -M ، فسيكون pathlist عبارة عن قائمة مفصولة بفواصل النقط للدلائل التي يبحث عنها الرجل .

إذا لم تقم بتحديد -M لكن قم بتعيين متغير بيئة MANPATH ، فإن قيمة هذا المتغير هي قائمة بالدلائل التي يبحث عنها الرجل .

إذا لم تقم بتحديد قائمة مسار صريحة بـ -M أو MANPATH ، يقوم الرجل بتطوير قائمة المسار الخاصة به استنادًا إلى محتويات ملف التهيئة /etc/man.config . تحدد عبارات MANPATH في ملف التكوين أدلة معينة لتضمينها في مسار البحث.

علاوة على ذلك ، تضيف عبارات MANPATH_MAP إلى مسار البحث بناءً على مسار بحث الأمر (أي متغير بيئة PATH ). لكل دليل قد يكون في مسار بحث الأمر ، تحدد عبارة MANPATH_MAP الدليل الذي يجب إضافته إلى مسار البحث لملفات الصفحات اليدوية. رجل ينظر إلى متغير PATH ويضيف الدلائل المقابلة إلى مسار البحث عن ملف صفحة يدوي. وهكذا ، مع الاستخدام السليم لـ MANPATH_MAP ، عند إصدار الأمر xyz man ، ستحصل على صفحة يدوية للبرنامج الذي سيتم تشغيله إذا قمت بإصدار الأمر xyz .

بالإضافة إلى ذلك ، بالنسبة إلى كل دليل في مسار بحث الأوامر ( سنسميه "دليل الأوامر") الذي ليس لديك به بيان MANPATH_MAP ، يبحث الرجل تلقائيًا عن دليل صفحات يدوي "قريب" ، على وجه التحديد كدليل فرعي في دليل الأوامر نفسه أو في الدليل الرئيسي لدليل الأوامر.

يمكنك تعطيل عمليات البحث "القريبة" التلقائية عن طريق تضمين عبارة NOAUTOPATH في /etc/man.config .

في كل دليل في مسار البحث كما هو موضح أعلاه ، يبحث الإنسان عن ملف اسمه . المقطع ، مع لاحقة اختيارية على رقم المقطع وربما لاحقة ضغط. إذا لم يعثر على مثل هذا الملف ، فإنه يبحث في أية أدلة فرعية تسمى N أو cat N حيث N هي رقم القسم اليدوي. إذا كان الملف في دليل فرعي للقطعة N ، يفترض الرجل أنه ملف صفحة يدوي منسق (صفحة قطة). خلاف ذلك ، الرجل يفترض أنه غير منسق. في كلتا الحالتين ، إذا كان اسم الملف يحتوي على لاحقة ضغط معروفة (مثل .gz ) ، يفترض الرجل أنه gzipped.

إذا كنت تريد معرفة مكان (أو إذا) سيجد الإنسان الصفحة اليدوية لموضوع معين ، فاستخدم خيار - path ( -w ).

هام: استخدم الأمر man ( ٪ man ) لمعرفة كيفية استخدام أمر ما على جهاز الكمبيوتر الخاص بك.