NAME

       ixp_srv_walkandclone, ixp_srv_readdir, ixp_srv_verifyfile, IxpLookupFn

SYNOPSIS

       #include <ixp_srvutil.h>

       void ixp_srv_walkandclone(Ixp9Req *req, IxpLookupFn lookup);

       void ixp_srv_readdir(Ixp9Req *req, IxpLookupFn lookup, void (*dostat)(IxpStat *, IxpFileId *));

       bool ixp_srv_verifyfile(IxpFileId *file, IxpLookupFn lookup);

       typedef IxpFileId* (*IxpLookupFn)(IxpFileId*, char*);

DESCRIPTION

       These  convenience  functions  simplify  the writing of basic and static file servers. They use a generic
       file lookup function to simplify the process of walking, cloning, and returning directory listings. Given
       the  IxpFileId(3)  of  a  directory  and  a  filename  name  should return a new IxpFileId (allocated via
       ixp_srv_getfile(3)) for the matching directory entry, or null if there is no match. If the passed name is
       null, lookup should return a linked list of IxpFileIds, one for each child directory entry.

       ixp_srv_walkandclone handles the moderately complex process of walking from a directory entry and cloning
       fids, and calls ixp_respond(3). It should be called in response to a TWalk request.

       ixp_srv_readdir should be called to handle read requests on directories. It  prepares  a  stat  for  each
       child  of  the  directory, taking into account the requested offset, and calls ixp_respond(3). The dostat
       parameter must be a function which fills the passed IxpStat(3) pointer  based  on  the  contents  of  the
       passed IxpFileId.

       ixp_srv_verifyfile  returns  whether  a  file  still  exists  in  the  filesystem,  and should be used by
       filesystems that invalidate files once they have been deleted.

SEE ALSO

       IxpFileId(3), ixp_getfile(3), ixp_freefile(3)