ref: df03eca7e7cbfadf1cf8c8c5a94390eaa5013a8b
dir: /module/readdir.m/
Readdir: module
{
PATH: con "/dis/lib/readdir.dis";
# sortkey is one of NAME, ATIME, MTIME, SIZE, or NONE
# possibly with DESCENDING or'd in
NAME, ATIME, MTIME, SIZE, NONE: con iota;
DESCENDING: con (1<<5);
init: fn(path: string, sortkey: int): (array of ref Sys->Dir, int);
readall: fn(fd: ref Sys->FD, sortkey: int): (array of ref Sys->Dir, int);
sortdir:fn(a: array of ref Sys->Dir, key: int): (array of ref Sys->Dir, int);
# COMPACT can be or'd into sortkey to preserve only the first
# (by depth) of a group of duplicate names in a union
COMPACT: con (1<<4);
};