aboutsummaryrefslogtreecommitdiffstats
path: root/man3/libsimple_close_range.3
diff options
context:
space:
mode:
authorMattias Andrée <maandree@kth.se>2024-08-18 10:07:51 +0200
committerMattias Andrée <maandree@kth.se>2024-08-18 10:07:51 +0200
commit2de8dae44c40d97e3947070353c1db709a35f92c (patch)
tree13a9827273a54b2a9235135c84eae735ced05009 /man3/libsimple_close_range.3
parentAdd @since for definitions added in version 1.5 (diff)
parentAdd missing .c files (diff)
downloadlibsimple-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.374
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)