PKCON(1)

📦
version 1.4.0 · 2 versions
, in centos-stream 10, debian bookworm, debian trixie, fedora 43, fedora 44, opensuse-leap 16.0, ubuntu noble, ubuntu questing

💖 NAME 💖

okay so bestie, the command is pkcon, and it's the PackageKit console client 💅 basically your command line buddy for PackageKit 🦋

✨ SYNOPSIS ✨

pkcon [OPTION...] [COMMAND]

🌸 DESCRIPTION 🌸

ngl this manual page is just a quick intro to the pkcon command 🎀

pkcon is the command line client for PackageKit, so if you want to install, remove, update, or search for packages from your terminal, this is literally your girl 👑

🧚 COMMANDS 🧚

okay so pkcon knows a bunch of commands ✨ heads up though, not all of them may show up depending on the backend you're using 🙈

  • backend-details — peek at info about the PackageKit backend that's currently in use 🔍
  • get-roles — see the list of roles a transaction can have 🎭
  • get-groups — list the available package groups 🍓
  • get-filters — list the available filters 🫧
  • get-transactions — list the transactions it knows about 📜
  • get-time ROLE — see how much time has passed since the last transaction with the given role ⏰
  • search [name|details|group|file] DATA — search for a package matching your data 🔎 the search happens in whatever package info is picked by the first argument: name, details, group or files 💜
  • install PACKAGES — install the given packages from repositories 📦
  • install-local FILES — install the given packages from the local filesystem 💾
  • download DIRECTORY PACKAGES — download the given packages from repositories and stash them in the directory you give 📥
  • install-sig TYPE KEY_ID PACKAGE — install a package signature 🔐 only GPG signatures are supported right now, so that's the vibe 🙏
  • remove PACKAGE — remove the given package 🗑️
  • update [PACKAGES] — update your system by installing the available updates 🆙 if you give it a list of packages, it'll only install updates for those ones 🎯
  • refresh [force] — refresh the cached info about available updates 🔄
  • resolve PACKAGE — resolve the given package name and print info about installed or available packages and updates 🧩
  • upgrade-system DISTRIBUTION [minimal|default|complete] — upgrade your system to the given distribution 🚀
  • get-updates — list the available updates ⭐
  • get-distro-upgrades — list the available distribution upgrades 🌈
  • depends-on PACKAGE — list the dependencies for the given package 🕸️
  • required-by PACKAGE — list the packages that need the given package 🤝
  • get-details PACKAGE — print details about the available or installed package with the given name 📋
  • get-details-local FILE — print details about the local package 📄
  • get-files PACKAGE — list the files inside the given package 🗂️
  • get-files-local FILE — list the files inside the local package 🗃️
  • get-update-detail PACKAGE — print the package changelog for the given package 📝
  • get-packages — list every available and installed package 💅
  • repo-list — list all the configured package repositories 📚
  • repo-enable REPOSITORY — enable the given repository ✅
  • repo-disable REPOSITORY — disable the given repository ❌
  • repo-set-data REPOSITORY PARAMETER DATA — set the given parameter to the given value for the repository 🛠️
  • repo-remove REPOSITORY PARAMETER — removes the repository and, optionally, any packages installed from it 🧹
  • what-provides STRING — list the packages that provide the given string 🔮
  • accept-eula EULA_ID — accept the EULA with the given id 📜✍️
  • get-categories — list the available categories 🏷️
  • repair — attempt to repair the system package database 🩹
  • offline-get-prepared — print info about the prepared offline update 🌙 if no offline update is prepared, it exits with an exit code of 1 💀
  • offline-trigger — trigger an offline update ⚡
  • offline-status — print info about the result of the last offline update 📊

🎀 OPTIONS 🎀

okay so these options can be used to tweak how pkcon behaves 💖

  • --version — print the program version and exit 🏷️
  • -h, --help — show the help options 🆘
  • --help-all — show all the help options 📖
  • --filter FILTER — set the filter you want to use 🫧
  • -y, --noninteractive — install packages without asking you for confirmation 😤✨
  • --only-download — prepare the transaction by only downloading packages 📥
  • -n, --background — run the command using idle network bandwidth, and also using less power 🔋🌿
  • -p, --plain — print a machine-readable output to the screen instead of animated widgets 🤖
  • -v, --verbose — show debugging info 🕵️‍♀️
  • -c, --cache-age AGE — set the maximum acceptable age for cached metadata, in seconds ⏳ use -1 for 'never' 🙈
  • --allow-untrusted — allow untrusted packages to be installed ⚠️
  • --allow-downgrade — allow packages to be downgraded during a transaction ⬇️
  • --allow-reinstall — allow packages to be reinstalled during a transaction 🔁

🚦 RETURN VALUES 🚦

here's what the exit codes mean, bestie 💅

  • 0 — Success 🎉
  • 1 — failed with a miscellaneous internal error 💥
  • 3 — failed with a syntax error, or failed to parse the command 🙃
  • 4 — failed because a file or directory wasn't found 📂
  • 5 — nothing useful was done 🫠
  • 6 — the initial setup failed, e.g. setting the network proxy 🌐
  • 7 — the transaction failed, check the detailed error for more info 🧾

🔗 SEE ALSO 🔗

check out pkmon (1) too 💜

the programs are fully documented on https://www.freedesktop.org/software/PackageKit 📚

🫶 AUTHOR 🫶

this manual page was written by Richard Hughes <richard@hughsie.com> 💖

👑 AUTHOR 👑

Richard Hughes, the author 🌟

Copyright © 2007 - 2013 Richard Hughes 💜

bestie, this page is from PKCON(1) (User Commands) for PackageKit, dated July 29, 2013 🎀 stay iconic and keep those packages updated 🦋✨

📦 where this page comes from