NAME

       TSCacheWrite - TSCacheWrite API function

SYNOPSIS

          #include <ts/ts.h>

       TSAction TSCacheWrite(TSCont contp, TSCacheKey key)

DESCRIPTION

       Asks  the  Traffic Server cache if contp can start writing the object corresponding to key
       to the cache.

       If  the  object  can  be  written,  the  cache   calls   contp   back   with   the   event
       TS_EVENT_CACHE_OPEN_WRITE.   In this case, the cache also passes contp a cache vconnection
       and contp can then initiate a write operation on that vconnection using TSVConnWrite.  The
       object  is  not committed to the cache until the vconnection is closed.  When all data has
       been transferred, the user (contp) must do an TSVConnClose.  In case of  any  errors,  the
       user must do an TSVConnAbort(contp, 0).

       If   the   object   cannot  be  written,  the  cache  calls  contp  back  with  the  event
       TS_EVENT_CACHE_OPEN_WRITE_FAILED.  This can happen,  for  example,  if  there  is  another
       object  with  the same key being written to the cache.  The user (contp) has the option to
       cancel the action returned by TSCacheWrite.

       Note that reentrant calls are possible, i.e. the cache can call back the user  (contp)  in
       the same call.

COPYRIGHT

       2023, dev@trafficserver.apache.org