X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~mdw/git/mLib/blobdiff_plain/9f8886c72ce02c9c4487a562a24a518c96043664..36b6fecc4670f4d351cd662a6772a5a196108ceb:/man/sig.3 diff --git a/man/sig.3 b/man/sig.3 index ddfbdb4..a176e12 100644 --- a/man/sig.3 +++ b/man/sig.3 @@ -1,5 +1,5 @@ .\" -*-nroff-*- -.TH sel 3 "23 July 1999" mLib +.TH sel 3 "23 July 1999" "Straylight/Edgeware" "mLib utilities library" .SH NAME sig \- more controlled signal handling .\" @sig_init @@ -20,9 +20,9 @@ The subsystem uses the I/O multiplexing capabilities of .B mLib (see -.BR sel (3) for details) -to provide a more convenient interface for handling signals which don't -need to be dealt with `right away'. Like the I/O system, +.BR sel (3) +for details) to provide a more convenient interface for handling signals +which don't need to be dealt with `right away'. Like the I/O system, .B sig doesn't allocate any memory for itself: you have to give it space to work in. @@ -39,25 +39,25 @@ To register interest in a signal, call .BR sig_add , passing it the following arguments: .TP -.I s +.BI "sig *" s A pointer to an (uninitialized) object of type .BR sig . This will be used by the system to retain information about this signal claim. You use the address of this object to remove the handler again when you've finished. .TP -.I n +.BI "int " n The number of the signal you want to handle. .PP .TP -.I proc +.BI "void (*" proc ")(int " n ", void *" p ) A function to call when the signal is detected. The function is passed the signal number and the pointer .I p passed to .BR sig_add . .TP -.I p +.BI "void *" p A pointer argument to be passed to .I func when the signal is detected. @@ -89,9 +89,5 @@ The .B SA_NOCLDSTOP flag is also set, so that stopped child processes aren't reported by a signal. This is normally right, but ought to be configurable. -.PP -The system uses writes to a nonblocking pipe to integrate with the I/O -multiplexing system. It's possible (though very unlikely) that signals -get lost because the pipe is full. .SH "AUTHOR" -Mark Wooding, +Mark Wooding,