DELAY(1) OneGeek Software DELAY(1) NAME delay - counts down a specified number of seconds. SYNOPSIS delay [options] <length> [-- command] delay [options] until <timespec> [-- command] DESCRIPTION The delay program counts down a length of time specified on the command line. By default, it prints out the time remaining once a second. The rate and style of printing can be controlled using options to the program. This includes the ability to supress the printing entirely. It also somewhat supports delaying for fractional seconds. Delay attempts to compensate for the time it spends printing the updates. There should be no error that is a multiple of the time spent delaying. (There is a bit of error on the startup and termination of the program, but that's unavoidable.) There are several ways that the time to delay can be specified. The first is that it can be specified as an absolute length of time to delay. This can be in several formats. All of the following formats are allowable. (And equivalent.) delay 1d 2:03:04.5 delay 1d 2h 3m 4.5s delay 93785.5 Please note that the fractional seconds code will only work for actual fractional seconds. So, doing things like '0.5h' will delay for half a sec- ond, and not for half an hour as one may expect. (But don't rely on this behavior, as it may change in future versions.) The second format is for a time to delay until be specified. The time pars- ing code is derived from that used it at, and as a result the time specifi- cations should be described on at(1). For example: delay until 4 pm delay until noon tomorrow delay until midnight 13 september 2000 delay until now + 5 minutes Please note that the parsing code has a resolution of a minute. So, the last specification would calculate the 5 minutes from the beginning of the current minute, and delay to that absolute point in time. If you need more precision, you can use the first time format, which allows an the delay length to be specified precisely. If delay sees "--" while parsing it's command line, it stops argument pro- cessing. Instead, the argument after the "--" is interpreted as a command to be run when delay completes, and any further arguments are used as argu- ments to that command. For example: delay until 9:30 -- cdplay OPTIONS Delay allows you to use command line options to control aspects of its be- havior. Here's a list: -q This enables quiet mode. This prevents delay from outputting the time remaining as it usually does. (This is the default if delay is called with "sleep" as part of the program name.) -m This enables a minimalistic count of the time remaining, with only the number of seconds left being displayed. This was the default for delay 1.0. -d This enables the default display. The day, hour, minute, and second are all broken out into seperate entrys. (This is the default, except for the cases where -q is the default.) -v This enables a more verbose mode of display. (It adds some explanitory text, as compared to -d.) -c This allows you to specify a custom time prompt. Printf-style format- ting is performed, with the following being allowed as the possible percent substitutions: %d Days remaining %h Hours remaining (modulo 24) %m Minutes remaining (modulo 60) %s Seconds remaining (modulo 60) %n Total seconds remaining For best results, you'll want to make sure that your custom format stays the same length throughout the count. Printf-style formatting is done on these codes. Use of percent-codes other than the ones listed above will lead to undefined behavior. (Crashes, usually.) The following escapes are also supported: \n Newline \r Carriage Return \b Backspace \\ Backslash \% Percent Since the custom format no longer implicitly begins with a carriage re- turn, it usually makes sense to either begin a custom code with \r or end it with \n. The standard formats can be expressed as custom codes. Here's a list of translations. -m \r% 8n -d \r% 3d %02h:%02m:%02s -v \rTime Remaining: %d days, %02h:%02m:%02s. -C This option enables the display of time remaining in big ugly curses numerals. This only displays the hours, minutes, and seconds remaining, although the number of hours to go may range above 24. -u This option takes a single parameter, the time in seconds between up- dates of the time remaining. It need not be a factor of the delay length. It defaults to 1 second, and must be at least that value. -b If this option is given, a bell character will be sent when time ex- pires. This may be useful in cases where an xterm is send to de-iconify on a bell. -V If given, delay will display it's version and a short copyright mes- sage, and will then exit. BUGS The default format is only good for delays of less than 1000 days. Improper use of the -c option can lead to various problems, and may even have some security implications. execvp(2) is used to run the command, and this may run programs in the cur- rent directory rather than fully respecting your path. Please see execvp(2) for more details. AUTHOR Tom Rothamel <tom-delay@onegeek.org> WEB SITE The delay web site is located at: http://onegeek.org/~tom/software/delay/ SEE ALSO sleep(1), printf(3), at(1) 3rd Berkeley Distribution 2002-02-09 DELAY(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | BUGS | AUTHOR | WEB SITE | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=delay&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>