1*8269e767SBrooks Davis.\" Copyright (c) 2009 Hudson River Trading LLC 2*8269e767SBrooks Davis.\" Written by: John H. Baldwin <jhb@FreeBSD.org> 3*8269e767SBrooks Davis.\" All rights reserved. 4*8269e767SBrooks Davis.\" 5*8269e767SBrooks Davis.\" Redistribution and use in source and binary forms, with or without 6*8269e767SBrooks Davis.\" modification, are permitted provided that the following conditions 7*8269e767SBrooks Davis.\" are met: 8*8269e767SBrooks Davis.\" 1. Redistributions of source code must retain the above copyright 9*8269e767SBrooks Davis.\" notice, this list of conditions and the following disclaimer. 10*8269e767SBrooks Davis.\" 2. Redistributions in binary form must reproduce the above copyright 11*8269e767SBrooks Davis.\" notice, this list of conditions and the following disclaimer in the 12*8269e767SBrooks Davis.\" documentation and/or other materials provided with the distribution. 13*8269e767SBrooks Davis.\" 14*8269e767SBrooks Davis.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 15*8269e767SBrooks Davis.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 16*8269e767SBrooks Davis.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 17*8269e767SBrooks Davis.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 18*8269e767SBrooks Davis.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 19*8269e767SBrooks Davis.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 20*8269e767SBrooks Davis.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 21*8269e767SBrooks Davis.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 22*8269e767SBrooks Davis.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 23*8269e767SBrooks Davis.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 24*8269e767SBrooks Davis.\" SUCH DAMAGE. 25*8269e767SBrooks Davis.\" 26*8269e767SBrooks Davis.Dd March 3, 2022 27*8269e767SBrooks Davis.Dt CLOSEFROM 2 28*8269e767SBrooks Davis.Os 29*8269e767SBrooks Davis.Sh NAME 30*8269e767SBrooks Davis.Nm closefrom , 31*8269e767SBrooks Davis.Nm close_range 32*8269e767SBrooks Davis.Nd delete open file descriptors 33*8269e767SBrooks Davis.Sh LIBRARY 34*8269e767SBrooks Davis.Lb libc 35*8269e767SBrooks Davis.Sh SYNOPSIS 36*8269e767SBrooks Davis.In unistd.h 37*8269e767SBrooks Davis.Ft void 38*8269e767SBrooks Davis.Fn closefrom "int lowfd" 39*8269e767SBrooks Davis.Ft int 40*8269e767SBrooks Davis.Fn close_range "u_int lowfd" "u_int highfd" "int flags" 41*8269e767SBrooks Davis.Sh DESCRIPTION 42*8269e767SBrooks DavisThe 43*8269e767SBrooks Davis.Fn closefrom 44*8269e767SBrooks Davissystem call deletes all open file descriptors greater than or equal to 45*8269e767SBrooks Davis.Fa lowfd 46*8269e767SBrooks Davisfrom the per-process object reference table. 47*8269e767SBrooks DavisAny errors encountered while closing file descriptors are ignored. 48*8269e767SBrooks Davis.Pp 49*8269e767SBrooks DavisThe 50*8269e767SBrooks Davis.Fn close_range 51*8269e767SBrooks Davissystem call deletes all open file descriptors between 52*8269e767SBrooks Davis.Fa lowfd 53*8269e767SBrooks Davisand 54*8269e767SBrooks Davis.Fa highfd 55*8269e767SBrooks Davisinclusive, clamped to the range of open file descriptors. 56*8269e767SBrooks DavisAny errors encountered while closing file descriptors are ignored. 57*8269e767SBrooks DavisSupported 58*8269e767SBrooks Davis.Fa flags : 59*8269e767SBrooks Davis.Bl -tag -width ".Dv CLOSE_RANGE_CLOEXEC" 60*8269e767SBrooks Davis.It Dv CLOSE_RANGE_CLOEXEC 61*8269e767SBrooks DavisSet the close-on-exec flag on descriptors in the range instead of closing them. 62*8269e767SBrooks Davis.El 63*8269e767SBrooks Davis.Sh RETURN VALUES 64*8269e767SBrooks DavisUpon successful completion, 65*8269e767SBrooks Davis.Fn close_range 66*8269e767SBrooks Davisreturns a value 67*8269e767SBrooks Davisof 0. 68*8269e767SBrooks DavisOtherwise, a value of -1 is returned and the global variable 69*8269e767SBrooks Davis.Va errno 70*8269e767SBrooks Davisis set to indicate the error. 71*8269e767SBrooks Davis.Sh ERRORS 72*8269e767SBrooks DavisThe 73*8269e767SBrooks Davis.Fn close_range 74*8269e767SBrooks Davissystem call 75*8269e767SBrooks Daviswill fail if: 76*8269e767SBrooks Davis.Bl -tag -width Er 77*8269e767SBrooks Davis.It Bq Er EINVAL 78*8269e767SBrooks DavisThe 79*8269e767SBrooks Davis.Fa highfd 80*8269e767SBrooks Davisargument is lower than the 81*8269e767SBrooks Davis.Fa lowfd 82*8269e767SBrooks Davisargument. 83*8269e767SBrooks Davis.It Bq Er EINVAL 84*8269e767SBrooks DavisAn invalid flag was set. 85*8269e767SBrooks Davis.El 86*8269e767SBrooks Davis.Sh SEE ALSO 87*8269e767SBrooks Davis.Xr close 2 88*8269e767SBrooks Davis.Sh HISTORY 89*8269e767SBrooks DavisThe 90*8269e767SBrooks Davis.Fn closefrom 91*8269e767SBrooks Davisfunction first appeared in 92*8269e767SBrooks Davis.Fx 8.0 . 93