نام (NAME)

runtest - گرداننده آزمون DejaGnu

خلاصه دستور (SYNOPSIS)

runtest [گزینه]...

توضیحات (DESCRIPTION)

DejaGnu یک چارچوب برای آزمایش برنامه‌ها با استفاده از Expect است. runtest برنامه گرداننده برای DejaGnu است. این ابزار تعیین می‌کند چه آزمون‌هایی اجرا شوند و چگونه اجرا گردند.

گزینه‌ها (OPTIONS)

--all, -a: خروجی دادن تمام نتایج آزمون. به‌طور پیش‌فرض، فقط نتایج غیرمنتظره نمایش داده می‌شوند.
--build TRIPLET: سه‌تایی پیکربندی (TRIPLET) برای سیستم ساخت (build).
--debug: فعال کردن خروجی اشکال‌زدایی درونی Expect. خروجی در فایلی به نام dbg.log ثبت می‌شود.
--directory DIRECTORY: اجرای آزمون‌ها تنها در دایرکتوری مشخص‌شده.
--global_init NAME: نام مورداستفاده برای فایل سراسری init در libdir. در صورت مشخص نشدن این گزینه، پیش‌فرض site.exp است.
--help: نمایش پیام راهنما و سپس خروج.
--host TRIPLET: سه‌تایی پیکربندی برای سیستم میزبان (host).
--host_board NAME: تعریف برد میزبان مورد استفاده.
--ignore test1.exp test2.exp ...: عدم اجرای آزمون‌های مشخص‌شده.
--local_init NAME: نام مورداستفاده برای فایل محلی init مجموعه آزمون در هر دو پوشه جاری و objdir. در صورت مشخص نشدن این گزینه، پیش‌فرض site.exp است.
--log_dialog: ارسال خروجی Expect به خروجی استاندارد.
--mail ´name1 name2 ...´: نشانی‌های پست الکترونیکی برای دریافت نتایج آزمون.
--objdir PATH: مسیر PATH دایرکتوری حاوی کدهای کامپایل‌شده آزمون است.
--outdir DIRECTORY: نام یک دایرکتوری برای ذخیره لاگ‌های آزمون.
--reboot: راه‌اندازی مجدد (Reboot) برد هدف هنگام راه‌اندازی اولیه runtest (در صورت پشتیبانی).
--srcdir PATH: مسیر PATH دایرکتوری حاوی پوشه‌های آزمون است.
--strace N: فعال‌سازی ردیابی درونی Expect تا عمق N سطح. خروجی در فایلی به نام dbg.log ثبت می‌شود.
--target TRIPLET: سه‌تایی پیکربندی برای سیستم هدف (target).
--target_board NAME: فهرستی از نام‌های بردهای هدف برای اجرای آزمون‌ها بر روی آن‌ها.
--tool TOOLNAME: مشخص کردن ابزار مورد آزمایش. TOOLNAME مجموعه آزمون اعمال‌شده و ماژول راه‌اندازی اولیه مرتبط را کنترل می‌کند.
--tool_exec PATH: مشخص کردن مسیر فایل اجرایی مورد آزمایش.
--tool_opts OPTIONS: گزینه‌های اضافی برای ارسال به ابزار.
-v, --verbose: فعال کردن خروجی اشکال‌زدایی بیشتر از آزمون‌ها و کدهای ابزار DejaGnu. برای افزایش بیشتر خروجی، بیش از یک بار استفاده کنید.
-V, --version: چاپ نسخه‌های DejaGnu، Expect و Tcl.
-x, --xml: تولید خروجی XML. فایل خروجی با نام ابزار و پسوند .xml نام‌گذاری می‌شود.
-D[number]: فعال‌سازی اشکال‌زدای Tcl. مقدار number می‌تواند 1 یا 0 باشد. اگر 1 باشد، شل Expect هنگام شروع اجرا متوقف می‌شود. کلید وقفه (interrupt) باعث رفتن DejaGnu به پرامپت دیباگر می‌شود. اگر 0 باشد، DejaGnu مثل همیشه شروع می‌شود اما فشردن Control-C آن را به پرامپت دیباگر می‌برد.
هر نام فایلی در خط فرمان به‌عنوان زیرمجموعه‌ای از نام‌های آزمون‌های اجرایی در نظر گرفته می‌شود. معمولاً این‌ها نام اسکریپت‌های آزمون هستند (مانند foo.exp).

متغیرهای مشابه Makefile برای تعیین نام ابزارها و فلگ‌های آن‌ها استفاده می‌شوند؛ این مقادیر و سایر مقادیر وابسته به پیکربندی در فایل site.exp که هنگام پیکربندی ساخته می‌شود، ذخیره می‌گردند.

وضعیت خروج (Exit status):

0: اگر تمام آزمون‌ها با موفقیت سپری شوند، از جمله شکست‌های مورد انتظار و آزمون‌های پشتیبانی‌نشده.
1: اگر هر آزمونی شکست بخورد، به‌طور غیرمنتظره موفق شود یا حل‌نشده باقی بماند.
2: اگر Expect با هر خطایی در اسکریپت‌های آزمون مواجه شود.

نویسنده (AUTHOR)

Rob Savoye (rob@welcomehome.org)

گزارش باگ‌ها (REPORTING BUGS)

گزارش باگ‌ها به <bug-dejagnu@gnu.org>.

حق نشر (COPYRIGHT)

این یک نرم‌افزار آزاد است. شما می‌توانید نسخه‌های آن را تحت شرایط مجوز عمومی همگانی گنو (GPL) بازتوزیع کنید http://www.gnu.org/licenses/gpl.html. هیچ تضمینی وجود ندارد، تا حدی که قانون مجاز دانسته است.

همچنین ببینید (SEE ALSO)

مستندات کامل DejaGnu به‌صورت یک راهنمای Texinfo نگهداری می‌شود. اگر برنامه info روی سیستم شما نصب باشد، دستور

: info dejagnu

باید دسترسی به راهنمای کامل را به شما بدهد.