Perintah man Linux: membaca dan mencari halaman manual
man adalah perintah yang digunakan di sistem Linux untuk membaca dokumentasi perintah yang diinstal, file konfigurasi, panggilan sistem, fungsi pustaka, dan item lainnya langsung di terminal. Jalankan man nama_perintah untuk membaca halaman yang tersedia; isi dan bagiannya bergantung pada halaman tersebut.
Contoh di internet bisa berbeda dari versi yang terpasang. Periksa halaman manual lokal sebelum menjalankan perintah pada sistem Anda. Artikel ini menjelaskan semuanya mulai dari cara membuka manual, memilih bagian, mencari berdasarkan kata kunci, memeriksa perintah bawaan shell, hingga pemecahan masalah.
Apa itu perintah man?
man adalah antarmuka yang menampilkan manual referensi sistem. Ketika diberikan nama halaman sebagai argumen, ia mencari jalur yang dikonfigurasi untuk manual, memformatnya, dan menampilkannya satu layar pada satu waktu. Secara umum, less digunakan sebagai pager untuk menampilkan layar, tetapi ini dapat bervariasi tergantung pada pengaturan sistem dan variabel lingkungan MANPAGER atau PAGER.
Halaman manual tidak disediakan oleh satu program man saja. Setiap perintah atau paket pustaka menginstal dokumentasinya sendiri, sehingga halaman yang tersedia bisa berbeda tergantung pada paket dan versi yang diinstal, bahkan pada distribusi yang sama.
Sintaks dasar dan contoh pertama
Sintaks yang paling umum digunakan adalah sebagai berikut. Tanda kurung siku menandakan bagian opsional; ini adalah notasi, bukan perintah yang harus diketik.
man [options] [[section] page...]
Untuk membuka manual untuk perintah ls, jalankan seperti berikut.
man ls
Jika Anda ingin membuka halaman dari bagian tertentu, tentukan nomor bagian sebelum nama halaman.
man 5 passwd
Perintah di atas membuka halaman bagian 5, yang menjelaskan format file /etc/passwd, bukan perintah passwd. Jika Anda menghilangkan bagian seperti man passwd, ia akan mencari dalam urutan yang telah ditentukan dan hanya menampilkan halaman pertama yang ditemukan.
Cara menavigasi dan mencari di layar manual
Tombol berikut umumnya tersedia saat pager adalah less. Jika pager yang berbeda diatur, operasi tombol mungkin berbeda.
| Tombol | Tindakan |
|---|---|
Space, Page Down |
Berpindah ke layar berikutnya. |
b, Page Up |
Berpindah ke layar sebelumnya. |
↑, ↓ |
Bergerak satu baris ke atas atau ke bawah. |
g |
Pindah ke awal dokumen. |
G |
Pindah ke akhir dokumen. |
/string |
Cari string ke bawah dari posisi saat ini. |
?string |
Cari string ke atas dari posisi saat ini. |
n, N |
Pindah ke hasil pencarian berikutnya atau hasil pencarian sebelumnya. |
h |
Buka bantuan pager. |
q |
Keluar dari manual. |
Misalnya, jika Anda membuka man ls dan kemudian mengetik /-a dan menekan Enter, Anda dapat menemukan lokasi di mana -a muncul. Opsi pendek dapat cocok dengan kata lain dalam teks, jadi jika perlu, lebih cepat mencari nama opsi panjang atau kata kunci dalam deskripsi, seperti --all.
Membaca struktur halaman manual
Tidak setiap item ada di setiap halaman, tetapi manual perintah yang khas diatur ke dalam bagian-bagian berikut.
| Bagian | Konten |
|---|---|
NAME |
Meringkas nama halaman dan fungsi dalam satu baris. |
SYNOPSIS |
Menunjukkan format penggunaan perintah atau fungsi. |
DESCRIPTION |
Menjelaskan secara detail bagaimana cara kerjanya dan tujuan yang dimaksud. |
OPTIONS |
Menjelaskan opsi yang tersedia dan efek dari setiap opsi. |
EXIT STATUS |
Menjelaskan status keluar yang membedakan penghentian normal dari kesalahan. |
ENVIRONMENT |
Menjelaskan variabel lingkungan yang memengaruhi operasi. |
FILES |
Menunjukkan file konfigurasi terkait, file data, dan jalurnya. |
EXAMPLES |
Memberikan contoh penggunaan yang sebenarnya. Mungkin tidak tersedia di setiap halaman. |
SEE ALSO |
Memberikan panduan ke halaman manual lain yang bagus untuk dibaca bersama. |
SYNOPSIS juga menekankan pentingnya notasi. Teks yang dicetak tebal biasanya mewakili entri yang harus diketik apa adanya, sementara teks yang dicetak miring umumnya menunjukkan nilai yang harus diganti oleh pengguna. [ ] menunjukkan item opsional, dan ... menandakan item yang dapat diulang. Namun, representasi ini dapat bervariasi tergantung pada format halaman dan lingkungan keluaran, jadi Anda juga harus membaca penjelasan di halaman terkait.
Makna nomor bagian manual
Manual Linux dibagi menjadi beberapa bagian sesuai dengan sifat dokumennya. Karena halaman dengan nama yang sama dapat ada di beberapa bagian, ada baiknya mengetahui nomor bagian untuk menemukan dokumen yang diinginkan tanpa kesalahan.
| Bagian | Klasifikasi | Contoh |
|---|---|---|
| 1 | Program yang dapat dijalankan dan perintah shell | ls(1), grep(1) |
| 2 | Panggilan sistem | open(2), read(2) |
| 3 | Fungsi pustaka | printf(3), malloc(3) |
| 4 | Berkas dan Perangkat Khusus | null(4), Antarmuka Perangkat |
| 5 | Format dan Konvensi Berkas | passwd(5), fstab(5) |
| 6 | Permainan | Manual Permainan yang Terinstal |
| 7 | Topik dan Konvensi Lainnya | signal(7), man-pages(7) |
| 8 | Perintah Manajemen Sistem | mount(8), useradd(8) |
| 9 | Rutinitas Kernel | Ini adalah bagian non-standar dan mungkin tidak ada di semua sistem |
Dalam dokumentasi, Anda mungkin melihat angka setelah nama seperti passwd(1) atau passwd(5). Angka ini bukan versi tetapi bagian dari manual. Masing-masing dapat dibuka sebagai berikut.
man 1 passwd
man 5 passwd
Cara menemukan halaman dengan nama yang sama
Periksa semua bagian yang sesuai
-a menampilkan semua halaman yang ditemukan dalam urutan pencarian satu per satu. Setelah keluar dari halaman pertama, perilaku rinci, seperti menanyakan apakah akan membuka halaman berikutnya atau langsung menampilkan dokumen berikutnya, dapat berbeda tergantung pada implementasi dan pengaturan.
man -a passwd
-f menampilkan nama halaman dan deskripsi singkat. Fungsinya setara dengan whatis pada man-db.
man -f passwd
whatis passwd
Membuka hanya bagian tertentu
Jika Anda mengetahui bagian yang diinginkan, menentukan nomor adalah yang paling akurat. Selain format yang dipisahkan spasi, beberapa implementasi man mendukung format seperti passwd.5 atau 'passwd(5)' yang dikutip.
man 5 passwd
man passwd.5
man 'passwd(5)'
Untuk portabilitas, gunakan format man 5 passwd yang umum dipahami.
Cara mencari berdasarkan kata kunci ketika Anda tidak mengetahui namanya
Mencari berdasarkan nama dan deskripsi singkat
man -k mencari kata kunci dalam nama dan deskripsi singkat halaman manual. apropos juga digunakan untuk tujuan yang sama.
man -k "copy files"
apropos "copy files"
Karena istilah pencarian dapat diperlakukan sebagai ekspresi reguler, jika mereka menyertakan karakter khusus, Anda perlu mempertimbangkan aturan shell dan pencarian. Untuk frasa sederhana, lebih aman menempatkannya dalam tanda kutip, seperti dalam contoh di atas.
Mencari seluruh teks manual
-K mencari teks dalam isi manual, bukan hanya nama atau ringkasan. Pencarian dapat lambat pada sistem dengan banyak halaman; coba -k terlebih dahulu. Hasil yang cocok dibuka secara berurutan dan pencarian dapat dihentikan dengan Ctrl+C.
man -K "environment variable"
Membatasi jangkauan ke bagian tertentu dapat mengurangi waktu pencarian.
man -K 5 "password database"
Opsi man yang sering digunakan
Opsi di bawah ini disusun berdasarkan implementasi man-db yang banyak digunakan di Linux. Karena dukungan dan maknanya dapat berbeda di sistem operasi atau implementasi lain, cara paling akurat untuk memeriksanya adalah menggunakan man man untuk deskripsi pada sistem saat ini.
| Opsi | Deskripsi |
|---|---|
-a, --all |
Menampilkan semua halaman manual yang sesuai dengan nama. |
-f, --whatis |
Mencetak nama halaman dan deskripsi singkat. |
-k, --apropos |
Mencari kata kunci dalam nama dan deskripsi singkat. |
-K, --global-apropos |
Mencari string dalam isi semua halaman manual. |
-w, --where |
Menampilkan lokasi file manual asli tanpa membuka halaman. |
-l, --local-file |
Menampilkan file manual lokal tertentu daripada jalur pencarian. |
-L locale, --locale=locale |
Menentukan lokal yang digunakan dalam eksekusi tersebut. |
-M path, --manpath=path |
Secara langsung menentukan jalur tempat halaman manual akan dicari. |
Sebagai contoh, Anda dapat memeriksa lokasi sebenarnya dari file manual ls yang sedang Anda baca sebagai berikut.
man -w ls
Gunakan perintah help untuk perintah bawaan shell juga
Perintah bawaan yang dijalankan sendiri oleh shell, seperti cd, alias, read, mungkin tidak memiliki file eksekusi terpisah. Di Bash, sebaiknya pertama-tama periksa tipe perintah dengan type, dan jika itu adalah perintah bawaan, menggunakan help lebih akurat dan lebih cepat.
type cd
help cd
help -m cd
help -m menampilkan bantuan dalam format yang mirip dengan halaman manual. Artikel berbahasa Inggris tentang perintah help untuk bawaan Bash membahasnya lebih lanjut. Anda dapat memeriksa penjelasan rinci tentang Bash sebagai berikut.
man bash
Nama yang sama dapat ada secara bersamaan sebagai alias, fungsi, perintah bawaan shell, dan program eksternal, jadi jika Anda tidak yakin apa yang sebenarnya dijalankan, periksa semuanya dengan type -a name.
type -a printf
Memeriksa bahasa dan locale manual
man dapat menampilkan dokumen dalam lokal saat ini terlebih dahulu jika halaman yang diterjemahkan telah diinstal. Anda dapat memeriksa lokal saat ini dengan perintah berikut.
locale
echo "$LANG"
Untuk meminta halaman dengan locale C, yang biasanya menampilkan teks bahasa Inggris jika tersedia, gunakan opsi -L.
man -L C ls
Bahkan jika locale yang cocok telah diset, jika halaman terjemahan tidak diinstal atau tidak ada terjemahan untuk dokumen tersebut, halaman dalam bahasa Inggris dapat ditampilkan. Karena terjemahan mungkin diperbarui lebih lambat daripada aslinya, disarankan untuk memeriksa versi bahasa Inggris dan versi program ketika opsi atau perilakunya mencurigakan.
Cara menangani ketika halaman manual tidak tersedia
Periksa apakah perintah dan paket terkait telah diinstal
Jika No manual entry for... muncul, nama halaman mungkin salah atau paket dokumentasinya belum terpasang. Ganti command dalam contoh berikut dengan nama perintah yang ingin diperiksa. Pesan man: command not found menunjukkan program man sendiri tidak tersedia di jalur pencarian shell.
type -a command
command -v command
Gambar instalasi minimal atau kontainer mungkin tidak memiliki program man dan manual dasar. Pada sistem Debian/Ubuntu dan Rocky Linux/RHEL, paket berikut umumnya diinstal.
sudo apt update
sudo apt install man-db manpages
sudo dnf install man-db man-pages
Perintah instalasi memerlukan hak administrator dan mengubah sistem; tinjau paket yang akan dipasang. Nama paket dan konfigurasi repositori dapat berbeda menurut distribusi dan versinya. Dokumentasi untuk program tertentu dapat disertakan dalam paket program atau paket dokumentasi/pengembangan terpisah, sehingga juga berguna untuk menggunakan fitur pencarian paket distribusi.
Memeriksa basis data dan jalur pencarian
Jika man command terbuka tetapi man -k atau whatis tidak mengembalikan hasil, basis data indeks mungkin belum dibuat. Dalam lingkungan man-db, Anda dapat memperbarui basis data dengan hak administratif.
sudo mandb
Perubahan indeks melalui mandb mungkin memerlukan waktu dan tidak memasang dokumentasi yang hilang. Anda dapat memeriksa jalur pencarian manual dengan manpath. Jika pengguna mengatur MANPATH secara langsung, jalur pencarian default mungkin akan berubah, jadi umumnya lebih baik untuk menghindari mengaturnya tanpa alasan tertentu.
manpath
printf '%s\n' "$MANPATH"
Contoh penggunaan praktis yang berguna
Menemukan opsi dengan cepat
Setelah membuka manual, Anda dapat dengan cepat menemukan opsi yang diperlukan dalam dokumen panjang dengan menggunakan tombol pencarian.
man tar
Ketik /--exclude di layar dan tekan Enter, lalu pindah antar hasil pencarian menggunakan n dan N.
Memeriksa format file konfigurasi
Sebelum memodifikasi file konfigurasi, periksa apakah ada halaman yang relevan di Bagian 5. Arti dari bidang, nilai yang diperbolehkan, aturan komentar, dan contoh dapat dijelaskan.
man 5 fstab
man 5 ssh_config
man 5 sshd_config
Menyelidiki dengan mengikuti dokumen terkait
Jika Anda tidak dapat menemukan jawaban di satu halaman, periksa SEE ALSO di akhir dokumen. Perintah terkait, file konfigurasi, panggilan sistem, dan dokumen konseptual terhubung dalam format name(section), memungkinkan Anda memperluas cakupan pencarian secara sistematis.
man 2 open
man 7 path_resolution
Apa perbedaan man, --help, dan info?
| Metode | Situasi yang sesuai | Fitur |
|---|---|---|
command --help |
Saat Anda ingin dengan cepat melihat sintaks dan opsi | Cocok untuk pemeriksaan singkat; tidak semua perintah mendukung opsi ini. |
man command |
Saat Anda ingin melihat dokumentasi rinci terkait arti opsi, file, dan variabel lingkungan | Menyediakan dokumen referensi yang diinstal di sistem saat ini |
info command |
Saat Anda ingin membaca bab dan contoh program GNU secara mendalam | Ini adalah struktur hypertext dan memerlukan dokumen Info terpisah. |
help command |
Saat memeriksa perintah bawaan Bash | Menampilkan bantuan untuk perintah bawaan yang disediakan oleh Bash saat ini |
Alih-alih hanya terpaku pada satu, lebih efisien untuk pertama-tama memeriksa sintaks dengan --help, membaca perilaku rinci di man, dan menggunakan help bersama untuk perintah bawaan shell.
Pertanyaan yang Sering Diajukan
Apakah angka setelah man adalah versinya?
Tidak. Angka-angka di printf(1) dan printf(3) menunjukkan bagian manual. Bagian 1 mencakup perintah pengguna, dan bagian 3 mencakup fungsi pustaka, jadi meskipun namanya sama, itu adalah dokumen yang berbeda.
Bagaimana cara keluar dari manual?
Jika pager default adalah less, tekan q. Jika tidak keluar, periksa bantuan atau pengaturan dari pager yang sedang Anda gunakan.
Mengapa isi halaman manual berbeda dari dokumen online?
Manual lokal disediakan oleh paket yang diinstal pada sistem saat ini, sehingga dapat bervariasi tergantung pada distribusi, versi paket, dan status instalasi. Di sisi lain, dokumen online mungkin menggambarkan versi yang lebih baru atau implementasi yang berbeda. Untuk opsi yang digunakan pada server yang sebenarnya, yang paling aman adalah memeriksa manual lokal dan command --version.
Bagaimana jika Anda sama sekali tidak tahu nama perintahnya?
Cari nama dan deskripsi singkat menggunakan man -k keyword atau apropos keyword. Jika hasil pencarian terlalu banyak, tambahkan kata yang lebih spesifik atau batasi rentang bagian di lingkungan yang mendukung opsi -s.
Ringkasan
man adalah alat paling dasar untuk memeriksa dokumen referensi yang terpasang pada sistem Linux saat ini. Alih-alih hanya mengingat man command, jika Anda juga mempelajari nomor bagian, pencarian -k, ringkasan -f, pemeriksaan jalur -w, dan pencarian pager bersama-sama, Anda dapat menemukan informasi yang Anda butuhkan jauh lebih cepat.
Pertama, jalankan man man untuk memeriksa opsi yang disediakan oleh implementasi man di sistem Anda. Menggunakan perintah bawaan shell help, pemeriksaan opsi singkat --help, dan deskripsi panjang program GNU info bersama-sama dapat mengurangi celah dalam navigasi dokumen.




