Status key
In computing, a status key is a keyboard key that causes an operating system and/or a program to output status information on a terminal when it is pressed. In the event that a program on a terminal produces no indications that it is running, typing the status key will reveal the program's state and activity.[1] Older implementations produced only a quick one-line status report for the current job when the status key was pressed.[2] Newer implementations support sending a signal to the current process to allow the application to report on status as well.[3]
Operating System-Level Implementations[edit]
Several different operating systems have a status key feature implemented in the kernel or other low-level component.
TENEX[edit]
TENEX has the feature since at least 1971: "Another terminal Interrupt character, control-T is serviced by the EXEC. It interrupts a user's EXEC process to type out total CPU and console time used, and status of the fork being run under the EXEC."[4]
DEC RSTS/E[edit]
RSTS/E is documented as having a status key at least as far back as 1977 and it continued to have one into at least the 1980s. Typing the status key results in output that is represented by the following example:[5][6][2]
18 GARP::KB32 SYSTAT+BAS4F ^C(0R) 11(16)K+ 16K 3.3(+5)
| Field | Value |
|---|---|
| Job number | 18 |
| Node name | GARP |
| Keyboard number | KB32 |
| Program or Operation | SYSTAT |
| Run-time system name | BAS4 |
| Job state | ^C(0R) |
| Program size in words | 11 |
| Maximum size in words | (16)K |
| Run-time system size in words | +16K |
| Amount of CPU time used | 3.3 |
| CPU time since the last CTRL/T | (+.5) |
DEC TOPS-10[edit]
On TOPS-10 when the CTRL/T (control-T) key is pressed, the monitor prints status information pertaining to the job on the terminal. Typing CTRL/T displays a job's progress without interrupting its execution. No representation of a control-t character is displayed on the terminal, just the status information.[7]
DAY: :05:43 RUN:0.48 RD:75 WR:8 SOS 12+19p ^C Ctx:1 PC:400275
Incremental values in the table below indicate that the value is the accumulation since login or last CTRL/T whichever was shortest.[7]
| Field | Value |
|---|---|
| Incremental day time | DAY: :05:43 |
| Incremental run time | RUN:0.48 |
| Incremental disk reads | RD:75 |
| Incremental disk writes | WR:8 |
| Program name | SOS |
| Amount of memory program is using | 12+19p |
| Context number | Ctx:1 |
| Job state code | ^C |
| Program Counter | PC:400275 |
| Job state, INPUT WAIT or OUTPUT WAIT | (only when CTRL/T is used at USER level) |
DEC TOPS-20[edit]
TOPS-20 reports a shorter list of information than its predecessors:[9]
09:36:35 TEST Running at 404157 Used 0:00:35.8 in 0:30:39, Load 4.04
| Field | Value |
|---|---|
| Time | 09:36:35 |
| Name | TEST |
| Status | Running at 404157 |
| Used CPU-time | Used 0:00:35.8 |
| Logged-in-time | in 0:30:39 |
| Load average | Load 4.04 |
MIT ITS[edit]
ITS copied the idea from TOPS-20,[10] but used the key sequence Control+_ J.[11]
19:29:10 3 RMS HACTRN EMACS1 130566
| Field | Value |
|---|---|
| Time | 19:29:10 |
| Job index | 3 |
| User name | RMS |
| Job name | HACTRN |
| System name | EMACS1 |
| User program counter | 130566 |
VSI OpenVMS[edit]
OpenVMS has a status key which can be customized and works with remote processes.[12] The default output includes these items:[1]
NODE22::SMITH 16:21:04 (DCL) CPU=00:03:29.39 PF=14802 IO=18652 MEM=68
| Field | Value |
|---|---|
| Node and process name | NODE22::SMITH |
| Time of day | 16:21:04 |
| Active image name | (DCL) |
| Processor time used | CPU=00:03:29.39 |
| Accumulated page faults | PF=14802 |
| I/O operations | IO=18652 |
| Frames in use | MEM=68 |
BSD UNIX[edit]
4.3BSD-Reno[13][14][15] and BSD systems derived from that version and OSF/1 have a status key which defaults to Ctrl-T and can be assigned to any key.[3][16] It sends SIGINFO to the current process which is ignored by default but can be configured to call a function which can display status information from the program.[17][18]
load: 0.10 cmd: sleep 1594 [nanslp] 1.33r 0.00u 0.00s 0% 1864k
| Field | Value |
|---|---|
| Five minute load average | load: 0.10 |
| Command name | cmd: sleep |
| Process ID | 1594 |
| Wait channel name or lock name | [nanslp] |
| Elapsed real time | 1.33r |
| Elapsed user CPU time | 0.00u |
| Elapsed system CPU time | 0.00s |
| Percentage of CPU | 0% |
| Program memory resident set size | 1864k |
Apple macOS[edit]
Because XNU has a FreeBSD kernel which has been modified to be a Mach server process, the terminal driver includes a status key which is inherited.[19][20][21][22]
load: 3.04 cmd: sleep 719 waiting 0.00u 0.00s
| Field | Value |
|---|---|
| Five minute load average | load: 3.04 |
| Command name | cmd: sleep |
| Process ID | 719 |
| Wait channel name or lock name | waiting |
| Elapsed user CPU time | 0.00u |
| Elapsed system CPU time | 0.00s |
Application-level Implementations[edit]
It addition to implementing a status key in the kernel or related OS component, some applications have features that allow you to press a key to view the application's status.
SDS-940 running BBN Lisp in 1969[edit]
BBN Lisp which runs on an SDS 940 had a status key which was implemented in the Lisp which ran on an OS, rather than in the OS kernel itself.[23]
Control-T Print Time. Causes an immediate printout of the total execution time (in clock ticks) for the job, (even during garbage collections), i.e. clock[2], (p. 14.22). A series of such printouts should show increasing numbers if the program is using any CPU time. Of course, the program is not using CPU time if it is waiting for input. This information may serve to help the user determine if his LISP and/or the time sharing sys- tem has crashed.
References[edit]
- ^ a b Miller, David Donald (1997). Open VMS Operating System Concepts. Elsevier. p. 151. ISBN 978-1-55558-157-2.
- ^ a b RSTS/E System User's Guide (PDF). Maynard, MA: Digital Equipment Corportation. 1985. pp. 4–10. Archived (PDF) from the original on 2007-08-16.
- ^ a b Kerrisk, Michael (2010). The Linux Programming Interface: A Linux and UNIX System Programming Handbook. No Starch Press. p. 1299. ISBN 978-1-59327-291-3.
- ^ Daniel G. Bobrow; Jerry D. Burchfiel; Daniel L. Murphy; Raymond S. Tomlinson (1971-08-15). "4.4 Interrupt Characters". TENEX, a Paged Time Sharing System for the PDP-10 (PDF) (Report).
- ^ BASIC-PLUS-2 RSTS/E User's Guide (PDF). Maynard, MA: Digital Equipment Corportation. 1977. pp. 4–10. Archived (PDF) from the original on 2006-10-09.
- ^ RSTS/E System User's Guide (PDF). Maynard, MA: Digital Equipment Corportation. 1979. pp. 4–13. Archived (PDF) from the original on 2005-03-29.
- ^ a b TOPS-10 Operation System Commands Manual. Maynard, MA: Digital Equipment Corporation. 1988. pp. 1–7. Archived from the original on 2017-12-04.
- ^ TOPS-20 User's Guide. Maynard, MA: Digital Equipment Corportation. 1982. pp. 8–5. Archived from the original on 2017-12-04.
- ^ TOPS-20 User's Guide. Maynard, MA: Digital Equipment Corportation. 1982. pp. 8–5. Archived from the original on 2017-12-04.
- ^ "Re: ooh, a *real* flamewar :)". GitHub. 2000-03-24.
- ^ "ITSTTY". GitHub.
- ^ Peleg, Guy (2006-10-01). "OpenVMS Utilties Update" (PDF). OpenVMS News. Bruden On Shore Systems Group. Archived (PDF) from the original on 2017-12-06. Retrieved 2017-11-06.
- ^ Karels, Michael J. (1989-08-26). "Computer Systems Research Group BSD Distribution signal.h 7.5". SCCS to fossil conversion of the original University of California, Berkeley Computer Systems Research Group BSD repository. Regents of the University of California. Retrieved 2017-12-05.
#define SIGINFO 29 /* information request */
- ^ Teitelbaum, Marc (1989-10-26). "Computer Systems Research Group BSD Distribution tty.c 7.18". SCCS to fossil conversion of the original University of California, Berkeley Computer Systems Research Group BSD repository. Regents of the University of California. Retrieved 2017-12-05.
add ^T prototype
- ^ Teitelbaum, Marc (1990-05-01). "Computer Systems Research Group BSD Distribution tty.c 7.22". SCCS to fossil conversion of the original University of California, Berkeley Computer Systems Research Group BSD repository. Regents of the University of California. Retrieved 2017-12-05.
^T
- ^ – BSD General Commands Manual
- ^ Lucas, Michael W (2015). Tarsnap Mastery. Tilted Windmill Press. p. 71.
- ^ Lavigne, Dru (2004). BSD Hacks 100 Industrial Tip & Tools. O'Reilly Media. ISBN 978-0-596-55256-5.
- ^ "BSD Overview". Apple, Inc. 2013-08-08. Retrieved 2022-03-13.
The BSD portion of the OS X kernel is derived primarily from FreeBSD
- ^ "darwin-xnu/bsd/sys/ttydefaults.h". Github. Apple Computer, Inc. 2007-10-29. Retrieved 2017-12-05.
#define CSTATUS CTRL('t')
- ^ "darwin-xnu/bsd/sys/signal.h". Github. Apple Computer, Inc. 2017-09-26. Retrieved 2017-12-05.
#define SIGINFO 29 /* information request */
- ^ "darwin-xnu/bsd/kern/tty.c". Github. Apple Computer, Inc. 2017-09-26. Retrieved 2017-12-05.
Report on state of foreground process group.
- ^ Bobrow, Daniel; Murphy, Daniel; Teitelman, W (April 1969). "Section 23.10". THE BBN - LISP SYSTEM REFERENCE MANUAL (PDF).