| directory.3 (256281) | directory.3 (270002) |
|---|---|
| 1.\" Copyright (c) 1983, 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. --- 12 unchanged lines hidden (view full) --- 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.\" @(#)directory.3 8.1 (Berkeley) 6/4/93 | 1.\" Copyright (c) 1983, 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. --- 12 unchanged lines hidden (view full) --- 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.\" @(#)directory.3 8.1 (Berkeley) 6/4/93 |
| 29.\" $FreeBSD: stable/10/lib/libc/gen/directory.3 254499 2013-08-18 20:11:34Z pjd $ | 29.\" $FreeBSD: stable/10/lib/libc/gen/directory.3 270002 2014-08-14 20:20:21Z jhb $ |
| 30.\" | 30.\" |
| 31.Dd August 18, 2013 | 31.Dd July 28, 2014 |
| 32.Dt DIRECTORY 3 33.Os 34.Sh NAME 35.Nm opendir , 36.Nm fdopendir , 37.Nm readdir , 38.Nm readdir_r , 39.Nm telldir , --- 124 unchanged lines hidden (view full) --- 164.Dv DIR 165pointer, 166.Fa dirp , 167from which they are derived. 168If the directory is closed and then 169reopened, prior values returned by 170.Fn telldir 171will no longer be valid. | 32.Dt DIRECTORY 3 33.Os 34.Sh NAME 35.Nm opendir , 36.Nm fdopendir , 37.Nm readdir , 38.Nm readdir_r , 39.Nm telldir , --- 124 unchanged lines hidden (view full) --- 164.Dv DIR 165pointer, 166.Fa dirp , 167from which they are derived. 168If the directory is closed and then 169reopened, prior values returned by 170.Fn telldir 171will no longer be valid. |
| 172Values returned by 173.Fn telldir 174are also invalidated by a call to 175.Fn rewinddir . |
|
| 172.Pp 173The 174.Fn seekdir 175function 176sets the position of the next 177.Fn readdir 178operation on the 179.Em directory stream . 180The new position reverts to the one associated with the 181.Em directory stream 182when the 183.Fn telldir 184operation was performed. | 176.Pp 177The 178.Fn seekdir 179function 180sets the position of the next 181.Fn readdir 182operation on the 183.Em directory stream . 184The new position reverts to the one associated with the 185.Em directory stream 186when the 187.Fn telldir 188operation was performed. |
| 185State associated with the token returned by 186.Fn telldir is freed when it is passed to 187.Fn seekdir . 188If you wish return to the same location again, 189then you must create a new token with another 190.Fn telldir 191call. | |
| 192.Pp 193The 194.Fn rewinddir 195function 196resets the position of the named 197.Em directory stream 198to the beginning of the directory. 199.Pp --- 74 unchanged lines hidden --- | 189.Pp 190The 191.Fn rewinddir 192function 193resets the position of the named 194.Em directory stream 195to the beginning of the directory. 196.Pp --- 74 unchanged lines hidden --- |