NAME
man - format dan paparkan halaman manual dalam talian
manpath - menentukan laluan carian pengguna untuk halaman lelaki
SINOPSIS
man [ -acdfFhkKtwW ] [ --path ] [ -m system ] [ -p string ] [ -C config_file ] [ -M pathlist ] [ -P pager ] [ -S section_list ] [ section ] name ...
DESKRIPSI
format manusia dan memaparkan halaman manual dalam talian. Sekiranya anda menentukan bahagian , manusia hanya melihat bahagian manual tersebut. nama biasanya nama halaman manual, yang biasanya nama arahan, fungsi, atau fail. Walau bagaimanapun, jika nama mengandungi slash ( / ) maka manusia menafsirkannya sebagai spesifikasi fail, supaya anda boleh melakukan manusia ./foo.5 atau bahkan man / cd / foo / bar.1.gz.
Lihat di bawah untuk keterangan di mana manusia mencari fail halaman manual.
PILIHAN
-C config_file
Tentukan fail konfigurasi yang hendak digunakan; lalai adalah /etc/man.config . (Lihat man.conf (5).)
-M laluan
Tentukan senarai direktori untuk mencari halaman lelaki. Pisahkan direktori dengan titik. Senarai kosong adalah sama seperti tidak menentukan -M sama sekali. Lihat PANDUAN SEARCH UNTUK PEMANDANGAN MANUAL .
-P pager
Tentukan pager mana yang hendak digunakan. Opsyen ini mengatasi pembolehubah persekitaran MANPAGER , yang seterusnya mengatasi pembolehubah PAGER . Secara lalai, manusia menggunakan / usr / bin / less -isr .
-S section_list
Senarai adalah senarai berasingan bagi bahagian manual yang dipisahkan. Pilihan ini mengatasi pembolehubah persekitaran MANSECT .
-a
Secara lalai, lelaki akan keluar selepas memaparkan halaman manual yang pertama dijumpai. Menggunakan pilihan ini memaksa manusia untuk memaparkan semua halaman manual yang sepadan dengan nama, bukan hanya yang pertama.
-c
Reformat laman sumber manusia, walaupun terdapat halaman kucing yang terkini. Ini boleh bermakna jika halaman kucing diformat untuk skrin dengan bilangan lajur yang berlainan, atau jika halaman yang telah diformat rosak.
-d
Tidak benar-benar memaparkan halaman lelaki itu, tetapi cetak maklumat mengenai debugging.
-D
Kedua-dua paparan dan cetak maklumat penyahpepijatan.
-f
Bersamaan dengan whatis .
-F atau --format
Format sahaja - jangan paparkan.
-h
Cetak mesej bantuan satu talian dan keluar.
-k
Bersamaan dengan apropos .
-K
Cari rentetan yang dinyatakan dalam * semua * halaman lelaki. Amaran: ini mungkin sangat perlahan! Ia membantu menentukan bahagian. (Untuk memberi idea yang kasar, pada mesin saya ini mengambil masa satu minit setiap 500 halaman lelaki.)
-m sistem
Tentukan satu set halaman lelaki alternatif untuk mencari berdasarkan nama sistem yang diberikan.
-p string
Tentukan turutan pra-proses yang dijalankan sebelum nroff atau troff . Tidak semua pemasangan akan mempunyai set lengkap preprocessor. Beberapa preprocessor dan surat-surat yang digunakan untuk menetapkannya adalah: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), rujuk (r). Pilihan ini mengatasi pembolehubah persekitaran MANROFFSEQ .
-t
Gunakan / usr / bin / groff -Tps -mandoc untuk memformat halaman manual, lulus output untuk stdout. Output dari / usr / bin / groff -Tps -mandoc mungkin perlu melalui beberapa penapis atau yang lain sebelum dicetak.
-w atau --path
Tidak benar-benar memaparkan halaman lelaki, tetapi cetak lokasi (s) fail yang akan diformat atau dipaparkan. Jika tiada hujah diberikan: paparan (pada stdout) senarai direktori yang dicari oleh lelaki untuk halaman lelaki. Sekiranya manpath adalah pautan kepada manusia, maka "manpath" bersamaan dengan "man - path".
-W
Seperti -w, tetapi cetak nama fail satu setiap baris, tanpa maklumat tambahan. Ini berguna dalam perintah shell seperti manusia lelaki xargs ls -l
CAT PAGE
Manusia akan cuba menyelamatkan halaman lelaki diformat, untuk menyelamatkan masa pemformatan pada saat berikutnya halaman-halaman ini diperlukan. Secara tradisinya, versi halaman diformat di DIR / manX disimpan di DIR / catX, tetapi pemetaan lain dari dir kepada cat dir dapat ditentukan dalam /etc/man.config . Tiada halaman kucing disimpan apabila direktori kucing yang diperlukan tidak wujud. Tiada halaman kucing disimpan apabila ia diformatkan untuk panjang baris berbeza dari 80. Tiada halaman kucing disimpan apabila man.conf mengandungi baris NOCACHE.
Adalah mungkin untuk menjadikan lelaki suid kepada seorang lelaki pengguna. Kemudian, jika direktori kucing mempunyai pemilik lelaki dan mod 0755 (hanya ditulis oleh lelaki), dan fail kucing mempunyai lelaki dan mod pemilik 0644 atau 0444 (hanya boleh ditulis oleh manusia, atau tidak boleh ditulis sama sekali), pengguna biasa tidak boleh menukar halaman kucing atau letakkan fail lain dalam direktori kucing. Sekiranya lelaki tidak bersuara, maka direktori kucing perlu mempunyai mod 0777 jika semua pengguna sepatutnya dapat meninggalkan laman kucing di sana.
Kuasa pilihan -c memformat halaman, walaupun terdapat halaman kucing baru-baru ini.
PATH SEARCH UNTUK PEMANDANGAN MANUAL
manusia menggunakan kaedah canggih untuk mencari fail halaman manual, berdasarkan pilihan penyertaan dan pembolehubah persekitaran, fail konfigurasi /etc/man.config , dan beberapa yang dibina dalam konvensyen dan heuristik.
Pertama sekali, apabila hujah nama kepada lelaki mengandungi slash ( / ), manusia menganggap ia adalah spesifikasi fail itu sendiri, dan tidak ada pencarian yang terlibat.
Tetapi dalam kes biasa di mana nama tidak mengandungi slash, lelaki mencari pelbagai direktori untuk fail yang boleh menjadi halaman manual untuk tajuk bernama.
Sekiranya anda menentukan opsyen- pathlist -M , senarai pathlist ialah senarai direktori yang dipisahkan oleh kolon yang dicari oleh lelaki .
Jika anda tidak menentukan -M tetapi setkan pembolehubah MANPATH persekitaran, nilai pembolehubah itu ialah senarai direktori yang dicari oleh lelaki .
Jika anda tidak menentukan senarai laluan eksplisit dengan -M atau MANPATH , lelaki mengembangkan senarai laluannya sendiri berdasarkan kandungan fail konfigurasi /etc/man.config . Kenyataan MANPATH dalam fail konfigurasi mengenal pasti direktori tertentu untuk dimasukkan ke dalam laluan carian.
Selain itu, kenyataan MANPATH_MAP menambah laluan carian bergantung pada laluan carian arahan anda (iaitu pembolehubah persekitaran PATH anda). Untuk setiap direktori yang mungkin berada dalam laluan carian arahan, pernyataan MANPATH_MAP menentukan direktori yang perlu ditambah ke laluan carian untuk fail halaman manual. lelaki melihat pemboleh ubah PATH dan menambah direktori yang sepadan dengan laluan carian fail halaman manual. Oleh itu, dengan menggunakan MANPATH_MAP yang betul, apabila anda mengeluarkan arahan lelaki xyz , anda mendapat halaman manual untuk program yang akan dijalankan jika anda mengeluarkan perintah xyz .
Di samping itu, bagi setiap direktori dalam laluan carian arahan (kami akan memanggilnya sebagai "direktori arahan") yang mana anda tidak mempunyai pernyataan MANPATH_MAP , manusia secara automatik mencari direktori halaman manual "berdekatan" iaitu sebagai subdirektori dalam arahan arahan itu sendiri atau dalam direktori induk direktori arahan.
Anda boleh mematikan carian "berdekatan" automatik dengan memasukkan pernyataan NOAUTOPATH di /etc/man.config .
Di setiap direktori dalam laluan carian seperti yang diterangkan di atas, lelaki mencari fail bernama topik . seksyen , dengan akhiran opsyen pada nombor seksyen dan kemungkinan akhiran pemampatan. Jika ia tidak menemui fail sedemikian, maka ia akan melihat mana-mana subdirektori yang dinamakan lelaki N atau kucing N di mana N adalah nombor bahagian manual. Sekiranya fail itu berada dalam subdirektori kucing N , manusia menganggap ia adalah fail halaman manual yang diformat (halaman kucing). Jika tidak, manusia mengandaikan ia tidak diformatkan. Dalam kedua-dua kes, jika nama fail mempunyai akhiran mampatan yang diketahui (seperti .gz ), manusia menganggap ia gzip.
Sekiranya anda ingin melihat di mana (atau jika) manusia akan mencari halaman manual untuk topik tertentu, gunakan pilihan --path ( -w ).
Penting: Gunakan arahan lelaki ( % man ) untuk melihat bagaimana arahan digunakan pada komputer tertentu anda.