Chapter
8
Directories
An application stores information in a file system by creating a file or appending new
information to an existing file. At a later time, this information may be retrieved by reading
the file. However, if a certain file must be found, or all files may be listed, the application
can iterate through the entries in a directory using the directory access (or simply
directory) functions . The available directory functions are listed in Table 6-1.
A separate set of directory operations (or entry) functions manage the files and
directories available on the system. Using these functions, the application can create, delete
and rename directories, and get and set a directory’s attributes and date/time. More
information about the entry functions can be found in section 7-2 “Entry Access Functions”
on page 103.
The entry functions and the directory Open() function accept one or more full directory
paths. For information about using file and path names, see section 4-3 “μC/FS File and
Directory Names and Paths” on page 62.
The functions listed in Table 8-1 are core functions in the directory access module
( FSDir_####() functions). These are matched by API level functions that correspond to
standard C or POSIX functions. More information about the API-level functions can be
found in Chapter 6, “POSIX API” on page 83. The core and API functions provide basically
the same functionality; the benefits of the former are enhanced capabilities, a consistent
interface and meaningful return error codes.
107