NAMA
man - format dan menampilkan halaman manual on-line
manpath - menentukan jalur pencarian pengguna untuk halaman manual
RINGKASAN
man [ -acdfFhkKtwW ] [ --path ] [ -m system ] [ -p string ] [ -C config_file ] [ -M pathlist ] [ -P pager ] [ -S section_list ] [ bagian ] nama ...
DESKRIPSI
man format dan menampilkan halaman manual on-line. Jika Anda menentukan bagian , pria hanya melihat di bagian manual itu. nama biasanya adalah nama halaman buku panduan, yang biasanya adalah nama perintah, fungsi, atau file. Namun, jika nama berisi sebuah garis miring ( / ) lalu manusia menafsirkannya sebagai spesifikasi file, sehingga Anda dapat melakukan man ./foo.5 atau bahkan man /cd/foo/bar.1.gz .
Lihat di bawah untuk deskripsi di mana manusia mencari file halaman buku panduan.
PILIHAN
-C config_file
Tentukan file konfigurasi untuk digunakan; defaultnya adalah /etc/man.config . (Lihat man.conf (5).)
Jalan -M
Tentukan daftar direktori untuk mencari halaman manual. Pisahkan direktori dengan titik dua. Daftar kosong sama dengan tidak menentukan -M sama sekali. Lihat JALUR CARI UNTUK PANDUAN MANUAL .
-P pager
Tentukan pager mana yang akan digunakan. Pilihan ini mengesampingkan variabel lingkungan MANPAGER , yang pada gilirannya mengesampingkan variabel PAGER . Secara default, manusia menggunakan / usr / bin / less -isr .
-S section_list
Daftar adalah daftar bagian manual yang dipisahkan dengan titik dua untuk dicari. Pilihan ini mengesampingkan variabel lingkungan MANSECT .
-Sebuah
Secara default, pria akan keluar setelah menampilkan halaman manual pertama yang ditemukannya. Menggunakan opsi ini memaksa manusia untuk menampilkan semua halaman buku panduan yang sesuai dengan nama, bukan hanya yang pertama.
-c
Format ulang halaman manual sumber, bahkan ketika halaman cat terbaru ada. Ini dapat bermakna jika laman kucing diformat untuk layar dengan jumlah kolom berbeda, atau jika halaman yang telah diformat rusak.
-d
Jangan benar-benar menampilkan halaman manual, tetapi lakukan pencetakan sekumpulan informasi debug.
-D
Baik menampilkan dan mencetak info debugging.
-f
Setara dengan whatis .
-F atau --preformat
Format saja - jangan tampilkan.
-h
Cetak pesan bantuan satu baris dan keluar.
-k
Setara dengan apropos .
-K
Cari string yang ditentukan di * semua * halaman manual. Peringatan: ini mungkin sangat lambat! Ini membantu untuk menentukan bagian. (Hanya untuk memberikan gambaran kasar, di mesin saya ini membutuhkan waktu sekitar satu menit per 500 halaman manual.)
sistem -m
Tentukan satu set alternatif halaman man untuk mencari berdasarkan nama sistem yang diberikan.
string -p
Tentukan urutan preprosesor untuk dijalankan sebelum nroff atau troff . Tidak semua instalasi memiliki satu set lengkap preprocessors. Beberapa preprosesor dan huruf yang digunakan untuk menunjuk mereka adalah: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), rujukan (r). Opsi ini mengesampingkan variabel lingkungan MANROFFSEQ .
-t
Gunakan / usr / bin / groff -Tps -mandoc untuk memformat halaman buku panduan, mengoper output ke stdout. Output dari / usr / bin / groff -Tps -mandoc mungkin perlu melewati beberapa filter atau yang lain sebelum dicetak.
-w atau --path
Jangan benar-benar menampilkan halaman manual, tetapi jangan cetak lokasi file yang akan diformat atau ditampilkan. Jika tidak ada argumen yang diberikan: tampilkan (pada stdout) daftar direktori yang dicari oleh manusia untuk halaman manual. Jika manpath adalah tautan ke manusia, maka "manpath" setara dengan "man - path".
-W
Seperti -w, tetapi cetak nama file satu per baris, tanpa informasi tambahan. Ini berguna dalam perintah shell seperti man -aW man | xargs ls-l
CAT PAGES
Manusia akan mencoba untuk menyimpan halaman manual yang diformat, untuk menghemat waktu pemformatan waktu berikutnya halaman ini diperlukan. Secara tradisional, versi halaman yang diformat dalam DIR / manX disimpan dalam DIR / catX, tetapi pemetaan lain dari man dir ke cat dir dapat ditentukan di /etc/man.config . Tidak ada halaman kucing yang disimpan ketika direktori cat yang dibutuhkan tidak ada. Tidak ada halaman kucing yang disimpan ketika mereka diformat untuk panjang garis yang berbeda dari 80. Tidak ada halaman kucing yang disimpan ketika man.conf berisi garis NOCACHE.
Adalah mungkin untuk membuat pria menjadi pria pengguna. Kemudian, jika direktori kucing memiliki pemilik pria dan mode 0755 (hanya dapat ditulis oleh manusia), dan file kucing memiliki pemilik pria dan mode 0644 atau 0444 (hanya dapat ditulis oleh manusia, atau tidak dapat ditulis sama sekali), tidak ada pengguna biasa yang dapat mengubah halaman kucing atau menaruh file lain di direktori kucing. Jika pria tidak dijadikan suid, maka direktori kucing harus memiliki mode 0777 jika semua pengguna harus dapat meninggalkan halaman cat di sana.
Opsi -c memaksa memformat ulang halaman, bahkan jika halaman cat baru-baru ini ada.
CARI CARI UNTUK PANDUAN MANUAL
Manusia menggunakan metode yang canggih untuk menemukan file halaman buku panduan, berdasarkan pada opsi-opsi invokasi dan variabel lingkungan, file konfigurasi /etc/man.config , dan beberapa konvensi dan heuristik yang dibangun.
Pertama-tama, ketika argumen nama untuk man berisi slash ( / ), pria menganggap itu adalah spesifikasi file itu sendiri, dan tidak ada pencarian yang terlibat.
Tetapi dalam kasus normal di mana nama tidak mengandung slash, manusia mencari berbagai direktori untuk file yang bisa menjadi halaman manual untuk topik yang dinamai.
Jika Anda menentukan opsi pathlist -M , pathlist adalah daftar direktori yang dipisahkan dengan titik dua yang dicari manusia .
Jika Anda tidak menentukan -M tetapi mengatur variabel lingkungan MANPATH , nilai variabel itu adalah daftar direktori yang ditelusuri manusia .
Jika Anda tidak menentukan daftar jalur eksplisit dengan -M atau MANPATH , manusia mengembangkan daftar jalurnya sendiri berdasarkan konten file konfigurasi /etc/man.config . Pernyataan MANPATH dalam file konfigurasi mengidentifikasi direktori tertentu untuk dimasukkan dalam jalur pencarian.
Selanjutnya, pernyataan MANPATH_MAP menambah jalur pencarian tergantung pada jalur pencarian perintah Anda (yaitu variabel lingkungan PATH Anda). Untuk setiap direktori yang mungkin berada di jalur pencarian perintah, pernyataan MANPATH_MAP menentukan direktori yang harus ditambahkan ke jalur pencarian untuk file halaman buku panduan. man melihat variabel PATH dan menambahkan direktori yang sesuai ke jalur pencarian file halaman manual. Dengan demikian, dengan penggunaan MANPATH_MAP yang tepat, ketika Anda mengeluarkan perintah man xyz , Anda mendapatkan halaman manual untuk program yang akan dijalankan jika Anda mengeluarkan perintah xyz .
Selain itu, untuk setiap direktori di jalur pencarian perintah (kita akan menyebutnya "direktori perintah") yang Anda tidak memiliki pernyataan MANPATH_MAP , manusia secara otomatis mencari direktori halaman manual "di dekatnya" yaitu sebagai subdirektori di direktori perintah itu sendiri atau di direktori induk dari direktori perintah.
Anda dapat menonaktifkan pencarian otomatis "di dekatnya" dengan memasukkan pernyataan NOAUTOPATH di /etc/man.config .
Di setiap direktori di jalur pencarian seperti yang dijelaskan di atas, pria mencari topik bernama file . bagian , dengan akhiran opsional pada nomor bagian dan mungkin sufiks kompresi. Jika tidak menemukan file seperti itu, maka akan terlihat di subdirektori apa pun yang bernama man N atau cat N di mana N adalah nomor bagian manual. Jika file tersebut berada dalam subdirektori kucing N , manusia menganggap itu adalah file halaman buku panduan yang diformat (halaman kucing). Jika tidak, pria menganggap itu tidak diformat. Dalam kedua kasus, jika nama file memiliki sufiks kompresi yang dikenal (seperti .gz ), manusia menganggap itu adalah gzip.
Jika Anda ingin melihat di mana (atau jika) manusia akan menemukan halaman manual untuk topik tertentu, gunakan opsi - path ( -w ).
Penting: Gunakan perintah man ( % man ) untuk melihat bagaimana perintah digunakan pada komputer khusus Anda.