Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
WHEREINTHEWORLD(8)	  BSD System Manager's Manual	    WHEREINTHEWORLD(8)

NAME
     whereintheworld --	print summary of make world logs

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 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 NOTES
     whereintheworld 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 al-
     ways 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

NAME | SYNOPSIS | DESCRIPTION | IMPLEMENTATION NOTES | FILES | EXAMPLES | DIAGNOSTICS | COMPATIBILITY | SEE ALSO | HISTORY | AUTHORS | BUGS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=whereintheworld&sektion=8&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help