IXP_SRV_WALKANDCLONE(3)

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, IlookupR 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 IdostatR 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)