GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  WHEREINTHEWORLD (8)

NAME

whereintheworld - print summary of make world logs

CONTENTS

Synopsis
Description
Implementation Notes
Files
Examples
Diagnostics
Compatibility
See Also
History
Authors
Bugs

SYNOPSIS

whereintheworld [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 compilation 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 NOTES

whereintheworld expects the build log to be in a certain format. In particular, 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 modules 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 endlessly.

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
.Fx 3.x, but it should work with about any version, provided the
.Fx 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
.An The Anarcat Aq anarcat@anarcat.ath.cx . The whereintheworld command was written by
.An Bill Fenner Aq fenner@freebsd.org in January 2000 and was modified by
.An The Anarcat Aq 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
.Fx system.
Search for    or go to Top of page |  Section 8 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.