TSTextLogObjectCreate - traffic Server text logging API
Contents
Copyright
2025, dev@trafficserver.apache.org
9.2 May 22, 2025 TSTEXTLOGOBJECTCREATE(3ts)
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.
Name
TSTextLogObjectCreate - traffic Server text logging API
See Also
TSAPI(3ts)Synopsis
#include <ts/ts.h>
TSReturnCodeTSTextLogObjectCreate(constchar*filename,intmode,TSTextLogObject*new_log_obj)TSReturnCodeTSTextLogObjectWrite(TSTextLogObjectthe_object,constchar*format,...)voidTSTextLogObjectFlush(TSTextLogObjectthe_object)TSReturnCodeTSTextLogObjectDestroy(TSTextLogObjectthe_object)voidTSTextLogObjectHeaderSet(TSTextLogObjectthe_object,constchar*header)TSReturnCodeTSTextLogObjectRollingEnabledSet(TSTextLogObjectthe_object,introlling_enabled)voidTSTextLogObjectRollingIntervalSecSet(TSTextLogObjectthe_object,introlling_interval_sec)voidTSTextLogObjectRollingOffsetHrSet(TSTextLogObjectthe_object,introlling_offset_hr)voidTSTextLogObjectRollingSizeMbSet(TSTextLogObjectthe_object,introlling_size_mb)