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

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

lttng-gen-tp [--verbose] [--output=FILE.c]
             [--output=FILE.h] [--output=FILE.o] TEMPLATE

ابزار 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 می‌توانید یک یا چند نوع فایل خاص را تولید کنید؛ در صورت نیاز این گزینه می‌تواند تکرار شود.

فایل الگو که معمولاً دارای پسوند .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)
    )
)

-o, --output=FILE

عدم تولید فایل‌های پیش‌فرض: تولید FILE.

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

-v, --verbose

افزایش سطح جزئیات خروجی.

-h, --help

نمایش راهنمای دستور.

CC

کامپایلر C مورد استفاده. پیش‌فرض: cc، سپس در صورت پیدا نشدن cc از gcc استفاده می‌شود. این گزینه تنها هنگام تولید فایل .o کاربرد دارد.

CFLAGS

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

0

موفقیت

Non-zero

خطا

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

•وب‌سایت پروژه 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

ابزار 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 را ببینید.

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

lttng-ust(3)

08/27/2026 LTTng 2.16.0