LTTNG-GEN-TP(1)                  LTTng Manual                  LTTNG-GEN-TP(1)

نام (NAME)
       lttng-gen-tp - تولید کدهای C و فایل‌های سرآیند نقاط ردیابی LTTng-UST

خلاصه دستور (SYNOPSIS)
       lttng-gen-tp [--verbose] [--output=FILE.c]
                    [--output=FILE.h] [--output=FILE.o] TEMPLATE

توضیحات (DESCRIPTION)
       ابزار lttng-gen-tp فرآیند تولید فایل‌های ارائه‌دهنده نقطه ردیابی
       (tracepoint provider) در LTTng-UST را ساده می‌کند. این ابزار یک فایل
       الگوی ساده (TEMPLATE) را دریافت کرده و کد C لازم برای استفاده از نقاط
       ردیابی تعریف‌شده در برنامه شما را تولید می‌کند. برای اطلاعات بیشتر درباره
       ساختار TEMPLATE، بخش فرمت فایل الگو در زیر را ببینید.

       در حال حاضر، lttng-gen-tp می‌تواند فایل‌های .h، .c و .o مرتبط با
       ارائه‌دهنده نقطه ردیابی شما را تولید کند. فایل .h تولیدشده را می‌توان
       مستقیماً در برنامه ضمیمه کرد. شما می‌توانید اجازه دهید lttng-gen-tp فایل
       .o را تولید کند یا خودتان فایل .c را کامپایل نمایید. برای اطلاعات بیشتر
       در خصوص کامپایل ارائه‌دهندگان نقاط ردیابی LTTng-UST، به lttng-ust(3)
       مراجعه کنید.

       به‌طور پیش‌فرض، lttng-gen-tp فایل‌های .h، .c و .o را تولید می‌کند که نام
       پایه (basename) آن‌ها همان نام پایه TEMPLATE است. با استفاده از گزینه
       --output می‌توانید یک یا چند نوع فایل خاص را تولید کنید؛ در صورت نیاز
       این گزینه می‌تواند تکرار شود.

   فرمت فایل الگو (Template file format)
       فایل الگو که معمولاً دارای پسوند .tp است، شامل فهرستی از تعاریف
       LTTNG_UST_TRACEPOINT_EVENT() و سایر ورودی‌های تعریف اختیاری مانند
       LTTNG_UST_TRACEPOINT_LOGLEVEL() است. برای فهرست کامل تعاریف موجود، به
       lttng-ust(3) مراجعه کنید.

       تعاریف LTTNG_UST_TRACEPOINT_EVENT() به همان صورتی نوشته می‌شوند که در یک
       فایل سرآیند ارائه‌دهنده الگوی LTTng-UST می‌نویسید. کامنت‌های زبان C (/* */
       و //) و همچنین خطوطی که با # آغاز می‌شوند پشتیبانی می‌گردند.

           نکته

           نام ارائه‌دهنده (اولین آرگومان LTTNG_UST_TRACEPOINT_EVENT()) باید در
           تمامی ماکروهای LTTNG_UST_TRACEPOINT_EVENT() موجود در TEMPLATE یکسان
           باشد.

       در اینجا یک مثال آمده است:

           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)
               )
           )

گزینه‌ها (OPTIONS)
       -o, --output=FILE
           عدم تولید فایل‌های پیش‌فرض: تولید FILE.

           پسوند FILE تعیین می‌کند چه فایلی از میان .h، .c و .o تولید شود. از
           این گزینه می‌توان بیش از یک بار برای تولید انواع مختلف فایل استفاده
           کرد.

       -v, --verbose
           افزایش سطح جزئیات خروجی.

       -h, --help
           نمایش راهنمای دستور.

متغیرهای محیطی (ENVIRONMENT VARIABLES)
       CC
           کامپایلر C مورد استفاده. پیش‌فرض: cc، سپس در صورت پیدا نشدن cc از
           gcc استفاده می‌شود. این گزینه تنها هنگام تولید فایل .o کاربرد دارد.

       CFLAGS
           فلگ‌ها و گزینه‌هایی که مستقیماً به کامپایلر ($CC) ارسال می‌شوند. این
           گزینه تنها هنگام تولید فایل .o کاربرد دارد.

وضعیت خروج (EXIT STATUS)
       0
           موفقیت

       Non-zero
           خطا

اشکالات (BUGS)
       در صورت مواجهه با هرگونه اشکال یا مشکل کاربری، لطفاً آن را در سامانه
       ردیابی اشکالات LTTng به نشانی <https://bugs.lttng.org/projects/lttng-
       ust> گزارش دهید.

منابع (RESOURCES)
       •   وب‌سایت پروژه LTTng: <http://lttng.org>

       •   مستندات LTTng: <http://lttng.org/docs>

       •   مخازن گیت: <http://git.lttng.org>

       •   سازمان گیت‌هاب: <http://github.com/lttng>

       •   یکپارچه‌سازی مداوم (CI): <http://ci.lttng.org>

       •   فهرست پستی <http://lists.lttng.org> برای پشتیبانی و توسعه: lttng-
           dev@lists.lttng.org

       •   کانال IRC به نشانی <irc://irc.oftc.net/lttng>: #lttng روی
           irc.oftc.net

حق نشر (COPYRIGHTS)
       ابزار lttng-gen-tp بخشی از پروژه LTTng-UST است.

       ابزار lttng-gen-tp تحت مجوز عمومی همگانی گنو، نسخه ۲ (GNU General
       Public License, version 2) توزیع شده است
       <http://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html>. برای جزئیات
       بیشتر پرونده COPYING به نشانی <https://github.com/lttng/lttng-
       ust/blob/v2.16/COPYING> را ببینید.

نویسنده (AUTHOR)
       ابزار lttng-gen-tp در ابتدا توسط Yannick Brosseau
       <mailto:yannick.brosseau@gmail.com> نوشته شد. در حال حاضر توسط Mathieu
       Desnoyers <mailto:mathieu.desnoyers@efficios.com> نگهداری می‌شود.

همچنین ببینید (SEE ALSO)
       lttng-ust(3)

LTTng 2.16.0                      08/27/2026                   LTTNG-GEN-TP(1)