pSOSystem System Calls - Read

pHILE+ System Calls verify_vol
The contents of the verify_vol_params fields are as follows:
pb_dataptr Points to a work area required by verify_vol().
The size of this work area (in bytes) is given by the
formula:
96 + (4 * vsize) + (16 * nfd) + (38 * maxdepth)
where vsize is the size of the volume in blocks; nfd is
the number of file descriptors specified when the
volume was initialized; and maxdepth is the
maximum depth of the directory tree (it should be
equal to pb_maxdepth, below.) For example, on a
volume with:
vsize = 5000 blocks
nfd = 100 entries
maxdepth = 5 levels
a total of 96 + (4 * 5000) + (16 * 100) + (38 * 5) =
21886 bytes would be required. This work area can
be statically allocated, or it can be dynamically
allocated by a pSOS+ rn_getseg() call.
pb_datalen The size (in bytes) of the work area pointed to by
pb_dataptr. The verify_vol() call uses this
entry to confirm that the work area is large enough.
pb_maxdepth The maximum depth of the volume’s directory tree. If
any branch of the directory exceeds this depth,
verify_vol() terminates and returns an error
code to the calling task. The minimum value allowed
is 1, which indicates a flat directory (i.e., one
containing no subdirectories).
pb_fdbptr Points to a fault descriptor block (FDB) in the caller's
memory area. When a fault is detected,
verify_vol() places a detailed description of the
fault into the FDB. The FDB format is described on
page 2-132.
pb_faultp Points to the user-provided faultp() procedure
that is called each time verify_vol() detects a
fault. faultp() is responsible for processing the
fault. Refer to “faultp()” on page 2-131 for more
details.
pSOSystem System Calls 2-127
2