NAME

       TSTextLogObjectCreate - traffic Server text logging API

SYNOPSIS

          #include <ts/ts.h>

       TSReturnCode   TSTextLogObjectCreate(const   char  *filename,  int  mode,  TSTextLogObject
       *new_log_obj)

       TSReturnCode TSTextLogObjectWrite(TSTextLogObject the_object, const char *format, ...)

       void TSTextLogObjectFlush(TSTextLogObject the_object)

       TSReturnCode TSTextLogObjectDestroy(TSTextLogObject the_object)

       void TSTextLogObjectHeaderSet(TSTextLogObject the_object, const char *header)

       TSReturnCode     TSTextLogObjectRollingEnabledSet(TSTextLogObject     the_object,      int
       rolling_enabled)

       void       TSTextLogObjectRollingIntervalSecSet(TSTextLogObject       the_object,      int
       rolling_interval_sec)

       void TSTextLogObjectRollingOffsetHrSet(TSTextLogObject the_object, int rolling_offset_hr)

       void TSTextLogObjectRollingSizeMbSet(TSTextLogObject the_object, int rolling_size_mb)

DESCRIPTION

       TSTextLogObjectRollingEnabledSet() sets the log rolling mode for the  given  object.  This
       API  must  be  used  once  the  object  is  created  and  before  writing  into  logs. The
       rolling_enabled argument must  be  a  valid  proxy.config.log.rolling_enabled  values.  If
       TSTextLogObjectRollingEnabledSet()  is never called, the log object takes it's log rolling
       mode from the global proxy.config.log.rolling_enabled setting.

       It's also important to call TSTextLogObjectRollingEnabledSet() before  any  of  the  other
       APIs  that  modifies  the  rolling  object. This is due to the fact that this API dictates
       which rolling mode should be used, and therefore  affects  further  modifications  of  the
       logging object.

SEE ALSO

       TSAPI(3ts)

COPYRIGHT

       2023, dev@trafficserver.apache.org