Home | History | Annotate | Line # | Download | only in ftp
progressbar.c revision 1.22
      1 /*	$NetBSD: progressbar.c,v 1.22 2012/06/27 22:07:36 riastradh Exp $	*/
      2 
      3 /*-
      4  * Copyright (c) 1997-2009 The NetBSD Foundation, Inc.
      5  * All rights reserved.
      6  *
      7  * This code is derived from software contributed to The NetBSD Foundation
      8  * by Luke Mewburn.
      9  *
     10  * Redistribution and use in source and binary forms, with or without
     11  * modification, are permitted provided that the following conditions
     12  * are met:
     13  * 1. Redistributions of source code must retain the above copyright
     14  *    notice, this list of conditions and the following disclaimer.
     15  * 2. Redistributions in binary form must reproduce the above copyright
     16  *    notice, this list of conditions and the following disclaimer in the
     17  *    documentation and/or other materials provided with the distribution.
     18  *
     19  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
     20  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
     21  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     22  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
     23  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     24  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     25  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     26  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
     27  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     28  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     29  * POSSIBILITY OF SUCH DAMAGE.
     30  */
     31 
     32 #include <sys/cdefs.h>
     33 #ifndef lint
     34 __RCSID("$NetBSD: progressbar.c,v 1.22 2012/06/27 22:07:36 riastradh Exp $");
     35 #endif /* not lint */
     36 
     37 /*
     38  * FTP User Program -- Misc support routines
     39  */
     40 #include <sys/param.h>
     41 #include <sys/types.h>
     42 #include <sys/time.h>
     43 
     44 #include <err.h>
     45 #include <errno.h>
     46 #include <signal.h>
     47 #include <stdio.h>
     48 #include <stdlib.h>
     49 #include <string.h>
     50 #include <time.h>
     51 #include <tzfile.h>
     52 #include <unistd.h>
     53 
     54 #include "progressbar.h"
     55 
     56 #if !defined(NO_PROGRESS)
     57 /*
     58  * return non-zero if we're the current foreground process
     59  */
     60 int
     61 foregroundproc(void)
     62 {
     63 	static pid_t pgrp = -1;
     64 
     65 	if (pgrp == -1)
     66 		pgrp = getpgrp();
     67 
     68 	return (tcgetpgrp(fileno(ttyout)) == pgrp);
     69 }
     70 #endif	/* !defined(NO_PROGRESS) */
     71 
     72 
     73 static void updateprogressmeter(int);
     74 
     75 /*
     76  * SIGALRM handler to update the progress meter
     77  */
     78 static void
     79 updateprogressmeter(int dummy)
     80 {
     81 	int oerrno = errno;
     82 
     83 	progressmeter(0);
     84 	errno = oerrno;
     85 }
     86 
     87 /*
     88  * List of order of magnitude suffixes, per IEC 60027-2.
     89  */
     90 static const char * const suffixes[] = {
     91 	"",	/* 2^0  (byte) */
     92 	"KiB",	/* 2^10 Kibibyte */
     93 	"MiB",	/* 2^20 Mebibyte */
     94 	"GiB",	/* 2^30 Gibibyte */
     95 	"TiB",	/* 2^40 Tebibyte */
     96 	"PiB",	/* 2^50 Pebibyte */
     97 	"EiB",	/* 2^60 Exbibyte */
     98 #if 0
     99 		/* The following are not necessary for signed 64-bit off_t */
    100 	"ZiB",	/* 2^70 Zebibyte */
    101 	"YiB",	/* 2^80 Yobibyte */
    102 #endif
    103 };
    104 #define NSUFFIXES	(int)(sizeof(suffixes) / sizeof(suffixes[0]))
    105 
    106 /*
    107  * Display a transfer progress bar if progress is non-zero.
    108  * SIGALRM is hijacked for use by this function.
    109  * - Before the transfer, set filesize to size of file (or -1 if unknown),
    110  *   and call with flag = -1. This starts the once per second timer,
    111  *   and a call to updateprogressmeter() upon SIGALRM.
    112  * - During the transfer, updateprogressmeter will call progressmeter
    113  *   with flag = 0
    114  * - After the transfer, call with flag = 1
    115  */
    116 static struct timeval start;
    117 static struct timeval lastupdate;
    118 
    119 #define	BUFLEFT	(sizeof(buf) - len)
    120 
    121 void
    122 progressmeter(int flag)
    123 {
    124 	static off_t lastsize;
    125 	off_t cursize;
    126 	struct timeval now, wait;
    127 #ifndef NO_PROGRESS
    128 	struct timeval td;
    129 	off_t abbrevsize, bytespersec;
    130 	double elapsed;
    131 	int ratio, i, remaining, barlength;
    132 
    133 			/*
    134 			 * Work variables for progress bar.
    135 			 *
    136 			 * XXX:	if the format of the progress bar changes
    137 			 *	(especially the number of characters in the
    138 			 *	`static' portion of it), be sure to update
    139 			 *	these appropriately.
    140 			 */
    141 #endif
    142 	size_t		len;
    143 	char		buf[256];	/* workspace for progress bar */
    144 #ifndef NO_PROGRESS
    145 #define	BAROVERHEAD	45		/* non `*' portion of progress bar */
    146 					/*
    147 					 * stars should contain at least
    148 					 * sizeof(buf) - BAROVERHEAD entries
    149 					 */
    150 	static const char	stars[] =
    151 "*****************************************************************************"
    152 "*****************************************************************************"
    153 "*****************************************************************************";
    154 
    155 #endif
    156 
    157 	if (flag == -1) {
    158 		(void)gettimeofday(&start, NULL);
    159 		lastupdate = start;
    160 		lastsize = restart_point;
    161 	}
    162 
    163 	(void)gettimeofday(&now, NULL);
    164 	cursize = bytes + restart_point;
    165 	timersub(&now, &lastupdate, &wait);
    166 	if (cursize > lastsize) {
    167 		lastupdate = now;
    168 		lastsize = cursize;
    169 		wait.tv_sec = 0;
    170 	} else {
    171 #ifndef STANDALONE_PROGRESS
    172 		if (quit_time > 0 && wait.tv_sec > quit_time) {
    173 			len = snprintf(buf, sizeof(buf), "\r\n%s: "
    174 			    "transfer aborted because stalled for %lu sec.\r\n",
    175 			    getprogname(), (unsigned long)wait.tv_sec);
    176 			(void)write(fileno(ttyout), buf, len);
    177 			alarmtimer(0);
    178 			(void)xsignal(SIGALRM, SIG_DFL);
    179 			siglongjmp(toplevel, 1);
    180 		}
    181 #endif	/* !STANDALONE_PROGRESS */
    182 	}
    183 	/*
    184 	 * Always set the handler even if we are not the foreground process.
    185 	 */
    186 #ifdef STANDALONE_PROGRESS
    187 	if (progress) {
    188 #else
    189 	if (quit_time > 0 || progress) {
    190 #endif /* !STANDALONE_PROGRESS */
    191 		if (flag == -1) {
    192 			(void)xsignal_restart(SIGALRM, updateprogressmeter, 1);
    193 			alarmtimer(1);		/* set alarm timer for 1 Hz */
    194 		} else if (flag == 1) {
    195 			alarmtimer(0);
    196 			(void)xsignal(SIGALRM, SIG_DFL);
    197 		}
    198 	}
    199 #ifndef NO_PROGRESS
    200 	if (!progress)
    201 		return;
    202 	len = 0;
    203 
    204 	/*
    205 	 * print progress bar only if we are foreground process.
    206 	 */
    207 	if (! foregroundproc())
    208 		return;
    209 
    210 	len += snprintf(buf + len, BUFLEFT, "\r");
    211 	if (prefix)
    212 	  len += snprintf(buf + len, BUFLEFT, "%s", prefix);
    213 	if (filesize > 0) {
    214 		ratio = (int)((double)cursize * 100.0 / (double)filesize);
    215 		ratio = MAX(ratio, 0);
    216 		ratio = MIN(ratio, 100);
    217 		len += snprintf(buf + len, BUFLEFT, "%3d%% ", ratio);
    218 
    219 			/*
    220 			 * calculate the length of the `*' bar, ensuring that
    221 			 * the number of stars won't exceed the buffer size
    222 			 */
    223 		barlength = MIN((int)(sizeof(buf) - 1), ttywidth) - BAROVERHEAD;
    224 		if (prefix)
    225 			barlength -= (int)strlen(prefix);
    226 		if (barlength > 0) {
    227 			i = barlength * ratio / 100;
    228 			len += snprintf(buf + len, BUFLEFT,
    229 			    "|%.*s%*s|", i, stars, (int)(barlength - i), "");
    230 		}
    231 	}
    232 
    233 	abbrevsize = cursize;
    234 	for (i = 0; abbrevsize >= 100000 && i < NSUFFIXES; i++)
    235 		abbrevsize >>= 10;
    236 	if (i == NSUFFIXES)
    237 		i--;
    238 	len += snprintf(buf + len, BUFLEFT, " " LLFP("5") " %-3s ",
    239 	    (LLT)abbrevsize,
    240 	    suffixes[i]);
    241 
    242 	timersub(&now, &start, &td);
    243 	elapsed = td.tv_sec + (td.tv_usec / 1000000.0);
    244 
    245 	bytespersec = 0;
    246 	if (bytes > 0) {
    247 		bytespersec = bytes;
    248 		if (elapsed > 0.0)
    249 			bytespersec /= elapsed;
    250 	}
    251 	for (i = 1; bytespersec >= 1024000 && i < NSUFFIXES; i++)
    252 		bytespersec >>= 10;
    253 	len += snprintf(buf + len, BUFLEFT,
    254 	    " " LLFP("3") ".%02d %.2sB/s ",
    255 	    (LLT)(bytespersec / 1024),
    256 	    (int)((bytespersec % 1024) * 100 / 1024),
    257 	    suffixes[i]);
    258 
    259 	if (filesize > 0) {
    260 		if (bytes <= 0 || elapsed <= 0.0 || cursize > filesize) {
    261 			len += snprintf(buf + len, BUFLEFT, "   --:-- ETA");
    262 		} else if (wait.tv_sec >= STALLTIME) {
    263 			len += snprintf(buf + len, BUFLEFT, " - stalled -");
    264 		} else {
    265 			remaining = (int)
    266 			    ((filesize - restart_point) / (bytes / elapsed) -
    267 			    elapsed);
    268 			if (remaining >= 100 * SECSPERHOUR)
    269 				len += snprintf(buf + len, BUFLEFT,
    270 				    "   --:-- ETA");
    271 			else {
    272 				i = remaining / SECSPERHOUR;
    273 				if (i)
    274 					len += snprintf(buf + len, BUFLEFT,
    275 					    "%2d:", i);
    276 				else
    277 					len += snprintf(buf + len, BUFLEFT,
    278 					    "   ");
    279 				i = remaining % SECSPERHOUR;
    280 				len += snprintf(buf + len, BUFLEFT,
    281 				    "%02d:%02d ETA", i / 60, i % 60);
    282 			}
    283 		}
    284 	}
    285 	if (flag == 1)
    286 		len += snprintf(buf + len, BUFLEFT, "\n");
    287 	(void)write(fileno(ttyout), buf, len);
    288 
    289 #endif	/* !NO_PROGRESS */
    290 }
    291 
    292 #ifndef STANDALONE_PROGRESS
    293 /*
    294  * Display transfer statistics.
    295  * Requires start to be initialised by progressmeter(-1),
    296  * direction to be defined by xfer routines, and filesize and bytes
    297  * to be updated by xfer routines
    298  * If siginfo is nonzero, an ETA is displayed, and the output goes to stderr
    299  * instead of ttyout.
    300  */
    301 void
    302 ptransfer(int siginfo)
    303 {
    304 	struct timeval now, td, wait;
    305 	double elapsed;
    306 	off_t bytespersec;
    307 	int remaining, hh, i;
    308 	size_t len;
    309 
    310 	char buf[256];		/* Work variable for transfer status. */
    311 
    312 	if (!verbose && !progress && !siginfo)
    313 		return;
    314 
    315 	(void)gettimeofday(&now, NULL);
    316 	timersub(&now, &start, &td);
    317 	elapsed = td.tv_sec + (td.tv_usec / 1000000.0);
    318 	bytespersec = 0;
    319 	if (bytes > 0) {
    320 		bytespersec = bytes;
    321 		if (elapsed > 0.0)
    322 			bytespersec /= elapsed;
    323 	}
    324 	len = 0;
    325 	len += snprintf(buf + len, BUFLEFT, LLF " byte%s %s in ",
    326 	    (LLT)bytes, bytes == 1 ? "" : "s", direction);
    327 	remaining = (int)elapsed;
    328 	if (remaining > SECSPERDAY) {
    329 		int days;
    330 
    331 		days = remaining / SECSPERDAY;
    332 		remaining %= SECSPERDAY;
    333 		len += snprintf(buf + len, BUFLEFT,
    334 		    "%d day%s ", days, days == 1 ? "" : "s");
    335 	}
    336 	hh = remaining / SECSPERHOUR;
    337 	remaining %= SECSPERHOUR;
    338 	if (hh)
    339 		len += snprintf(buf + len, BUFLEFT, "%2d:", hh);
    340 	len += snprintf(buf + len, BUFLEFT,
    341 	    "%02d:%02d ", remaining / 60, remaining % 60);
    342 
    343 	for (i = 1; bytespersec >= 1024000 && i < NSUFFIXES; i++)
    344 		bytespersec >>= 10;
    345 	if (i == NSUFFIXES)
    346 		i--;
    347 	len += snprintf(buf + len, BUFLEFT, "(" LLF ".%02d %.2sB/s)",
    348 	    (LLT)(bytespersec / 1024),
    349 	    (int)((bytespersec % 1024) * 100 / 1024),
    350 	    suffixes[i]);
    351 
    352 	if (siginfo && bytes > 0 && elapsed > 0.0 && filesize >= 0
    353 	    && bytes + restart_point <= filesize) {
    354 		remaining = (int)((filesize - restart_point) /
    355 				  (bytes / elapsed) - elapsed);
    356 		hh = remaining / SECSPERHOUR;
    357 		remaining %= SECSPERHOUR;
    358 		len += snprintf(buf + len, BUFLEFT, "  ETA: ");
    359 		if (hh)
    360 			len += snprintf(buf + len, BUFLEFT, "%2d:", hh);
    361 		len += snprintf(buf + len, BUFLEFT, "%02d:%02d",
    362 		    remaining / 60, remaining % 60);
    363 		timersub(&now, &lastupdate, &wait);
    364 		if (wait.tv_sec >= STALLTIME)
    365 			len += snprintf(buf + len, BUFLEFT, "  (stalled)");
    366 	}
    367 	len += snprintf(buf + len, BUFLEFT, "\n");
    368 	(void)write(siginfo ? STDERR_FILENO : fileno(ttyout), buf, len);
    369 }
    370 
    371 /*
    372  * SIG{INFO,QUIT} handler to print transfer stats if a transfer is in progress
    373  */
    374 void
    375 psummary(int notused)
    376 {
    377 	int oerrno = errno;
    378 
    379 	if (bytes > 0) {
    380 		if (fromatty)
    381 			write(fileno(ttyout), "\n", 1);
    382 		ptransfer(1);
    383 	}
    384 	errno = oerrno;
    385 }
    386 #endif	/* !STANDALONE_PROGRESS */
    387 
    388 
    389 /*
    390  * Set the SIGALRM interval timer for wait seconds, 0 to disable.
    391  */
    392 void
    393 alarmtimer(int wait)
    394 {
    395 	struct itimerval itv;
    396 
    397 	itv.it_value.tv_sec = wait;
    398 	itv.it_value.tv_usec = 0;
    399 	itv.it_interval = itv.it_value;
    400 	setitimer(ITIMER_REAL, &itv, NULL);
    401 }
    402 
    403 
    404 /*
    405  * Install a POSIX signal handler, allowing the invoker to set whether
    406  * the signal should be restartable or not
    407  */
    408 sigfunc
    409 xsignal_restart(int sig, sigfunc func, int restartable)
    410 {
    411 	struct sigaction act, oact;
    412 	act.sa_handler = func;
    413 
    414 	sigemptyset(&act.sa_mask);
    415 #if defined(SA_RESTART)			/* 4.4BSD, Posix(?), SVR4 */
    416 	act.sa_flags = restartable ? SA_RESTART : 0;
    417 #elif defined(SA_INTERRUPT)		/* SunOS 4.x */
    418 	act.sa_flags = restartable ? 0 : SA_INTERRUPT;
    419 #else
    420 #error "system must have SA_RESTART or SA_INTERRUPT"
    421 #endif
    422 	if (sigaction(sig, &act, &oact) < 0)
    423 		return (SIG_ERR);
    424 	return (oact.sa_handler);
    425 }
    426 
    427 /*
    428  * Install a signal handler with the `restartable' flag set dependent upon
    429  * which signal is being set. (This is a wrapper to xsignal_restart())
    430  */
    431 sigfunc
    432 xsignal(int sig, sigfunc func)
    433 {
    434 	int restartable;
    435 
    436 	/*
    437 	 * Some signals print output or change the state of the process.
    438 	 * There should be restartable, so that reads and writes are
    439 	 * not affected.  Some signals should cause program flow to change;
    440 	 * these signals should not be restartable, so that the system call
    441 	 * will return with EINTR, and the program will go do something
    442 	 * different.  If the signal handler calls longjmp() or siglongjmp(),
    443 	 * it doesn't matter if it's restartable.
    444 	 */
    445 
    446 	switch(sig) {
    447 #ifdef SIGINFO
    448 	case SIGINFO:
    449 #endif
    450 	case SIGQUIT:
    451 	case SIGUSR1:
    452 	case SIGUSR2:
    453 	case SIGWINCH:
    454 		restartable = 1;
    455 		break;
    456 
    457 	case SIGALRM:
    458 	case SIGINT:
    459 	case SIGPIPE:
    460 		restartable = 0;
    461 		break;
    462 
    463 	default:
    464 		/*
    465 		 * This is unpleasant, but I don't know what would be better.
    466 		 * Right now, this "can't happen"
    467 		 */
    468 		errx(1, "xsignal_restart: called with signal %d", sig);
    469 	}
    470 
    471 	return(xsignal_restart(sig, func, restartable));
    472 }
    473