from small one page howto to huge articles all in one place
Last additions:
May 25th. 2007:
April, 26th. 2006:
| 
qlop
Section: qlop (1) Updated: Feb 2026 Index
Return to Main Contents
NAME
qlop - emerge log analyzer
SYNOPSIS
qlop
[opts] <pkgname>
DESCRIPTION
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 -v, qlop acts as if -slumt was given
and thus lists the time taken for all occurrances of merges, unmerges
and sync operations found in the log for the last emerge(1) action
performed by Portage.
By default, packages are printed as CATEGORY/PN. Use -v to print
the package version and revision numbers, e.g. CATEGORY/PF. Note that
when using this option, averages ( -a) are reported per version
instead of per package.
The no-option arguments to qlop 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 <bas-5. This allows to zoom
in further on specific packages.
After version 0.74 of portag-utils, qlop was changed
considerably to be more consistent and more advanced. Most notably,
this has changed default date output and command line flags. Instead
of reporting the time the operation finished, qlop now reports the
time the operation started. The behaviour of the old -g flag is
best matched by the new -t flag. Similar, the old -t flag
is matched by the new -a flag.
OPTIONS
- -c, --summary
-
Show a grand total for averages. This option implies -a.
Useful to compute time it takes to recompile all packages or a set
of packages (e.g. world).
- -t, --time
-
Show the time it took to merge, unmerge or sync.
- -a, --average
-
Calculate average merge, unmerge or sync time. This is the average
time for all occurrences found respecting any date limits.
- -p, --predict
-
Print prediction of time it takes to complete action.
- -H, --human
-
Print elapssed time in human readable format. This form uses
minutes, hours and days instead of just seconds.
- -M, --machine
-
Print start/elapsed time as seconds with no formatting.
- -m, --merge
-
Show merge history.
- -u, --unmerge
-
Show unmerge history.
- -U, --autoclean
-
Show autoclean unmerge history.
- -s, --sync
-
Show sync history.
- -E, --emerge
-
Immitate emerge(1) output, as if emerge-pv had been
run. This produces a list of packages that were installed (N),
upgraded (U), downgraded (UD), r-installed (R) or unmerged (D).
The list always includes the version numbers, and for up/downgrades
the previous version is listed between square brackets after the
package. When -v is used, the emerge invocations are
printed as well, to really show what happened. When concurrent
merges are present in the displayed timeframe, the output will be
hard to read. This is a limitation of the emerge.log format.
It is possible to combine this flag with the -d flag, in which
case the default behaviour of displaying the last merge (-l)
is disabled.
- -e, --endtime
-
Report time at which the operation finished (iso started).
- -r, --running
-
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. The -v flag will display which mode is
currently used. If the elapsed time also exceeds the longest time
observed, or no previous occurrences for the operation exist,
unknown is printed. When combined with -t the
elapsed time is also displayed.
- -d <arg>, --date <arg>
-
Limit the selection of packages to the date given, or to the range
of dates if this argument is given twice. The -date option
can take a few forms.
-
- NUMBER <day|week|month|year>[s] [ago]
-
Relative time, specifying NUMBER days, weeks,
months or years, for example 3 days ago.
- today
-
Alias for 0 days ago.
- yesterday
-
Alias for 1 day ago.
- YYY-M-DD
-
Bi-endian date, with components separated by hyphens, starting with
year, followed by month and day of month.
- YYY-M-DDThh:mm:ss
-
As before, but hours, minutes and seconds added. This is the same
format qlop prints for timestamps.
- SSSSSSSSS or @SSSSSSSSS
-
Seconds since 197-0-01 00:00:00 +0000 (UTC), the UNIX epoch.
- FORMAT|DATE
-
Use FORMAT as input for strptime(3) to parse DATE.
- -l, --lastmerge
-
Limit selection to last Portage emerge action. This option is a
dynamic version of -d, and hence both cannot be used together.
- -f <arg>, --logfile <arg>
-
Read emerge logfile instead of $EMERGE_LOG_DIR/emerge.log.
- -w <arg>, --atoms <arg>
-
Read package atoms to report from file.
- -F <arg>, --format <arg>
-
Print matched atom using given format string.
- --root <arg>
-
Set the ROOT env var.
- -v, --verbose
-
Print package versions and revisions (PF) instead of package (PN).
- -q, --quiet
-
Omit printing of timestamps and operation symbols, can be used to generate a flat list of atoms, e.g. -qml to print the package names merged in the last emerge operation.
- -C, --nocolor
-
Don't output color.
- --color
-
Force color in output.
- -h, --help
-
Print this help and exit.
- -V, --version
-
Print version and exit.
REPORTING BUGS
Please report bugs via http://bugs.gentoo.org/
Product: Gentoo Linux; Component: Current packages
AUTHORS
Ned Ludd <solar@gentoo.org>
Mike Frysinger <vapier@gentoo.org>
Fabian Groffen <grobian@gentoo.org>
SEE ALSO
q(1),
qatom(1),
qcheck(1),
qdepends(1),
qfile(1),
qgrep(1),
qkeyword(1),
qlist(1),
qmanifest(1),
qmerge(1),
qpkg(1),
qsearch(1),
qsize(1),
qtbz2(1),
qtegrity(1),
quse(1),
qwhich(1),
qxpak(1)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- REPORTING BUGS
-
- AUTHORS
-
- SEE ALSO
-
| 
|
|
|
- Running on 
-
:
