The perrpt command displays, clears, restarts or suppresses the D3 error log maintained on UNIX. The system automatically logs every boot, shut down, and incident or abnormal procedure related to a D3 virtual machine.
perrpt {-e {code}} {-h} {-f file.name} {-p pib} [-a|-k key|-x key|-c|-s]
Options are specified by these flags:
| -e {code} | Displays errors only. Boots and shut downs are not displayed. If the code is specified, only the log entries with this error code are displayed. |
| -h | Displays only the header of the log entries in short form.
The information below displays:
|
| -f file.name | Uses the file name as the log file instead of the default. |
| -p pib | Displays all entries logged by the D3 port PIB, expressed in decimal. |
| -a | Displays logs for all virtual machines. |
| -k key | Displays error log for the virtual machine specified by the key. The virtual machine key is specified using the standard C syntax: 0xNNNN for a hexadecimal number, NNNN for a decimal number, and 0NNNN for an octal number. |
| -x key | Displays error log for all virtual machines except the one specified by the key. The virtual machine key is specified using the standard C syntax: 0xNNNN for a hexadecimal number, NNNN for a decimal number, and 0NNNN for an octal number. |
| -c | Clears the error log and restarts the error logging. Requires the root privilege. |
| -s | Clears the error log and stops the logging process. Requires the root privilege. After this command is issued, no error logging takes place. Error logging is restarted by using the -c flag. The trace is reactivated automatically every time D3 is installed or reinstalled on the system. |
The log is kept in the file /usr/tmp/ap.log. Each log entry has the UNIX time and date of the incident, the key in hexadecimal of the D3 virtual machine, an error code, the process port (PIB) number of the process that logged the error (not necessarily the process that had a problem), and the optional information in the form of a hexadecimal dump. The table below describes each error and the syntax of the additional data:
| 1 | Boot. | |
| 2 | Shut down. | |
| 3 | Line 0 or the flusher received a SIGTERM. When the flusher receives this signal, it shuts the virtual machine down. There should be two shut entries when the system is shut down properly (that is, there is a log entry for a shut down). If not, the system was shut down abnormally. | |
| 4 | Process killed. When a D3 process
does not respond, logoff escalates and sends a signal SIGKILL to the
D3 process. The additional information is (in hexadecimal): <pib+1 of killed process> <pib+1 of killer> |
|
| 5 | Process abort. When a process receives a serious abort signal (for example, SIGSEGV, SIGBUS, SIGTRAP, and so on), the machine registers are dumped in the additional data (in a format implementation dependent). | |
| 6 | Security failure. Wrong activation code. | |
| 7 | <reserved> | |
| 8 | Tape error. The additional information
contains: <cmd> <devnum> <errno>where |
|
| <cmd> |
|
|
| <devnum> | Tape device number in hexadecimal. | |
| <errno> | UNIX error code in hexadecimal. | |
| 9 | Tape buffer allocation failed. The internal tape buffer is allocated dynamically. If this fails because UNIX is temporary out of memory, the set-device command may appear to hang. | |
| 10 | Keyboard read error. A process
attempted to read from stdin (normally a keyboard) and received an
error. The process is disconnected. The additional information is
(in hexadecimal): <pib> <errno> |
|
| 11 | Terminal write error. A process
attempted to write to stdout (normally to a terminal) and received
an error. The additional information is (in hexadecimal): <pib> <errno> |
|
Displays an all errors log, stopping at each page.
perrpt -a | pg
Displays only errors relative to the virtual machine with the key 0x29733 (hexadecimal), and pipes the result to the UNIX spooler.
perrpt -e -k 0x29733 | lp
Clears the error log, but leaves it active (or restarts it if it was stopped).
perrpt -c
Stops error logging.
perrpt -s
Displays all entries with an error code=4 in short form:
perrpt -e 4 -h
Saves the current error log in the file usr/tmp/ap.log.monday and lists it.
mv/usr/tmp/ap.log/usr/tmp/ap.log.monday perrpt -a -f /usr/tmp/ap.log.monday