NAME¶

pkgos-schroot-clean - end all remaining schroot sessions

SYNOPSIS¶

pkgos-schroot-clean [-n|--dry-run]
pkgos-schroot-clean -h | --help

DESCRIPTION¶

pkgos-schroot-clean lists every active schroot session (as shown by schroot --all-sessions --list) and ends each of them with schroot -e, so that no session is left behind after a packaging work batch. A session which is currently in use (for example by a concurrently running sbuild(1) build) cannot be ended: the script prints a warning, carries on with the remaining sessions, and exits non-zero at the end so that the situation is not silently ignored.

OPTIONS¶

-n, --dry-run

Only print the list of the sessions that would be ended, and do not end any of them.

-h, --help

Print a short help message.

EXIT STATUS¶

Returns 0 when every session was ended successfully (which includes the case when there was no session to clean), and non-zero when ending at least one session failed.

EXAMPLES¶

pkgos-schroot-clean --dry-run && pkgos-schroot-clean

SEE ALSO¶

schroot(1), sbuild(1).

AUTHOR¶

This script and its man page: (c) 2026, Thomas Goirand <zigo@debian.org>, released under the Apache-2.0 license.