PACREPORT(1)

✨ PACREPORT ✨

okay so bestie, let me put you onto pacreport from the pacreport fam — she's giving "tell me absolutely everything about the packages on this system" and honestly? iconic. 💅

🦋 SYNOPSIS

pacreport [options]
pacreport (--help|--version)

🌸 DESCRIPTION

so basically this generates a whole lil report of the installed packages, and it's covering so much tea, like:

• unneeded packages installed explicitly
• unneeded packages installed as dependencies
• unneeded packages in a dependency cycle
• installed packages not in a repository
• packages missing from specified groups
• missing package files
• unmerged backup files
• unowned files
• cache directory sizes

and psa bestie: package sizes include dependencies not needed by other packages. noted!

also!! packages prefixed by an asterisk ("*") are optional dependencies for another package. so when you see that lil star, you know what's up ✨

🎀 OPTIONS 🎀

• --config=path — sets an alternate pacman configuration file path
• --dbext=extension — sets an alternate sync database extension
• --dbpath=path — sets an alternate database path
• --root=path — sets an alternate installation root
• --sysroot=path — sets an alternate system root. go check pacutils-sysroot(7) bestie 🫶
• --cachedir=path — sets an alternate cache directory path
• --backups — searches for .pac{save,orig,new} files. by default it searches /etc and checks all known config files, but pass it twice to search outside /etc. lowkey a double-tap moment 💀
• --group=name — displays any packages in group name that aren't currently installed. can be specified multiple times, no cap
• --missing-files — checks for missing package files
• --unowned-files — checks for unowned files. peep /etc/pacreport.conf under FILES for more info
• --optional-for — shows which packages optionally depend on listed packages
• --optional-deps — takes optional dependencies into account when listing unneeded packages and dependency loops
• --help — displays usage information and exits
• --version — displays version information and exits

🌈 FILES 🌈

• /etc/pacreport.conf — an INI-style configuration file listing paths to ignore when run with --unowned-files. paths that should always be ignored can be specified with "IgnoreUnowned" in the "Options" section. paths that should only be ignored if a particular package is installed can be listed under the section "PkgIgnoreUnowned", using the package name as the option name and the path to be ignored as the value. all options can be specified multiple times, and paths may include shell-style globs. the installation root should not be included in paths. 🫶

[Options]
IgnoreUnowned = home/*
IgnoreUnowned = proc/*
IgnoreUnowned = mnt/*

[PkgIgnoreUnowned]
linux = boot/initramfs-linux.img
linux = boot/initramfs-linux-fallback.img

okay that's the whole vibe check bestie, go forth and audit those packages 👑💖

— with love from the pacutils crew, dated 2025-12-04, version vibes immaculate 🎀