.\" -*-nroff-*- .\" Copyright (c) 2012, 2013, 2014 Petr Machata, Red Hat Inc. .\" Copyright (c) 1997-2005 Juan Cespedes .\" .\" This program is free software; you can redistribute it and/or .\" modify it under the terms of the GNU General Public License as .\" published by the Free Software Foundation; either version 2 of the .\" License, or (at your option) any later version. .\" .\" This program is distributed in the hope that it will be useful, but .\" WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU .\" General Public License for more details. .\" .\" You should have received a copy of the GNU General Public License .\" along with this program; if not, write to the Free Software .\" Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA .\" 02110-1301 USA .\" .TH LTRACE "1" "January 2013" "" "دستورات کاربری" .SH "نام (NAME)" ltrace \- ردیاب فراخوانی‌های کتابخانه .SH "خلاصه دستور (SYNOPSIS)" .\" .\" --------------------------------------------------------------------------- .\" .PP .B ltrace .\" .\" What events to trace: .\" [\-e \fIfilter\fR|\-L] [\-l|\-\-library=\fIlibrary_pattern\fR] [\-x \fIfilter\fR] [\-S] [\-b|\-\-no-signals] .\" .\" What to display with each event: .\" [\-i] [\-w|\-\-where=\fInr\fR] [\-r|\-t|\-tt|\-ttt] [\-T] .\" .\" Output formatting: .\" [[\-F|\-\-config] \fIpathlist\fR] [\-A \fImaxelts\fR] [\-s \fIstrsize\fR] [\-C|\-\-demangle] [\-a|\-\-align \fIcolumn\fR] [\-n|\-\-indent \fInr\fR] [\-o|\-\-output \fIfilename\fR] .\" .\" Various: .\" [\-D|\-\-debug \fImask\fR] [\-u \fIusername\fR] .\" .\" What processes to trace: .\" [\-f] [\-p \fIpid\fR] [[\-\-] \fIcommand [arg ...]\fR] .\" .\" --------------------------------------------------------------------------- .\" .PP .BR ltrace " \-c" .\" .\" What events to trace: .\" [\-e \fIfilter\fR|\-L] [\-l|\-\-library=\fIlibrary_pattern\fR] [\-x \fIfilter\fR] [\-S] .\" .\" Output formatting: .\" [\-o|\-\-output \fIfilename\fR] .\" .\" What processes to trace: .\" [\-f] [\-p \fIpid\fR] [[\-\-] \fIcommand [arg ...]\fR] .\" .\" --------------------------------------------------------------------------- .\" .PP .BR ltrace " \-V|\-\-version" .PP .BR ltrace " \-h|\-\-help" .SH "توضیحات (DESCRIPTION)" برنامه .B ltrace دستور مشخص‌شده .RI ( command ) را تا زمان پایان یافتن آن اجرا می‌کند. این برنامه فراخوانی‌های کتابخانه‌های پویا را که توسط فرآیندِ در حال اجرا فراخوانده می‌شوند و همچنین سیگنال‌هایی را که آن فرآیند دریافت می‌کند، رهگیری و ثبت می‌نماید. همچنین می‌تواند فراخوانی‌های سیستمی (system calls) اجرا شده توسط برنامه را رهگیری و چاپ کند. .PP کاربرد آن بسیار شبیه به .BR strace (1) است. .PP دستور .B ltrace پارامترهای توابع فراخوانی‌شده و فراخوانی‌های سیستمی را نمایش می‌دهد. برای تعیین اینکه هر تابع چه آرگومان‌هایی دارد، به اعلان‌های خارجی پیش‌نمونه‌های تابع (function prototypes) نیاز دارد. این اعلان‌ها در فایل‌هایی موسوم به .I کتابخانه‌های پیش‌نمونه (prototype libraries) ذخیره می‌شوند؛ برای جزئیات نحو ساختاری این فایل‌ها، .BR ltrace.conf (5) را ببینید. همچنین برای آگاهی از نحوه یافتن کتابخانه‌های پیش‌نمونه توسط .BR ltrace ، بخش .B "کشف کتابخانه پیش‌نمونه (PROTOTYPE LIBRARY DISCOVERY)" را مطالعه کنید. .SH "گزینه‌ها (OPTIONS)" .PP .IP "\-a, \-\-align \fIcolumn\fR" تراز کردن مقادیر بازگشتی در یک ستون .RI ( column ) مشخص (ستون پیش‌فرض ۵/۸ پهنای صفحه نمایش است). .IP "\-A \fImaxelts\fR" حداکثر تعداد عناصر آرایه برای چاپ پیش از خلاصه کردن باقی موارد با سه‌نقطه ("..."). این گزینه همچنین تعداد بسط‌های بازگشتی ساختار را محدود می‌کند. .IP "\-b, \-\-no-signals" غیرفعال کردن چاپ سیگنال‌های دریافتی توسط فرآیندِ در حال ردیابی. .IP \-c شمارش زمان صرف‌شده و تعداد فراخوانی‌ها برای هر فراخوانی کتابخانه و ارائه گزارشی خلاصه هنگام خروج برنامه. .IP "\-C, \-\-demangle" رمزگشایی (demangle) نام‌های نماد سطح پایین به نام‌های سطح کاربر. این گزینه علاوه بر حذف پیشوند زیرخط (underscore) اولیه که توسط سیستم استفاده می‌شود، نام توابع C++ را خوانا می‌سازد. .IP "\-D, \-\-debug \fImask\fR" نمایش خروجی اشکال‌زدایی خود .BR ltrace . مقدار .I mask عددی است که مشخص می‌کند کدام پیام‌های اشکال‌زدایی باید نمایش داده شوند. از گزینه .B \-Dh برای مشاهده گزینه‌های قابل استفاده بهره بگیرید، اما توجه داشته باشید که در حال حاضر تنها ماسک اشکال‌زدایی قابل اعتماد ۷۷ است که تمام پیام‌های اشکال‌زدایی را نشان می‌دهد. .IP "\-e \fIfilter\fR" یک عبارت شرطی که مشخص می‌کند کدام فراخوانی‌های کتابخانه (یعنی فراخوانی‌های انجام‌شده از طریق اسلات‌های PLT، که معمولاً فراخوانی از باینری اصلی به یک کتابخانه یا فراخوانی‌های بین‌کتابخانه‌ای هستند) ردیابی شوند. مثال‌های کاربرد و شرح نحو دستوری در بخش‌های .B "مشخصات فیلتر (FILTER SPECIFICATIONS)" و .B "عبارت‌های فیلتر (FILTER EXPRESSIONS)" در ادامه آمده است. اگر بیش از یک گزینه .B \-e در خط فرمان مشخص شود، فراخوانی‌های کتابخانه‌ای که با هر یک از آن‌ها تطابق داشته باشند ردیابی می‌شوند. اگر هیچ گزینه .B \-e مشخص نشود، .B @MAIN به عنوان پیش‌فرض در نظر گرفته می‌شود. .IP \-f ردیابی فرآیندهای فرزند هنگام ایجاد شدن توسط فرآیندهای در حال ردیابی فعلی در نتیجه فراخوانی‌های سیستمی .BR fork (2) یا .BR clone (2) . فرآیند جدید بلافاصله متصل می‌شود. .IP "\-F, \-\-config \fIpathlist\fR" شامل فهرستی از مسیرها که با دونقطه (:) از هم جدا شده‌اند. اگر مسیری به یک دایرکتوری اشاره کند، آن دایرکتوری هنگام جستجوی کتابخانه‌های پیش‌نمونه در نظر گرفته می‌شود (بخش .B "کشف کتابخانه پیش‌نمونه (PROTOTYPE LIBRARY DISCOVERY)" را ببینید). اگر به یک فایل اشاره کند، آن فایل به‌طور ضمنی در تمام کتابخانه‌های پیش‌نمونه بارگذاری‌شده وارد (import) می‌شود. .IP "\-h, \-\-help" نمایش خلاصه‌ای از گزینه‌های ltrace و خروج. .IP \-i چاپ اشاره‌گر دستورالعمل (instruction pointer) در لحظه فراخوانی کتابخانه. .IP "\-l, \-\-library \fIlibrary_pattern\fR" نمایش تنها فراخوانی‌های توابعی که توسط کتابخانه‌های منطبق با .I library_pattern پیاده‌سازی شده‌اند. این رفتار مشابه آن است که برای هر نمادِ پیاده‌سازی‌شده در کتابخانه مشخص‌شده توسط .I library_pattern یک گزینه .B \-e تعیین کرده باشید. با تکرار چندباره این گزینه می‌توان الگوهای کتابخانه‌ای متعددی را مشخص کرد. مثال‌های کاربرد و شرح نحو دستوری library_pattern در بخش‌های .B "مشخصات فیلتر (FILTER SPECIFICATIONS)" و .B "عبارت‌های فیلتر (FILTER EXPRESSIONS)" در ادامه آمده است. .PP توجه داشته باشید اگرچه این گزینه فراخوانی‌هایی را که ممکن است به سمت کتابخانه‌های انتخاب‌شده هدایت شوند انتخاب می‌کند، اما هیچ تضمین واقعی وجود ندارد که فراخوانی به دلیل مواردی چون LD_PRELOAD یا ترتیب وابستگی‌ها به جای دیگری هدایت نشود. اگر می‌خواهید مطمئن شوید که نمادهای موجود در کتابخانه داده‌شده واقعاً فراخوانی می‌شوند، به جای آن از .BI "\-x @" library_pattern استفاده کنید. .IP \-L هنگامی که هیچ گزینه .B \-e مشخص نشده باشد، عملکرد پیش‌فرض .B @MAIN را در نظر نگیر. در عمل این بدان معناست که فراخوانی‌های کتابخانه ردیابی نخواهند شد. .IP "\-n, \-\-indent \fInr\fR" دندانه‌گذاری خروجی ردیابی به اندازه .I nr فاصله (space) برای هر سطح از تودرتویی فراخوانی‌ها. استفاده از این گزینه، دنبال کردن جریان بصری اجرای برنامه را آسان‌تر می‌کند. این گزینه همچنین توابعی را که هرگز برنمی‌گردند (مانند توابع سرویس برای پرتاب استثناها در محیط زمان اجرای C++)، بدون فایده دندانه‌دار می‌کند. .IP "\-o, \-\-output \fIfilename\fR" نوشتن خروجی ردیابی در فایل .I filename به جای خروجی استاندارد خطا (stderr). .IP "\-p \fIpid\fR" متصل شدن به فرآیندی با شناسه .I pid و آغاز ردیابی. این گزینه را می‌توان همراه با تعیین یک دستور برای اجرا نیز به کار برد. امکان اتصال به چند فرآیند با مشخص کردن بیش از یک گزینه .B \-p وجود دارد. .IP \-r چاپ برچسب زمانی نسبی همراه با هر خط از خروجی ردیابی. این گزینه اختلاف زمانی بین آغاز خطوط متوالی را ثبت می‌کند. .IP "\-s \fIstrsize\fR" تعیین حداکثر اندازه رشته برای چاپ (پیش‌فرض ۳۲ است). .IP \-S نمایش فراخوانی‌های سیستمی و همچنین فراخوانی‌های کتابخانه. .IP \-t افزودن زمان روز به ابتدای هر خط از ردیابی. .IP \-tt اگر دو بار مشخص شود، زمان چاپ‌شده شامل میکروثانیه نیز خواهد بود. .IP \-ttt اگر سه بار مشخص شود، زمان چاپ‌شده شامل میکروثانیه خواهد بود و بخش ابتدایی به عنوان تعداد ثانیه‌های سپری‌شده از مبدأ زمانی (epoch) چاپ می‌شود. .IP \-T نمایش زمان صرف‌شده درون هر فراخوانی. این گزینه اختلاف زمانی بین آغاز و پایان هر فراخوانی را ثبت می‌کند. .IP "\-u \fIusername\fR" اجرای دستور با شناسه کاربری (userid)، شناسه گروهی (groupid) و گروه‌های تکمیلیِ .IR username . این گزینه تنها هنگام اجرا به عنوان کاربر ریشه (root) سودمند است و اجرای صحیح باینری‌های setuid و/یا setgid را ممکن می‌سازد. .IP "\-w, \-\-where \fInr\fR" نمایش ردگیری پشته (backtrace) به اندازه .I nr فریم پشته برای هر تابع ردیابی‌شده. این گزینه تنها در صورتی فعال است که پشتیبانی از elfutils یا libunwind در زمان کامپایل فعال شده باشد. .IP "\-x \fIfilter\fR" یک عبارت شرطی که مشخص می‌کند کدام نقاط ورودی جدول نمادها ردیابی شوند (این موارد معمولاً فراخوانی‌های درون یک کتابخانه یا باینری اصلی هستند، هرچند فراخوانی‌های PLT که توسط \-e ردیابی می‌شوند نیز روی نقاط ورودی فرود می‌آیند). مثال‌های کاربرد و شرح نحو دستوری در بخش‌های .B "مشخصات فیلتر (FILTER SPECIFICATIONS)" و .B "عبارت‌های فیلتر (FILTER EXPRESSIONS)" در ادامه آمده است. اگر بیش از یک گزینه .B \-x در خط فرمان مشخص شود، نمادهایی که با هر یک از آن‌ها تطابق داشته باشند ردیابی می‌شوند. در صورت عدم تعیین .B \-x هیچ نقطه ورودی ردیابی نمی‌شود. .IP "\-V, \-\-version" نمایش شماره نگارش ltrace و خروج. .SH "مشخصات فیلتر (FILTER SPECIFICATIONS)" فیلترها با گزینه‌های .BR \-l ، .B \-e و .B \-x تعیین می‌شوند. به طور خلاصه معنای آن‌ها عبارت است از: .IP "\fB\-x\fR یعنی «به من نشان بده چه چیزی این نمادها را فراخوانی می‌کند (شامل فراخوانی‌های محلی)»" .IP "\fB\-e\fR یعنی «به من نشان بده چه چیزی این نمادها را فراخوانی می‌کند (تنها فراخوانی‌های بین‌کتابخانه‌ای)»" .IP "\fB\-l\fR یعنی «به من نشان بده چه چیزی به درون این کتابخانه فراخوانی انجام می‌دهد»" .PP .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. فرض کنید کتابخانه‌ای با این سرآیند .B tstlib.h تعریف شده است: .PP .Vb 6 \& void func_f_lib(void); \& void func_g_lib(void); .Ve .PP و این پیاده‌سازی .B tstlib.c را دارد: .PP .Vb 6 \& #include "tstlib.h" \& void func_f_lib(void) \& { \& func_g_lib(); \& } \& void func_g_lib(void) \& { \& } .Ve .PP فرض کنید یک فایل اجرایی داریم که از این کتابخانه استفاده می‌کند و در .B tst.c به این صورت تعریف شده است: .PP .Vb 6 \& #include "tstlib.h" \& void func_f_main(void) \& { \& } \& void main(void) \& { \& func_f_main(); \& func_f_lib(); \& } .Ve .PP در صورت پیوند دادن (link) بدون گزینه .BR \-Bsymbolic ، فراخوانی داخلی .B func_g_lib() مانند فراخوانی‌های خارجی از PLT استفاده می‌کند و در نتیجه ltrace این خروجی را تولید می‌کند: .PP .Vb 6 \& \fB$ ltrace -x 'func*' -L ./tst\fR \& func_f_main() = \& func_f_lib@tstlib.so( \& func_g_lib@tstlib.so() = \& <... func_f_lib resumed> ) = \& +++ exited (status 163) +++ .Ve .Vb 6 \& \fB$ ltrace -e 'func*' ./tst\fR \& tst->func_f_lib( \& tstlib.so->func_g_lib() = \& <... func_f_lib resumed> ) = \& +++ exited (status 163) +++ .Ve .Vb 6 \& \fB$ ltrace -l tstlib.so ./tst\fR \& tst->func_f_lib( \& tstlib.so->func_g_lib() = \& <... func_f_lib resumed> ) = \& +++ exited (status 163) +++ .Ve .PP در مقابل، اگر با .B \-Bsymbolic پیوند داده شود، فراخوانی داخلی .B func_g_lib() جدول PLT را دور می‌زند و ltrace خروجی زیر را خواهد داد: .PP .Vb 6 \& \fB$ ltrace -x 'func*' -L ./tst\fR \& func_f_main() = \& func_f_lib@tstlib.so( \& func_g_lib@tstlib.so() = \& <... func_f_lib resumed> ) = \& +++ exited (status 163) +++ .Ve .Vb 6 \& \fB$ ltrace -e 'func*' ./tst\fR \& tst->func_f_lib() = \& +++ exited (status 163) +++ .Ve .Vb 6 \& \fB$ ltrace -l tstlib.so ./tst\fR \& tst->func_f_lib() = \& +++ exited (status 163) +++ .Ve .PP .SH "عبارت‌های فیلتر (FILTER EXPRESSIONS)" عبارت فیلتر زنجیره‌ای از قواعد مبتنی بر glob یا عبارات باقاعده (regexp) است که برای گزینش نمادها جهت ردیابی از کتابخانه‌های مورد استفاده فرآیند به کار می‌رود. بخش عمده آن شهودی است، بنابراین به عنوان مثال، عبارت زیر فراخوانی‌های malloc و free را ردیابی می‌کند، به جز مواردی که توسط libc انجام می‌شوند: .PP .nf -e malloc+free-@libc.so* .fi .PP این عبارت این‌گونه خوانده می‌شود: malloc و free را ردیابی کن، اما هر آنچه را که از libc می‌آید ردیابی نکن. به صورت نیمه‌رسمی، نحو دستوری مثال بالا تقریباً به این شکل است: .PP .nf {[+-][\fIsymbol_pattern\fR][@\fIlibrary_pattern\fR]} .fi .PP الگوی .I symbol_pattern برای تطبیق با نام نمادها و .I library_pattern برای تطبیق با نام‌های SONAME کتابخانه استفاده می‌شود. هر دوی این‌ها به طور ضمنی الگوهای glob هستند، اما می‌توانند عبارات باقاعده نیز باشند (در ادامه ببینید). نحو glob از نویسه‌های ویژه .B * و .B ? و کلاس‌های نویسه‌ای، مشابه آنچه که globهای پایه‌ای bash پشتیبانی می‌کنند، پشتیبانی می‌نماید. نویسه‌های .B ^ و .B $ به ترتیب برای نشان دادن آغاز و پایان نام داده‌شده شناخته می‌شوند. .PP هر دو الگوی .I symbol_pattern و .I library_pattern باید با کل نام مطابقت داشته باشند. اگر می‌خواهید تنها با بخشی از نام تطبیق داده شود، آن را بر حسب نیاز با یک یا دو علامت * احاطه کنید. استثنا در صورتی است که الگو اصلاً ذکر نشده باشد؛ در این حالت فرض می‌شود که الگوی متناظر .B * بوده است (بنابراین .B malloc در واقع همان .B malloc@* است و .B @libc.* در واقع همان .BR *@libc.* می‌باشد). .PP در کتابخانه‌هایی که SONAME مشخصی ندارند، نام پایه (basename) به عنوان SONAME در نظر گرفته می‌شود. این موضوع برای باینری اصلی برنامه نیز صدق می‌کند: .B /bin/echo دارای SONAME ضمنی .B echo است. علاوه بر این، الگوی کتابخانه‌ای خاص .B MAIN همواره با نمادهای باینری اصلی مطابقت دارد و هرگز با کتابخانه‌ای با SONAME واقعی .B MAIN تطبیق داده نمی‌شود (برای این منظور می‌توانید از .B ^MAIN یا .B [M]AIN استفاده کنید). .PP اگر الگوی نماد یا کتابخانه در میان اسلش قرار گیرد (/مانند این/)، به جای آن به عنوان یک عبارت باقاعده (regular expression) در نظر گرفته می‌شود. به عنوان یک حالت اختصاری، به جای نوشتن .BR /x/@/y/ ، می‌توانید .B /x@y/ را بنویسید. .PP اگر الگوی کتابخانه با اسلش آغاز شود، یک عبارت SONAME نیست، بلکه یک عبارت مسیر (path) است و با نام مسیر کتابخانه مطابقت داده می‌شود. .PP قاعده نخست ممکن است بدون علامت باشد که در این صورت علامت .B + فرض می‌شود. از سوی دیگر، اگر قاعده نخست دارای علامت .B \- باشد، همانند آن است که قاعده دیگری به صورت .B @ پیش از آن وجود داشته است، که اثر آن ردیابی متممِ قاعده داده‌شده خواهد بود. .PP قواعد فوق برای ساخت مجموعه نمادهای ردیابی‌شده به کار می‌روند. هر نماد کاندید از زنجیره قواعد فوق عبور داده می‌شود. در ابتدا، نماد .IR نشانه‌گذاری‌نشده (unmarked) است. اگر با یک قاعده .B + مطابقت یابد، .IR نشانه‌گذاری‌شده (marked) می‌شود؛ اگر با یک قاعده .B \- مطابقت یابد، دوباره .IR نشانه‌گذاری‌نشده می‌گردد. اگر پس از اعمال تمام قواعد، نماد .I نشانه‌گذاری‌شده باقی بماند، ردیابی خواهد شد. .SH "کشف کتابخانه پیش‌نمونه (PROTOTYPE LIBRARY DISCOVERY)" هنگامی که یک کتابخانه در فضای آدرس فرآیندِ در حال ردیابی نگاشت (map) می‌شود، .B ltrace باید بداند پیش‌نمونه‌های (prototypes) توابعی که این کتابخانه پیاده‌سازی می‌کند چه هستند. برای اهداف .BR ltrace ، یک پیش‌نمونه در واقع چیزی فراتر از صرفاً امضای نوع (type signature) است: شامل قالب‌بندی تک‌تک پارامترها و مقدار بازگشتی نیز می‌شود. این پیش‌نمونه‌ها در فایل‌هایی موسوم به «کتابخانه‌های پیش‌نمونه» (prototype libraries) ذخیره می‌شوند. .PP پس از نگاشت کتابخانه، .B ltrace نام SONAME آن را پیدا می‌کند. سپس به دنبال فایلی به نام SONAME.conf می‌گردد؛ برای نمونه protolib برای libc.so.6 در فایلی به نام libc.so.6.conf خواهد بود. هنگامی که چنین فایلی یافت شود (توضیحات بیشتر درباره مکان‌های جستجوی این فایل‌ها توسط ltrace در ادامه آمده است)، .B ltrace تمام پیش‌نمونه‌های ذخیره‌شده در آن را می‌خواند. زمانی که به یک نقطه ورودی جدول نمادها (مانند موارد ردیابی‌شده با .BR \-x ) برخورد شود، پیش‌نمونه در کتابخانه پیش‌نمونه متناظر با همان کتابخانه‌ای که برخورد در آن رخ داده است جستجو می‌شود. هنگامی که به یک فراخوانی کتابخانه (مانند موارد ردیابی‌شده با .B \-e و .BR \-l ) برخورد شود، پیش‌نمونه در تمام کتابخانه‌های پیش‌نمونه بارگذاری‌شده برای فرآیند مربوطه جستجو می‌شود. این امر ضروری است زیرا فراخوانی کتابخانه در جدول PLT کتابخانه فراخواننده (caller) ردیابی می‌شود، اما پیش‌نمونه در کتابخانه فراخوانده‌شده (callee) توصیف شده است. .PP اگر کتابخانه‌ای فاقد SONAME باشد، نام پایه (basename) فایل کتابخانه به جای آن در نظر گرفته می‌شود. برای باینری اصلی برنامه نیز نام پایه در نظر گرفته می‌شود (برای مثال protolib برای bin/echo/ به صورت echo.conf نامیده خواهد شد). اگر نام متناظر با SONAME (مثلاً libc.so.6.conf) پیدا نشود و ماژول تحت بررسی یک کتابخانه اشتراکی باشد، .B ltrace تطابق‌های جزئی را نیز امتحان می‌کند. ltrace نقطه به نقطه پسوندها را حذف کرده و جستجو را تکرار می‌کند تا اینکه یا یک protolib پیدا شود یا تنها X.so باقی بماند. بنابراین libc.so.conf در نظر گرفته می‌شود، اما libc.conf خیر. .PP هنگام جستجو برای یک کتابخانه پیش‌نمونه، .B ltrace به چندین دایرکتوری سر می‌زند. در لینوکس، این مسیرها عبارتند از: .BR $XDG_CONFIG_HOME/ltrace ، .BR $HOME/.ltrace ، مسیر .RI X /ltrace به ازای هر .I X در .BR $XDG_CONFIG_DIRS ، و .BR /usr/share/ltrace . اگر متغیر محیطی .B XDG_CONFIG_HOME تعریف نشده باشد، .B ltrace به جای آن مسیر .B $HOME/.config/ltrace را بررسی می‌کند. .PP همچنین سازوکاری برای بارگذاری فایل‌های پیکربندی قدیمی (legacy) وجود دارد. اگر .B $HOME/.ltrace.conf وجود داشته باشد، در هر کتابخانه پیش‌نمونه بارگذاری‌شده وارد (import) می‌شود. به طور مشابه برای .BR /etc/ltrace.conf . اگر هر دو فایل موجود باشند، هر دو وارد می‌شوند و .B $HOME/.ltrace.conf پیش از .B /etc/ltrace.conf مورد مراجعه قرار می‌گیرد. .PP اگر .B \-F شامل دایرکتوری‌هایی باشد، آن دایرکتوری‌ها با اولویت نسبت به دایرکتوری‌های سیستمی فوق، و با همان ترتیبی که در .B \-F ذکر شده‌اند جستجو می‌شوند. هر فایلی که در .B \-F ارسال شود، مشابه فایل‌های پیکربندی قدیمی بالا و پیش از آن‌ها وارد می‌شود. .PP برای جزئیات درباره نحو دستوری فایل‌های کتابخانه پیش‌نمونه ltrace، به .BR ltrace.conf (5) مراجعه کنید. .SH "اشکالات (BUGS)" این برنامه بیشتر باگ‌های ذکرشده در .BR strace (1) را دارد. .LP این ابزار تنها روی لینوکس و در برخی معماری‌ها کار می‌کند. .PP اگر می‌خواهید اشکالی را گزارش دهید، پیامی به فهرست پستی (ltrace-devel@lists.alioth.debian.org) ارسال کنید، یا در صورتی که از توزیع دبیان گنو/لینوکس استفاده می‌کنید از برنامه .BR reportbug (1) بهره بگیرید. .SH "فایل‌ها (FILES)" .TP .I /etc/ltrace.conf فایل پیکربندی سیستم .TP .I ~/.ltrace.conf فایل پیکربندی شخصی؛ که بر .I /etc/ltrace.conf ارجحیت دارد. .SH "نویسندگان (AUTHORS)" Juan Cespedes .br Petr Machata .SH "همچنین ببینید (SEE ALSO)" .BR ltrace.conf (5), .BR strace (1), .BR ptrace (2)