[unix-history] / usr / man / man1 / sysline.1

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