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  -  BUILDIT (8)

NAME

buildit - time a command, log its output and mail notification when finished

CONTENTS

Synopsis
Description
Options
Examples
Diagnostics
Compatibility
See Also
History
Authors
Bugs

SYNOPSIS

buildit [-m] -l logfile command ...

DESCRIPTION

The buildit command is a trivial wrapper script for running commands unattended. buildit will start the given command using time(1); log the stdout and stderr of the command in the given logfile; wait for termination of the command while printing its output on the terminal; and then optionally mail the head and tail of the logfile to the calling user.

The date(1) command is called before and after the command so that there is a start and end date of the process in the logfile.

OPTIONS

The options are as follows:
-m do not send mail when finished.
-l logfile log stdin and stderr to this logfile. If the logfile already exists, it is moved to logfile.old.

EXAMPLES

Here are typical usages of the buildit command:

    buildit -l /var/src/install.out make installworld | whereintheworld

    buildit -l trace.log povray +iscene +oscene.out

DIAGNOSTICS

Exit status is 0 on success, and 1 if the command fails for one of the following reasons:
-l parameter mandatory No logfile has been chosen.

COMPATIBILITY

The mail(1) command is called to send email, with the -s flag to set the subject. This might not work equally on all systems.

SEE ALSO

time(1), wait(1), head(1), tail(1), mail(1), date(1), kill(1), whereintheworld(8).

HISTORY

The buildit manual page was first written for worldtools 1.2

AUTHORS

The buildit command and this manual page were written by
.An The Anarcat Aq anarcat@anarcat.ath.cx .

BUGS

buildit might leave stray processes running, even after being interrupted. This is due to a bug in sh since calling trap from a subshell has no effect. See the file test_trap.sh in the source distribution for an example.
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.