مرد - فرمان لینوکس - فرمان یونیکس

نام

man - قالب بندی و نمایش صفحات دستی آنلاین
manpath - تعیین مسیر جستجوی کاربر برای صفحات مرد

خلاصه

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

شرح

مرد قالب بندی و نمایش صفحات دستی آنلاین را نمایش می دهد. اگر بخش را مشخص کنید، مرد فقط در بخش آن کتابچه نگاه می کند. نام به طور معمول نام صفحه کتابچه راهنمای کاربر است، که معمولا نام یک فرمان، تابع یا فایل است. با این حال، اگر نام شامل یک اسلش ( / ) باشد، مرد آن را به عنوان یک مشخصه فایل تفسیر می کند، بنابراین شما می توانید man / .ff.5 و یا حتی مرد /cd/foo/bar.1.gz انجام دهید .

برای توضیح اینکه در آن مرد به دنبال فایلهای صفحه دستی است، زیر را ببینید.

گزینه ها

-C config_file

تعیین پرونده پیکربندی برای استفاده؛ default /etc/man.config است . (نگاه کنید به man.conf (5).)

-M مسیر

لیست دایرکتوری ها را برای جستجوی صفحات شخصی مشخص کنید. جداگانه دایرکتوری ها با کولون یک لیست خالی همان است که مشخص نیست -M در همه. جستجوی مسیر را برای صفحات دستی مشاهده کنید.

پی پی پی

مشخص کنید که کدام پیجر را استفاده کنید. این گزینه منجر به تغییر متغیر محیط MANPAGER می شود که به نوبه خود متغیر PAGER را منحرف می کند. به طور پیش فرض، مرد با استفاده از / usr / bin / less -isr .

-S section_list

فهرست لیستی از بخش های کتابچه ای است که برای جستجوی جستجو شده است. این گزینه متغیر محیط MANSECT را رفع می کند.

-a

به طور پیش فرض، پس از نمایش اولین صفحه دستی که آن را پیدا می کند، مرد خارج خواهد شد. با استفاده از این گزینه، مرد را مجبور می کند تا تمام صفحات دستی که نام آنها را مطابقت داده است ، نمایش داده نشود.

-c

تغییر صفحه مرد منبع، حتی زمانی که یک صفحه گربه تا به امروز وجود دارد. این می تواند معنی دار باشد اگر صفحه گربه برای یک صفحه با تعداد مختلف ستون فرمت شده باشد یا اگر صفحه پیش فرمت شده خراب شود.

-d

در واقع صفحات مردی را نمایش نمیدهد، اما اطلاعاتی راجع به خطایابی را چاپ کنید.

-D

هر دو اطلاعات نمایش و چاپ اشکال زدایی را نمایش می دهد.

-f

معادل با همه چیز.

-F یا --preformat

فقط فرمت - نمایش داده نمی شود.

یک پیام خطی یک خط و خروج را چاپ کنید.

-k

معادل با معامله

-K

جستجو برای رشته های مشخص شده در * همه * صفحات مرد. هشدار: این احتمالا خیلی کند است! این کمک می کند تا یک بخش را مشخص کنید. (فقط برای دادن یک نظر خشن، در ماشین من این طول می کشد حدود یک دقیقه در هر 500 صفحه مرد.)

-m سیستم

تعیین یک مجموعه متناوب از صفحات مرد برای جستجو بر اساس نام سیستم داده شده.

-p رشته

توالی preprocessors را قبل از nroff یا troff اجرا کنید . تمام تاسیسات یک مجموعه کامل از پیش پردازنده ها را ندارند. برخی از پیش پردازنده ها و حروف مورد استفاده برای تعیین آنها عبارتند از: eqn (e)، grap (g)، pic (p)، tbl (t)، vgrind (v)، refer (r). این گزینه منو متغیر محیطی MANROFFSEQ را منحرف می کند.

از / usr / bin / groff -Tps -mandoc برای قالب بندی صفحه دستی استفاده کنید، خروجی را به stdout منتقل کنید. خروجی از / usr / bin / groff -Tps -mandoc ممکن است قبل از اینکه چاپ شود باید از طریق یک فیلتر یا یک دیگر منتقل شود.

-w یا - مسیر

در واقع صفحات مردانه را نمایش نمیدهد، اما محل (های) فایلهایی را که میبایست فرمت شده یا نمایش داده شوند، چاپ کنید. اگر هیچ استدلالی داده نشود: صفحه نمایش (در stdout) لیست فهرست هایی که توسط انسان برای صفحات مرد جستجو می شود. اگر manpath یک پیوند به انسان است، سپس "manpath" معادل "man -path" است.

-W

مانند -w، اما چاپ فایل ها را به هر خط، بدون اطلاعات اضافی. این در فرمانهای پوسته مانند man -AW man | مفید است xargs ls -l

صفحات CAT

مرد تلاش خواهد کرد که صفحات مرد فرمت شده را ذخیره کند تا زمان formatting را بعدا در این صفحات مورد نیاز ذخیره کند. به طور سنتی، نسخه های فرمت شده از صفحات در DIR / manX در DIR / catX ذخیره می شوند، اما سایر تنظیمات از man dir به cat dir می تواند در /etc/man.config مشخص شود. صفحات گربه هنگامی که دایرکتوری گره مورد نیاز وجود ندارد، ذخیره می شوند. صفحات گربه زمانی ذخیره می شوند که برای طول خطی متفاوت از 80 قالب بندی می شوند. وقتی صفحه man.conf حاوی خط NOCACHE است، صفحات گربه ذخیره نمی شوند.

