.\" Man page generated from reStructuredText .\" by the Docutils 0.23 manpage writer. . . .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 "LLDB" "1" "Jun 21, 2026" "22" "LLDB" .SH "نام (NAME)" lldb \- مستندات دیباگر LLDB .SH "خلاصه دستور (SYNOPSIS)" .nf \fBlldb\fP [\fIoptions\fP] \fIexecutable\fP .fi .sp .SH "توضیحات (DESCRIPTION)" .sp \fBlldb\fP یک دیباگر نسل جدید و با کارایی بالا است. این برنامه به‌صورت مجموعه‌ای از مؤلفه‌های با قابلیت استفادهٔ مجدد ساخته شده است که به‌طور گسترده از کتابخانه‌های موجود در پروژهٔ بزرگ‌تر LLVM، مانند تجزیه‌کنندهٔ عبارت Clang و دی‌اسمبلر LLVM بهره می‌برند. .sp \fBlldb\fP دیباگر پیش‌فرض در Xcode روی macOS است و از اشکال‌زدایی C،‏ Objective\-C و C++ روی رایانه‌های رومیزی، دستگاه‌های iOS و شبیه‌ساز پشتیبانی می‌کند. .sp تمام کدهای موجود در پروژهٔ LLDB تحت مجوز Apache 2.0 با استثنائات LLVM منتشر شده و در دسترس هستند. .SH "پیوست شدن (ATTACHING)" .INDENT 0.0 .TP .B \-\-attach\-name به دیباگر اعلام می‌کند تا به فرایندی با نام داده‌شده متصل شود. .UNINDENT .INDENT 0.0 .TP .B \-\-attach\-pid به دیباگر اعلام می‌کند تا به فرایندی با pid مشخص‌شده متصل شود. .UNINDENT .INDENT 0.0 .TP .B \-n نام مستعار برای \-\-attach\-name .UNINDENT .INDENT 0.0 .TP .B \-p نام مستعار برای \-\-attach\-pid .UNINDENT .INDENT 0.0 .TP .B \-\-wait\-for به دیباگر اعلام می‌کند قبل از متصل شدن، منتظر راه‌اندازی و اجرای فرایندی با pid یا نام مشخص‌شده بماند. .UNINDENT .INDENT 0.0 .TP .B \-w نام مستعار برای \-\-wait\-for .UNINDENT.SH "دستورها (COMMANDS)" .INDENT 0.0 .TP .B \-\-batch به دیباگر اعلام می‌کند دستورهای \-s، \-S، \-o و \-O را اجرا کرده و سپس خارج شود. .UNINDENT .INDENT 0.0 .TP .B \-b نام مستعار برای \-\-batch .UNINDENT .INDENT 0.0 .TP .B \-K نام مستعار برای \-\-source\-on\-crash .UNINDENT .INDENT 0.0 .TP .B \-k نام مستعار برای \-\-one\-line\-on\-crash .UNINDENT .INDENT 0.0 .TP .B \-\-local\-lldbinit به دیباگر اجازه می‌دهد فایل‌های .lldbinit موجود در دایرکتوری کاری فعلی را پردازش کند، مگر آنکه \-\-no\-lldbinit داده شده باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-no\-lldbinit هیچ فایل \(aq.lldbinit\(aq را به‌طور خودکار پردازش نکند. .UNINDENT .INDENT 0.0 .TP .B \-\-one\-line\-before\-file به دیباگر اعلام می‌کند این دستور تک‌خطی lldb را پیش از بارگذاری هر فایلی که در خط فرمان مشخص شده، اجرا کند. .UNINDENT .INDENT 0.0 .TP .B \-\-one\-line\-on\-crash در حالت دسته‌ای (batch mode)، به دیباگر اعلام می‌کند در صورت کرش کردن هدف، این دستور تک‌خطی lldb را اجرا کند. .UNINDENT .INDENT 0.0 .TP .B \-\-one\-line به دیباگر اعلام می‌کند این دستور تک‌خطی lldb را پس از بارگذاری هر فایلی که در خط فرمان مشخص شده، اجرا کند. .UNINDENT .INDENT 0.0 .TP .B \-O نام مستعار برای \-\-one\-line\-before\-file .UNINDENT .INDENT 0.0 .TP .B \-o نام مستعار برای \-\-one\-line .UNINDENT .INDENT 0.0 .TP .B \-Q نام مستعار برای \-\-source\-quietly .UNINDENT .INDENT 0.0 .TP .B \-\-source\-before\-file به دیباگر اعلام می‌کند پیش از بارگذاری هر فایلی، دستورهای lldb درون فایل داده‌شده را خوانده و اجرا کند. .UNINDENT .INDENT 0.0 .TP .B \-\-source\-on\-crash در حالت دسته‌ای، به دیباگر اعلام می‌کند در صورت کرش کردن هدف، این فایلِ حاوی دستورهای lldb را اجرا کند. .UNINDENT .INDENT 0.0 .TP .B \-\-source\-quietly به دیباگر اعلام می‌کند هنگام اجرای فایل‌ها یا دستورهای تک‌خطی ارائه‌شده در خط فرمان، دستورها را در خروجی چاپ (echo) نکند. .UNINDENT .INDENT 0.0 .TP .B \-\-source به دیباگر اعلام می‌کند پس از بارگذاری هر فایلی، دستورهای lldb درون فایل داده‌شده را خوانده و اجرا کند. .UNINDENT .INDENT 0.0 .TP .B \-S نام مستعار برای \-\-source\-before\-file .UNINDENT .INDENT 0.0 .TP .B \-s نام مستعار برای \-\-source .UNINDENT .INDENT 0.0 .TP .B \-x نام مستعار برای \-\-no\-lldbinit .UNINDENT.SH "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .B \-\-arch به دیباگر اعلام می‌کند که هنگام راه‌اندازی و اجرای برنامه از معماری مشخص‌شده استفاده کند. .UNINDENT .INDENT 0.0 .TP .B \-a نام مستعار برای \-\-arch .UNINDENT .INDENT 0.0 .TP .B \-\-capture\-path به دیباگر اعلام می‌کند که از نام فایل داده‌شده برای بازتولیدکننده (reproducer) استفاده کند. .UNINDENT .INDENT 0.0 .TP .B \-\-capture به دیباگر اعلام می‌کند که یک بازتولیدکننده (reproducer) را ضبط کند. .UNINDENT .INDENT 0.0 .TP .B \-\-core به دیباگر اعلام می‌کند که از مسیر کامل به به عنوان فایل core استفاده کند. .UNINDENT .INDENT 0.0 .TP .B \-c نام مستعار برای \-\-core .UNINDENT .INDENT 0.0 .TP .B \-\-debug به دیباگر اعلام می‌کند که اطلاعات اضافی را برای دیباگ کردن خود چاپ کند. .UNINDENT .INDENT 0.0 .TP .B \-d نام مستعار برای \-\-debug .UNINDENT .INDENT 0.0 .TP .B \-\-editor به دیباگر اعلام می‌کند که فایل‌های کد منبع را با استفاده از سازوکار \(dqویرایشگر خارجی\(dq میزبان باز کند. .UNINDENT .INDENT 0.0 .TP .B \-e نام مستعار برای \-\-editor .UNINDENT .INDENT 0.0 .TP .B \-\-file به دیباگر اعلام می‌کند که از فایل به عنوان برنامه‌ای که باید دیباگ شود استفاده کند. .UNINDENT .INDENT 0.0 .TP .B \-f نام مستعار برای \-\-file .UNINDENT .INDENT 0.0 .TP .B \-\-help اطلاعات نحوه استفاده از دیباگر LLDB را چاپ می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-h نام مستعار برای \-\-help .UNINDENT .INDENT 0.0 .TP .B \-\-no\-use\-colors از رنگ‌ها استفاده نمی‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-replay به دیباگر اعلام می‌کند که یک بازتولیدکننده (reproducer) را از بازپخش کند. .UNINDENT .INDENT 0.0 .TP .B \-\-version شماره نسخه فعلی دیباگر LLDB را چاپ می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-v نام مستعار برای \-\-version .UNINDENT .INDENT 0.0 .TP .B \-X نام مستعار برای \-\-no\-use\-color .UNINDENT.SH "محیط تعاملی (REPL)" .INDENT 0.0 .TP .B \-r= نام مستعار برای \-\-repl= .UNINDENT .INDENT 0.0 .TP .B \-\-repl\-language زبان مورد استفاده برای REPL را انتخاب می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-repl= برنامه lldb را در حالت REPL همراه با یک فرایند ساختگی (stub) با پرچم‌های مشخص‌شده اجرا می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-R نام مستعار برای \-\-repl\-language .UNINDENT .SH "اسکریپت‌نویسی (SCRIPTING)" .INDENT 0.0 .TP .B \-l نام مستعار برای \-\-script\-language .UNINDENT .INDENT 0.0 .TP .B \-\-print\-script\-interpreter\-info یک دیکشنری json حاوی اطلاعات مربوط به مفسر زبان اسکریپت‌نویسی را چاپ می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-python\-path مسیر فایل lldb.py را برای این نسخه از lldb چاپ می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-P نام مستعار برای \-\-python\-path .UNINDENT .INDENT 0.0 .TP .B \-\-script\-language به دیباگر اعلام می‌کند که از زبان اسکریپت‌نویسی مشخص‌شده برای اسکریپت‌های تعریف‌شده توسط کاربر استفاده کند. .UNINDENT .SH "مثال‌ها (EXAMPLES)" .sp دیباگر را می‌توان در چندین حالت راه‌اندازی کرد. .sp ارسال یک فایل اجرایی به عنوان یک آرگومان موضعی، lldb را برای اشکال‌زدایی فایل اجرایی داده‌شده آماده می‌کند. برای جلوگیری از ابهام میان آرگومان‌های ارسالی به lldb و آرگومان‌های ارسالی به فایل اجرایی تحت اشکال‌زدایی، آرگومان‌هایی که با \- آغاز می‌شوند باید پس از \-\- ارسال گردند. .INDENT 0.0 .INDENT 3.5 lldb \-\-arch x86_64 /path/to/program program argument \-\- \-\-arch armv7 .UNINDENT .UNINDENT .sp برای راحتی بیشتر، ارسال فایل اجرایی پس از \-\- نیز پشتیبانی می‌شود. .INDENT 0.0 .INDENT 3.5 lldb \-\-arch x86_64 \-\- /path/to/program program argument \-\-arch armv7 .UNINDENT .UNINDENT .sp ارسال یکی از گزینه‌های اتصال (attach) باعث می‌شود \fBlldb\fP بی‌درنگ به فرایند داده‌شده متصل شود. .INDENT 0.0 .INDENT 3.5 lldb \-p lldb \-n .UNINDENT .UNINDENT .sp ارسال \-\-repl برنامه \fBlldb\fP را در حالت REPL راه‌اندازی می‌کند. .INDENT 0.0 .INDENT 3.5 lldb \-r .UNINDENT .UNINDENT .sp ارسال \-\-core باعث می‌شود \fBlldb\fP فایل core را اشکال‌زدایی کند. .INDENT 0.0 .INDENT 3.5 lldb \-c /path/to/core .UNINDENT .UNINDENT .sp گزینه‌های دستوری می‌توانند با این حالت‌ها ترکیب شده و موجب شوند \fBlldb\fP دستورهای تعیین‌شده را قبل یا بعد از رویدادها، مانند بارگذاری فایل یا کرش کردن، به ترتیبی که در خط فرمان آمده اجرا کند. .INDENT 0.0 .INDENT 3.5 lldb \-O \(aqsettings set stop\-disassembly\-count 20\(aq \-o \(aqrun\(aq \-o \(aqbt\(aq lldb \-S /source/before/file \-s /source/after/file lldb \-K /source/before/crash \-k /source/after/crash .UNINDENT .UNINDENT .sp نکته: در حالت REPL هیچ فایلی بارگذاری نمی‌شود، بنابراین دستورهای تعیین‌شده برای اجرا پس از بارگذاری فایل (از طریق \-o یا \-s) نادیده گرفته خواهند شد..SH "استفاده از LLDB (USING LLDB)" .sp در \fBlldb\fP یک دستور help وجود دارد که می‌تواند برای یافتن توضیحات و مثال‌های مربوط به تمام دستورات \fBlldb\fP استفاده شود. برای دریافت راهنما دربارهٔ \(dqbreakpoint set\(dq، باید عبارت \(dqhelp breakpoint set\(dq را وارد کنید. .sp همچنین یک دستور apropos وجود دارد که متن راهنمای تمام دستورات را برای یافتن یک عبارت مشخص جستجو می‌کند ‐‐ این قابلیت برای یافتن یک دستور بر اساس موضوع مفید است. برای نمونه، \(dqapropos breakpoint\(dq هر دستوری را که واژهٔ \(dqbreakpoint\(dq در متن راهنمایش آمده باشد فهرست می‌کند. .SH "فایل‌های پیکربندی (CONFIGURATION FILES)" .sp \fBlldb\fP مواردی مانند تنظیمات، نام‌های مستعار و دستورات را از فایل \&.lldbinit می‌خواند. .sp ابتدا، \fBlldb\fP تلاش می‌کند فایل init مخصوص برنامه را بخواند که نام آن به صورت ~/.lldbinit به همراه یک \(dq\-\(dq و نام برنامهٔ جاری است. این نام برای نسخهٔ خط فرمان \fBlldb\fP برابر ~/.lldbinit\-lldb و برای Xcode برابر ~/.lldbinit\-Xcode خواهد بود. اگر فایل init مخصوص برنامه وجود نداشته باشد، \fBlldb\fP به دنبال یک فایل init در دایرکتوری خانگی خواهد گشت. اگر برنامه با گزینهٔ REPL اجرا شده باشد، ابتدا به دنبال فایل پیکربندی REPL ویژهٔ زبان آن REPL می‌گردد. نام این فایل init باید به این صورت باشد: \fB\&.lldbinit\-\-repl\fP (برای مثال \fB\&.lldbinit\-swift\-repl\fP). اگر این فایل وجود نداشته باشد یا \fBlldb\fP با REPL اجرا نشده باشد—به این معنی که نه فایل init مخصوص REPL و نه فایل init مخصوص برنامه یافت نشود—\fBlldb\fP به فایل سراسری ~/.lldbinit بازمی‌گردد. .sp در مرحلهٔ دوم، این ابزار به دنبال یک فایل .lldbinit در دایرکتوری کاری فعلی می‌گردد. به دلایل امنیتی، \fBlldb\fP به طور پیش‌فرض هشداری چاپ کرده و این فایل را بارگذاری (source) نمی‌کند. این رفتار را می‌توان با تغییر دادن تنظیم target.load\-cwd\-lldbinit عوض کرد. .sp برای بارگذاری همیشگی فایل .lldbinit در دایرکتوری کاری فعلی، دستور زیر را به ~/.lldbinit اضافه کنید: .INDENT 0.0 .INDENT 3.5 settings set target.load\-cwd\-lldbinit true .UNINDENT .UNINDENT .sp برای اینکه فایل .lldbinit در دایرکتوری کاری فعلی هرگز بارگذاری نشود و نمایش هشدار نیز غیرفعال گردد، دستور زیر را به ~/.lldbinit اضافه کنید: .INDENT 0.0 .INDENT 3.5 settings set target.load\-cwd\-lldbinit false .UNINDENT .UNINDENT .SH "همچنین ببینید (SEE ALSO)" .sp صفحهٔ پروژهٔ LLDB در \% منابع گوناگونی برای کاربران \fBlldb\fP دارد ‐‐ صفحهٔ معادل‌های دستورات gdb/lldb در \% می‌تواند به ویژه برای کاربرانی که از gdb می‌آیند بسیار مفید باشد. .SH "نویسندگان (AUTHORS)" پروژه LLVM .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 2007-2026, The LLDB Team .\" End of generated man page.