getdirentries.2 (8269e7673cf033aba67dab8264fe719920c70f87) getdirentries.2 (dd81cc2bc5f25fb2c58bb59bf585deeeae196345)
1.\" Copyright (c) 1989, 1991, 1993
2.\" The Regents of the University of California. All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.

--- 11 unchanged lines hidden (view full) ---

20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26.\" SUCH DAMAGE.
27.\"
1.\" Copyright (c) 1989, 1991, 1993
2.\" The Regents of the University of California. All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.

--- 11 unchanged lines hidden (view full) ---

20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26.\" SUCH DAMAGE.
27.\"
28.Dd September 5, 2023
28.Dd July 8, 2025
29.Dt GETDIRENTRIES 2
30.Os
31.Sh NAME
32.Nm getdirentries ,
33.Nm getdents
34.Nd "get directory entries in a file system independent format"
35.Sh LIBRARY
36.Lb libc

--- 136 unchanged lines hidden (view full) ---

173is not a valid file descriptor open for reading.
174.It Bq Er EFAULT
175Either
176.Fa buf
177or non-NULL
178.Fa basep
179point outside the allocated address space.
180.It Bq Er EINVAL
29.Dt GETDIRENTRIES 2
30.Os
31.Sh NAME
32.Nm getdirentries ,
33.Nm getdents
34.Nd "get directory entries in a file system independent format"
35.Sh LIBRARY
36.Lb libc

--- 136 unchanged lines hidden (view full) ---

173is not a valid file descriptor open for reading.
174.It Bq Er EFAULT
175Either
176.Fa buf
177or non-NULL
178.Fa basep
179point outside the allocated address space.
180.It Bq Er EINVAL
181The file referenced by
182.Fa fd
183is not a directory, or
181The value of
184.Fa nbytes
185is too small for returning a directory entry or block of entries,
186or the current position pointer is invalid.
187.It Bq Er EIO
188An
189.Tn I/O
190error occurred while reading from or writing to the file system.
191.It Bq Er EINTEGRITY
192Corrupted data was detected while reading from the file system.
193.It Bq Er ENOENT
194Directory unlinked but still open.
182.Fa nbytes
183is too small for returning a directory entry or block of entries,
184or the current position pointer is invalid.
185.It Bq Er EIO
186An
187.Tn I/O
188error occurred while reading from or writing to the file system.
189.It Bq Er EINTEGRITY
190Corrupted data was detected while reading from the file system.
191.It Bq Er ENOENT
192Directory unlinked but still open.
193.It Bq Er ENOTDIR
194The file referenced by
195.Fa fd
196is not a directory.
195.El
196.Sh SEE ALSO
197.Xr lseek 2 ,
198.Xr open 2 ,
199.Xr directory 3 ,
200.Xr dir 5
201.Sh HISTORY
202The
203.Fn getdirentries
204system call first appeared in
205.Bx 4.4 .
206The
207.Fn getdents
208system call first appeared in
209.Fx 3.0 .
197.El
198.Sh SEE ALSO
199.Xr lseek 2 ,
200.Xr open 2 ,
201.Xr directory 3 ,
202.Xr dir 5
203.Sh HISTORY
204The
205.Fn getdirentries
206system call first appeared in
207.Bx 4.4 .
208The
209.Fn getdents
210system call first appeared in
211.Fx 3.0 .