Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ clock(1) — SunOS 4.0.2

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

sunview(1)

date(1V)

CLOCK(1)  —  USER COMMANDS

NAME

clock − display the time in an icon or window

SYNOPSIS

clock [ −s ] [ −t ] [ −r ] [ −d mdyaw ] [ −f ]

AVAILABILITY

This command is available with the SunView 1 User’s software installation option.  Refer to Installing the SunOS for information on how to install optional software. 

DESCRIPTION

clock is a SunView utility that displays the current time in a window.  When open, clock shows the date and time in text format.  When closed, clock displays a clock face. 

Note:  In previous releases clock was known as clocktool.  In the current release, clocktool is a symbolic link to clock. 

OPTIONS

−rcauses clock to use a square face with roman numerals in the iconic state.  This replaces the default round clock face. 

−ddisplay date information in a small area just below the clock face.  The date information to be displayed may include:

m the month,

d the day of the month (1-31),

y the year,

a the string AM or PM, as appropriate,

w the day of the week (Sun−Sat). 

There is only room for 3 of these, but any 3 may be displayed in any sequence. 

−fDisplay the date and day of week on the clock face. 

−sstart clock with the seconds turned on.  By default, the clock starts with seconds turned off, and updates every minute.  With seconds turned on, it updates every second, and, if iconic, displays a second hand. 

−tTest mode — ignore the real time, and instead run in a loop continuously incrementing the time by one minute and displaying it. 

clock also accepts all of the generic tool arguments discussed in sunview(1). 

USAGE

clock listens for keyboard input while open.  It recognizes the following characters:

s or SEnable or disable the display of seconds. 

t or TEnable or disable “test” mode. 

FILES

/usr/lib/fonts/fixedwidthfonts/sail.r.6
font for day-of-month clock-face display

SEE ALSO

sunview(1), date(1V)

BUGS

If you reset the system time, clock will not reflect the new time until you change its state from open to icon, or vice versa.  To reset the system time, see date(1V). 

The date display does not go well with the round clock face. 

Sun Release 4.0  —  Last change: 21 December 1987

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026