[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]
Base Operating System and Extensions Technical Reference, Volume 1

psignal Subroutine or sys_siglist Vector

Purpose

Prints system signal messages.

Library

Standard C Library (libc.a)

Syntax

psignal (Signal, String)
unsigned Signal;
char *String;
char *sys_siglist[ ];

Description

The psignal subroutine produces a short message on the standard error file describing the indicated signal. First the String parameter is printed, then the name of the signal and a new-line character.

To simplify variant formatting of signal names, the sys_siglist vector of message strings is provided. The signal number can be used as an index in this table to get the signal name without the new-line character. The NSIG defined in the signal.h file is the number of messages provided for in the table. It should be checked because new signals may be added to the system before they are added to the table.

Parameters

Signal Specifies a signal. The signal number should be among those found in the signal.h file.
String Specifies a string that is printed. Most usefully, the String parameter is the name of the program that incurred the signal.

Implementation Specifics

These subroutines are part of Base Operating System (BOS) Runtime.

Related Information

The perror subroutine, sigvec subroutine.


[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]