Commit | Line | Data |
---|---|---|
39d0ae39 KB |
1 | .\" Copyright (c) 1983 The Regents of the University of California. |
2 | .\" All rights reserved. | |
412e4f93 | 3 | .\" |
39d0ae39 KB |
4 | .\" Redistribution and use in source and binary forms are permitted |
5 | .\" provided that the above copyright notice and this paragraph are | |
6 | .\" duplicated in all such forms and that any documentation, | |
7 | .\" advertising materials, and other materials related to such | |
8 | .\" distribution and use acknowledge that the software was developed | |
9 | .\" by the University of California, Berkeley. The name of the | |
10 | .\" University may not be used to endorse or promote products derived | |
11 | .\" from this software without specific prior written permission. | |
12 | .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR | |
13 | .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED | |
14 | .\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. | |
412e4f93 | 15 | .\" |
39d0ae39 KB |
16 | .\" @(#)sysline.1 6.4 (Berkeley) %G% |
17 | .\" | |
18 | .TH <PROGNAME> <SECTION> "" | |
975a0faf | 19 | .TH SYSLINE 1 "" |
412e4f93 KM |
20 | .UC 5 |
21 | .SH NAME | |
22 | sysline \- display system status on status line of a terminal | |
23 | .SH SYNOPSIS | |
24 | .B sysline | |
25 | [ | |
975a0faf | 26 | .B \-bcdewhDilmpqrsj |
412e4f93 KM |
27 | ] [ |
28 | .B \-H\ remote | |
29 | ] [ | |
30 | .B +N | |
31 | ] | |
32 | .SH DESCRIPTION | |
33 | .I Sysline | |
34 | runs in the background and periodically displays system status information | |
35 | on the status line of the terminal. | |
36 | Not all terminals contain a status line. | |
37 | Those that do include the h19, concept 108, Ann Arbor Ambassador, vt100, | |
38 | Televideo 925/950 and Freedom 100. | |
39 | If no flags are given, | |
40 | .I sysline | |
41 | displays the time of day, the current load average, the change in load | |
42 | average in the last 5 minutes, the number of users (followed by a `u'), | |
43 | the number of runnable process (followed by a `r')[VAX only], the number | |
44 | of suspended processes (followed by a `s')[VAX only], | |
45 | and the users who have logged on and off since the last status report. | |
46 | Finally, if new mail has arrived, a summary of it is printed. | |
47 | If there is unread mail in your mailbox, an asterisk will appear after the | |
48 | display of the number of users. | |
49 | The display is normally in reverse video (if your terminal supports | |
50 | this in the status line) and is right justified to reduce distraction. | |
51 | Every fifth display is done in normal video to give the screen a chance | |
52 | to rest. | |
53 | .PP | |
54 | If you have a file named .who in your home directory, then the contents | |
55 | of that file is printed first. One common use of this | |
56 | feature is to alias chdir, pushd, and popd to place the current directory | |
57 | stack in ~/.who after it changes the new directory. | |
58 | .PP | |
59 | The following flags may be given on the command line. | |
60 | .TP 12 | |
61 | .B \-b | |
62 | Beep once every half hour and twice every hour, just like those obnoxious | |
63 | watches you keep hearing. | |
64 | .TP | |
65 | .B \-c | |
66 | Clear the status line for 5 seconds before each redisplay. | |
67 | .TP | |
68 | .B \-d | |
570d12e7 | 69 | Debug mode -- print status line data in human readable format. |
412e4f93 KM |
70 | .TP |
71 | .B \-D | |
72 | Print out the current day/date before the time. | |
73 | .TP | |
74 | .B \-e | |
75 | Print out only the information. Do not print out the control commands | |
76 | necessary to put the information on the bottom line. This option is | |
77 | useful for putting the output of | |
78 | .I sysline | |
79 | onto the mode line of an emacs window. | |
80 | .TP | |
975a0faf KM |
81 | .B \-w |
82 | Window mode -- print the status on the current line of the terminal, | |
83 | suitable for use inside a one line window. | |
84 | .TP | |
412e4f93 KM |
85 | .B \-H remote |
86 | Print the load average on the remote host \fIremote\fP [VAX only]. | |
87 | If the host is down, or is not sending out \fIrwhod\fP packets, then | |
975a0faf KM |
88 | the down time is printed instead. If the prefix "ucb" is present, |
89 | then it is removed. | |
412e4f93 KM |
90 | .TP |
91 | .B \-h | |
92 | Print out the host machine's name after the time [VAX only]. | |
93 | .TP | |
94 | .B \-l | |
95 | Don't print the names of people who log in and out. | |
96 | .TP | |
97 | .B \-m | |
98 | Don't check for mail. | |
99 | .TP | |
100 | .B \-p | |
101 | Don't report the number of process which are runnable and suspended. | |
102 | .TP | |
103 | .B \-r | |
104 | Don't display in reverse video. | |
105 | .TP | |
00f19af8 | 106 | .B +N |
412e4f93 KM |
107 | Update the status line every N seconds. The default is 60 seconds. |
108 | .TP | |
109 | .B \-q | |
110 | Don't print out diagnostic messages if something goes wrong when starting up. | |
111 | .TP | |
112 | .B \-i | |
113 | Print out the process id of the | |
114 | .I sysline | |
115 | process onto standard output upon startup. | |
116 | With this information you can send the alarm signal to the | |
117 | .I sysline | |
118 | process to cause it to update immediately. | |
119 | .I sysline | |
120 | writes to the standard error, so you can redirect the standard | |
121 | output into a file to catch the process id. | |
122 | .TP | |
123 | .B \-s | |
124 | Print "short" form of line by left-justifying | |
125 | .I iff | |
126 | escapes are not allowed in the status line. | |
127 | Some terminals (the Televideos and Freedom 100 for example) | |
128 | do not allow cursor movement (or other "intelligent" operations) | |
129 | in the status line. For these terminals, | |
130 | .I sysline | |
131 | normally uses blanks to cause right-justification. | |
132 | This flag will disable the adding of the blanks. | |
133 | .TP | |
134 | .B \-j | |
135 | Force the sysline output to be left justified even on terminals capable of | |
136 | cursor movement on the status line. | |
137 | .PP | |
138 | If you have a file .syslinelock in your home directory, then | |
139 | .I sysline | |
140 | will not update its statistics and write on your screen, it will just go to | |
141 | sleep for a minute. This is useful if you want to momentarily disable | |
142 | .I sysline. | |
143 | Note that it may take a few seconds from the time the lock file | |
144 | is created until you are guaranteed that | |
145 | .I sysline | |
146 | will not write on the screen. | |
147 | .SH FILES | |
148 | .ta 2.4i | |
149 | .nf | |
150 | /etc/utmp names of people who are logged in | |
151 | /dev/kmem contains process table [VAX only] | |
152 | /usr/spool/rwho/whod.* who/uptime information for remote hosts [VAX only] | |
153 | ${HOME}/.who information to print on bottom line | |
154 | ${HOME}/.syslinelock when it exists, sysline will not print | |
155 | .fi | |
156 | .SH AUTHORS | |
157 | John Foderaro | |
158 | .br | |
159 | Tom Ferrin converted it to use termcap. | |
160 | .br | |
161 | Mark Horton added terminfo capability. | |
162 | .SH BUGS | |
163 | If you interrupt the display then you may find your cursor missing or | |
164 | stuck on the status line. The best thing to do is reset the terminal. | |
165 | .br | |
166 | If there is too much for one line, the excess is thrown away. |