.TH DIR 5 
.SH NAME
dir \- format of directories
.SH SYNOPSIS
.B #include <sys/types.h>
.br
.B #include <sys/dir.h>
.SH DESCRIPTION
A directory
behaves exactly like an ordinary file, save that no
user may write into a directory.
The fact that a file is a directory is indicated by
a bit in the flag word of its i-node entry
see,
.IR filsys (5).
The structure of a directory entry as given in the
include file is:
.RS
.ta 8n +10n
.PP
.nf
.so /usr/include/sys/dir.h
.fi
.RE
.PP
By convention, the first two entries in each directory
are for `\fB.\fR' and `\fB..\fR'.  The first is an entry for the
directory itself.  The second is for the parent
directory.
The meaning of `\fB..\fR' is modified for the root directory
of the master file system and for the root directories of removable
file systems.
In the first case, there is no parent, and in the second,
the system does not permit off-device references.
Therefore in both cases `\fB..\fR' has the
same meaning as `\fB.\fR'.
.SH "SEE ALSO"
filsys(5)