pclean - system cleaning utility¶
Synopsis¶
pclean [-h] [–version] [–debug] [-q] [-v] [–color BOOLEAN] [–config CONFIG_PATH] [–domain DOMAIN] {config,dist,pkg,tmp} …
Base Options¶
-h, --helpShow this help message and exit. To get more information see the related man page.
--versionShow this program’s version information and exit.
When running from within a git repo or a version installed from git the latest commit hash and date will be shown.
--debugEnable debug checks and show verbose debug output.
-q, --quietSuppress non-error, informational messages.
-v, --verboseIncrease the verbosity of various output.
--color BOOLEANToggle colored output support. This can be used to forcibly enable color support when piping output or other situations where stdout is not a tty.
Config Options¶
--config CONFIG_PATHThe path to a custom pkgcore config file or portage config directory can be given to override loading the default system config.
Alternatively, an argument of ‘false’ or ‘no’ will skip loading the system config entirely if one exists.
--domain DOMAINcustom pkgcore domain to use for this operation
Subcommands¶
cleaning applets
pclean config - remove config file settings¶
Synopsis¶
pclean config [-p] [-x EXCLUDE] [-X EXCLUDE_FILE] [-S PKGSET] [-h] [–debug] [-q] [-v] [–color BOOLEAN] [TARGET …]
Generic Cleaning Options¶
TARGETpackages to target for cleaning
-p, --pretenddry run without performing any changes
-x EXCLUDE, --exclude EXCLUDElist of packages to exclude from removal
-X EXCLUDE_FILE, --exclude-file EXCLUDE_FILEpath to exclusion file
-S PKGSET, --pkgsets PKGSETlist of pkgsets to include or exclude from removal
Base Options¶
-h, --helpShow this help message and exit. To get more information see the related man page.
--debugEnable debug checks and show verbose debug output.
-q, --quietSuppress non-error, informational messages.
-v, --verboseIncrease the verbosity of various output.
--color BOOLEANToggle colored output support. This can be used to forcibly enable color support when piping output or other situations where stdout is not a tty.
pclean dist - remove distfiles¶
Synopsis¶
pclean dist [-p] [-x EXCLUDE] [-X EXCLUDE_FILE] [-S PKGSET] [-m TIME] [-s SIZE] [-I] [-E] [-f] [-r REPO] [-h] [–debug] [-q] [-v] [–color BOOLEAN] [TARGET …]
Generic Cleaning Options¶
TARGETpackages to target for cleaning
-p, --pretenddry run without performing any changes
-x EXCLUDE, --exclude EXCLUDElist of packages to exclude from removal
-X EXCLUDE_FILE, --exclude-file EXCLUDE_FILEpath to exclusion file
-S PKGSET, --pkgsets PKGSETlist of pkgsets to include or exclude from removal
File Cleaning Options¶
-m TIME, --modified TIMEDon’t remove files that have been modified since a given time. For example, to skip files newer than a year use “1y” as an argument to this option. this option.
Supported units are y, m, w, and d, and s representing years, months, weeks, days, and seconds, respectively.
-s SIZE, --size SIZEDon’t remove files bigger than a given size. For example, to skip files larger than 100 megabytes use “100M” as an argument to this option.
Supported units are B, K, M, and G representing bytes, kilobytes, megabytes, and gigabytes, respectively.
Repo Cleaning Options¶
-I, --installedskip files for packages that are currently installed
-E, --existsskip files for packages that relate to ebuilds in the tree
-f, --fetch-restrictedskip fetch-restricted files
-r REPO, --repo REPOTarget repository to search for matches. If no repo is specified all relevant repos are used.
Base Options¶
-h, --helpShow this help message and exit. To get more information see the related man page.
--debugEnable debug checks and show verbose debug output.
-q, --quietSuppress non-error, informational messages.
-v, --verboseIncrease the verbosity of various output.
--color BOOLEANToggle colored output support. This can be used to forcibly enable color support when piping output or other situations where stdout is not a tty.
pclean pkg - remove binpkgs¶
Synopsis¶
pclean pkg [-p] [-x EXCLUDE] [-X EXCLUDE_FILE] [-S PKGSET] [-m TIME] [-s SIZE] [-I] [-E] [-f] [-r REPO] [–source-repo REPO] [-b] [-c CHANGED] [-h] [–debug] [-q] [-v] [–color BOOLEAN] [TARGET …]
Generic Cleaning Options¶
TARGETpackages to target for cleaning
-p, --pretenddry run without performing any changes
-x EXCLUDE, --exclude EXCLUDElist of packages to exclude from removal
-X EXCLUDE_FILE, --exclude-file EXCLUDE_FILEpath to exclusion file
-S PKGSET, --pkgsets PKGSETlist of pkgsets to include or exclude from removal
File Cleaning Options¶
-m TIME, --modified TIMEDon’t remove files that have been modified since a given time. For example, to skip files newer than a year use “1y” as an argument to this option. this option.
Supported units are y, m, w, and d, and s representing years, months, weeks, days, and seconds, respectively.
-s SIZE, --size SIZEDon’t remove files bigger than a given size. For example, to skip files larger than 100 megabytes use “100M” as an argument to this option.
Supported units are B, K, M, and G representing bytes, kilobytes, megabytes, and gigabytes, respectively.
Repo Cleaning Options¶
-I, --installedskip files for packages that are currently installed
-E, --existsskip files for packages that relate to ebuilds in the tree
-f, --fetch-restrictedskip fetch-restricted files
-r REPO, --repo REPOTarget repository to search for matches. If no repo is specified all relevant repos are used.
Binpkg Cleaning Options¶
--source-repo REPOremove binpkgs with matching source repo
-b, --bindistonly remove binpkgs that restrict distribution
-c CHANGED, --changed CHANGEDcomma separated list of package attributes to check for ebuild changes
Base Options¶
-h, --helpShow this help message and exit. To get more information see the related man page.
--debugEnable debug checks and show verbose debug output.
-q, --quietSuppress non-error, informational messages.
-v, --verboseIncrease the verbosity of various output.
--color BOOLEANToggle colored output support. This can be used to forcibly enable color support when piping output or other situations where stdout is not a tty.
pclean tmp - remove tmpdir entries¶
Synopsis¶
pclean tmp [-p] [-x EXCLUDE] [-X EXCLUDE_FILE] [-S PKGSET] [-h] [–debug] [-q] [-v] [–color BOOLEAN] [-a] [TARGET …]
Generic Cleaning Options¶
TARGETpackages to target for cleaning
-p, --pretenddry run without performing any changes
-x EXCLUDE, --exclude EXCLUDElist of packages to exclude from removal
-X EXCLUDE_FILE, --exclude-file EXCLUDE_FILEpath to exclusion file
-S PKGSET, --pkgsets PKGSETlist of pkgsets to include or exclude from removal
Base Options¶
-h, --helpShow this help message and exit. To get more information see the related man page.
--debugEnable debug checks and show verbose debug output.
-q, --quietSuppress non-error, informational messages.
-v, --verboseIncrease the verbosity of various output.
--color BOOLEANToggle colored output support. This can be used to forcibly enable color support when piping output or other situations where stdout is not a tty.
Tmpfile Options¶
-a, --allForce the entire tmpdir to be wiped. Note that this overrides any restrictions that have been specified.