| .TH "EMAINT" "1" "Feb 2021" "Portage VERSION" "Portage" |
| .SH NAME |
| emaint \- performs package management related system health checks and maintenance |
| .SH SYNOPSIS |
| .BR emaint |
| [\fIoptions\fR] |
| [\fBall\fR | \fBbinhost\fR | \fBcleanresume\fR | \ |
| \fBmerges\fR | \fBmovebin\fR | \fBmoveinst\fR | \fBsync\fR | \fBworld\fR] |
| .SH DESCRIPTION |
| The emaint program provides a command line interface to package |
| management health checks and maintenance. |
| .SH COMMANDS |
| .TP |
| .BR all |
| Perform all supported commands that accept the specified option. |
| .TP |
| .BR binhost |
| Generate a metadata index for binary packages located in \fBPKGDIR\fR (for |
| download by remote clients). See the \fBPORTAGE_BINHOST\fR documentation in |
| the \fBmake.conf\fR(5) man page for additional information. |
| .br |
| OPTIONS: check, fix |
| .TP |
| .BR cleanconfmem |
| Discard no longer installed config tracker entries. |
| .br |
| OPTIONS: check, fix |
| .TP |
| .BR cleanresume |
| Discard merge lists saved for the \fBemerge\fR(1) \fB--resume\fR action. |
| .br |
| OPTIONS: check, fix |
| .TP |
| .BR logs |
| Clean out old logs from the \fBPORTAGE_LOGDIR\fR using the command |
| \fBPORTAGE_LOGDIR_CLEAN\fR. |
| See the \fBmake.conf\fR(5) man page for additional information as well as |
| enabling the \fB'clean-logs'\fR feature in emerge to do this automatically. |
| .br |
| OPTIONS: check, clean |
| .TP |
| .BR merges |
| Scan for failed package merges and attempt to fix those failed packages. |
| .br |
| OPTIONS: check, fix, purge |
| .TP |
| .BR movebin |
| Perform package move updates for binary packages located in \fBPKGDIR\fR. |
| .br |
| OPTIONS: check, fix |
| .TP |
| .BR moveinst |
| Perform package move updates for installed packages. |
| .br |
| OPTIONS: check, fix |
| .TP |
| .BR sync |
| Perform sync actions on specified repositories. |
| .br |
| OPTIONS: allrepos, auto, repo |
| .TP |
| .BR world |
| Fix problems in the \fIworld\fR file. |
| .br |
| OPTIONS: check, fix |
| .SH DEFAULT OPTIONS (Not supported in all commands) |
| .TP |
| .BR \-c ", " \-\-check |
| Check for any problems that may exist. |
| .TP |
| .BR \-f ", " \-\-fix |
| Fix any problems that may exist. |
| .SH OPTIONS logs command only |
| .TP |
| .BR \-C ", " \-\-clean |
| Cleans the logs from \fBPORTAGE_LOGDIR\fR |
| .TP |
| .BR \-p ", " \-\-pretend |
| Sets pretend mode (same as \-c, \-\-check) for use with the \-C, \-\-clean |
| OPTION |
| .TP |
| .BR \-t \ \fINUM\fR,\ \-\-time \ \fINUM\fR |
| Changes the minimum age \fINUM\fR (in days) of the logs to be listed or |
| deleted. |
| .SH OPTIONS merges command only |
| .TP |
| .BR \-y ", " \-\-yes |
| Do not prompt for emerge invocations. |
| .SH OPTIONS sync command only |
| .TP |
| .BR \-a ", " \-\-auto |
| Sync repositories which have their auto\-sync setting set yes, true. |
| .TP |
| .BR \-A ", " \-\-allrepos |
| Sync all repositories which have a sync\-uri specified. |
| .TP |
| .BR \-r ", " \-\-repo \ \fIREPO\fR |
| Sync the repository specified. |
| .TP |
| .BR \-\-sync-submodule \ \fI<glsa|news|profiles>\fR |
| Restrict sync to the specified submodule(s). This option may be |
| specified multiple times, in order to sync multiple submodules. |
| Currently, this option has no effect for sync protocols other |
| than rsync. |
| .SH "REPORTING BUGS" |
| Please report bugs via https://bugs.gentoo.org/ |
| .SH AUTHORS |
| .nf |
| Pavel Kazakov <nullishzero@gentoo.org> |
| Mike Frysinger <vapier@gentoo.org> |
| Brian Dolbec <dolsen@gentoo.org> |
| .fi |
| .SH "FILES" |
| .TP |
| .B /var/lib/portage/world |
| Contains a list of all user\-specified packages. |
| .TP |
| .B /var/lib/portage/config |
| Contains the paths and md5sums of all the config files being tracked. |
| .TP |
| .B /var/lib/portage/failed-merges |
| Contains the packages and timestamps of any failed merges being cleaned from |
| the system, and to be re-emerged. |
| .SH "SEE ALSO" |
| .BR emerge (1), |
| .BR portage (5) |
