.\" Man page generated from reStructuredText. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "TSTEXTLOGOBJECTCREATE" "3ts" "Jan 06, 2024" "9.2" "Apache Traffic Server" .SH NAME TSTextLogObjectCreate \- traffic Server text logging API .SH SYNOPSIS .INDENT 0.0 .INDENT 3.5 .sp .EX #include .EE .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \fI\%TSReturnCode\fP TSTextLogObjectCreate(const char *filename, int mode, \fI\%TSTextLogObject\fP *new_log_obj) .UNINDENT .INDENT 0.0 .TP .B \fI\%TSReturnCode\fP TSTextLogObjectWrite(\fI\%TSTextLogObject\fP the_object, const char *format, \&...) .UNINDENT .INDENT 0.0 .TP .B void TSTextLogObjectFlush(\fI\%TSTextLogObject\fP the_object) .UNINDENT .INDENT 0.0 .TP .B \fI\%TSReturnCode\fP TSTextLogObjectDestroy(\fI\%TSTextLogObject\fP the_object) .UNINDENT .INDENT 0.0 .TP .B void TSTextLogObjectHeaderSet(\fI\%TSTextLogObject\fP the_object, const char *header) .UNINDENT .INDENT 0.0 .TP .B \fI\%TSReturnCode\fP TSTextLogObjectRollingEnabledSet(\fI\%TSTextLogObject\fP the_object, int rolling_enabled) .UNINDENT .INDENT 0.0 .TP .B void TSTextLogObjectRollingIntervalSecSet(\fI\%TSTextLogObject\fP the_object, int rolling_interval_sec) .UNINDENT .INDENT 0.0 .TP .B void TSTextLogObjectRollingOffsetHrSet(\fI\%TSTextLogObject\fP the_object, int rolling_offset_hr) .UNINDENT .INDENT 0.0 .TP .B void TSTextLogObjectRollingSizeMbSet(\fI\%TSTextLogObject\fP the_object, int rolling_size_mb) .UNINDENT .SH DESCRIPTION .sp \fI\%TSTextLogObjectRollingEnabledSet()\fP 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 \fIrolling_enabled\fP argument must be a valid \fI\%proxy.config.log.rolling_enabled\fP values. If \fI\%TSTextLogObjectRollingEnabledSet()\fP is never called, the log object takes it\(aqs log rolling mode from the global \fI\%proxy.config.log.rolling_enabled\fP setting. .sp It\(aqs also important to call \fI\%TSTextLogObjectRollingEnabledSet()\fP 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. .SH SEE ALSO .sp \fBTSAPI(3ts)\fP .SH COPYRIGHT 2024, dev@trafficserver.apache.org .\" Generated by docutils manpage writer. .