Artifact
3f56004aca01b8eccbcdfaf5e806744733b2ca3c:
Attachment "Signal.3" to
ticket [412609ffff]
added by
andreas_kupries
2001-03-31 17:51:20.
'\"
'\" Copyright (c) 2001 ActiveState Tool Corp.
'\"
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
'\" RCS: @(#) $Id: Signal.3,v 1.3 2000/01/26 21:36:35 ericm Exp $
.so man.macros
.TH Tcl_SignalId 3 8.3 Tcl "Tcl Library Procedures"
.BS
.SH NAME
Tcl_SignalId, Tcl_SignalMsg \- Retrieve signal codes
.SH SYNOPSIS
.nf
\fB#include <tcl.h>\fR
.sp
char *
\fBTcl_SignalId\fR(\fIsig\fR)
.sp
char *
\fBTcl_SignalMsg\fR(\fIsig\fR)
.sp
.SH ARGUMENTS
.AP int sig in
A POSIX signal number such as \fBSIGPIPE\fR.
.BE
.SH DESCRIPTION
.PP
\fBTcl_SignalId\fR and \fBTcl_SignalMsg\fR return a string
representation of the provided signal number (\fIsig\fR).
\fBTcl_SignalId\fR returns a machine-readable textual identifier such
as "SIGPIPE". \fBTcl_SignalMsg\fR returns a human-readable string such
as "bus error". The strings returned by these functions are
statically allocated and the caller must not free or modify them.
.SH KEYWORDS
signals, signal numbers
