Annotation of 43BSDReno/lib/libc/gen/sigsetops.3, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1983 The Regents of the University of California.
                      2: .\" All rights reserved.
                      3: .\"
                      4: .\" Redistribution and use in source and binary forms are permitted provided
                      5: .\" that: (1) source distributions retain this entire copyright notice and
                      6: .\" comment, and (2) distributions including binaries display the following
                      7: .\" acknowledgement:  ``This product includes software developed by the
                      8: .\" University of California, Berkeley and its contributors'' in the
                      9: .\" documentation or other materials provided with the distribution and in
                     10: .\" all advertising materials mentioning features or use of this software.
                     11: .\" Neither the name of the University nor the names of its contributors may
                     12: .\" be used to endorse or promote products derived from this software without
                     13: .\" specific prior written permission.
                     14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
                     15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
                     16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     17: .\"
                     18: .\"    @(#)sigsetops.2 6.1 (Berkeley) 7/1/90
                     19: .\"
                     20: .TH SIGSETOPS 3 "July 1, 1990"
                     21: .UC 7
                     22: .SH NAME
                     23: sigsetops, sigemptyset, sigfillset, sigaddset, sigdelset, sigismember \- manipulate signal masks
                     24: .SH SYNOPSIS
                     25: .nf
                     26: .B #include <signal.h>
                     27: 
                     28: .B sigemptyset(set);
                     29: .B sigset_t *set;
                     30: 
                     31: .B sigfillset(set);
                     32: .B sigset_t *set;
                     33: 
                     34: .B sigaddset(set, signo);
                     35: .B sigset_t *set;
                     36: .B int signo;
                     37: 
                     38: .B sigdelset(set, signo);
                     39: .B sigset_t *set;
                     40: .B int signo;
                     41: 
                     42: .B sigismember(set, signo);
                     43: .B sigset_t *set;
                     44: .B int signo;
                     45: 
                     46: .SH DESCRIPTION
                     47: These functions manipulate signal mask stored in a
                     48: .IR sigset_t .
                     49: They are provided as macros, but actual functions are available
                     50: if their names are undefined (with #undef
                     51: .IR name ).
                     52: .PP
                     53: The
                     54: .I sigemptyset
                     55: function initializes a signal set to be empty.
                     56: The
                     57: .I sigfillset
                     58: function initializes a signal set to contain all of the known signals.
                     59: One of these routines must be used to initialize a signal set
                     60: before its use by the other functions.
                     61: .PP
                     62: The
                     63: .I sigaddset
                     64: function adds a specified signal
                     65: .I signo
                     66: to a signal set.
                     67: The
                     68: .I sigdelset
                     69: function deletes a specified signal
                     70: .I signo
                     71: from a signal set.
                     72: .PP
                     73: The
                     74: .I sigismember
                     75: function tests whether a specified signal
                     76: .I signo
                     77: is contained in a signal set.
                     78: .SH "RETURN VALUE
                     79: The
                     80: .I sigismember
                     81: function returnes 1
                     82: if the signal is a member of the set,
                     83: a 0 otherwise.
                     84: The other functions return 0 upon success.
                     85: A \-1 return value
                     86: indicates an error occurred and
                     87: .I errno
                     88: is set to indicated the reason.
                     89: The current implementation does not detect any errors.
                     90: .SH ERRORS
                     91: These functions could fail if one of the following occurs:
                     92: .TP 15
                     93: [EINVAL]
                     94: .I signo
                     95: has an invalid value.
                     96: .SH STANDARDS
                     97: These functions are defined by POSIX.1.
                     98: .SH "SEE ALSO"
                     99: kill(2), sigaction(2), sigsetops(2), sigsuspend(2)

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.