![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to sysline.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDTahoe / man / man1|
Return to sysline.1 CVS log | Up to [CSRG BSD Unix] / 43BSDTahoe / man / man1 |
1.1 root 1: .\" Copyright (c) 1983 Regents of the University of California.
2: .\" All rights reserved. The Berkeley software License Agreement
3: .\" specifies the terms and conditions for redistribution.
4: .\"
5: .\" @(#)sysline.1 6.3 (Berkeley) 6/5/86
6: .\"
7: .TH SYSLINE 1 "June 5, 1986"
8: .UC 5
9: .SH NAME
10: sysline \- display system status on status line of a terminal
11: .SH SYNOPSIS
12: .B sysline
13: [
14: .B \-bcdewhDilmpqrsj
15: ] [
16: .B \-H\ remote
17: ] [
18: .B +N
19: ]
20: .SH DESCRIPTION
21: .I Sysline
22: runs in the background and periodically displays system status information
23: on the status line of the terminal.
24: Not all terminals contain a status line.
25: Those that do include the h19, concept 108, Ann Arbor Ambassador, vt100,
26: Televideo 925/950 and Freedom 100.
27: If no flags are given,
28: .I sysline
29: displays the time of day, the current load average, the change in load
30: average in the last 5 minutes, the number of users (followed by a `u'),
31: the number of runnable process (followed by a `r')[VAX only], the number
32: of suspended processes (followed by a `s')[VAX only],
33: and the users who have logged on and off since the last status report.
34: Finally, if new mail has arrived, a summary of it is printed.
35: If there is unread mail in your mailbox, an asterisk will appear after the
36: display of the number of users.
37: The display is normally in reverse video (if your terminal supports
38: this in the status line) and is right justified to reduce distraction.
39: Every fifth display is done in normal video to give the screen a chance
40: to rest.
41: .PP
42: If you have a file named .who in your home directory, then the contents
43: of that file is printed first. One common use of this
44: feature is to alias chdir, pushd, and popd to place the current directory
45: stack in ~/.who after it changes the new directory.
46: .PP
47: The following flags may be given on the command line.
48: .TP 12
49: .B \-b
50: Beep once every half hour and twice every hour, just like those obnoxious
51: watches you keep hearing.
52: .TP
53: .B \-c
54: Clear the status line for 5 seconds before each redisplay.
55: .TP
56: .B \-d
57: Debug mode -- print status line data in human readable format.
58: .TP
59: .B \-D
60: Print out the current day/date before the time.
61: .TP
62: .B \-e
63: Print out only the information. Do not print out the control commands
64: necessary to put the information on the bottom line. This option is
65: useful for putting the output of
66: .I sysline
67: onto the mode line of an emacs window.
68: .TP
69: .B \-w
70: Window mode -- print the status on the current line of the terminal,
71: suitable for use inside a one line window.
72: .TP
73: .B \-H remote
74: Print the load average on the remote host \fIremote\fP [VAX only].
75: If the host is down, or is not sending out \fIrwhod\fP packets, then
76: the down time is printed instead. If the prefix "ucb" is present,
77: then it is removed.
78: .TP
79: .B \-h
80: Print out the host machine's name after the time [VAX only].
81: .TP
82: .B \-l
83: Don't print the names of people who log in and out.
84: .TP
85: .B \-m
86: Don't check for mail.
87: .TP
88: .B \-p
89: Don't report the number of process which are runnable and suspended.
90: .TP
91: .B \-r
92: Don't display in reverse video.
93: .TP
94: .B +N
95: Update the status line every N seconds. The default is 60 seconds.
96: .TP
97: .B \-q
98: Don't print out diagnostic messages if something goes wrong when starting up.
99: .TP
100: .B \-i
101: Print out the process id of the
102: .I sysline
103: process onto standard output upon startup.
104: With this information you can send the alarm signal to the
105: .I sysline
106: process to cause it to update immediately.
107: .I sysline
108: writes to the standard error, so you can redirect the standard
109: output into a file to catch the process id.
110: .TP
111: .B \-s
112: Print "short" form of line by left-justifying
113: .I iff
114: escapes are not allowed in the status line.
115: Some terminals (the Televideos and Freedom 100 for example)
116: do not allow cursor movement (or other "intelligent" operations)
117: in the status line. For these terminals,
118: .I sysline
119: normally uses blanks to cause right-justification.
120: This flag will disable the adding of the blanks.
121: .TP
122: .B \-j
123: Force the sysline output to be left justified even on terminals capable of
124: cursor movement on the status line.
125: .PP
126: If you have a file .syslinelock in your home directory, then
127: .I sysline
128: will not update its statistics and write on your screen, it will just go to
129: sleep for a minute. This is useful if you want to momentarily disable
130: .I sysline.
131: Note that it may take a few seconds from the time the lock file
132: is created until you are guaranteed that
133: .I sysline
134: will not write on the screen.
135: .SH FILES
136: .ta 2.4i
137: .nf
138: /etc/utmp names of people who are logged in
139: /dev/kmem contains process table [VAX only]
140: /usr/spool/rwho/whod.* who/uptime information for remote hosts [VAX only]
141: ${HOME}/.who information to print on bottom line
142: ${HOME}/.syslinelock when it exists, sysline will not print
143: .fi
144: .SH AUTHORS
145: John Foderaro
146: .br
147: Tom Ferrin converted it to use termcap.
148: .br
149: Mark Horton added terminfo capability.
150: .SH BUGS
151: If you interrupt the display then you may find your cursor missing or
152: stuck on the status line. The best thing to do is reset the terminal.
153: .br
154: If there is too much for one line, the excess is thrown away.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.