.\" $NetBSD: progress.1,v 1.5 2003/02/14 15:59:18 grant Exp $ .\" .\" Copyright (c) 2003 The NetBSD Foundation, Inc. .\" All rights reserved. .\" .\" This code is derived from software contributed to The NetBSD Foundation .\" by John Hawkinson. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. Neither the name of The NetBSD Foundation nor the names of its .\" contributors may be used to endorse or promote products derived .\" from this software without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" .Dd January 21, 2003 .Dt PROGRESS 1 .Os .Sh NAME .Nm progress .Nd feed input to a command, displaying a progress bar .Sh SYNOPSIS .Nm .Op Fl z .Op Fl f Ar file .Op Fl l Ar length .Ar cmd .Op Ar args ... .Sh DESCRIPTION The .Nm utility opens a pipe to .Ar cmd and feeds an input stream into it, while displaying a progress bar to standard output. If no filename is specified, .Nm reads from standard input. Where feasible, .Nm .Xr fstat 2 Ns s the input to determine the length, so a time estimate can be calculated. .Pp If no length is specified or determined, .Nm simply displays a count of the data and the data rate. .Pp The options are as follows: .Bl -tag -width XlXlengthXX .It Fl f Ar file Read from the specified .Ar file instead of standard input. .It Fl l Ar length Use the specified length for the time estimate, rather than attempting to .Xr fstat 2 the input. .It Fl z Filter the input through .Xr gzip 1 . If .Fl f is specified, calculate the length using .Ic gzip -l . .El .Sh EXIT STATUS .Nm exits 0 on success. .Sh EXAMPLES The command .Ic progress -zf file.tar.gz tar xf - will extract the .Pa file.tar.gz displaying the progress bar as time passes: .Bd -literal 0% | | 0 0.00 KB/s --:-- ETA 40% |********** | 273 KB 271.95 KB/s 00:01 ETA 81% |************************* | 553 KB 274.61 KB/s 00:00 ETA 100% |*********************************| 680 KB 264.59 KB/s 00:00 ETA .Ed .Pp If it is preferred to monitor the progress of the decompression process (unlikely), then .Ic progress -f file.tar.gz tar zxf - could be used. .Sh SEE ALSO .Xr ftp 1 .Sh HISTORY .Nm first appeared in .Nx 1.6.1 . The dynamic progress bar display code is part of .Xr ftp 1 . .Sh AUTHORS .Nm was written by .An John Hawkinson .Aq jhawk@NetBSD.org . .Xr ftp 1 Ns 's dynamic progress bar was written by Luke Mewburn. .Sh BUGS Since the progress bar is displayed asynchronously, it may be difficult to read some error messages, both those produced by the pipeline, as well as those produced by .Nm itself. 08-05-11 02:04:33 +0000'>2008-05-11Update 2400 f/w to something more akin to what is current.mjacob 2008-03-11Checkpoint of some fairly major isp(4) rototilling.mjacob 2008-03-09Remove files that have no apparent immediate use.mjacob 2007-05-24Major update to isp(4) driver to bring it in line with external sources.mjacob 2005-12-11merge ktrace-lwp.christos 2005-05-31remove bogus cast.christos 2005-03-01revert the whitespace kill -- these are binaries.perry 2005-02-27nuke trailing whitespaceperry 2004-08-01Add binary versions of firmware images, which will be used Soon.mycroft 2004-05-02Revert ISP2100 firmware to Qlogic revision 1.19.16 (the version that shippedtls 2004-01-21Updated firmware from QLogic via Matt Jacob (from his Jan 14 distribution).briggs 2003-02-09Roll to latest f/w. Supposed to correct some nasty f/w bugs.mjacob 2002-10-18Update to the latest Fibre Channel f/w from the QLogic intranet site.mjacob 2002-03-22Cast for now non-const in ispdv structure.mjacob 2002-02-19Update 2300 firmware to latest release level.mjacob 2001-12-14Roll f/w to latest level, correcting several, ah, interesting bugs.mjacob 2001-10-20Update to latest 12160 initiator firmware.mjacob 2001-08-31Ulp! Open Wide! Another Firmware Enchilada!mjacob 2001-04-11Only install headers which are actually used by our userland. Thisjdolecek 2001-02-12update to latest f/wmjacob 2000-12-28roll to 2.01.26 f/wmjacob 2000-10-16roll SBus f/w to latest released level (1.37)mjacob 2000-07-05split firmware into smaller filesmjacob 2000-02-12add 12160 (Ultra3) microcodemjacob 1999-12-20oops, got the initiator and initiator/target f/w reversed for the 1080mjacob 1999-12-20add in initiator mode only f/w versionsmjacob 1999-12-03add back firmware with BSD style copyright as approved by Qlogicmjacob 1999-11-16Re-add stub Qlogic F/W files so that life is easier when/if the newmjacob 1999-10-28Remove f/w from tree. The licences are not acceptable to TNF.mjacob 1999-10-14roll firmwaremjacob