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)

libixp Manual                                       2012 Dec                             IXP_SRV_WALKANDCLONE(3)