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

       2018, dev@trafficserver.apache.org