ممکن است انسان را به یک مرد کاربر سویدن داد. سپس اگر یک پوشه گربه دارای مالک و حالت 0755 باشد (تنها توسط انسان قابل خواندن است) و فایلهای گربه دارای مالک و حالت 0644 یا 0444 هستند (تنها توسط انسان قابل ویرایش است و یا نمی توان نوشتن)، هیچ یک از کاربران معمولی نمی توانند تغییر دهند صفحات گربه و یا قرار دادن فایل های دیگر در دایرکتوری گربه. اگر انسان ساخته شده است suid، و سپس یک پوشه گربه باید حالت 0777 اگر تمام کاربران باید قادر به ترک صفحات گربه وجود دارد.

گزینه -c نیروی بازنویسی یک صفحه را، حتی اگر یک صفحه گربه جدید وجود داشته باشد.

مسیر جستجو برای صفحات دستی

مرد با استفاده از روش پیچیده برای پیدا کردن فایل های صفحه دستی، بر اساس گزینه های فراخوانی و متغیرهای محیطی، فایل پیکربندی /etc/man.config و برخی از قراردادها و اکتشافات ساخته شده است.

اول از همه، زمانی که آرگومان نام به مرد حاوی یک اسلش ( /انسان فرض می کند که خودش یک مشخصه فایل است و هیچ جستجو انجام نمی شود.

اما در حالت عادی که نام شامل یک علامت نشانه نیست، مرد یک دایرکتوری مختلف را برای یک فایل جستجو می کند که می تواند یک صفحه دستی برای موضوع مورد نظر باشد.

اگر گزینه -M pathlist را مشخص کنید، لیست مسیریابی لیستی از فهرست جدا شده روده بزرگ از دایرکتوری هایی است که انسان جستجو می کند.

اگر مشخص نمیکنید -M اما متغیر محدوده MANPATH را تنظیم کنید، مقدار آن متغیر لیستی از دایرکتوری هایی است که انسان جستجو می کند.

اگر لیست مسیر صریح را با -M یا MANPATH مشخص نکنید، فرد لیست مسیر خود را بر اساس محتویات فایل پیکربندی /etc/man.config ایجاد می کند . اظهارات MANPATH در فایل پیکربندی دایرکتوری های خاصی را در مسیر جستجو جستجو می کند.

علاوه بر این، دستورات MANPATH_MAP بسته به مسیر جستجو فرمان (به عنوان مثال متغیر محیط PATH شما) به مسیر جستجوی اضافه می شود. برای هر دایرکتوری که ممکن است در مسیر جستجوی فرمان باشد، دستور MANPATH_MAP یک دایرکتوری را مشخص می کند که باید به مسیر جستجو برای فایل های صفحه دستی اضافه شود. مرد به متغیر PATH نگاه می کند و دایرکتوری های مربوطه را به مسیر جستجوی فایل صفحه کتاب اضافه می کند. بنابراین، با استفاده مناسب از MANPATH_MAP ، هنگامی که شما دستور command xyz را صادر می کنید، شما یک صفحه دستی برای برنامه ای که اجرا می کنید، اگر شما xyz را صادر کردید، دریافت کنید.

علاوه بر این، برای هر دایرکتوری در مسیر جستجو فرمان (ما آن را یک "دایرکتوری فرمان" نامیده ایم) که برای آن شما یک دستور MANPATH_MAP ندارید ، مرد به طور خودکار یک دایرکتوری صفحه دستی "نزدیک" را جستجو می کند یعنی به عنوان یک زیرپوشه در خود دایرکتوری فرمان یا در دایرکتوری اصلی دایرکتوری فرمان.

شما می توانید جستجوهای اتوماتیک "نزدیک" را با وارد کردن بیانیه NOAUTOPATH در /etc/man.config غیرفعال کنید .

در هر دایرکتوری در مسیر جستجو همانطور که در بالا توضیح داده شد، مرد برای یک فایل با موضوع جستجو می کند . بخش ، با پسوند اختیاری در شماره بخش و احتمالا پسوند فشرده. اگر چنین فایلی پیدا نکرد، آنگاه در هر زیرشاخه ای که به نام man N یا cat N نامیده می شود، که در آن N تعداد بخش کتابچه ای است، به نظر می رسد. اگر فایل در subdirectory گربه N باشد ، فرض می کند که این یک فایل صفحه کتابچه راهنمای کاربر فرمت شده (صفحه گربه) است. در غیر این صورت، انسان تصور می کند که آن را فرمت نشده است. در هر صورت، اگر نام فایل دارای پسوند فشرده شناخته شده (مانند .gz ) باشد، انسان فرض می کند که آن را gzip شده است.

اگر می خواهید ببینید که در کجا (یا اگر) یک صفحه دستی برای یک موضوع خاص پیدا کنید، از گزینه --path ( -w ) استفاده کنید.

مهم: از دستور man ( ٪ man ) برای دیدن نحوه استفاده از دستور در رایانه خاص خود استفاده کنید.