grdc(6)

grdc6

Grand digital clock (curses)

Usage

grdc [-st] [n]

grdc -c n

Overview

grdc runs a digital clock made of reverse-video blanks on a curses compatible VDU screen. With an optional numeric argument n it stops after n seconds (default never). The clock can act as a countdown timer with the -c flag, n specifies the number of seconds to time for. The optional -s flag makes digits scroll as they change. The optional -t flag tells grdc to output the time in a 12-hour format. In this curses mode implementation, the scrolling option has trouble keeping up.

Environment

TZ

The time zone to use for displaying the time. It is normally specified as a pathname relative to /usr/share/zoneinfo, though see tzset(3) for more information. If this variable is not set, the time zone is determined based on /etc/localtime.

Notes

In countdown timer mode, the specifying of -n > 360000 seconds (100 hours) will lead to the counter displaying incorrect remaining time, however it will time correctly, and display correctly when the remaining time becomes less than 100 hours.

Releases

30 releases since FreeBSD 2.0.5-RELEASE; the text changed 13 times.

  1. 2.0.5–2.2.2
  2. 11.0
  3. 11.1
  4. 11.2
  5. 11.3
  6. 11.4
  7. 12.0
  8. 12.1
  9. 12.2
  10. 12.3
  11. 12.4
  12. 13.0–13.2
  13. 13.3–14.5
  14. 15.0–16.0

Authors

Amos Shapir, modified for curses by John Lupien. Countdown timer mode by Gavin Atkinson.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.