Perintah modinfo Linux: baca metadata dan parameter modul

Perintah modinfo menampilkan metadata modul kernel Linux, seperti deskripsi, lokasi berkas, lisensi, alias, dependensi, dan parameter. Perintah ini tidak memuat modul atau mengubah pengaturannya; metadata yang ditemukan juga tidak membuktikan modul sedang dimuat.

Modul kernel adalah komponen yang menyediakan driver atau fungsi kernel. Modinfo dapat menerima nama modul atau path berkas. Untuk pencarian berdasarkan nama, perhatikan versi kernel yang dipilih agar informasi modul terpasang tidak tertukar dengan keadaan kernel yang sedang berjalan.

Sintaks dan prasyarat

modinfo [OPSI] NAMA_MODUL|PATH_BERKAS

OPSI, NAMA_MODUL, dan PATH_BERKAS adalah penanda. Pilih nama modul atau path berkas; tanda | pada sintaks menunjukkan pilihan, bukan pipe yang harus diketik. Panduan ini membahas modinfo dari paket kmod. Periksa modinfo -V, modinfo -h, atau man modinfo pada sistem tujuan.

Jika argumen berupa nama, modinfo mencari dalam direktori modul untuk kernel yang dipilih. Secara bawaan, pencarian mengikuti rilis kernel yang sedang berjalan. Argumen berupa path menunjuk berkas tertentu sehingga identitas berkas tersebut tetap perlu diperiksa.

Lihat metadata modul

modinfo overlay

Overlay adalah contoh nama modul. Gunakan nama yang sesuai kebutuhan diagnosis. Keluaran umumnya berupa pasangan nama bidang dan nilai, tetapi tidak semua modul menyediakan semua bidang.

• filename: lokasi berkas modul yang ditemukan.
• description dan license: deskripsi serta informasi lisensi yang dicantumkan dalam metadata.
• alias: nama atau pola identifikasi yang terkait dengan modul.
• depends: dependensi yang dibutuhkan modul, bukan daftar modul lain yang sedang memakainya.
• parm: parameter yang didokumentasikan modul, bukan otomatis nilai parameter yang sedang diterapkan.

Untuk memeriksa modul yang sedang dimuat, gunakan lsmod dan penjelasan kolom Used by. Bedakan arah dependensi pada depends dari modul pemakai yang dapat muncul dalam keluaran lsmod.

Ambil lokasi berkas saja

modinfo -n overlay

Opsi -n merupakan bentuk singkat untuk bidang filename. Gunakan hasilnya untuk memastikan berkas yang sedang diperiksa. Path dapat berbeda menurut distribusi, rilis kernel, dan cara modul dipaketkan; jangan menyalin path contoh dari mesin lain sebagai lokasi yang pasti ada.

Keberadaan berkas tidak memastikan modul itu sedang dimuat atau cocok untuk dimuat pada kernel lain. Pemeriksaan ini hanya membaca metadata, sehingga tidak perlu mencoba memuat modul untuk melihat hasilnya.

Periksa parameter yang disediakan

modinfo -p overlay

Opsi -p menampilkan metadata parameter, termasuk uraian yang disediakan modul. Jika suatu bidang tidak tersedia, jangan membuat nilai bawaan atau nama parameter berdasarkan dugaan. Tidak semua modul menyediakan parameter yang sama.

Daftar parameter berbeda dari konfigurasi yang berlaku pada modul yang telah dimuat. Untuk diagnosis nilai aktif, periksa antarmuka dan dokumentasi modul pada sistem tersebut. Mengubah parameter merupakan pekerjaan administrasi tersendiri yang dapat memengaruhi perangkat atau layanan; modinfo -p tidak melakukannya.

Pilih satu bidang dan pahami contoh keluaran

modinfo -F license nf_conntrack

Opsi -F memilih nilai bidang, dalam contoh ini license dari nf_conntrack. Jika metadata modul tersebut tersedia dan memuat lisensi itu, contoh hasilnya:

GPL

GPL adalah nilai ilustrasi untuk contoh ini, bukan hasil yang dijamin untuk semua modul. Modinfo membaca pernyataan metadata; keluaran satu bidang tidak menggantikan pemeriksaan seluruh ketentuan lisensi bila Anda hendak mendistribusikan perangkat lunak.

Bidang dapat memiliki lebih dari satu nilai. Jangan menganggap setiap kueri -F selalu menghasilkan satu baris. Untuk program yang perlu memisahkan nilai tanpa mengandalkan baris baru, periksa dukungan -0 pada versi terpasang. Penjelasan bidang dan pemisah tersedia dalam manual resmi modinfo dari proyek kmod.

Opsi penting

Misalnya, bentuk modinfo -k RILIS overlay memerlukan penggantian RILIS dengan rilis kernel yang modulnya benar-benar terpasang. Opsi ini hanya mengganti sasaran pencarian; tidak mengganti kernel yang sedang berjalan.

Jika modul tidak ditemukan

Pesan seperti Module ... not found dapat berarti nama salah atau metadata untuk kernel yang dipilih tidak tersedia. Periksa uname -r untuk rilis kernel berjalan, lalu cocokkan dengan berkas dan paket modulnya. Panduan uname menjelaskan perbedaan kernel berjalan dan informasi distribusi.

Periksa juga apakah fitur dibangun langsung ke dalam kernel dan apakah metadata modul bawaan tersedia pada instalasi tersebut. Tidak adanya berkas modul terpisah atau kegagalan modinfo tidak cukup untuk menyimpulkan bahwa fitur sama sekali tidak didukung.

Dalam kontainer, kernel dapat berasal dari host sementara direktori modul pada sistem berkas kontainer tidak tersedia atau berbeda. Jika diagnosis menyangkut kernel host, periksa sumber informasi host yang sesuai. Jangan memasang atau memuat modul acak hanya untuk menghilangkan pesan pencarian.

FAQ

Apakah hasil modinfo berarti modul sedang aktif?

Tidak. Modinfo membaca metadata, sedangkan lsmod menunjukkan modul yang sedang dimuat. Status driver pada perangkat dan berfungsinya layanan juga perlu diperiksa terpisah.

Mengapa modinfo tidak menampilkan hasil?

Periksa pesan kesalahan, nama atau path, rilis kernel sasaran, dan metadata yang terpasang. Jika hanya satu bidang yang diminta, bidang itu juga mungkin tidak disediakan oleh modul tersebut.