| .TH filter_wait 3 "12 July 2007" "ClearSilver" "util/filter.h" |
| |
| .de Ss |
| .sp |
| .ft CW |
| .nf |
| .. |
| .de Se |
| .fi |
| .ft P |
| .sp |
| .. |
| .SH NAME |
| filter_wait - wrap waitpid to decode the exitcode and why |
| your filter quit |
| .SH SYNOPSIS |
| .Ss |
| #include <util/filter.h> |
| .Se |
| .Ss |
| NEOERR *filter_wait(pid_t pid, int options, int *exitcode); |
| |
| .Se |
| |
| .SH ARGUMENTS |
| pid -> the process identifier to wait for |
| .br |
| options -> the options to pass to waitpid (see wait(2)) |
| |
| .SH DESCRIPTION |
| filter_wait wraps the waitpid call and raises an error |
| (with description) if the call failed. Note that if the |
| ask for the exitcode and the process exited with a code |
| other than zero, we don't raise an error. If you don't |
| ask for the exitcode, and it is non-zero, we raise an |
| error |
| |
| .SH "RETURN VALUE" |
| exitcode -> the exitcode if the process existed normally |
| |
| .SH "SEE ALSO" |
| .BR filter_wait "(3), "filter_create_fp "(3), "filter_create_fd |