WHEREINTHEWORLD(8) BSD System Manager's Manual WHEREINTHEWORLD(8)NAMEwhereintheworld — print summary of make world logs
SYNOPSISwhereintheworld [file]
DESCRIPTION
The whereintheworld command is a simple filter that reads the output of a
make world and outputs only the important status lines, skipping all the
compilation commands. The result is a terse summary of where the compila‐
tion is at now.
whereintheworld can be run against an existing file or it can simply read
from stdin. It will continue reading from the pipe or the file until EOF
at which point it will print out the few last lines of the log.
IMPLEMENTATION NOTESwhereintheworld expects the build log to be in a certain format. In par‐
ticular, it recognizes lines starting with repeating dashes as ''section
delimiters''. Lines starting with ''>>>'' will be considered as the names
of the sections. Lines starting with ''===>'' are considered to be mod‐
ules being build in the section, and will be printed on screen, but
always on the same line so that they don't make the screen scroll end‐
lessly.
See the EXAMPLES section for output samples.
whereintheworld is written in Perl and therefore will need an installed
perl(1) interpreter to run. It has been tested on 5.00503 and 5.6.1.
FILES
/usr/src/world.out whereintheworld will first try to open this file if
started without argument. If missing, it will read
stdin.
EXAMPLES
The most simple incantation would be:
whereintheworld
A more typical usage of the whereintheworld command:
make world 2>&1 | tee /var/log/build.log | whereintheworld
If you lost this terminal for one reason or another, the display can be
restarted, with a little pipe magic:
(cat build.log && tail -f build.log ) | whereintheworld
The live output will look something like this:
--------------------------------------------------------------
>>> Rebuilding the temporary build tree
--------------------------------------------------------------
>>> stage 1: bootstrap tools
--------------------------------------------------------------
===> gnu/usr.bin/groff/font/devlatin1
with the last line changing as a new module is compiled.
DIAGNOSTICS
Should be self-explanatory.
COMPATIBILITY
The whereintheworld command has been written to parse make world logs for
FreeBSD 3.x, but it should work with about any version, provided the
FreeBSD folks do not change the output format too much.
SEE ALSO
/usr/src/README, tee(1), cat(1), tail(1).
http://www.FreeBSD.org/handbook/makeworld.html
HISTORY
The whereintheworld manual page example first appeared in worldtools 1.2.
AUTHORS
This manual page was written by The Anarcat ⟨anarcat@anarcat.ath.cx⟩.
The whereintheworld command was written by
Bill Fenner ⟨fenner@freebsd.org⟩ in January 2000 and was modified by
The Anarcat ⟨anarcat@anarcat.ath.cx⟩ to output modules without scrolling.
BUGS
The whereintheworld command is written in perl(1) and therefore cannot be
included in the base FreeBSD system.
BSD August 27, 2003 BSD
