'\" t
.\"     Title: lttng-gen-tp
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 08/27/2026
.\"    Manual: LTTng Manual
.\"    Source: LTTng 2.16.0
.\"  Language: Persian
.\"
.TH "LTTNG\-GEN\-TP" "1" "08/27/2026" "LTTng 2\&.16\&.0" "LTTng Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
lttng-gen-tp \- تولید کدهای C و فایل‌های سرآیند نقاط ردیابی LTTng-UST
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fBlttng\-gen\-tp\fR [\fB--verbose\fR] [\fB--output\fR=\fIFILE\fR\&.c]
             [\fB--output\fR=\fIFILE\fR\&.h] [\fB--output\fR=\fIFILE\fR\&.o] \fITEMPLATE\fR
.fi
.SH "توضیحات (DESCRIPTION)"
.sp
ابزار \fBlttng-gen-tp\fR فرآیند تولید فایل‌های ارائه‌دهنده نقطه ردیابی (tracepoint provider) در LTTng\-UST را ساده می‌کند\&. این ابزار یک فایل الگوی ساده (\fITEMPLATE\fR) را دریافت کرده و کد C لازم برای استفاده از نقاط ردیابی تعریف‌شده در برنامه شما را تولید می‌کند\&. برای اطلاعات بیشتر درباره ساختار \fITEMPLATE\fR، بخش \fIفرمت فایل الگو\fR در زیر را ببینید\&.
.sp
در حال حاضر، \fBlttng-gen-tp\fR می‌تواند فایل‌های \fB.h\fR، \fB.c\fR و \fB.o\fR مرتبط با ارائه‌دهنده نقطه ردیابی شما را تولید کند\&. فایل \fB.h\fR تولیدشده را می‌توان مستقیماً در برنامه ضمیمه کرد\&. شما می‌توانید اجازه دهید \fBlttng-gen-tp\fR فایل \fB.o\fR را تولید کند یا خودتان فایل \fB.c\fR را کامپایل نمایید\&. برای اطلاعات بیشتر در خصوص کامپایل ارائه‌دهندگان نقاط ردیابی LTTng\-UST، به \fBlttng-ust\fR(3) مراجعه کنید\&.
.sp
به‌طور پیش‌فرض، \fBlttng-gen-tp\fR فایل‌های \fB.h\fR، \fB.c\fR و \fB.o\fR را تولید می‌کند که نام پایه (basename) آن‌ها همان نام پایه \fITEMPLATE\fR است\&. با استفاده از گزینه \fB--output\fR می‌توانید یک یا چند نوع فایل خاص را تولید کنید؛ در صورت نیاز این گزینه می‌تواند تکرار شود\&.
.SS "فرمت فایل الگو (Template file format)"
.sp
فایل الگو که معمولاً دارای پسوند \fB.tp\fR است، شامل فهرستی از تعاریف \fBLTTNG_UST_TRACEPOINT_EVENT()\fR و سایر ورودی‌های تعریف اختیاری مانند \fBLTTNG_UST_TRACEPOINT_LOGLEVEL()\fR است\&. برای فهرست کامل تعاریف موجود، به \fBlttng-ust\fR(3) مراجعه کنید\&.
.sp
تعاریف \fBLTTNG_UST_TRACEPOINT_EVENT()\fR به همان صورتی نوشته می‌شوند که در یک فایل سرآیند ارائه‌دهنده الگوی LTTng\-UST می‌نویسید\&. کامنت‌های زبان C (\fB/* */\fR و \fB//\fR) و همچنین خطوطی که با \fB#\fR آغاز می‌شوند پشتیبانی می‌گردند\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته\fR
.ps -1
.br
.sp
نام ارائه‌دهنده (اولین آرگومان \fBLTTNG_UST_TRACEPOINT_EVENT()\fR) باید در تمامی ماکروهای \fBLTTNG_UST_TRACEPOINT_EVENT()\fR موجود در \fITEMPLATE\fR یکسان باشد\&.
.sp .5v
.RE
.sp
در اینجا یک مثال آمده است:
.sp
.if n \{\
.RS 4
.\}
.nf
LTTNG_UST_TRACEPOINT_EVENT(
    // Tracepoint provider name
    my_provider,

    // Tracepoint/event name
    my_event,

    // Tracepoint arguments (input)
    LTTNG_UST_TP_ARGS(char *, text),

    // Tracepoint/event fields (output)
    LTTNG_UST_TP_FIELDS(
        lttng_ust_field_string(message, text)
    )
)
.fi
.if n \{\
.RE
.\}
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB-o\fR, \fB--output\fR=\fIFILE\fR
.RS 4
عدم تولید فایل‌های پیش‌فرض: تولید
\fIFILE\fR\&.
.sp
پسوند
\fIFILE\fR
تعیین می‌کند چه فایلی از میان
\fB.h\fR،
\fB.c\fR و
\fB.o\fR
تولید شود\&. از این گزینه می‌توان بیش از یک بار برای تولید انواع مختلف فایل استفاده کرد\&.
.RE
.PP
\fB-v\fR, \fB--verbose\fR
.RS 4
افزایش سطح جزئیات خروجی\&.
.RE
.PP
\fB-h\fR, \fB--help\fR
.RS 4
نمایش راهنمای دستور\&.
.RE
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.PP
\fBCC\fR
.RS 4
کامپایلر C مورد استفاده\&. پیش‌فرض:
\fBcc\fR،
سپس در صورت پیدا نشدن
\fBcc\fR
از
\fBgcc\fR
استفاده می‌شود\&. این گزینه تنها هنگام تولید فایل
\fB.o\fR
کاربرد دارد\&.
.RE
.PP
\fBCFLAGS\fR
.RS 4
فلگ‌ها و گزینه‌هایی که مستقیماً به کامپایلر (\fB$CC\fR) ارسال می‌شوند\&. این گزینه تنها هنگام تولید فایل
\fB.o\fR
کاربرد دارد\&.
.RE
.SH "وضعیت خروج (EXIT STATUS)"
.PP
\fB0\fR
.RS 4
موفقیت
.RE
.PP
\fBNon\-zero\fR
.RS 4
خطا
.RE
.SH "اشکالات (BUGS)"
.sp
در صورت مواجهه با هرگونه اشکال یا مشکل کاربری، لطفاً آن را در سامانه ردیابی اشکالات LTTng به نشانی <https://bugs.lttng.org/projects/lttng-ust> گزارش دهید\&.
.SH "منابع (RESOURCES)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
وب‌سایت پروژه LTTng: <http://lttng.org>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
مستندات LTTng: <http://lttng.org/docs>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
مخازن گیت: <http://git.lttng.org>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
سازمان گیت‌هاب: <http://github.com/lttng>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
یکپارچه‌سازی مداوم (CI): <http://ci.lttng.org>
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
فهرست پستی <http://lists.lttng.org>
برای پشتیبانی و توسعه:
\fBlttng-dev@lists.lttng.org\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
کانال IRC به نشانی <irc://irc.oftc.net/lttng>:
\fB#lttng\fR
روی
\fBirc.oftc.net\fR
.RE
.SH "حق نشر (COPYRIGHTS)"
.sp
ابزار \fBlttng-gen-tp\fR بخشی از پروژه LTTng\-UST است\&.
.sp
ابزار \fBlttng-gen-tp\fR تحت مجوز عمومی همگانی گنو، نسخه ۲ (GNU General Public License, version 2) توزیع شده است <http://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html>\&. برای جزئیات بیشتر پرونده \fBCOPYING\fR به نشانی <https://github.com/lttng/lttng-ust/blob/v2.16/COPYING> را ببینید\&.
.SH "نویسنده (AUTHOR)"
.sp
ابزار \fBlttng-gen-tp\fR در ابتدا توسط Yannick Brosseau <mailto:yannick.brosseau@gmail.com> نوشته شد\&. در حال حاضر توسط Mathieu Desnoyers <mailto:mathieu.desnoyers@efficios.com> نگهداری می‌شود\&.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBlttng-ust\fR(3)