Return to directory.3 CVS log

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

Annotation of researchv10dc/man/adm/man3/directory.3, revision 1.1.1.1

1.1       root        1: .TH DIRECTORY 3  
                      2: .CT 2 dirs
                      3: .SH NAME
                      4: opendir, readdir, telldir, seekdir, closedir \(mi directory operations
                      5: .SH SYNOPSIS
                      6: .nf
                      7: .B #include <sys/types.h>
                      8: .B #include <ndir.h>
                      9: .PP
                     10: .B DIR *opendir(filename)
                     11: .B char *filename;
                     12: .PP
                     13: .B struct direct *readdir(dirp)
                     14: .B DIR *dirp;
                     15: .PP
                     16: .B long telldir(dirp)
                     17: .B DIR *dirp;
                     18: .PP
                     19: .B seekdir(dirp, loc)
                     20: .B DIR *dirp;
                     21: .B long loc;
                     22: .PP
                     23: .B closedir(dirp)
                     24: .B DIR *dirp;
                     25: .fi
                     26: .SH DESCRIPTION
                     27: .I Opendir
                     28: opens the directory named by
                     29: .I filename
                     30: and associates a `directory stream'
                     31: with it.
                     32: .I Opendir
                     33: returns a pointer to be used to identify the
                     34: directory stream
                     35: in subsequent operations.
                     36: The pointer value 0
                     37: is returned if
                     38: .I filename
                     39: cannot be accessed or is not a directory.
                     40: .PP
                     41: .I Readdir
                     42: returns a pointer to the next directory entry.
                     43: It returns 0
                     44: upon reaching the end of the directory or detecting
                     45: an invalid
                     46: .I seekdir
                     47: operation.
                     48: .PP
                     49: .I Telldir
                     50: returns the current location associated with the named
                     51: directory stream.
                     52: .PP
                     53: .I Seekdir
                     54: sets the position of the next
                     55: .I readdir
                     56: operation on the
                     57: directory stream.
                     58: The new position reverts to the one associated with the
                     59: directory stream
                     60: when the
                     61: .I telldir
                     62: operation was performed.
                     63: Values returned by
                     64: .I telldir
                     65: are good only for the lifetime of the 
                     66: .B DIR
                     67: pointer from
                     68: which they are derived.
                     69: .PP
                     70: .I Closedir
                     71: causes the named
                     72: directory stream
                     73: to be closed,
                     74: and the structure associated with the 
                     75: .B DIR
                     76: pointer to be freed.
                     77: .LP
                     78: .nf
                     79: .ftL
                     80: .ta \w'struct\ 'u +\w'direct\ 'u +\w'd_name[MAXNAMLEN+1];\ 'u
                     81: struct direct  {
                     82:        \fLu_long       d_ino;\fR       inode for the entry
                     83:        \fLshort        d_reclen;\fP    don't use
                     84:        \fLshort        d_namlen;\fP    equivalent to \fLstrlen(d_name)\fP
                     85:        \fLchar d_name[MAXNAMLEN+1];\fP null-terminated entry name
                     86: \fL};\fR
                     87: .fi
                     88: .PP
                     89: The preferred way to search the current directory is:
                     90: .ft L
                     91: .nf
                     92: .ta 8n +8n +8n +8n
                     93:        DIR *dirp;
                     94:        dirp = opendir(".");
                     95:        for(dp = readdir(dirp); dp != 0; dp = readdir(dir))
                     96:                if(strcmp(dp->d_name, name) == 0)
                     97:                        break;
                     98:        closedir(dirp);
                     99:        /* found name if dp != 0 */
                    100: .fi
                    101: .ft P
                    102: .SH "SEE ALSO"
                    103: .IR dir (5),
                    104: .IR open (2),
                    105: .IR dirread (2),
                    106: .IR read (2),
                    107: .IR lseek (2),
                    108: .IR ftw (3)
                    109: .SH BUGS
                    110: The return values point to static data whose content is overwritten by each call.

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