.\" generated by mkman.py, please do NOT edit!
.TH qlop "1" "Feb 2019" "Gentoo Foundation" "qlop"
.SH NAME
qlop \- emerge log analyzer
.SH SYNOPSIS
.B qlop
\fI[opts] <pkgname>\fR
.SH DESCRIPTION
.I qlop
reads from $EMERGE_LOG_DIR/emerge.log and tries to extract
information about merges, unmerges and syncs.  It can
calculate average merge times or just list them.  When given no
arguments or just \fB-v\fR, \fIqlop\fR acts as if \fB-must\fR was given
and thus lists the time taken for all occurrances of merges, unmerges
and sync operations found in the log.
.P
By default, packages are printed as CATEGORY/PN.  Use \fB-v\fR to print
the package version and revision numbers, e.g\. CATEGORY/PF.  Note that
when using this option, averages (\fB-a\fR) are reported per version
instead of per package.
.P
The non-option arguments to \fIqlop\fR can be any valid atoms.  Multiple
can be given to match.  Since all of these are treated as atoms, version
specifications can be used such as \fB<bash-5\fR.  This allows to zoom
in further on specific packages.
.P
After version \fB0.74\fR of portage-utils, \fIqlop\fR was changed
considerably to be more consistent and more advanced.  Most notably,
this has changed default date output and commmand line flags.  Instead
of reporting the time the operation finished, \fIqlop\fR now reports the
time the operation started.  The behaviour of the old \fB-q\fR flag is
best matched by the new \fB-t\fR flag.  Similar, the old \fB-t\fR flag
is matched by the new \fB-a\fR flag.
.SH OPTIONS
.TP
\fB\-c\fR, \fB\-\-summary\fR
Show a grand total for averages.  This option implies \fB-a\fR.
Useful to compute time it takes to recompile all packages or a set
of packages (e.g\. world).
.TP
\fB\-t\fR, \fB\-\-time\fR
Show the time it took to merge, unmerge or sync.
.TP
\fB\-a\fR, \fB\-\-average\fR
Calculate average merge, unmerge or sync time.  This is the average
time for all occurrences found respecting any date limits.
.TP
\fB\-H\fR, \fB\-\-human\fR
Print elapssed time in human readable format.  This form uses
minutes, hours and days instead of just seconds.
.TP
\fB\-M\fR, \fB\-\-machine\fR
Print elapsed time as seconds with no formatting.
.TP
\fB\-m\fR, \fB\-\-merge\fR
Show merge history.
.TP
\fB\-u\fR, \fB\-\-unmerge\fR
Show unmerge history.
.TP
\fB\-U\fR, \fB\-\-autoclean\fR
Show autoclean unmerge history.
.TP
\fB\-s\fR, \fB\-\-sync\fR
Show sync history.
.TP
\fB\-e\fR, \fB\-\-endtime\fR
Report time at which the operation finished (iso started).
.TP
\fB\-r\fR, \fB\-\-running\fR
Print operations currently in progress.  An ETA is calculated based
on the average for the operation.  If the elapsed exceeds the
average, the ETA is calculated against the longest time observed for
the operation.  If the elapsed time exceeds this too, or no previous
occurrences for the operation exist, \fIunknown\fR is printed.
.TP
\fB\-d\fR \fI<arg>\fR, \fB\-\-date\fR \fI<arg>\fR
Limit the selection of packages to the date given, or to the range
of dates if this argument is given twice.  The \fB--date\fR option
can take a few forms.
.RS
.IP "NUMBER <day|week|month|year>[s] [ago]"
Relative time, specifying \fINUMBER\fR \fIdays\fR, \fIweeks\fR,
\fImonths\fR or \fIyears\fR, for example \fI3 days ago\fR.
.IP today
Alias for \fI0 days ago\fR.
.IP yesterday
Alias for \fI1 day ago\fR.
.IP YYYY-MM-DD
Big-endian date, with components separated by hyphens, starting with
year, followed by month and day of month.
.IP SSSSSSSSS
Seconds since 1970-01-01 00:00:00 +0000 (UTC), the UNIX epoch.
.IP FORMAT|DATE
Use \fIFORMAT\fR as input for \fBstrptime\fR(3) to parse \fIDATE\fR.
.RE
.TP
\fB\-f\fR \fI<arg>\fR, \fB\-\-logfile\fR \fI<arg>\fR
Read emerge logfile instead of $EMERGE_LOG_DIR/emerge.log.
.TP
\fB\-w\fR \fI<arg>\fR, \fB\-\-atoms\fR \fI<arg>\fR
Read package atoms to report from file.
.TP
\fB\-\-root\fR \fI<arg>\fR
Set the ROOT env var.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Print package versions and revisions (PF) instead of package (PN).
.TP
\fB\-q\fR, \fB\-\-quiet\fR
Tighter output; suppress warnings.
.TP
\fB\-C\fR, \fB\-\-nocolor\fR
Don't output color.
.TP
\fB\-h\fR, \fB\-\-help\fR
Print this help and exit.
.TP
\fB\-V\fR, \fB\-\-version\fR
Print version and exit.

.SH "REPORTING BUGS"
Please report bugs via http://bugs.gentoo.org/
.br
Product: Portage Development; Component: Tools
.SH AUTHORS
.nf
Ned Ludd <solar@gentoo.org>
Mike Frysinger <vapier@gentoo.org>
Fabian Groffen <grobian@gentoo.org>
.fi
.SH "SEE ALSO"
.BR q (1),
.BR qatom (1),
.BR qcache (1),
.BR qcheck (1),
.BR qdepends (1),
.BR qfile (1),
.BR qgrep (1),
.BR qlist (1),
.BR qmerge (1),
.BR qpkg (1),
.BR qsearch (1),
.BR qsize (1),
.BR qtbz2 (1),
.BR qtegrity (1),
.BR quse (1),
.BR qxpak (1)