Commit | Line | Data |
---|---|---|
daacd5f0 | 1 | .\" Copyright (c) 1983, 1990 The Regents of the University of California. |
39d0ae39 | 2 | .\" All rights reserved. |
412e4f93 | 3 | .\" |
b2a7c0f3 | 4 | .\" %sccs.include.redist.roff% |
412e4f93 | 5 | .\" |
b2a7c0f3 | 6 | .\" @(#)sysline.1 6.6 (Berkeley) %G% |
39d0ae39 | 7 | .\" |
b2a7c0f3 CL |
8 | .Dd |
9 | .Dt SYSLINE 1 | |
10 | .Os BSD 4.2 | |
11 | .Sh NAME | |
12 | .Nm sysline | |
13 | .Nd display system status on status line of a terminal | |
14 | .Sh SYNOPSIS | |
15 | .Nm sysline | |
16 | .Op Fl Dbcdehijlmpqrsw | |
17 | .Op Fl H Ar remote | |
18 | .Op Cm +N | |
19 | .Sh DESCRIPTION | |
20 | .Nm Sysline | |
412e4f93 KM |
21 | runs in the background and periodically displays system status information |
22 | on the status line of the terminal. | |
23 | Not all terminals contain a status line. | |
24 | Those that do include the h19, concept 108, Ann Arbor Ambassador, vt100, | |
25 | Televideo 925/950 and Freedom 100. | |
26 | If no flags are given, | |
b2a7c0f3 | 27 | .Nm sysline |
412e4f93 KM |
28 | displays the time of day, the current load average, the change in load |
29 | average in the last 5 minutes, the number of users (followed by a `u'), | |
b2a7c0f3 CL |
30 | the number of runnable process (followed by a `r') |
31 | .Bq Tn VAX No only , | |
32 | the number | |
33 | of suspended processes (followed by a `s') | |
34 | .Bq Tn VAX No only , | |
412e4f93 KM |
35 | and the users who have logged on and off since the last status report. |
36 | Finally, if new mail has arrived, a summary of it is printed. | |
37 | If there is unread mail in your mailbox, an asterisk will appear after the | |
38 | display of the number of users. | |
39 | The display is normally in reverse video (if your terminal supports | |
40 | this in the status line) and is right justified to reduce distraction. | |
41 | Every fifth display is done in normal video to give the screen a chance | |
42 | to rest. | |
b2a7c0f3 CL |
43 | .Pp |
44 | If you have a file named | |
45 | .Pa .who | |
46 | in your home directory, then the contents | |
412e4f93 KM |
47 | of that file is printed first. One common use of this |
48 | feature is to alias chdir, pushd, and popd to place the current directory | |
b2a7c0f3 CL |
49 | stack in |
50 | .Pa ~/.who | |
51 | after it changes the new directory. | |
52 | .Pp | |
412e4f93 | 53 | The following flags may be given on the command line. |
b2a7c0f3 CL |
54 | .Bl -tag -width Ds |
55 | .It Fl D | |
56 | Print out the current day/date before the time. | |
57 | .It Fl H Ar remote | |
58 | Print the load average on the remote host | |
59 | .Ar remote | |
60 | .Bq Tn VAX No only . | |
61 | If the host is down, or is not sending out | |
62 | .Xr rwhod | |
63 | packets, then | |
64 | the down time is printed instead. If the prefix "ucb" is present, | |
65 | then it is removed. | |
66 | .It Cm +N | |
67 | Update the status line every N seconds. The default is 60 seconds. | |
68 | .It Fl b | |
412e4f93 KM |
69 | Beep once every half hour and twice every hour, just like those obnoxious |
70 | watches you keep hearing. | |
b2a7c0f3 | 71 | .It Fl c |
412e4f93 | 72 | Clear the status line for 5 seconds before each redisplay. |
b2a7c0f3 | 73 | .It Fl d |
570d12e7 | 74 | Debug mode -- print status line data in human readable format. |
b2a7c0f3 | 75 | .It Fl e |
412e4f93 KM |
76 | Print out only the information. Do not print out the control commands |
77 | necessary to put the information on the bottom line. This option is | |
78 | useful for putting the output of | |
b2a7c0f3 | 79 | .Nm sysline |
412e4f93 | 80 | onto the mode line of an emacs window. |
b2a7c0f3 CL |
81 | .It Fl h |
82 | Print out the host machine's name after the time | |
83 | .Bq Tn VAX No only . | |
84 | .It Fl i | |
412e4f93 | 85 | Print out the process id of the |
b2a7c0f3 | 86 | .Nm sysline |
412e4f93 KM |
87 | process onto standard output upon startup. |
88 | With this information you can send the alarm signal to the | |
b2a7c0f3 | 89 | .Nm sysline |
412e4f93 | 90 | process to cause it to update immediately. |
b2a7c0f3 | 91 | .Nm Sysline |
412e4f93 KM |
92 | writes to the standard error, so you can redirect the standard |
93 | output into a file to catch the process id. | |
b2a7c0f3 CL |
94 | .It Fl j |
95 | Force the sysline output to be left justified even on terminals capable of | |
96 | cursor movement on the status line. | |
97 | .It Fl l | |
98 | Don't print the names of people who log in and out. | |
99 | .It Fl m | |
100 | Don't check for mail. | |
101 | .It Fl p | |
102 | Don't report the number of process which are runnable and suspended. | |
103 | .It Fl q | |
104 | Don't print out diagnostic messages if something goes wrong when starting up. | |
105 | .It Fl r | |
106 | Don't display in reverse video. | |
107 | .It Fl s | |
412e4f93 | 108 | Print "short" form of line by left-justifying |
b2a7c0f3 | 109 | .Em iff |
412e4f93 KM |
110 | escapes are not allowed in the status line. |
111 | Some terminals (the Televideos and Freedom 100 for example) | |
112 | do not allow cursor movement (or other "intelligent" operations) | |
113 | in the status line. For these terminals, | |
b2a7c0f3 | 114 | .Nm sysline |
412e4f93 KM |
115 | normally uses blanks to cause right-justification. |
116 | This flag will disable the adding of the blanks. | |
b2a7c0f3 CL |
117 | .It Fl w |
118 | Window mode -- print the status on the current line of the terminal, | |
119 | suitable for use inside a one line window. | |
120 | .El | |
121 | .Pp | |
122 | If you have a file | |
123 | .Pa .syslinelock | |
124 | in your home directory, then | |
125 | .Nm sysline | |
412e4f93 KM |
126 | will not update its statistics and write on your screen, it will just go to |
127 | sleep for a minute. This is useful if you want to momentarily disable | |
b2a7c0f3 | 128 | .Nm sysline . |
412e4f93 KM |
129 | Note that it may take a few seconds from the time the lock file |
130 | is created until you are guaranteed that | |
b2a7c0f3 | 131 | .Nm sysline |
412e4f93 | 132 | will not write on the screen. |
b2a7c0f3 CL |
133 | .Sh FILES |
134 | .Bl -tag -width /var/spool/rwho/whod.x -compact | |
135 | .It Pa /var/run/utmp | |
136 | names of people who are logged in | |
137 | .It Pa /dev/kmem | |
138 | contains process table | |
139 | .Bq Tn VAX No only | |
140 | .It Pa /var/spool/rwho/whod.* | |
141 | who/uptime information for remote hosts | |
142 | .Bq Tn VAX No only | |
143 | .It Pa ${HOME}/.who | |
144 | information to print on bottom line | |
145 | .It Pa ${HOME}/.syslinelock | |
146 | when it exists, sysline will not print | |
147 | .El | |
148 | .Sh BUGS | |
412e4f93 KM |
149 | If you interrupt the display then you may find your cursor missing or |
150 | stuck on the status line. The best thing to do is reset the terminal. | |
b2a7c0f3 | 151 | .Pp |
412e4f93 | 152 | If there is too much for one line, the excess is thrown away. |
b2a7c0f3 CL |
153 | .Sh HISTORY |
154 | The | |
155 | .Nm | |
156 | command appeared in | |
157 | .Bx 4.2 . | |
158 | .Sh ENVIRONMENT | |
159 | .Bl -tag -width HOME | |
160 | .Nm Sysline | |
161 | checks for the existence of | |
162 | the following environment variables: | |
163 | .It Ev HOME | |
164 | The directory provided by the | |
165 | .Ev HOME | |
166 | variable is checked for the file | |
167 | .Pa .who . | |
168 | .It Ev TERM | |
169 | Provides terminal type. | |
170 | .It Ev USER | |
171 | Provides username. | |
172 | .El |