.\" Copyright (C) 1993, 1995, 2001, 2002, 2003, 2004, 2005, 2008,
.\"               2009, 2012, 2015, 2016, 2017, 2018, 2020
.\"               Free Software Foundation, Inc.
.\" You may distribute this file under the terms of the GNU Free
.\" Documentation License.
.TH runtest 1 "2018-12-01"
.SH "نام (NAME)"
runtest \- گرداننده آزمون DejaGnu
.SH "خلاصه دستور (SYNOPSIS)"
.B runtest
[\fIگزینه\fR]...
.SH "توضیحات (DESCRIPTION)"
.I DejaGnu
یک چارچوب برای آزمایش برنامه‌ها با استفاده از Expect است.
.B runtest
برنامه گرداننده برای
.I DejaGnu
است. این ابزار تعیین می‌کند چه آزمون‌هایی اجرا شوند و چگونه اجرا گردند.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B --all,\ -a
خروجی دادن تمام نتایج آزمون. به‌طور پیش‌فرض، فقط نتایج غیرمنتظره نمایش داده می‌شوند.
.TP
.BI --build \ TRIPLET
سه‌تایی پیکربندی (TRIPLET) برای سیستم ساخت (build).
.TP
.B --debug
فعال کردن خروجی اشکال‌زدایی درونی
.BR Expect .
خروجی در فایلی به نام
\fBdbg.log\fR
ثبت می‌شود.
.TP
.BI --directory \ DIRECTORY
اجرای آزمون‌ها تنها در دایرکتوری مشخص‌شده.
.TP
.BI --global_init \ NAME
نام مورداستفاده برای فایل سراسری init در libdir.
در صورت مشخص نشدن این گزینه، پیش‌فرض
\fBsite.exp\fR
است.
.TP
.B --help
نمایش پیام راهنما و سپس خروج.
.TP
.BI --host \ TRIPLET
سه‌تایی پیکربندی برای سیستم میزبان (host).
.TP
.BI --host_board \ NAME
تعریف برد میزبان مورد استفاده.
.TP
.BI --ignore \ test1.exp\ test2.exp\ ...
عدم اجرای آزمون‌های مشخص‌شده.
.TP
.BI --local_init \ NAME
نام مورداستفاده برای فایل محلی init مجموعه آزمون در هر دو پوشه جاری و objdir.
در صورت مشخص نشدن این گزینه، پیش‌فرض
\fBsite.exp\fR
است.
.TP
.B --log_dialog
ارسال خروجی Expect به خروجی استاندارد.
.TP
.BI --mail \ \'name1\ name2\ ...\'
نشانی‌های پست الکترونیکی برای دریافت نتایج آزمون.
.TP
.BI --objdir \ PATH
مسیر
\fIPATH\fR
دایرکتوری حاوی کدهای کامپایل‌شده آزمون است.
.TP
.BI --outdir \ DIRECTORY
نام یک دایرکتوری برای ذخیره لاگ‌های آزمون.
.TP
.B --reboot
راه‌اندازی مجدد (Reboot) برد هدف هنگام راه‌اندازی اولیه
\fBruntest\fR
(در صورت پشتیبانی).
.TP
.BI --srcdir \ PATH
مسیر
\fIPATH\fR
دایرکتوری حاوی پوشه‌های آزمون است.
.TP
.BI --strace \ N
فعال‌سازی ردیابی درونی
.B Expect
تا عمق
\fIN\fR
سطح. خروجی در فایلی به نام
\fBdbg.log\fR
ثبت می‌شود.
.TP
.BI --target \ TRIPLET
سه‌تایی پیکربندی برای سیستم هدف (target).
.TP
.BI --target_board \ NAME
فهرستی از نام‌های بردهای هدف برای اجرای آزمون‌ها بر روی آن‌ها.
.TP
.BI --tool \ TOOLNAME
مشخص کردن ابزار مورد آزمایش.
\fITOOLNAME\fR
مجموعه آزمون اعمال‌شده و ماژول راه‌اندازی اولیه مرتبط را کنترل می‌کند.
.TP
.BI --tool_exec \ PATH
مشخص کردن مسیر فایل اجرایی مورد آزمایش.
.TP
.BI --tool_opts \ OPTIONS
گزینه‌های اضافی برای ارسال به ابزار.
.TP
.B -v,\ --verbose
فعال کردن خروجی اشکال‌زدایی بیشتر از آزمون‌ها و کدهای ابزار DejaGnu.
برای افزایش بیشتر خروجی، بیش از یک بار استفاده کنید.
.TP
.B -V,\ --version
چاپ نسخه‌های DejaGnu، Expect و Tcl.
.TP
.B -x,\ --xml
تولید خروجی XML. فایل خروجی با نام ابزار و پسوند .xml نام‌گذاری می‌شود.
.TP
.B -D[number]
فعال‌سازی اشکال‌زدای Tcl. مقدار
\fBnumber\fR
می‌تواند 1 یا 0 باشد. اگر 1 باشد، شل Expect هنگام شروع اجرا متوقف می‌شود. کلید وقفه (interrupt) باعث رفتن DejaGnu به پرامپت دیباگر می‌شود. اگر 0 باشد، DejaGnu مثل همیشه شروع می‌شود اما فشردن Control-C آن را به پرامپت دیباگر می‌برد.
.TP 0
هر نام فایلی در خط فرمان به‌عنوان زیرمجموعه‌ای از نام‌های آزمون‌های اجرایی در نظر گرفته می‌شود. معمولاً این‌ها نام اسکریپت‌های آزمون هستند (مانند foo.exp).
.PP
متغیرهای مشابه Makefile برای تعیین نام ابزارها و فلگ‌های آن‌ها استفاده می‌شوند؛ این مقادیر و سایر مقادیر وابسته به پیکربندی در فایل
\fBsite.exp\fR
که هنگام پیکربندی ساخته می‌شود، ذخیره می‌گردند.
.SS "وضعیت خروج (Exit status):"
.TP
0
اگر تمام آزمون‌ها با موفقیت سپری شوند، از جمله شکست‌های مورد انتظار و آزمون‌های پشتیبانی‌نشده.
.TP
1
اگر هر آزمونی شکست بخورد، به‌طور غیرمنتظره موفق شود یا حل‌نشده باقی بماند.
.TP
2
اگر Expect با هر خطایی در اسکریپت‌های آزمون مواجه شود.
.SH "نویسنده (AUTHOR)"
Rob Savoye (rob@welcomehome.org)
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌ها به <bug\-dejagnu@gnu.org>.
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2005\-2016, 2018, 2020 Free Software Foundation, Inc.
.PP
این یک نرم‌افزار آزاد است. شما می‌توانید نسخه‌های آن را تحت شرایط مجوز عمومی همگانی گنو (GPL) بازتوزیع کنید <http://www.gnu.org/licenses/gpl.html>.
هیچ تضمینی وجود ندارد، تا حدی که قانون مجاز دانسته است.
.SH "همچنین ببینید (SEE ALSO)"
مستندات کامل
.B DejaGnu
به‌صورت یک راهنمای Texinfo نگهداری می‌شود. اگر برنامه
.B info
روی سیستم شما نصب باشد، دستور
.IP
.B info dejagnu
.PP
باید دسترسی به راهنمای کامل را به شما بدهد.