diff options
author | Mattias Andrée <maandree@kth.se> | 2024-08-18 10:07:51 +0200 |
---|---|---|
committer | Mattias Andrée <maandree@kth.se> | 2024-08-18 10:07:51 +0200 |
commit | 2de8dae44c40d97e3947070353c1db709a35f92c (patch) | |
tree | 13a9827273a54b2a9235135c84eae735ced05009 /man3/libsimple_close_range.3 | |
parent | Add @since for definitions added in version 1.5 (diff) | |
parent | Add missing .c files (diff) | |
download | libsimple-2de8dae44c40d97e3947070353c1db709a35f92c.tar.gz libsimple-2de8dae44c40d97e3947070353c1db709a35f92c.tar.bz2 libsimple-2de8dae44c40d97e3947070353c1db709a35f92c.tar.xz |
Merge tag '1.6' into since
Version 1.6
Diffstat (limited to '')
-rw-r--r-- | man3/libsimple_close_range.3 | 74 |
1 files changed, 74 insertions, 0 deletions
diff --git a/man3/libsimple_close_range.3 b/man3/libsimple_close_range.3 new file mode 100644 index 0000000..891ac3f --- /dev/null +++ b/man3/libsimple_close_range.3 @@ -0,0 +1,74 @@ +.TH LIBSIMPLE_CLOSE 3 libsimple +.SH NAME +libsimple_close_range \- close a range of file descriptors + +.SH SYNOPSIS +.nf +#include <libsimple.h> + +#define LIBSIMPLE_CLOSE_RANGE_MAX (~0U) + +int libsimple_close_range(unsigned int first, unsigned int last, unsigned int *next); +.fi +.PP +Link with +.IR \-lsimple . + +.SH DESCRIPTION +The +.BR libsimple_close_range () +function closes all file descriptors in the +range inclusive range +.RI [ *first ", " last ]. +.PP +Unless +.I next +is, +.IR NULL , +the first potentially unclosed file descriptor +will be written to +.I *next . + +.SH RETURN VALUE +The +.BR libsimple_close_range () +function returns 0 upon successful completion; +otherwise \-1 is returned (potentially partially +successful). + +.SH ERRORS +The +.BR libsimple_close_range () +function fail for the reasons specified for the +.BR close (3) +function except +.BR EBADF , +or if +.TP +.B EINVAL +.I first +is greater than +.IR last . + +.SH EXAMPLES +None. + +.SH APPLICATION USAGE +None. + +.SH RATIONALE +None. + +.SH FUTURE DIRECTIONS +None. + +.SH NOTES +None. + +.SH BUGS +None. + +.SH SEE ALSO +.BR close_range (2), +.BR close (3), +.BR libsimple_close (3) |