tty-clock.1 - tty-clock - port of tty-clock to OpenBSD, with pledge/unveil added as goodie
HTML git clone https://git.drkhsh.at/tty-clock.git
DIR Log
DIR Files
DIR Refs
DIR README
DIR LICENSE
---
tty-clock.1 (3193B)
---
1 .\" This manpage was written by Carla Valenti <valenti.karla@gmail.com>
2 .\" and Christian Giessen <cgie@informatik.uni-kiel.de> for tty-clock.
3 .\" In details the command line options displayed by tty-clock -h as
4 .\" well as the keyboard commands.
5 .TH "TTY-CLOCK" "1" "October 2013" "" "User Commands"
6 .SH "NAME"
7 .LP
8 tty\-clock \- a terminal digital clock
9 .SH "SYNOPSIS"
10 .LP
11 \fBtty\-clock [\-iuvsScbtrahDBxn] [\-C [\fI0\-7\fB]] [\-f \fIformat\fB] [\-d \fIdelay\fB] [\-a \fInsdelay\fB] \fB[\-T \fItty\fB]\fR
12 .SH "DESCRIPTION"
13 .LP
14 \fItty\-clock\fR displays a simple digital clock on the terminal. Invoked without options
15 it will display the clock on the upper left corner of the screen on the terminal it was
16 executed from.
17 .SH "COMMANDS"
18 .LP
19 \fItty\-clock\fR accepts a number of runtime keyboard commands, upper and lower case characters are
20 treated identically.
21 .TP
22 K,J,H,L
23 vi\-style movement commands to set the position of the displayed clock.
24 These commands have no effect when the \fBcentered\fR option is set.
25 .TP
26 [0\-7]
27 Select a different color for displaying the clock.
28 .TP
29 B
30 Toggles between bold and normal colors.
31 .TP
32 X
33 Toggles displaying a box around the clock. This option is disabled by default.
34 .TP
35 C
36 Toggle the clock's position to \fBcentered\fR.
37 When set the movement commands are disabled.
38 .TP
39 R
40 Set the clock to \fBrebound\fR along the edges of the terminal.
41 .TP
42 S
43 Display seconds.
44 .TP
45 T
46 Switch time output to the 12\-hour format.
47 .TP
48 Q
49 Quit.
50 .SH "OPTIONS"
51 .LP
52 .TP
53 \fB\-s\fR
54 Show seconds.
55 .TP
56 \fB\-S\fR
57 Screensaver mode. tty\-clock terminates when any key is pressed.
58 .TP
59 \fB\-x\fR
60 Show box.
61 .TP
62 \fB\-c\fR
63 Set the clock at the center of the terminal.
64 .TP
65 \fB\-C\fR \fI[0\-7]\fR
66 Set the clock color.
67 .TP
68 \fB\-b\fR
69 Use bold colors.
70 .TP
71 \fB\-t\fR
72 Set the hour in 12h format.
73 .TP
74 \fB\-u\fR
75 Use UTC time.
76 .TP
77 \fB\-T\fR \fItty\fR
78 Display the clock on the given \fItty\fR. \fItty\fR must be
79 a valid character device to which the user has rw access permissions.
80 (See \fBEXAMPLES\fR)
81 .TP
82 \fB\-r\fR
83 Do rebound the clock.
84 .TP
85 \fB\-f\fR \fIformat\fR
86 Set the date format as described in \fBstrftime(3)\fR.
87 .TP
88 \fB\-n\fR
89 Do not quit the program when the Q key is pressed (or when any
90 key is pressed while in \fBScreensaver\fR mode). A signal must
91 be sent to \fItty\-clock\fR in order to terminate its execution. (See \fBEXAMPLES\fR)
92 .TP
93 \fB\-v\fR
94 Show tty\-clock version.
95 .TP
96 \fB\-i\fR
97 Show some info about tty\-clock.
98 .TP
99 \fB\-h\fR
100 Show usage information.
101 .TP
102 \fB\-D\fR
103 Hide the date.
104 .TP
105 \fB\-B\fR
106 Enable blinking colon.
107 .TP
108 \fB\-d\fR \fIdelay\fR
109 Set the delay (in seconds) between two redraws of the clock. Default 1s.
110 .TP
111 \fB\-a\fR \fInsdelay\fR
112 Additional delay (in nanoseconds) between two redraws of the clock. Default 0ns.
113 .SH "EXAMPLES"
114 .LP
115 To invoke
116 .I tty\-clock
117 in screensaver mode with the clock display set to rebound and the update
118 delay set to 1/10th of a second (10 FPS):
119 .IP
120 $ tty\-clock \-Sra 100000000 \-d 0
121 .LP
122 The following example arranges for \fItty\-clock\fR to be displayed
123 indefinitely on one of the Virtual Terminals on a Linux system
124 at boot time using an
125 .B inittab(5)
126 entry:
127 .IP
128 # /etc/inittab:
129 .br
130 9:2345:respawn:/usr/bin/tty\-clock \-c \-n \-T /dev/tty9
131 .LP