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. --- 16 unchanged lines hidden (view full) --- 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" 32.\" @(#)dir.5 8.3 (Berkeley) 4/19/94 |
33.\" $FreeBSD: head/share/man/man5/dir.5 107788 2002-12-12 17:26:04Z ru $ |
34.\" 35.Dd April 19, 1994 36.Dt DIR 5 37.Os 38.Sh NAME 39.Nm dir , 40.Nm dirent 41.Nd directory file format --- 7 unchanged lines hidden (view full) --- 49.Xr inode 5 50entry. 51It consists of records (directory entries) each of which contains 52information about a file and a pointer to the file itself. 53Directory entries may contain other directories 54as well as plain files; such nested directories are referred to as 55subdirectories. 56A hierarchy of directories and files is formed in this manner |
57and is called a file system (or referred to as a file system tree). |
58.\" An entry in this tree, 59.\" nested or not nested, 60.\" is a pathname. 61.Pp 62Each directory file contains two special directory entries; one is a pointer 63to the directory itself 64called dot 65.Ql .\& 66and the other a pointer to its parent directory called dot-dot 67.Ql \&.. . 68Dot and dot-dot 69are valid pathnames, however, 70the system root directory 71.Ql / , 72has no parent and dot-dot points to itself like dot. 73.Pp 74File system nodes are ordinary directory files on which has |
75been grafted a file system object, such as a physical disk or a |
76partitioned area of such a disk. 77(See 78.Xr mount 2 79and 80.Xr mount 8 . ) 81.Pp 82The directory entry format is defined in the file 83.Aq sys/dirent.h --- 63 unchanged lines hidden (view full) --- 147#endif /* !_SYS_DIRENT_H_ */ 148.Ed 149.Sh SEE ALSO 150.Xr fs 5 , 151.Xr inode 5 152.Sh BUGS 153The usage of the member d_type of struct dirent is unportable as it is 154.Fx Ns -specific . |
155It also may fail on certain file systems, for example the cd9660 file system. |
156.Sh HISTORY 157A 158.Nm 159file format appeared in 160.At v7 . |