APTITUDE-RUN-STATE(1)

💖 aptitude-run-state-bundle — the girlies' guide to section 1 of the manual 💖

okay so bestie, this is aptitude-run-state-bundle, and it lives in the section 1 of the command-line reference. she's a little niche, she's a little internal, but she ATE. 🎀

---

✨ NAME ✨

aptitude-run-state-bundle — unpack an aptitude state bundle and invoke aptitude on it 🦋

---

✨ SYNOPSIS ✨

aptitude-run-state-bundle [<options>...] <input-file>
                          [<program> [<arguments>...]]

---

✨ DESCRIPTION ✨

⚠️ Note — heads up bestie: this command is mostly for internal use and bug reporting in exceptional cases, it is not intended for end-users under normal circumstances. so like, don't just casually run it, mwah 💅

so what does she actually do? aptitude-run-state-bundle unpacks the given aptitude state bundle — the kind created by aptitude-create-state-bundle(1) — into a temporary directory, then invokes <program> on it with the supplied <arguments>, and then removes that temporary directory afterwards. clean up after yourself queen 👑

and if <program> isn't supplied? no worries, she defaults to aptitude(8). iconic default behavior fr fr 🌸

---

✨ OPTIONS ✨

the following options may occur on the command-line before the input file. options following the input file are presumed to be arguments to aptitude. so order matters, no cap 💀

• --append-args — Place the options that give the location of the state bundle at the end of the command line when invoking <program>, rather than at the beginning (the default is to place options at the beginning). ✨
• --help — Display a brief usage summary. that's it, she's helpful like that 🫶
• --prepend-args — Place the options that give the location of the state bundle at the beginning of the command line when invoking <program>, overriding any previous --append-args (the default is to place options at the beginning). lowkey just puts things back how they were 💜
• --no-clean — Do not remove the unpacked state directory after running aptitude. You might want to use this if, for instance, you are debugging a problem that appears when aptitude's state file is modified. When aptitude finishes running, the name of the state directory will be printed so that you can access it in the future. 🕵️♀️ This option is enabled automatically by --statedir. (they're besties, they come as a pair 🎀)
• --really-clean — Delete the state directory after running aptitude, even if --no-clean or --statedir was supplied. she said no leftovers, periodt 🗑️
• --statedir — Instead of treating the input file as a state bundle, treat it as an unpacked state bundle. For instance, you can use this to access the state directory that was created by a prior run with --no-clean. 💖
• --unpack — Unpack the input file to a temporary directory, but don't actually run aptitude. all the unpacking, none of the running, main character energy who does zero work 🌈

---

✨ SEE ALSO ✨

• aptitude-create-state-bundle(1)
• aptitude(8)
• apt(8)

the whole friend group, go read them too 📚💕

---

✨ AUTHORS ✨

• Daniel Burrows <dburrows@debian.org> — Main author of the document. 👑
• Manuel A. Fernandez Montecelo <mafm@debian.org> — Main maintainer after Daniel Burrows, documentation about new features, corrections and formatting. 🎀

---

✨ COPYRIGHT ✨

Copyright 2007 Daniel Burrows.

This manual page is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This manual page is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

ok real talk bestie, that license bit is a whole legal vibe but you gotta keep it exactly as-is, no paraphrasing allowed 💀📜

---

and that's the whole page!! this was aptitude-run-state-bundle version 0.8., dated 02/04/2026 — go forth and debug responsibly, you absolute icon 🦋💖✨ slay, bye!!