const lrid_t &dir,
writes sets of directory entries into a caller-provided buffer.
identifies the directory object of interest.
is points to the caller's buffer.
is the size of the buffer, in bytes.
is a pointer to an integer in the caller's data area,
into which the SVAS writes the number of complete entries
that were placed in the buffer.
is a pointer to an opaque value that
the SVAS places in the caller's data area, and which
is used by the SVAS to maintain state between calls to
The caller must set the initial value of
(on the first call) to
is returned when the last entry has been returned.
there are no more entries to process when
*nresults == 0
*cookie == TerminalCookie.
A directory entry is a 5-tuple:
All entries are 8-byte aligned when placed in the caller's buffer.
Four bytes of opaque data.
A serial number, which is Shore's analog of an i-node number.
The length, in bytes, of the entry.
The length, in bytes, of the name.
A sequence of characters that constitute the name of the directory entry.
is available on
on the server and in the client library.
so it must be run in transactions.
Deadlocks can occur while locks are being acquired. See
for information about deadlocks.
A complete list of errors is in
This manual page applies to Version 1.1.1 of the Shore software.
The Shore project is sponsored by the Advanced Research Project Agency, ARPA
order number 018 (formerly 8230), monitored by the U.S. Army Research
Laboratory under contract DAAB07-91-C-Q518.
Copyright © 1994, 1995, 1996, 1997,
Computer Sciences Department, University of
Wisconsin -- Madison. All Rights Reserved.