| OCAMLDEBUG(1) | General Commands Manual | OCAMLDEBUG(1) |
نام (NAME)
ocamldebug - اشکال‌زدای بازپخش در سطح کد منبع برای OCaml
خلاصه دستور (SYNOPSIS)
ocamldebug [ options ] program [ arguments ]
توضیحات (DESCRIPTION)
ocamldebug اشکال‌زدای بازپخش در سطح کد منبع برای OCaml است.
پیش از اینکه بتوان از اشکال‌زدا استفاده کرد، برنامه باید با گزینهٔ -g کامپایل و پیوند داده (link) شود: تمام فایل‌های .cmo و .cma که بخشی از برنامه هستند باید با ocamlc -g ایجاد شده باشند، و باید به‌وسیلهٔ ocamlc -g به یکدیگر پیوند داده شوند.
کامپایل کردن با -g هیچ جریمه‌ای بر زمان اجرای برنامه‌ها تحمیل نمی‌کند: فایل‌های شیء و فایل‌های اجرایی بایت‌کد حجیم‌تر بوده و تولید آن‌ها زمان بیشتری می‌برد، اما فایل‌های اجرایی دقیقاً با همان سرعتی اجرا می‌شوند که گویی بدون -g کامپایل شده‌اند.
گزینه‌ها (OPTIONS)
خلاصه‌ای از گزینه‌ها در زیر آمده است. برای توضیحات کامل، به مستندات html در بستهٔ ocaml-doc مراجعه کنید.
- -c count
- تنظیم حداکثر تعداد نقاط وارسی (checkpoints) فعال به‌طور هم‌زمان روی count.
- -cd dir
- اجرای برنامهٔ اشکال‌زدا از دایرکتوری کاریِ dir، به‌جای دایرکتوری کاری فعلی (همچنین دستور cd را ببینید).
- -emacs
- به اشکال‌زدا اعلام می‌کند که تحت Emacs در حال اجرا است (برای اطلاعات دربارهٔ نحوهٔ اجرای اشکال‌زدا تحت Emacs، The OCaml user's manual را ببینید). این گزینه به‌طور ضمنی شامل -machine-readable نیز می‌شود.
- -I directory
- افزودن directory به فهرست دایرکتوری‌هایی که برای فایل‌های منبع و فایل‌های کامپایل‌شده جستجو می‌شوند (همچنین دستور directory را ببینید).
- -machine-readable
- چاپ اطلاعات در قالبی مناسب‌تر برای ماشین‌ها به‌جای کاربران انسانی، در صورت امکان. برای مثال، هنگام توصیف مکانی در برنامه، مانند چاپ ردگیری به عقب (backtrace)، شمارندهٔ برنامه (program counter) و آفست نویسه در فایل را به‌جای نام فایل، شماره خط و آفست نویسه در آن خط چاپ می‌کند.
- -s socket
- استفاده از socket برای برقراری ارتباط با برنامهٔ تحت اشکال‌زدایی. برای دیدن ساختار و قالب socket، توضیحات دستور set socket در The OCaml user's manual را ببینید.
- -version
- چاپ رشتهٔ نسخه و خروج.
- -vnum
- چاپ شماره نسخهٔ کوتاه و خروج.
- -help یا --help
- نمایش خلاصهٔ کوتاهی از نحوهٔ استفاده و خروج.
فایل مقداردهی اولیه (INITIALIZATION FILE)
هنگامی که ocamldebug(1) فراخوانی می‌شود، پیش از واگذاری کنترل به کاربر، دستورها را از یک فایل مقداردهی اولیه می‌خواند. فایل پیش‌فرض در صورت وجود، .ocamldebug در دایرکتوری فعلی است، در غیر این صورت .ocamldebug در دایرکتوری خانگی کاربر خواهد بود.
توجه داشته باشید که می‌توانید از دستور source file نیز برای خواندن دستورها از یک فایل استفاده کنید.
همچنین ببینید (SEE ALSO)
ocamlc(1).
The OCaml user's manual،
فصل «The debugger».
نویسندگان (AUTHORS)
این صفحهٔ راهنما توسط Sven LUTHER <luther@debian.org> برای سیستم گنو/لینوکس دبیان نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود).