>>-v_readdir--vntoken--stem--start--+--------------+-----------><
'-access_check-'
Function
v_readdir invokes
the v_readdir callable service to accept a vnode token representing
a directory and return directory entries from this directory.
Parameters
- vntoken
- A variable name that contains the vnode token for the directory
to be read.
- stem
- The name of a stem variable used to return the directory entries.
Upon return, stem.0 contains the number
of directory entries returned. stem.1 through stem.n (where n is
the number of entries returned) each contain a directory entry.
Note: Only
small directories can be read in a single call. To ensure that you
read to the end of the directory, make calls to v_readdir until no
entries are returned.
- start
- The number of the first directory entry to be returned. The numbers 0 and
1 both indicate that the read should start at the beginning of the
directory.
- access_check
- Specify a 0 for no access_check, or 1 to specify
that the system is to check the user for read access to the file.
The user is defined by the effective UID and GID. Setting the effective
GID does not affect supplemental groups. Also, there is no support
for altering the MVS™ user identity
of the task using the ACEE.
Example
In the following example, assume
that
dirtok was assigned a value earlier
in the exec:
"v_readdir dirtok dir. 0"