Return to dirread.2 CVS log

Up to [Research Unix] / researchv10dc / man / adm / man2

Annotation of researchv10dc/man/adm/man2/dirread.2, revision 1.1.1.1

1.1       root        1: .TH DIRREAD 2
                      2: .CT 2 file_io dirs
                      3: .SH NAME
                      4: dirread \(mi read from directory, hiding format
                      5: .SH SYNOPSIS
                      6: .nf
                      7: .B int dirread(fildes, buffer, nbytes)
                      8: .B char *buffer;
                      9: .fi
                     10: .SH DESCRIPTION
                     11: .I Dirread
                     12: reads at most
                     13: .I nbytes
                     14: bytes of directory information
                     15: from the file pointer location
                     16: in the directory associated with
                     17: .I fildes
                     18: into memory at
                     19: .IR buffer .
                     20: The information is converted into a canonical form,
                     21: independent of the format used by the file system in which
                     22: the directory resides.
                     23: .PP
                     24: Each canonicalized entry consists of a decimal ASCII inode number,
                     25: a tab character,
                     26: a file name,
                     27: and an ASCII NUL.
                     28: .I Buffer
                     29: is filled with as many entries
                     30: as will fit;
                     31: the number of bytes used is returned.
                     32: 0 is returned when there are no more entries.
                     33: .PP
                     34: The file pointer is advanced by
                     35: the number of bytes passed over in the directory,
                     36: not the number of bytes placed in
                     37: .IR buffer .
                     38: Ask
                     39: .I lseek
                     40: for the new pointer;
                     41: don't try to compute it.
                     42: .SH "SEE ALSO"
                     43: .IR open (2),
                     44: .IR read (2),
                     45: .IR directory (3),
                     46: .IR dir (5)
                     47: .SH DIAGNOSTICS
                     48: .BR EBADF ,
                     49: .BR ENOSPC 
                     50: (buffer too small),
                     51: .BR ENOTDIR ,
                     52: .BR EFAULT ,
                     53: .B EINVAL
                     54: .SH BUGS
                     55: Not all file system types
                     56: support
                     57: .IR dirread .
                     58: The routines in
                     59: .IR directory (3)
                     60: know how to cope.
                     61: .br
                     62: Seeking in directories is dangerous,
                     63: because the contents often change under foot.

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