xbps-reconfigure

xbps-reconfigure adalah utilitas XBPS untuk menjalankan ulang skrip konfigurasi paket yang sudah terinstall. Digunakan ketika paket mengalami masalah konfigurasi atau perlu menerapkan ulang perubahan.

Cara Kerja

Ketika paket diinstall, XBPS menjalankan skrip INSTALL yang berisi langkah konfigurasi pasca-instalasi. xbps-reconfigure menjalankan ulang bagian post dari skrip tersebut.

Proses konfigurasi terdiri dari dua langkah:

Langkah	Deskripsi
1	Eksekusi aksi `post` pada skrip INSTALL paket. Isi skrip bisa dilihat dengan `xbps-query --property=install-script <paket>`
2	Update status paket menjadi `XBPS_PKG_STATE_INSTALLED` jika langkah pertama berhasil

Secara default, hanya paket yang belum dikonfigurasi yang diproses. Gunakan -f untuk memaksa konfigurasi ulang.

Opsi

Flag	Keterangan
`-a`, `--all`	Konfigurasi semua paket terinstall
`-f`, `--force`	Paksa konfigurasi ulang meskipun paket sudah dikonfigurasi sebelumnya
`-x`, `--deps`	Konfigurasi paket beserta dependensi langsungnya
`--fulldeptree`	Konfigurasi seluruh pohon dependensi — harus digunakan bersama `-x`
`-i`, `--ignore <pkg>`	Abaikan paket tertentu saat konfigurasi massal (`-a`). Bisa diulang untuk beberapa paket
`-r`, `--rootdir <dir>`	Tentukan direktori root alternatif (untuk chroot atau container)
`-v`, `--verbose`	Tampilkan output lebih detail
`-d`, `--debug`	Tampilkan informasi debug ke stderr

Kapan Digunakan

Skenario	Contoh
Paket dengan konfigurasi bermasalah	Instalasi terputus di tengah jalan
Bangun ulang initramfs	Setelah install atau update kernel
Bangun ulang modul DKMS	Setelah install kernel baru atau linux-headers
Terapkan ulang perubahan font	Setelah menambah atau mengubah konfigurasi font
Recovery sistem	Konfigurasi ulang semua paket sekaligus

Contoh Penggunaan

Paksa konfigurasi ulang satu paket:

sudo xbps-reconfigure -f fontconfig

Konfigurasi semua paket (berguna saat recovery):

sudo xbps-reconfigure -a

Bangun ulang initramfs untuk kernel tertentu:

sudo xbps-reconfigure -f linux6.6

Cek versi kernel yang terinstall dengan xbps-query -l | grep linux.

Konfigurasi paket beserta seluruh pohon dependensinya:

sudo xbps-reconfigure -x --fulldeptree dbus

Konfigurasi semua paket kecuali yang dikecualikan:

sudo xbps-reconfigure -a -i firefox -i vim

Lihat isi skrip INSTALL suatu paket:

xbps-query --property=install-script xbps

Contoh: Ganti Initramfs Generator

Beralih dari dracut ke mkinitcpio:

sudo xbps-install -S mkinitcpio
sudo xbps-alternatives -s mkinitcpio -g initramfs
sudo xbps-reconfigure -f linux6.6

Perbedaan dengan `xbps-install`

Aspek	`xbps-install`	`xbps-reconfigure`
Fungsi utama	Install/update paket	Jalankan ulang skrip konfigurasi paket
Mengubah file paket	Ya (download, ekstrak)	Tidak (hanya eksekusi skrip)
Konfigurasi	Hanya saat instalasi pertama	Bisa dijalankan kapan saja
Bangun initramfs	Tidak otomatis	Ya (untuk paket kernel)
Perlu download	Ya	Tidak

Catatan Penting

Sebagian besar operasi memerlukan sudo karena menyentuh file sistem.
Tanpa -f, paket yang sudah berstatus INSTALLED tidak akan diproses ulang.
Beberapa skrip INSTALL bisa menimpa perubahan konfigurasi manual — perhatikan ini sebelum menjalankan -f pada paket yang konfigurasinya sudah dikustomisasi.
Membangun initramfs memakan waktu dan memerlukan ruang di /boot.

Referensi

man xbps-reconfigure
xbps-reconfigure(1) — Void Linux manpages

@T4n-Labs · @Gh0sT4n