Return to dirent.4 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / contrib / isode-beta / dirent

Annotation of 43BSDReno/contrib/isode-beta/dirent/dirent.4, revision 1.1.1.1

1.1       root        1: .TH DIRENT 4 "Standard Extension"
                      2: .SH NAME
                      3: dirent \- file system independent directory entry
                      4: .SH SYNOPSIS
                      5: .B "#include <sys/types.h>"
                      6: .br
                      7: .B "#include <isode/sys.dirent.h>"
                      8: .SH DESCRIPTION
                      9: Different file system types
                     10: may have different directory entries.
                     11: The
                     12: .I dirent
                     13: structure defines a
                     14: file system independent directory entry,
                     15: which contains information common to
                     16: directory entries in different file system types.
                     17: A set of these structures is returned by the
                     18: .IR getdents (2)
                     19: system call.
                     20: .P
                     21: The
                     22: .I dirent
                     23: structure is defined below.
                     24: .sp
                     25: struct dirent  {
                     26: .br
                     27:                        long                    d_ino;
                     28: .br
                     29:                        off_t                   d_off;
                     30: .br
                     31:                        unsigned short          d_reclen;
                     32: .br
                     33:                        char                    d_name[1];
                     34: .br
                     35:                };
                     36: .P
                     37: .sp
                     38: The field
                     39: .I d_ino
                     40: is a number which is unique
                     41: for each file in the file system.
                     42: The field
                     43: .I d_off\^
                     44: represents an offset of that directory entry
                     45: in the actual file system directory.
                     46: The field
                     47: .I d_name
                     48: is the beginning of the character array
                     49: giving the name of the directory entry.
                     50: This name is null terminated
                     51: and may have at most
                     52: .SM NAME_MAX
                     53: characters in addition to the null terminator.
                     54: This results in file system independent directory entries
                     55: being variable-length entities.
                     56: The value of
                     57: .I d_reclen
                     58: is the record length of this entry.
                     59: This length is defined to be the number of bytes
                     60: between the beginning of the current entry and the next one,
                     61: adjusted so that the next entry
                     62: will start on a long boundary.
                     63: .SH FILES
                     64: \*(IDsys.dirent.h
                     65: .SH "SEE ALSO"
                     66: getdents(2).
                     67: .SH WARNING
                     68: The field
                     69: .I d_off\^
                     70: does not have a simple interpretation
                     71: for some file system types
                     72: and should not be used directly by applications.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.