.\" 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 "CTEST" "1" "Aug 31, 2026" "4.4.3" "CMake"
.SH "نام (NAME)"
ctest \- ابزار اجرای آزمون‌ها در سیستم ساخت CMake
.SS "فهرست مطالب (Contents)"
.INDENT 0.0
.IP \(bu 2
ctest(1)
.INDENT 2.0
.IP \(bu 2
خلاصه دستور
.IP \(bu 2
توضیحات
.IP \(bu 2
اجرای آزمون‌ها
.IP \(bu 2
مشاهده راهنما
.IP \(bu 2
تطبیق برچسب‌ها
.IP \(bu 2
خلاصه برچسب‌ها و زیرپروژه‌ها
.IP \(bu 2
حالت ساخت و آزمون
.IP \(bu 2
کلاینت داشبورد
.INDENT 2.0
.IP \(bu 2
مراحل کلاینت داشبورد
.IP \(bu 2
حالت‌های کلاینت داشبورد
.IP \(bu 2
کلاینت داشبورد از طریق خط فرمان CTest
.IP \(bu 2
کلاینت داشبورد از طریق اسکریپت CTest
.UNINDENT
.IP \(bu 2
پیکربندی کلاینت داشبورد
.INDENT 2.0
.IP \(bu 2
مرحله آغاز CTest
.IP \(bu 2
مرحله به‌روزرسانی CTest
.IP \(bu 2
مرحله پیکربندی CTest
.IP \(bu 2
مرحله ساخت CTest
.IP \(bu 2
مرحله آزمون CTest
.IP \(bu 2
مرحله پوشش کد CTest
.IP \(bu 2
مرحله بررسی حافظه CTest
.IP \(bu 2
مرحله ارسال CTest
.UNINDENT
.IP \(bu 2
نمایش به عنوان مدل شیء JSON
.IP \(bu 2
تخصیص منابع
.INDENT 2.0
.IP \(bu 2
فایل مشخصات منابع
.IP \(bu 2
ویژگی \fBRESOURCE_GROUPS\fP
.IP \(bu 2
متغیرهای محیطی
.IP \(bu 2
فایل مشخصات منابع تولیدشده به‌صورت پویا
.UNINDENT
.IP \(bu 2
یکپارچه‌سازی با سرور کارها
.IP \(bu 2
همچنین ببینید
.UNINDENT
.UNINDENT
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
اجرای آزمون‌ها
 ctest [<options>...] [\-\-test\-dir <path\-to\-build>] [\-\- <test\-args>...]

حالت ساخت و آزمون
 ctest \-\-build\-and\-test <path\-to\-source> <path\-to\-build>
       \-\-build\-generator <generator> [<options>...]
      [\-\-build\-options <opts>...]
      [\-\-test\-command <command> [<args>...]]

کلاینت داشبورد
 ctest \-D <dashboard>            [\-\- <dashboard\-options>...]
 ctest \-M <model> \-T <action>    [\-\- <dashboard\-options>...]
 ctest [\-M <model>] \-T Configure \-\-source\-dir <path\-to\-source>
                                 [\-\-build\-dir <path\-to\-build>]
                                 [\-\- <dashboard\-options>...]
 ctest \-S <script>               [\-\- <dashboard\-options>...]
 ctest \-SP <script>              [\-\- <dashboard\-options>...]

مشاهده راهنما
 ctest \-\-help[\-<topic>]
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه اجرایی \fBctest\fP ابزار گرداننده آزمون‌ها در سامانه ساخت CMake است.
درخت‌های ساخت تولیدشده توسط CMake برای پروژه‌هایی که از دستورات
\fBenable_testing()\fP \%<#\:command:enable_testing>
و
\fBadd_test()\fP \%<#\:command:add_test>
استفاده می‌کنند، دارای پشتیبانی از اجرای آزمون هستند.
این برنامه آزمون‌ها را اجرا کرده و نتایج را گزارش می‌کند.
.SH "اجرای آزمون‌ها (RUN TESTS)"
.sp
دستور \fBctest\fP آزمون‌های تعریف‌شده توسط یک فایل \fBCTestTestfile.cmake\fP را اجرا می‌کند،
که معمولاً در یک درخت ساخت تولیدشده توسط \fBcmake(1)\fP \%<#\:manual:cmake(1)> قرار دارد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ctest [<options>...] [\-\-test\-dir <path\-to\-build>] [\-\- <test\-args>...]
.EE
.UNINDENT
.UNINDENT
.sp
اگر تمام آزمون‌ها با موفقیت سپری شوند، کد خروج \fB0\fP\& خواهد بود. کد خروج در موارد زیر غیرصفر است:
.INDENT 0.0
.IP \(bu 2
خطایی رخ دهد، مانند شکست در پردازش آرگومان‌های نامعتبر.
.IP \(bu 2
افزوده‌شده در نسخه 4.4: هیچ آرگومانی داده نشده باشد و هیچ فایل \fBCTestTestfile.cmake\fP وجود نداشته باشد.

.IP \(bu 2
آرگومان \fB\-\-no\-tests=error\fP داده شده باشد و هیچ آزمونی اجرا نشود؛
برای مثال هنگامی که \fBCTestTestfile.cmake\fP هیچ آزمونی را تعریف نکرده باشد، یا زمانی که آرگومان‌های داده‌شده تمام آزمون‌ها را مستثنی کنند.
.IP \(bu 2
دست‌کم یک آزمون با شکست مواجه شود.
.UNINDENT
.sp
گزینه‌های اجرای آزمون‌ها عبارتند از:
.INDENT 0.0
.TP
.B \-\-preset <preset>, \-\-preset=<preset>
استفاده از یک پیش‌تنظیم (\fBpreset\fP) آزمون \%<#\:manual:cmake-presets(7)> برای مشخص کردن گزینه‌های آزمون.
دایرکتوری باینری پروژه از کلید
\fBconfigurePreset\fP \%<#\:cmakepresets-testpresets-configurepreset> استنباط می‌شود.
.sp
افزوده‌شده در نسخه 3.30: گزینه \fB\-\-test\-dir\fP می‌تواند با دایرکتوری باینری متفاوتی نسبت به آنچه توسط کلید
\fBconfigurePreset\fP \%<#\:cmakepresets-testpresets-configurepreset> مشخص شده، تعیین گردد.

.sp
تغییریافته در نسخه 4.4: اگر \fB\-\-presets\-file\fP مشخص شده باشد، حضور هیچ‌یک از فایل‌های
\fBCMakePresets.json\fP یا \fBCMakeUserPresets.json\fP الزامی نیست.
در غیر این صورت، وجود آن‌ها در دایرکتوری منبع سطح بالا الزامی است.
در نسخه‌های پیشین، این موضوع اکیداً الزامی بود.

.UNINDENT
.INDENT 0.0
.TP
.B \-\-presets\-file <file>, \-\-presets\-file=<file>
افزوده‌شده در نسخه 4.4.

.sp
خواندن پیش‌تنظیم‌ها (\fBpresets\fP \%<#\:manual:cmake-presets(7)>) از \fB<file>\fP داده‌شده.
مسیر مشخص‌شده می‌تواند مطلق یا نسبت به دایرکتوری کاری جاری باشد.
اگر \fB\-\-presets\-file\fP داده شود، پیش‌تنظیم‌های تعریف‌شده در \fBCMakePresets.json\fP و
\fBCMakeUserPresets.json\fP نادیده گرفته خواهند شد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-list\-presets
فهرست کردن پیش‌تنظیم‌های آزمون موجود. دایرکتوری کاری جاری باید شامل
\fBCMakePresets.json\fP و/یا \fBCMakeUserPresets.json\fP\& باشد.
.sp
تغییریافته در نسخه 4.4: اگر \fB\-\-presets\-file\fP مشخص شده باشد، وجود هیچ‌یک از فایل‌های
\fBCMakePresets.json\fP یا \fBCMakeUserPresets.json\fP الزامی نیست، و تنها پیش‌تنظیم‌های تعریف‌شده در \fB<file>\fP مشخص‌شده فهرست خواهند شد.
در غیر این صورت، حضور آن‌ها در دایرکتوری منبع سطح بالا الزامی است.
در نسخه‌های پیشین، این موضوع اکیداً الزامی بود.

.UNINDENT
.INDENT 0.0
.TP
.B \-C <cfg>, \-\-build\-config <cfg>
انتخاب پیکربندی برای آزمون.
.sp
برخی از درخت‌های ساخت تولیدشده توسط CMake می‌توانند چندین پیکربندی ساخت در همان درخت داشته باشند.
این گزینه می‌تواند برای مشخص کردن اینکه کدام پیکربندی باید آزمایش شود به کار رود.
پیکربندی‌های نمونه شامل \fBDebug\fP و
\fBRelease\fP\& هستند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-progress
فعال‌سازی خروجی مختصر پیشرفت آزمون‌ها.
.sp
هنگامی که خروجی \fBctest\fP مستقیماً به یک ترمینال ارسال می‌شود، پیشرفت مجموعه آزمون‌ها به‌جای چاپ پیام‌های شروع و پایان هر آزمون در سطرهای جدید، با به‌روزرسانی همان سطر گزارش می‌شود.
این کار می‌تواند میزان پرگویی خروجی آزمون را به میزان چشمگیری کاهش دهد.
پیام‌های اتمام آزمون برای آزمون‌های ناموفق همچنان در سطر اختصاصی خود چاپ می‌شوند و خلاصه نهایی آزمون نیز ثبت خواهد شد.
.sp
این گزینه همچنین می‌تواند با تنظیم متغیر محیطی
\fBCTEST_PROGRESS_OUTPUT\fP \%<#\:envvar:CTEST_PROGRESS_OUTPUT>\& فعال شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-V, \-\-verbose
فعال‌سازی خروجی پرجزئیات از آزمون‌ها.
.sp
خروجی آزمون‌ها معمولاً مخفی نگه داشته شده و فقط اطلاعات خلاصه نمایش داده می‌شود.
این گزینه تمام خروجی‌های آزمون را نشان می‌دهد.
.UNINDENT
.INDENT 0.0
.TP
.B \-VV, \-\-extra\-verbose
فعال‌سازی خروجی با جزئیات بیشتر از آزمون‌ها.
.sp
خروجی آزمون‌ها معمولاً مخفی نگه داشته شده و تنها اطلاعات خلاصه نمایش داده می‌شود.
این گزینه حتی خروجی‌های بیشتری از آزمون را نشان می‌دهد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-debug
نمایش جزئیات داخلی دقیق‌تر CTest.
.sp
این ویژگی منجر به حجم بالایی از خروجی می‌شود که عمدتاً برای اشکال‌زدایی مشکلات داشبورد مفید است.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-output\-on\-failure
چاپ تمام خروجی‌های برنامه آزمون در صورت شکست آزمون.
این گزینه همچنین با تنظیم متغیر محیطی
\fBCTEST_OUTPUT_ON_FAILURE\fP \%<#\:envvar:CTEST_OUTPUT_ON_FAILURE> قابل فعال‌سازی است.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-stop\-on\-failure
توقف اجرای آزمون‌ها به محض وقوع نخستین شکست.
.UNINDENT
.INDENT 0.0
.TP
.B \-F
فعال‌سازی بازیابی پس از شکست (failover).
.sp
این گزینه به CTest اجازه می‌دهد اجرای مجموعه آزمونی را که قبلاً قطع شده بود، از سر بگیرد.
در صورتی که هیچ وقفه‌ای رخ نداده باشد، گزینه \fB\-F\fP هیچ اثری نخواهد داشت.
.UNINDENT
.INDENT 0.0
.TP
.B \-j [<level>], \-\-parallel [<level>]
اجرای موازی آزمون‌ها، به صورت اختیاری محدود به سطح مشخصی از موازی‌سازی.
.sp
افزوده‌شده در نسخه 3.29: مقدار \fB<level>\fP می‌تواند حذف شود، یا \fB0\fP باشد که در این حالت:
.INDENT 7.0
.IP \(bu 2
تحت یکپارچگی کارگزار کار (Job Server Integration)، موازی‌سازی با نشانه‌های کار (job tokens) موجود محدود می‌شود.
.IP \(bu 2
در غیر این صورت، اگر مقدار حذف شود، موازی‌سازی به تعداد پردازنده‌ها یا ۲ (هرکدام که بزرگ‌تر باشد) محدود خواهد شد.
.IP \(bu 2
در غیر این صورت، اگر مقدار \fB0\fP باشد، موازی‌سازی نامحدود خواهد بود.
.UNINDENT

.sp
این گزینه می‌تواند از طریق متغیر محیطی
\fBCTEST_PARALLEL_LEVEL\fP \%<#\:envvar:CTEST_PARALLEL_LEVEL> نیز مشخص گردد.
.sp
این گزینه می‌تواند با ویژگی آزمون \fBPROCESSORS\fP \%<#\:prop_test:PROCESSORS> به کار رود.
بخش خلاصه برچسب و زیرپروژه (Label and Subproject Summary) را ببینید\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-resource\-spec\-file <file>
اجرای CTest با تخصیص منابع فعال،
با استفاده از فایل مشخصات منبع (resource specification file)
تعیین‌شده در \fB<file>\fP\&.
.sp
هنگامی که \fBctest\fP به عنوان یک کلاینت داشبورد اجرا می‌شود، این گزینه فیلد
\fBResourceSpecFile\fP مرحله آزمون CTest را تنظیم می‌کند\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-test\-load <level>
هنگام اجرای موازی آزمون‌ها (برای مثال با \fB\-j\fP)، تلاش برای عدم شروع آزمون‌ها در زمانی که ممکن است باعث شوند بار پردازنده از یک آستانه مشخص فراتر رود.
.sp
هنگامی که \fBctest\fP به عنوان کلاینت داشبورد اجرا می‌شود، این گزینه فیلد
\fBTestLoad\fP مرحله آزمون CTest را تنظیم می‌نماید\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-Q, \-\-quiet
بی‌صدا کردن CTest.
.sp
این گزینه تمام خروجی‌ها را مسدود می‌کند. در صورتی که \fB\-\-output\-log\fP مشخص شده باشد، فایل لاگ خروجی همچنان ایجاد خواهد شد.
در صورت مشخص شدن \fB\-\-quiet\fP، گزینه‌هایی مانند \fB\-\-verbose\fP،
\fB\-\-extra\-verbose\fP و
\fB\-\-debug\fP نادیده گرفته می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-O <file>, \-\-output\-log <file>
ارسال خروجی به فایل گزارش (log).
.sp
این گزینه به CTest دستور می‌دهد تمام خروجی‌های خود را در فایل گزارش \fB<file>\fP بنویسد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-output\-junit <file>
افزوده‌شده در نسخه 3.21.

.sp
نوشتن نتایج آزمون در قالب JUnit.
.sp
این گزینه به CTest دستور می‌دهد نتایج آزمون را در قالب XML جی‌یونیت (JUnit XML) در \fB<file>\fP بنویسد. اگر \fB<file>\fP از قبل وجود داشته باشد، رونویسی خواهد شد. در صورت استفاده از گزینه
\fB\-S\fP برای اجرای یک اسکریپت داشبورد، به جای آن از کلمه کلیدی \fBOUTPUT_JUNIT\fP
همراه با دستور \fBctest_test()\fP \%<#\:command:ctest_test> استفاده کنید.
.UNINDENT
.INDENT 0.0
.TP
.B \-N, \-\-show\-only[=<format>]
غیرفعال کردن اجرای واقعی آزمون‌ها.
.sp
این گزینه به CTest دستور می‌دهد آزمون‌هایی را که قرار است اجرا شوند فهرست کند، اما عملاً آن‌ها را اجرا نکند.
در ترکیب با گزینه‌های \fB\-R\fP
و \fB\-E\fP مفید است.
.sp
افزوده‌شده در نسخه 3.14: گزینه \fB\-\-show\-only\fP یک مقدار \fB<format>\fP می‌پذیرد.

.sp
مقدار \fB<format>\fP می‌تواند یکی از مقادیر زیر باشد:
.INDENT 7.0
.INDENT 3.5
.INDENT 0.0
.TP
.B \fBhuman\fP
خروجی خوانا برای انسان. پایدار بودن این قالب تضمین نمی‌شود.
این حالت پیش‌فرض است.
.TP
.B \fBjson\-v1\fP
تخلیه اطلاعات آزمون در قالب JSON.
بخش Show as JSON Object Model را ببینید\&.
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-L <regex>, \-\-label\-regex <regex>
اجرای آزمون‌هایی با برچسب‌های منطبق بر عبارت باقاعده، همان‌طور که در
string(REGEX) \%<#\:regex-specification>\& توضیح داده شده است.
.sp
این گزینه به CTest دستور می‌دهد تنها آزمون‌هایی را اجرا کند که برچسب‌های آن‌ها با عبارت باقاعده داده‌شده مطابقت داشته باشد.
هنگامی که بیش از یک گزینه \fB\-L\fP داده شود، یک آزمون تنها در صورتی اجرا می‌شود که هر عبارت باقاعده دست‌کم با یکی از برچسب‌های آزمون مطابقت کند (یعنی برچسب‌های چندگانه \fB\-L\fP یک رابطه \fBAND\fP تشکیل می‌دهند). بخش Label Matching را ببینید\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-R <regex>, \-\-tests\-regex <regex>
اجرای آزمون‌های منطبق با عبارت باقاعده.
.sp
این گزینه به CTest دستور می‌دهد فقط آزمون‌هایی را اجرا کند که نام آن‌ها با عبارت باقاعده داده‌شده مطابقت دارد.
.UNINDENT
.INDENT 0.0
.TP
.B \-E <regex>, \-\-exclude\-regex <regex>
مستثنی کردن آزمون‌های منطبق با عبارت باقاعده.
.sp
این گزینه به CTest دستور می‌دهد آزمون‌هایی را که نام آن‌ها با عبارت باقاعده داده‌شده مطابقت دارد اجرا نکند.
.UNINDENT
.INDENT 0.0
.TP
.B \-LE <regex>, \-\-label\-exclude <regex>
مستثنی کردن آزمون‌هایی با برچسب‌های منطبق با عبارت باقاعده.
.sp
این گزینه به CTest دستور می‌دهد آزمون‌هایی را که برچسب‌های آن‌ها با عبارت باقاعده داده‌شده مطابقت دارد اجرا نکند.
هنگامی که بیش از یک گزینه \fB\-LE\fP داده شود، یک آزمون تنها در صورتی مستثنی می‌شود که هر عبارت باقاعده دست‌کم با یکی از برچسب‌های آزمون مطابقت داشته باشد (یعنی برچسب‌های چندگانه \fB\-LE\fP یک رابطه \fBAND\fP تشکیل می‌دهند). بخش Label Matching را ببینید\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-tests\-from\-file <filename>
افزوده‌شده در نسخه 3.29.

.sp
اجرای آزمون‌های فهرست‌شده در فایل مشخص‌شده.
.sp
این گزینه به CTest دستور می‌دهد آزمون‌هایی را که در فایل داده‌شده فهرست شده‌اند اجرا کند.
فایل باید در هر سطر دقیقاً شامل نام یک آزمون باشد.
سطرهایی که دقیقاً با هیچ نام آزمونی مطابقت ندارند نادیده گرفته می‌شوند.
این گزینه می‌تواند با گزینه‌های دیگری مانند
\fB\-R\fP، \fB\-E\fP، \fB\-L\fP یا
\fB\-LE\fP\& ترکیب شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-exclude\-from\-file <filename>
افزوده‌شده در نسخه 3.29.

.sp
مستثنی کردن آزمون‌های فهرست‌شده در فایل داده‌شده.
.sp
این گزینه به CTest اعلام می‌کند آزمون‌هایی را که در فایل داده‌شده فهرست شده‌اند اجرا نکند.
فایل باید در هر سطر شامل نام دقیق یک آزمون باشد.
سطرهایی که دقیقاً با هیچ نام آزمونی مطابقت ندارند نادیده گرفته می‌شوند.
این گزینه می‌تواند با گزینه‌های دیگری مانند
\fB\-R\fP، \fB\-E\fP، \fB\-L\fP یا
\fB\-LE\fP
ترکیب شود\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-FA <regex>, \-\-fixture\-exclude\-any <regex>
مستثنی کردن فیکسچرهای منطبق با \fB<regex>\fP از افزودن خودکار هرگونه آزمون به
مجموعه آزمون‌ها.
.sp
اگر آزمونی در مجموعه آزمون‌های در حال اجرا نیازمند یک فیکسچر خاص باشد،
آزمون‌های راه‌اندازی و پاک‌سازی آن فیکسچر به طور طبیعی و خودکار به مجموعه آزمون‌ها
افزوده می‌شوند. این گزینه از افزودن آزمون‌های راه‌اندازی یا پاک‌سازی برای فیکسچرهای
منطبق با \fB<regex>\fP جلوگیری می‌کند\&. توجه داشته باشید که تمام رفتارهای دیگر فیکسچر حفظ می‌شوند،
از جمله وابستگی‌های آزمون و صرف‌نظر کردن از آزمون‌هایی که آزمون‌های راه‌اندازی فیکسچر آن‌ها
با شکست مواجه شده است.
.UNINDENT
.INDENT 0.0
.TP
.B \-FS <regex>, \-\-fixture\-exclude\-setup <regex>
مشابه \fB\-FA\fP، با این تفاوت که تنها آزمون‌های راه‌اندازی منطبق مستثنی می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-FC <regex>, \-\-fixture\-exclude\-cleanup <regex>
مشابه \fB\-FA\fP، با این تفاوت که تنها آزمون‌های پاک‌سازی منطبق مستثنی می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-I [Start,End,Stride,test#,test#|Test file], \-\-tests\-information
اجرای تعداد مشخصی از آزمون‌ها بر اساس شماره.
.sp
این گزینه باعث می‌شود CTest آزمون‌ها را با شروع از شماره \fBStart\fP،
پایان در شماره \fBEnd\fP و با گام‌های افزایشی \fBStride\fP اجرا کند\&. هرگونه شماره اضافی
بعد از \fBStride\fP به عنوان شماره آزمون جداگانه در نظر گرفته می‌شود\&. مقادیر \fBStart\fP،
\fBEnd\fP یا \fBStride\fP می‌توانند خالی باشند. همچنین می‌توان فایلی را مشخص کرد که
شامل همان قواعد نگارشی خط فرمان باشد.
.UNINDENT
.INDENT 0.0
.TP
.B \-U, \-\-union
در نظر گرفتن اجتماع گزینه‌های \fB\-I\fP و \fB\-R\fP\&.
.sp
هنگامی که هر دو گزینه \fB\-R\fP و \fB\-I\fP مشخص شده باشند، به طور پیش‌فرض
اشتراک آزمون‌ها اجرا می‌شود. با تعیین \fB\-U\fP به جای آن اجتماع آزمون‌ها
اجرا خواهد شد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-rerun\-failed
تنها اجرای آزمون‌هایی که قبلاً شکست خورده‌اند.
.sp
این گزینه به CTest اعلام می‌کند فقط آزمون‌هایی را انجام دهد که در اجرای قبلی
شکست خورده‌اند. هنگامی که این گزینه مشخص شود، CTest تمام گزینه‌های دیگر را
که برای تغییر فهرست آزمون‌های اجرایی در نظر گرفته شده‌اند (مانند
\fB\-L\fP، \fB\-R\fP، \fB\-E\fP،
\fB\-LE\fP، \fB\-I\fP و غیره) نادیده می‌گیرد. در صورتی که
CTest اجرا شود و هیچ آزمونی شکست نخورد، فراخوانی‌های بعدی CTest با گزینه
\fB\-\-rerun\-failed\fP مجموعه آزمون‌هایی را اجرا خواهد کرد که اخیراً
شکست خورده بودند (در صورت وجود)\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-repeat <mode>:<n>
اجرای مکرر آزمون‌ها بر اساس \fB<mode>\fP داده‌شده تا سقف \fB<n>\fP بار.
حالت‌ها عبارتند از:
.INDENT 7.0
.TP
.B \fBuntil\-fail\fP
الزام به اجرای هر آزمون تا \fB<n>\fP بار بدون شکست برای قبولی.
این حالت برای یافتن خطاهای متناوب و تصادفی در موارد آزمون مفید است.
.TP
.B \fBuntil\-pass\fP
امکان اجرای هر آزمون تا سقف \fB<n>\fP بار به منظور قبولی.
در صورت شکست آزمون‌ها به هر دلیلی، آن‌ها را تکرار می‌کند.
این حالت برای تحمل خطاهای تصادفی در موارد آزمون مفید است.
.TP
.B \fBafter\-timeout\fP
امکان اجرای هر آزمون تا سقف \fB<n>\fP بار به منظور قبولی.
آزمون‌ها را تنها در صورت اتمام مهلت زمانی (timeout) تکرار می‌کند.
این حالت برای تحمل پایان مهلت‌های زمانی تصادفی در موارد آزمون
روی سیستم‌های شلوغ مفید است.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-repeat\-until\-fail <n>
معادل \fB\-\-repeat until\-fail:<n>\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-max\-width <width>
تعیین حداکثر عرض نام آزمون در خروجی.
.sp
تنظیم حداکثر عرض برای نمایش نام هر آزمون در خروجی.
این به کاربر امکان می‌دهد پهنای خروجی را افزایش دهد تا از بریده شدن نام آزمون
که می‌تواند بسیار آزاردهنده باشد جلوگیری شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-interactive\-debug\-mode <0|1>
غیرفعال‌سازی (\fB0\fP) یا فعال‌سازی (\fB1\fP) حالت اشکال‌زدایی تعاملی.
.sp
این گزینه باعث می‌شود CTest آزمون‌ها را در حالت تعاملی یا
غیرتعاملی اجرا کند. در حالت پیشخوان (\fBExperimental\fP، \fBNightly\fP،
\fBContinuous\fP)، حالت پیش‌فرض غیرتعاملی است. در حالت غیرتعاملی،
متغیر محیطی \fBDASHBOARD_TEST_FROM_CTEST\fP \%<#\:envvar:DASHBOARD_TEST_FROM_CTEST> تنظیم می‌شود.
.sp
حالت تعاملی به گزارش خطای ویندوز (WER) اجازه می‌دهد پنجره‌های بالاپر اشکال‌زدایی
را نشان داده و دامپ هسته ایجاد کند. برای فعال کردن دامپ‌های هسته در آزمون‌ها،
از حالت تعاملی استفاده کرده و مستندات ویندوز درباره
Collecting User\-Mode Dumps \%<https://\:learn\:.microsoft\:.com/\:en-us/\:windows/\:win32/\:wer/\:collecting-user-mode-dumps>\&
را دنبال کنید.
.sp
تغییریافته در نسخه 4.0: گزارش خطای ویندوز (WER) در حالت تعاملی فعال است، بنابراین
فرآیندهای آزمون ممکن است پنجره‌های بالاپر اشکال‌زدایی را نشان دهند و دامپ هسته ایجاد کنند.
این قابلیت با به‌روزرسانی‌های \fBlibuv\fP فراهم شد\&.

.sp
تغییریافته در نسخه 3.11: گزارش خطای ویندوز (WER) در هر دو حالت تعاملی و
غیرتعاملی غیرفعال است، بنابراین فرآیندهای آزمون پنجره‌های بالاپر نشان نمی‌دهند
یا دامپ هسته ایجاد نمی‌کنند. این موضوع به دلیل راه‌اندازی فرآیندهای آزمون با
\fBlibuv\fP است\&.

.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-label\-summary
غیرفعال‌سازی اطلاعات خلاصه زمان‌بندی برای برچسب‌ها.
.sp
این گزینه به CTest اعلام می‌کند اطلاعات خلاصه را برای هر
برچسب مرتبط با آزمون‌های اجراشده چاپ نکند. اگر هیچ برچسبی روی
آزمون‌ها وجود نداشته باشد، هیچ چیز اضافی چاپ نمی‌شود.
.sp
بخش Label and Subproject Summary را ببینید\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-subproject\-summary
غیرفعال‌سازی اطلاعات خلاصه زمان‌بندی برای زیرپروژه‌ها.
.sp
این گزینه به CTest اعلام می‌کند اطلاعات خلاصه را برای هر
زیرپروژه مرتبط با آزمون‌های اجراشده چاپ نکند. اگر هیچ زیرپروژه‌ای روی
آزمون‌ها وجود نداشته باشد، هیچ چیز اضافی چاپ نمی‌شود.
.sp
بخش Label and Subproject Summary را ببینید\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-test\-dir <path\-to\-build>
افزوده‌شده در نسخه 3.20.

.sp
مشخص کردن دایرکتوری مورد جستجو برای آزمون‌ها، که معمولاً دایرکتوری ساخت
یک پروژه CMake است. در صورت مشخص نشدن، از دایرکتوری جاری استفاده می‌شود.
همچنین \fB\-\-build\-dir\fP را ببینید\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-test\-output\-size\-passed <size>
افزوده‌شده در نسخه 3.4.

.sp
محدود کردن اندازه خروجی آزمون‌های موفق به \fB<size>\fP بایت.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-test\-output\-size\-failed <size>
افزوده‌شده در نسخه 3.4.

.sp
محدود کردن اندازه خروجی آزمون‌های شکست‌خورده به \fB<size>\fP بایت.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-test\-output\-truncation <mode>
افزوده‌شده در نسخه 3.24.

.sp
کوتاه‌سازی و برش بخش پایانی (\fBtail\fP، پیش‌فرض)، میانی (\fBmiddle\fP) یا ابتدایی (\fBhead\fP) خروجی آزمون
به محض رسیدن به حداکثر اندازه مجاز خروجی.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-overwrite <option\-name>
بازنویسی گزینه پیکربندی CTest.
.sp
به طور پیش‌فرض، CTest از گزینه‌های پیکربندی موجود در فایل پیکربندی استفاده می‌کند.
این گزینه مقدار گزینه پیکربندی را بازنویسی خواهد کرد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-force\-new\-ctest\-process
نادیده گرفته می‌شود\&. این گزینه در گذشته بهینه‌سازی مربوط به آزمون‌هایی را که خود
\fBctest\fP را اجرا می‌کردند و اکنون حذف شده است غیرفعال می‌کرد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-schedule\-random
استفاده از ترتیبی تصادفی برای زمان‌بندی اجرای آزمون‌ها.
.sp
این گزینه آزمون‌ها را با ترتیبی تصادفی اجرا می‌کند. این قابلیت معمولاً
برای شناسایی وابستگی‌های پنهان و ضمنی در یک مجموعه آزمون استفاده می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-schedule\-random\-seed <seed>
افزوده‌شده در نسخه 4.1.

.sp
بازنویسی بذر (seed) مربوط به ترتیب تصادفی.
.sp
این گزینه برای امکان بازتولید شکست‌های ناشی از
ترتیب تصادفی اجرا توسط \fB\-\-schedule\-random\fP استفاده می‌شود\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-submit\-index <index>
گزینه قدیمی برای قابلیت سرور پیشخوان قدیمی Dart2.
استفاده نکنید.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-timeout <seconds>
تنظیم مهلت زمانی (timeout) پیش‌فرض آزمون‌ها.
.sp
این گزینه در عمل مهلت زمانی را برای تمام آزمون‌هایی که قبلاً
از طریق ویژگی \fBTIMEOUT\fP \%<#\:prop_test:TIMEOUT>
مهلت زمانی برای آن‌ها تعیین نشده است اعمال می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-stop\-time <time>
تنظیم زمانی که در آن تمام آزمون‌ها باید متوقف شوند.
.sp
تعیین یک ساعت واقعی از شبانه‌روز که در آن زمان مهلت تمام آزمون‌ها به پایان برسد. مثال:
\fB7:00:00 \-0400\fP\&. هر فرمت زمانی قابل فهم برای تجزیه‌کننده تاریخ curl
پذیرفته می‌شود. در صورت عدم تعیین منطقه زمانی، زمان محلی فرض خواهد شد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-print\-labels
چاپ تمام برچسب‌های آزمون موجود.
.sp
این گزینه هیچ آزمونی را اجرا نخواهد کرد، بلکه صرفاً فهرست تمام
برچسب‌های مرتبط با مجموعه آزمون را چاپ می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-tests=<action>
تعیین رفتار سیستم در زمانی که هیچ آزمونی اجرا نمی‌شود؛ برای نمونه هنگامی که
\fBCTestTestfile.cmake\fP هیچ آزمونی تعریف نکرده است، یا وقتی آرگومان‌های داده‌شده
همه آزمون‌ها را مستثنی کرده‌اند. مقدار \fB<action>\fP می‌تواند یکی از موارد زیر باشد:
.INDENT 7.0
.TP
.B \fBerror\fP
اجرا نشدن هیچ آزمونی را به عنوان یک خطا در نظر بگیرد.
.sp
این حالت در هنگام اجرای اسکریپت‌های \fBctest \-S\fP حالت پیش‌فرض است.
.TP
.B \fBignore\fP
اجرا نشدن هیچ آزمونی را عادی تلقی کند.
.sp
این حالت در هنگام اجرای آزمون‌ها از طریق خط فرمان
\fBctest\fP، حتی در هنگام اجرا به عنوان
کلاینت پیشخوان (dashboard client)، حالت پیش‌فرض است\&.
.UNINDENT
.sp
افزوده‌شده در نسخه 3.26.

.sp
این گزینه می‌تواند با تنظیم متغیر محیطی
\fBCTEST_NO_TESTS_ACTION\fP \%<#\:envvar:CTEST_NO_TESTS_ACTION>
نیز تعیین شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-collect\-instrumentation <build>
افزوده‌شده در نسخه 4.0.

.sp
جمع‌آوری دستی داده‌های سنجش (instrumentation) از دایرکتوری ساخت مشخص‌شده. برای
جزئیات بیشتر، بخش Indexing \%<#\:cmake-instrumentation-indexing> از سنجش CMake را
ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B \-\- <test\-args>...
افزوده‌شده در نسخه 4.4.

.sp
ارسال آرگومان‌های اضافی به فایل‌های اجرایی آزمون.
.sp
تمام آرگومان‌های پس از \fB\-\-\fP به انتهای خط فرمان هر آزمون
اجراشده الحاق می‌شوند. این ویژگی برای ارسال گزینه‌ها به چارچوب‌های آزمون
مانند Google Test یا doctest مفید است. برای مثال:
.INDENT 7.0
.INDENT 3.5
.sp
.EX
ctest \-R my_test \-\- \-\-gtest_filter=SomeTest.Case
ctest \-\-verbose \-\- \-\-success
.EE
.UNINDENT
.UNINDENT
.sp
تمام آزمون‌های انتخاب‌شده آرگومان‌های اضافی یکسانی دریافت می‌کنند.
از \fB\-R\fP یا \fB\-L\fP برای محدود کردن
آزمون‌های اجرایی استفاده کنید.
.sp
یک \fB\-\-\fP به تنهایی و بدون آرگومان‌های پس از آن، بدون هشدار نادیده گرفته می‌شود.
.sp
هنگامی که هر دو مورد \fB<test\-args>\fP و
\fBtestPassthroughArguments\fP \%<#\:cmakepresets-testpresets-execution-testpassthrougharguments> ارائه شوند،
آرگومان‌های پیش‌تنظیم آزمون ابتدا قرار می‌گیرند و پس از آن‌ها \fB<test\-args>\fP می‌آیند\&.
.UNINDENT
.SH "مشاهده راهنما (VIEW HELP)"
.sp
برای چاپ جزئیات نسخه یا صفحات برگزیده‌ای از مستندات CMake،
از یکی از گزینه‌های زیر استفاده کنید:
.INDENT 0.0
.TP
.B \-version[=json\-v1] [<file>], \-\-version[=json\-v1] [<file>], /V[=json\-v1] [<file>], /version[=json\-v1] [<file>]
بنر نام و نسخه برنامه را نمایش داده و خارج می‌شود. اگر \fBjson\-v1\fP
مشخص شده باشد، اطلاعات تفصیلی نسخه را در قالب JSON چاپ می‌کند.
خروجی JSON حاوی نسخه‌های CMake و وابستگی‌های آن
است.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.sp
قالب خروجی JSON به شکل خوانا برای ماشین در
\fBthis JSON schema\fP\& توصیف شده است.
.UNINDENT
.INDENT 0.0
.TP
.B \-h, \-H, \-\-help, \-help, \-usage, /?
اطلاعات نحوه استفاده را چاپ کرده و خارج می‌شود.
.sp
نحوه استفاده، رابط خط فرمان پایه و گزینه‌های آن را شرح می‌دهد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help <keyword> [<file>]
راهنما را برای یک کلیدواژه CMake چاپ می‌کند.
.sp
کلیدواژه \fB<keyword>\fP می‌تواند یک ویژگی (property)، متغیر، دستور، خط‌مشی (policy)، تولیدکننده (generator)
یا ماژول باشد.
.sp
مدخل مربوطه در کتابچه راهنما برای \fB<keyword>\fP در
یک قالب متنی خوانا برای انسان چاپ می‌شود.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.sp
تغییریافته در نسخه 3.28: پیش از CMake 3.28، این گزینه تنها از نام دستورات پشتیبانی می‌کرد.

.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-full [<file>]
تمام کتابچه‌های راهنما را چاپ کرده و خارج می‌شود.
.sp
تمام کتابچه‌های راهنما در یک قالب متنی خوانا برای انسان چاپ می‌شوند.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-manual <man> [<file>]
یک کتابچه راهنما را چاپ کرده و خارج می‌شود.
.sp
کتابچه راهنمای مشخص‌شده در یک قالب متنی خوانا برای انسان چاپ می‌شود.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-manual\-list [<file>]
کتابچه‌های راهنمای موجود را فهرست کرده و خارج می‌شود.
.sp
این فهرست شامل تمام کتابچه‌های راهنمایی است که می‌توان با استفاده
از گزینه \fB\-\-help\-manual\fP همراه با نام کتابچه به راهنمای آن‌ها دست یافت.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-command <cmd> [<file>]
راهنما را برای یک دستور چاپ کرده و خارج می‌شود.
.sp
مدخل کتابچه راهنمای \fBcmake\-commands(7)\fP \%<#\:manual:cmake-commands(7)> برای \fB<cmd>\fP در
یک قالب متنی خوانا برای انسان چاپ می‌شود.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-command\-list [<file>]
دستوراتی را که راهنمای آن‌ها موجود است فهرست کرده و خارج می‌شود.
.sp
این فهرست شامل تمام دستوراتی است که می‌توان با استفاده
از گزینه \fB\-\-help\-command\fP همراه با نام دستور به راهنمای آن‌ها دست یافت.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-commands [<file>]
کتابچه راهنمای cmake\-commands را چاپ کرده و خارج می‌شود.
.sp
کتابچه راهنمای \fBcmake\-commands(7)\fP \%<#\:manual:cmake-commands(7)> در یک
قالب متنی خوانا برای انسان چاپ می‌شود.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-module <mod> [<file>]
راهنما را برای یک ماژول چاپ کرده و خارج می‌شود.
.sp
مدخل کتابچه راهنمای \fBcmake\-modules(7)\fP \%<#\:manual:cmake-modules(7)> برای \fB<mod>\fP در
یک قالب متنی خوانا برای انسان چاپ می‌شود.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-module\-list [<file>]
ماژول‌هایی را که راهنمای آن‌ها موجود است فهرست کرده و خارج می‌شود.
.sp
این فهرست شامل تمام ماژول‌هایی است که می‌توان با استفاده
از گزینه \fB\-\-help\-module\fP همراه با نام ماژول به راهنمای آن‌ها دست یافت.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-modules [<file>]
کتابچه راهنمای cmake\-modules را چاپ کرده و خارج می‌شود.
.sp
کتابچه راهنمای \fBcmake\-modules(7)\fP \%<#\:manual:cmake-modules(7)> در یک قالب متنی خوانا
برای انسان چاپ می‌شود.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-policy <cmp> [<file>]
راهنما را برای یک خط‌مشی چاپ کرده و خارج می‌شود.
.sp
مدخل کتابچه راهنمای \fBcmake\-policies(7)\fP \%<#\:manual:cmake-policies(7)> برای \fB<cmp>\fP در
یک قالب متنی خوانا برای انسان چاپ می‌شود.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-policy\-list [<file>]
خط‌مشی‌هایی را که راهنمای آن‌ها موجود است فهرست کرده و خارج می‌شود.
.sp
این فهرست شامل تمام خط‌مشی‌هایی است که می‌توان با استفاده
از گزینه \fB\-\-help\-policy\fP همراه با نام خط‌مشی به راهنمای آن‌ها دست یافت.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-policies [<file>]
کتابچه راهنمای cmake\-policies را چاپ کرده و خارج می‌شود.
.sp
کتابچه راهنمای \fBcmake\-policies(7)\fP \%<#\:manual:cmake-policies(7)> در
یک قالب متنی خوانا برای انسان چاپ می‌شود.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-property <prop> [<file>]
راهنما را برای یک ویژگی چاپ کرده و خارج می‌شود.
.sp
مدخل‌های کتابچه راهنمای \fBcmake\-properties(7)\fP \%<#\:manual:cmake-properties(7)> برای \fB<prop>\fP در
یک قالب متنی خوانا برای انسان چاپ می‌شوند.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-property\-list [<file>]
ویژگی‌هایی را که راهنمای آن‌ها موجود است فهرست کرده و خارج می‌شود.
.sp
این فهرست شامل تمام ویژگی‌هایی است که می‌توان با استفاده
از گزینه \fB\-\-help\-property\fP همراه با نام ویژگی به راهنمای آن‌ها دست یافت.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-properties [<file>]
کتابچه راهنمای cmake\-properties را چاپ کرده و خارج می‌شود.
.sp
کتابچه راهنمای \fBcmake\-properties(7)\fP \%<#\:manual:cmake-properties(7)> در
یک قالب متنی خوانا برای انسان چاپ می‌شود.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-variable <var> [<file>]
راهنما را برای یک متغیر چاپ کرده و خارج می‌شود.
.sp
مدخل کتابچه راهنمای \fBcmake\-variables(7)\fP \%<#\:manual:cmake-variables(7)> برای \fB<var>\fP در
یک قالب متنی خوانا برای انسان چاپ می‌شود.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-variable\-list [<file>]
متغیرهایی را که راهنمای آن‌ها موجود است فهرست کرده و خارج می‌شود.
.sp
این فهرست شامل تمام متغیرهایی است که می‌توان با استفاده
از گزینه \fB\-\-help\-variable\fP همراه با نام متغیر به راهنمای آن‌ها دست یافت.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-help\-variables [<file>]
کتابچه راهنمای cmake\-variables را چاپ کرده و خارج می‌شود.
.sp
کتابچه راهنمای \fBcmake\-variables(7)\fP \%<#\:manual:cmake-variables(7)> در
یک قالب متنی خوانا برای انسان چاپ می‌شود.
در صورت ارائه نام \fB<file>\fP، خروجی در آن نوشته می‌شود.
.UNINDENT
.SH "تطبیق برچسب‌ها (LABEL MATCHING)"
.sp
آزمون‌ها می‌توانند برچسب‌هایی پیوست خود داشته باشند. می‌توان آزمون‌ها را با
پالایش (فیلتر کردن) بر اساس برچسب‌ها، در یک اجرای آزمون گنجاند یا از آن مستثنی کرد.
هر فیلتر جداگانه یک عبارت باقاعده (regular expression) است که بر روی
برچسب‌های متصل به یک آزمون اعمال می‌شود.
.sp
هنگامی که \fB\-L\fP استفاده می‌شود، برای اینکه یک آزمون در یک اجرای آزمون
گنجانده شود، هر عبارت باقاعده باید حداقل با یک برچسب مطابقت داشته باشد. استفاده از بیش از
یک گزینه \fB\-L\fP به معنای \(dqتطبیق با \fBهمه\fP این موارد\(dq است.
.sp
گزینه \fB\-LE\fP دقیقاً مانند \fB\-L\fP عمل می‌کند،
اما آزمون‌ها را به جای گنجاندن، مستثنی می‌کند. یک آزمون در صورتی مستثنی می‌شود که هر
عبارت باقاعده با حداقل یک برچسب مطابقت داشته باشد.
.sp
اگر آزمونی هیچ برچسبی متصل به خود نداشته باشد، آن‌گاه \fB\-L\fP هرگز
آن آزمون را شامل نخواهد شد، و \fB\-LE\fP نیز هرگز آن آزمون را مستثنی نخواهد کرد.
به عنوان مثالی از آزمون‌های دارای برچسب، پنج آزمون را
با برچسب‌های زیر در نظر بگیرید:
.INDENT 0.0
.IP \(bu 2
آزمون \fItest1\fP دارای برچسب‌های \fItuesday\fP و \fIproduction\fP است
.IP \(bu 2
آزمون \fItest2\fP دارای برچسب‌های \fItuesday\fP و \fItest\fP است
.IP \(bu 2
آزمون \fItest3\fP دارای برچسب‌های \fIwednesday\fP و \fIproduction\fP است
.IP \(bu 2
آزمون \fItest4\fP دارای برچسب \fIwednesday\fP است
.IP \(bu 2
آزمون \fItest5\fP دارای برچسب‌های \fIfriday\fP و \fItest\fP است
.UNINDENT
.sp
اجرای \fBctest\fP با \fB\-L tuesday \-L test\fP آزمون \fItest2\fP را انتخاب خواهد کرد که
هر دو برچسب را دارد. اجرای CTest با \fB\-L test\fP آزمون‌های \fItest2\fP و
\fItest5\fP را انتخاب می‌کند، زیرا هر دوی آن‌ها برچسبی دارند که با آن عبارت
باقاعده مطابقت دارد.
.sp
از آنجا که تطبیق با عبارات باقاعده کار می‌کند، توجه داشته باشید که
اجرای CTest با \fB\-L es\fP با هر پنج آزمون تطابق خواهد داشت.
برای انتخاب آزمون‌های \fItuesday\fP و \fIwednesday\fP به همراه یکدیگر، از یک عبارت
باقاعده منفرد استفاده کنید که با هر یک از آن‌ها تطابق داشته باشد، مانند \fB\-L \(dqtue|wed\(dq\fP\&.
.SH "خلاصه برچسب‌ها و زیرپروژه‌ها (LABEL AND SUBPROJECT SUMMARY)"
.sp
ابزار CTest اطلاعات خلاصه زمان‌بندی را برای هر \fBLABEL\fP و زیرپروژه مرتبط با
آزمون‌های اجراشده چاپ می‌کند. خلاصه زمان برچسب شامل برچسب‌هایی که به زیرپروژه‌ها
نگاشت شده‌اند نخواهد بود.
.sp
افزوده‌شده در نسخه 3.22: برچسب‌هایی که به صورت پویا در طول اجرای آزمون اضافه می‌شوند نیز در
خلاصه زمان‌بندی گزارش می‌شوند. بخش Additional Labels \%<#\:additional-labels>\& را ببینید.

.sp
هنگامی که ویژگی آزمون \fBPROCESSORS\fP \%<#\:prop_test:PROCESSORS> تنظیم شده باشد، CTest یک نتیجه
زمان‌بندی وزنی آزمون را در خلاصه برچسب‌ها و زیرپروژه‌ها نمایش می‌دهد. زمان به جای
تنها \fBsec\fP، با \fBsec * proc\fP گزارش می‌شود.
.sp
خلاصه زمان وزن‌دار گزارش‌شده برای هر برچسب یا زیرپروژه \fBj\fP
به صورت زیر محاسبه می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Weighted Time Summary for Label/Subproject j =
    sum(raw_test_time[j,i] * num_processors[j,i], i=1...num_tests[j])

for labels/subprojects j=1...total
.EE
.UNINDENT
.UNINDENT
.sp
که در آن:
.INDENT 0.0
.IP \(bu 2
\fBraw_test_time[j,i]\fP: زمان واقعی (Wall\-clock time) برای آزمون \fBi\fP
مربوط به برچسب یا زیرپروژه \fBj\fP
.IP \(bu 2
\fBnum_processors[j,i]\fP: مقدار ویژگی \fBPROCESSORS\fP \%<#\:prop_test:PROCESSORS> در CTest
برای آزمون \fBi\fP مربوط به برچسب یا زیرپروژه \fBj\fP
.IP \(bu 2
\fBnum_tests[j]\fP: تعداد آزمون‌های مرتبط با برچسب یا زیرپروژه \fBj\fP
.IP \(bu 2
\fBtotal\fP: تعداد کل برچسب‌ها یا زیرپروژه‌هایی که حداقل یک آزمون اجراشده دارند
.UNINDENT
.sp
بنابراین، خلاصه زمان وزن‌دار برای هر برچسب یا زیرپروژه نشان‌دهنده مدت زمانی
است که CTest به اجرای آزمون‌های هر برچسب یا زیرپروژه اختصاص داده است و
نمایش مناسبی از هزینه کل آزمون‌ها برای هر برچسب یا زیرپروژه در مقایسه با
سایر برچسب‌ها یا زیرپروژه‌ها ارائه می‌دهد.
.sp
به عنوان مثال، اگر \fBSubprojectA\fP مقدار \fB100 sec*proc\fP و \fBSubprojectB\fP مقدار
\fB10 sec*proc\fP را نشان دهد، آن‌گاه CTest تقریباً ۱۰ برابر زمان پردازنده/هسته بیشتری را
برای اجرای آزمون‌های \fBSubprojectA\fP نسبت به \fBSubprojectB\fP اختصاص داده است (مثلاً اگر
قرار باشد تلاشی برای کاهش هزینه مجموعه آزمون برای کل پروژه صرف شود، کاهش هزینه مجموعه آزمون
برای \fBSubprojectA\fP احتمالاً تأثیر بیشتری نسبت به تلاش برای کاهش هزینه مجموعه آزمون
برای \fBSubprojectB\fP خواهد داشت).
.SH "حالت ساخت و آزمون (BUILD AND TEST MODE)"
.sp
ابزار CTest یک ساختار خط فرمانی برای پیکربندی (یعنی اجرای cmake روی آن)،
ساخت و/یا اجرای یک آزمون ارائه می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ctest \-\-build\-and\-test <path\-to\-source> <path\-to\-build>
      \-\-build\-generator <generator>
      [<options>...]
      [\-\-build\-options <opts>...]
      [\-\-test\-command <command> [<args>...]]
.EE
.UNINDENT
.UNINDENT
.sp
مراحل پیکربندی و آزمون اختیاری هستند. آرگومان‌های این خط فرمان
دایرکتوری‌های سورس و باینری هستند. برای استفاده از
\fB\-\-build\-and\-test\fP
گزینهٔ
\fB\-\-build\-generator\fP
\fIباید\fP
مشخص شود\&. اگر
\fB\-\-test\-command\fP
مشخص شده باشد، پس از اتمام ساخت اجرا خواهد شد. سایر گزینه‌هایی که بر
این حالت اثر می‌گذارند عبارتند از:
.INDENT 0.0
.TP
.B \-\-build\-and\-test <path\-to\-source> <path\-to\-build>
تغییر وضعیت به حالت ساخت و آزمون.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-build\-target <tgt>
مشخص کردن یک تارگت (هدف) مشخص برای ساخت. این گزینه می‌تواند چندین بار
با اهداف مختلف مشخص شود، که در این حالت هر هدف به نوبت ساخته می‌شود.
قبل از ساخت هر هدف، یک پاکسازی انجام خواهد شد مگر اینکه گزینهٔ
\fB\-\-build\-noclean\fP
داده شده باشد.
.sp
اگر هیچ \fB\-\-build\-target\fP مشخص نشود، تارگت \fBall\fP ساخته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-build\-nocmake
اجرای فرآیند ساخت بدون اجرای اولیهٔ \fBcmake\fP\&.
.sp
صرف‌نظر کردن از مرحلهٔ \fBcmake\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-build\-run\-dir <dir>
مشخص کردن دایرکتوری برای اجرای برنامه‌ها از داخل آن.
.sp
دایرکتوری که برنامه‌ها پس از کامپایل در آن قرار خواهند داشت.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-build\-two\-config
اجرای دو بارهٔ CMake (دو بار اجرای متوالی).
.UNINDENT
.INDENT 0.0
.TP
.B \-\-build\-exe\-dir <dir>
مشخص کردن دایرکتوری فایل اجرایی.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-build\-generator <generator\-name>
مشخص کردن ژنراتور (تولیدکننده) مورد استفاده. راهنمای \fBcmake\-generators(7)\fP \%<#\:manual:cmake-generators(7)> را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-build\-generator\-platform <platform\-name>
مشخص کردن پلتفرم ویژهٔ ژنراتور.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-build\-generator\-toolset <toolset\-name>
مشخص کردن جعبه‌ابزار (toolset) ویژهٔ ژنراتور.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-build\-project <project\-name>
مشخص کردن نام پروژه‌ای که باید ساخته شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-build\-makeprogram <program\-name>
مشخص کردن برنامهٔ make صریح برای استفاده توسط CMake هنگام پیکربندی و
ساخت پروژه. این گزینه تنها برای ژنراتورهای Makefile \%<#\:makefile-generators> و
ژنراتورهای Ninja \%<#\:ninja-generators> کاربرد دارد\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-build\-noclean
صرف‌نظر کردن از مرحلهٔ make clean.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-build\-config\-sample <exe\-name>
یک فایل اجرایی نمونه برای استفاده در تعیین پیکربندی مورد نظر
(مانند \fBDebug\fP، \fBRelease\fP و غیره).
.UNINDENT
.INDENT 0.0
.TP
.B \-\-build\-options [<options>...]
گزینه‌های اضافی برای پیکربندی فرآیند ساخت (یعنی برای \fBcmake(1)\fP \%<#\:manual:cmake(1)>،
نه برای ابزار ساخت). توجه داشته باشید که در صورت مشخص شدن، کلمهٔ کلیدی
\fB\-\-build\-options\fP و آرگومان‌های آن باید آخرین گزینهٔ ارائه‌شده
در خط فرمان باشند، به استثنای احتمالی
\fB\-\-test\-command\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-test\-command <command>
دستوری که باید به عنوان مرحلهٔ آزمون همراه با گزینهٔ
\fB\-\-build\-and\-test\fP اجرا شود.
تمامی آرگومان‌های بعد از این کلمهٔ کلیدی به عنوان بخشی از خط فرمان دستور آزمون
در نظر گرفته خواهند شد، بنابراین باید آخرین گزینهٔ ارائه‌شده باشد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-test\-timeout <timeout>
محدودیت زمانی بر حسب ثانیه.
.UNINDENT
.SH "کلاینت داشبورد (DASHBOARD CLIENT)"
.sp
ابزار CTest می‌تواند به عنوان یک کلاینت برای برنامهٔ داشبورد کیفیت نرم‌افزار CDash \%<https://\:www\:.cdash\:.org>
عمل کند. ابزار CTest در نقش کلاینت داشبورد، دنباله‌ای از مراحل را برای
پیکربندی، ساخت و آزمون نرم‌افزار انجام می‌دهد و سپس نتایج را به یک سرور
CDash \%<https://\:www\:.cdash\:.org> ارسال می‌کند. ساختار خط فرمانی مورد استفاده برای ارسال به CDash \%<https://\:www\:.cdash\:.org> عبارت است از:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ctest \-D <dashboard>         [\-\- <dashboard\-options>...]
ctest \-M <model> \-T <action> [\-\- <dashboard\-options>...]
ctest \-S <script>            [\-\- <dashboard\-options>...]
ctest \-SP <script>           [\-\- <dashboard\-options>...]
.EE
.UNINDENT
.UNINDENT
.sp
گزینه‌های کلاینت داشبورد شامل موارد زیر است:
.INDENT 0.0
.TP
.B \-D <dashboard>, \-\-dashboard <dashboard>
اجرای آزمون داشبورد.
.sp
این گزینه به CTest اعلام می‌کند که به عنوان کلاینت CDash عمل کرده و یک
آزمون داشبورد را انجام دهد. تمامی آزمون‌ها به صورت \fB<Mode><Test>\fP هستند، که در آن \fB<Mode>\fP می‌تواند
\fBExperimental\fP، \fBNightly\fP و \fBContinuous\fP باشد، و \fB<Test>\fP می‌تواند
\fBStart\fP، \fBUpdate\fP، \fBConfigure\fP، \fBBuild\fP، \fBTest\fP،
\fBCoverage\fP و \fBSubmit\fP باشد\&.
.sp
اگر \fB<dashboard>\fP یکی از مقادیر شناخته‌شدهٔ \fB<Mode><Test>\fP نباشد،
به جای آن به عنوان تعریف یک متغیر در نظر گرفته خواهد شد (بخش dashboard\-options در ادامه را ببینید).
.UNINDENT
.INDENT 0.0
.TP
.B \-M <model>, \-\-test\-model <model>
تنظیم مدل برای یک داشبورد.
.sp
این گزینه به CTest اعلام می‌کند که به عنوان کلاینت CDash عمل کند که در آن \fB<model>\fP
می‌تواند \fBExperimental\fP، \fBNightly\fP و \fBContinuous\fP باشد\&.
ترکیب کردن \fB\-M\fP و \fB\-T\fP مشابه \fB\-D\fP است\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-T <action>, \-\-test\-action <action>
تنظیم اقدام (action) داشبورد برای اجرا.
.sp
این گزینه به CTest اعلام می‌کند که به عنوان کلاینت CDash عمل کرده و اقدامی مانند
\fBstart\fP، \fBbuild\fP، \fBtest\fP و غیره را انجام دهد. برای فهرست کامل اقدامات، بخش
«مراحل کلاینت داشبورد» را ببینید.
ترکیب کردن \fB\-M\fP و \fB\-T\fP مشابه \fB\-D\fP است\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-S <script>, \-\-script <script>
اجرای یک داشبورد برای یک پیکربندی.
.sp
این گزینه به CTest اعلام می‌کند که یک اسکریپت پیکربندی را بارگذاری کند که
تعدادی از پارامترها مانند دایرکتوری‌های باینری و سورس را مقداردهی می‌کند.
سپس CTest اقدامات لازم را برای ایجاد و اجرای یک داشبورد انجام خواهد داد.
این گزینه اساساً یک داشبورد را برپا می‌کند و سپس \fBctest \-D\fP را با
گزینه‌های مناسب اجرا می‌نماید.
.UNINDENT
.INDENT 0.0
.TP
.B \-SP <script>, \-\-script\-new\-process <script>
اجرای یک داشبورد برای یک پیکربندی.
.sp
این گزینه همان عملیات \fB\-S\fP را انجام می‌دهد اما آن را
در یک پردازش جداگانه انجام خواهد داد. این گزینه در درجهٔ اول در مواردی مفید است که
اسکریپت ممکن است متغیرهای محیطی را تغییر دهد و شما نمی‌خواهید این محیطِ
تغییریافته بر سایر اسکریپت‌های \fB\-S\fP تأثیر بگذارد.
.UNINDENT
.sp
گزینه‌های \fB<dashboard\-options>\fP موجود شامل موارد زیر است:
.INDENT 0.0
.TP
.B \-D <var>:<type>=<value>, \-D <var>=<value>
تعریف یک متغیر برای حالت کلاینت داشبورد.
.sp
ارسال مقادیر متغیرها از طریق خط فرمان. در ترکیب با
\fB\-S\fP برای ارسال مقادیر متغیرها به یک اسکریپت داشبورد، یا با
\fB\-T\fP برای بازنویسی تنظیمات پیکربندی کلاینت داشبورد استفاده می‌شود.
تجزیهٔ آرگومان‌های \fB\-D\fP به عنوان مقادیر متغیر تنها در صورتی بررسی می‌شود که مقدارِ
پس از \fB\-D\fP با هیچ‌یک از انواع شناخته‌شدهٔ داشبورد مطابقت نداشته باشد.
.sp
قالب \fB<var>:<type>=<value>\fP هر نام متغیری را می‌پذیرد. قالب ساده‌ترِ
\fB<var>=<value>\fP (بدون تعیین نوع) تنها برای متغیرهایی پذیرفته می‌شود که
نام آن‌ها با \fBCTEST_\fP آغاز شود\&. در هر دو حالت، هنگام استفاده از \fB\-T\fP، این مقدار
تنظیمات متناظر را از فایل پیکربندی کلاینت داشبورد
(مانند \fBDartConfiguration.tcl\fP) بازنویسی می‌کند\&.
.sp
\fBنکته:\fP
.INDENT 7.0
.INDENT 3.5
این تعاریف، متغیرهای اسکریپت CTest را مقداردهی می‌کنند
(مانند \fBCTEST_BUILD_NAME\fP \%<#\:variable:CTEST_BUILD_NAME>)، نه متغیرهای کش CMake را.
برای ارسال متغیرهای کش CMake به مرحلهٔ پیکربندی، استفاده از یک
اسکریپت CTest، یک \fBconfigure preset\fP \%<#\:manual:cmake-presets(7)>، یا
تنظیم \fBCTEST_CONFIGURE_COMMAND\fP \%<#\:variable:CTEST_CONFIGURE_COMMAND> را در نظر بگیرید\&.
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-source\-dir <path\-to\-source>
افزوده‌شده در نسخهٔ 4.4.

.sp
مشخص کردن دایرکتوری سورس پروژه. در صورت ترکیب با
\fB\-T Configure\fP، به CTest اجازه می‌دهد تا یک مرحلهٔ پیکربندی اولیه
را برای یک دایرکتوری باینری خالی انجام دهد. دایرکتوری باینری به طور پیش‌فرض
روی دایرکتوری کاری جاری تنظیم است؛ از \fB\-\-build\-dir\fP برای
مشخص کردن مکانی دیگر استفاده کنید. اگر دایرکتوری باینری هنوز وجود نداشته باشد،
به طور خودکار ایجاد می‌شود.
.sp
هنگامی که یک \fBconfigure preset\fP \%<#\:manual:cmake-presets(7)> مشخص شود که
ویژگی \fBbinaryDir\fP \%<#\:cmakepresets-configurepresets-binarydir> را تعریف کرده باشد، CTest به طور خودکار
از آن مسیر به عنوان دایرکتوری باینری استفاده می‌کند (بدون نیاز به
\fB\-\-build\-dir\fP). یک گزینهٔ صریح
\fB\-\-build\-dir\fP بر مقدار
\fBbinaryDir\fP \%<#\:cmakepresets-configurepresets-binarydir> در پیش‌تنظیم اولویت دارد\&.
.sp
یک تولیدکنندهٔ CMake نیز باید مشخص شود. از
\fB\-D CTEST_CMAKE_GENERATOR=<gen>\fP برای معرفی آن استفاده کنید،
یا \fBCTEST_CONFIGURE_PRESET\fP \%<#\:variable:CTEST_CONFIGURE_PRESET> را برای تعیین یک
\fBconfigure preset\fP \%<#\:manual:cmake-presets(7)> تنظیم نمایید که شامل یک
\fBgenerator\fP \%<#\:cmakepresets-configurepresets-generator> باشد\&.
.sp
برای جزئیات بیشتر، تنظیمات مرحلهٔ CTest Configure را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-build\-dir <path\-to\-build>
افزوده‌شده در نسخهٔ 4.4.

.sp
مشخص کردن دایرکتوری باینری (ساخت) پروژه. این یک نام مستعار برای
\fB\-\-test\-dir\fP است که برای استفاده به همراه
\fB\-\-source\-dir\fP هنگام راه‌اندازی اولیهٔ فرآیند ساخت با
\fB\-T Configure\fP در نظر گرفته شده است\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-group <group>
مشخص کردن گروهی که نتایج باید به آن ارسال شوند.
.sp
ارسال داشبورد به گروه مشخص‌شده به جای گروه پیش‌فرض. به طور
پیش‌فرض، داشبورد به گروه Nightly، Experimental یا
Continuous ارسال می‌شود، اما با تعیین این گزینه، گروه می‌تواند
دلخواه باشد.
.sp
این گزینه جایگزین گزینهٔ منسوخ‌شدهٔ \fB\-\-track\fP می‌شود\&.
علیرغم تغییر نام، رفتار آن بدون تغییر باقی مانده است.
.UNINDENT
.INDENT 0.0
.TP
.B \-A <file>, \-\-add\-notes <file>
افزودن یک فایل یادداشت به همراه ارسال.
.sp
این گزینه به CTest اعلام می‌کند که هنگام ارسال داشبورد، یک فایل یادداشت
را نیز ضمیمه کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-tomorrow\-tag
شروع آزمون‌های \fBNightly\fP یا \fBExperimental\fP با برچسب روز بعد.
.sp
این گزینه زمانی مفید است که فرآیند ساخت در یک روز به پایان نرسد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-extra\-submit <file>[;<file>]
ارسال فایل‌های پارت \fB\&.xml\fP اضافی به داشبورد.
گزینهٔ \fBPARTS ExtraFiles\fP در دستور \fBctest_submit()\fP \%<#\:command:ctest_submit> را ببینید.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-http\-header <header>
افزوده‌شده در نسخهٔ 3.29.

.sp
پیوست کردن هدر HTTP هنگام ارسال به داشبورد.
.sp
این گزینه باعث می‌شود CTest هدر مشخص‌شده را هنگام
ارسال به داشبورد پیوست کند.
این گزینه می‌تواند بیش از یک بار مشخص شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-http1.0
ارسال با استفاده از \fBHTTP 1.0\fP\&.
.sp
این گزینه CTest را ملزم می‌کند تا به جای \fBHTTP 1.1\fP، از \fBHTTP 1.0\fP
برای ارسال فایل‌ها به داشبورد استفاده کند\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-compress\-output
عدم فشرده‌سازی خروجی آزمون هنگام ارسال.
.sp
این فلگ فشرده‌سازی خودکار خروجی آزمون را غیرفعال می‌کند. از این گزینه
برای حفظ سازگاری با نسخه‌های قدیمی‌تر CDash که از خروجی
فشرده‌شدهٔ آزمون پشتیبانی نمی‌کنند استفاده کنید.
.UNINDENT
.SS "مراحل کلاینت داشبورد (Dashboard Client Steps)"
.sp
ابزار CTest یک فهرست ترتیبی از مراحل آزمون را تعریف می‌کند که ممکن است
برخی یا همهٔ آن‌ها به عنوان کلاینت داشبورد اجرا شوند:
.INDENT 0.0
.TP
.B \fBStart\fP
آغاز یک ارسال داشبورد جدید که از نتایج ثبت‌شده توسط
مراحل بعدی تشکیل خواهد شد.
بخش «مرحلهٔ CTest Start» در ادامه را ببینید.
.TP
.B \fBUpdate\fP
به‌روزرسانی درخت سورس از مخزن سیستم کنترل نسخهٔ آن.
ثبت نسخه‌های قدیمی و جدید و فهرست فایل‌های سورس به‌روزرسانی‌شده.
بخش «مرحلهٔ CTest Update» در ادامه را ببینید.
.TP
.B \fBConfigure\fP
پیکربندی نرم‌افزار با اجرای یک دستور در درخت ساخت.
ثبت گزارش خروجی پیکربندی.
بخش «مرحلهٔ CTest Configure» در ادامه را ببینید.
.TP
.B \fBBuild\fP
ساخت نرم‌افزار با اجرای یک دستور در درخت ساخت.
ثبت گزارش خروجی ساخت و شناسایی هشدارها و خطاها.
بخش «مرحلهٔ CTest Build» در ادامه را ببینید.
.TP
.B \fBTest\fP
آزمون نرم‌افزار با بارگذاری یک فایل \fBCTestTestfile.cmake\fP
از درخت ساخت و اجرای آزمون‌های تعریف‌شده.
ثبت خروجی و نتیجهٔ هر آزمون.
بخش «مرحلهٔ CTest Test» در ادامه را ببینید.
.TP
.B \fBCoverage\fP
محاسبهٔ پوشش کد منبع با اجرای یک ابزار تحلیل
پوشش و ثبت خروجی آن.
بخش «مرحلهٔ CTest Coverage» در ادامه را ببینید.
.TP
.B \fBMemCheck\fP
اجرای مجموعه آزمون نرم‌افزار با استفاده از یک ابزار بررسی حافظه.
ثبت خروجی آزمون، نتایج و اشکالات گزارش‌شده توسط ابزار.
بخش «مرحلهٔ CTest MemCheck» در ادامه را ببینید.
.TP
.B \fBSubmit\fP
ارسال نتایج ثبت‌شده از سایر مراحل آزمون به سرور
داشبورد کیفیت نرم‌افزار.
بخش «مرحلهٔ CTest Submit» در ادامه را ببینید.
.UNINDENT
.SS "حالت‌های کلاینت داشبورد (Dashboard Client Modes)"
.sp
ابزار CTest سه حالت عملکردی را به عنوان کلاینت داشبورد تعریف می‌کند:
.INDENT 0.0
.TP
.B \fBNightly\fP
این حالت برای فراخوانی یک بار در روز، معمولاً در طول شب، در نظر گرفته شده است.
این حالت مراحل \fBStart\fP، \fBUpdate\fP، \fBConfigure\fP، \fBBuild\fP، \fBTest\fP،
\fBCoverage\fP و \fBSubmit\fP را به طور پیش‌فرض فعال می‌کند. مراحل انتخاب‌شده حتی اگر
مرحلهٔ \fBUpdate\fP هیچ تغییری را در درخت سورس گزارش نکند، اجرا می‌شوند.
.TP
.B \fBContinuous\fP
این حالت برای فراخوانی مکرر در طول روز در نظر گرفته شده است.
این حالت مراحل \fBStart\fP، \fBUpdate\fP، \fBConfigure\fP، \fBBuild\fP، \fBTest\fP،
\fBCoverage\fP و \fBSubmit\fP را به طور پیش‌فرض فعال می‌کند، اما در صورتی که
مرحلهٔ \fBUpdate\fP هیچ تغییری را در درخت سورس گزارش نکند، پس از آن مرحله پایان می‌یابد.
.TP
.B \fBExperimental\fP
این حالت برای فراخوانی توسط توسعه‌دهنده جهت آزمودن تغییرات محلی در نظر گرفته شده است.
این حالت مراحل \fBStart\fP، \fBConfigure\fP، \fBBuild\fP، \fBTest\fP، \fBCoverage\fP
و \fBSubmit\fP را به طور پیش‌فرض فعال می‌کند.
.UNINDENT
.SS "کلاینت داشبورد از طریق خط فرمان CTest"
.sp
ابزار CTest می‌تواند فرآیند آزمون را روی یک درخت ساخت از قبل تولیدشده انجام دهد.
دستور \fBctest\fP را با تنظیم دایرکتوری کاری جاری بر روی درخت ساخت
اجرا کنید و از یکی از این ساختارها استفاده نمایید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ctest \-D <mode>[<step>]
ctest \-M <mode> [\-T <step>]...
.EE
.UNINDENT
.UNINDENT
.sp
گزینهٔ \fB\-\-source\-dir\fP علاوه بر این اجازه می‌دهد تا مرحلهٔ
\fBConfigure\fP بر روی یک درخت ساخت که هنوز وجود ندارد انجام شود،
که در این صورت گزینهٔ \fB\-\-build\-dir\fP مشخص می‌کند که در کجا
ایجاد شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ctest [\-M <mode>] \-T Configure
    \-\-source\-dir <path\-to\-source> [\-\-build\-dir <path\-to\-build>]
ctest \-\-build\-and\-test <path\-to\-source> <path\-to\-build>
.EE
.UNINDENT
.UNINDENT
.sp
مقدار \fB<mode>\fP باید یکی از «حالت‌های کلاینت داشبورد» بالا باشد،
و هر \fB<step>\fP باید یکی از «مراحل کلاینت داشبورد» فوق باشد\&.
.sp
ابزار CTest تنظیمات پیکربندی کلاینت داشبورد را از یک فایل
در درخت ساخت به نام \fBCTestConfiguration.ini\fP یا
\fBDartConfiguration.tcl\fP می‌خواند (این نام‌ها جنبهٔ تاریخی دارند). قالب
این فایل به این صورت است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# Lines starting in \(aq#\(aq are comments.
# Other non\-blank lines are key\-value pairs.
<setting>: <value>
.EE
.UNINDENT
.UNINDENT
.sp
که در آن \fB<setting>\fP نام تنظیم و \fB<value>\fP مقدار تنظیم
است.
.sp
در درخت‌های ساختی که توسط CMake تولید می‌شوند، این فایل پیکربندی توسط ماژول
\fBCTest\fP \%<#\:module:CTest> در صورت گنجانده شدن در پروژه تولید می‌شود.
این ماژول از متغیرها برای دریافت مقدار هر تنظیم مطابق با توضیحات
ارائه‌شده در بخش تنظیمات در ادامه استفاده می‌کند.
.SS "کلاینت داشبورد از طریق اسکریپت CTest"
.sp
ابزار CTest می‌تواند آزمون را با هدایت یک اسکریپت \fBcmake\-language(7)\fP \%<#\:manual:cmake-language(7)>
انجام دهد که علاوه بر اجرای مراحل آزمون، درخت‌های سورس و ساخت را ایجاد
و نگهداری می‌کند. دستور \fBctest\fP را با تنظیم دایرکتوری کاری جاری
در خارج از هرگونه درخت ساخت اجرا کرده و از یکی از این ساختارها استفاده کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ctest \-S <script>
ctest \-SP <script>
.EE
.UNINDENT
.UNINDENT
.sp
فایل \fB<script>\fP باید دستورات CTest Commands \%<#\:ctest-commands> را
فراخوانی کند تا مراحل آزمون را به صورت صریح طبق توضیحات زیر اجرا نماید. این دستورات
تنظیمات پیکربندی کلاینت داشبورد را از آرگومان‌های خود یا از متغیرهای
تعیین‌شده در اسکریپت دریافت می‌کنند.
.SH "پیکربندی کلاینت داشبورد (DASHBOARD CLIENT CONFIGURATION)"
.sp
مراحل کلاینت داشبورد را می‌توان با تنظیمات نام‌گذاری‌شده همان‌طور که در بخش‌های زیر مستند شده است، پیکربندی کرد.
.SS "مرحله شروع CTest (CTest Start Step)"
.sp
شروع یک ارسال جدید به داشبورد که متشکل از نتایج ثبت‌شده توسط مراحل زیر خواهد بود.
.sp
در یک اسکریپت CTest، دستور \fBctest_start()\fP \%<#\:command:ctest_start> این مرحله را اجرا می‌کند.
آرگومان‌های ارائه‌شده به این دستور ممکن است برخی از تنظیمات مرحله را مشخص کنند.
این دستور ابتدا خط فرمان مشخص‌شده توسط متغیر
\fBCTEST_CHECKOUT_COMMAND\fP
را (در صورت تنظیم شدن) برای مقداردهی اولیه دایرکتوری سورس اجرا می‌کند.
.sp
تنظیمات پیکربندی شامل موارد زیر است:
.INDENT 0.0
.TP
.B \fBBuildDirectory\fP
مسیر کامل به درخت ساخت پروژه.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_BINARY_DIRECTORY\fP \%<#\:variable:CTEST_BINARY_DIRECTORY>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBPROJECT_BINARY_DIR\fP \%<#\:variable:PROJECT_BINARY_DIR>
.UNINDENT
.TP
.B \fBSourceDirectory\fP
مسیر کامل به درخت سورس پروژه.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_SOURCE_DIRECTORY\fP \%<#\:variable:CTEST_SOURCE_DIRECTORY>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBPROJECT_SOURCE_DIR\fP \%<#\:variable:PROJECT_SOURCE_DIR>
.UNINDENT
.TP
.B \fBCheckoutCommand\fP
خط فرمانی که پیش از مرحله شروع برای مقداردهی اولیه دایرکتوری سورس اجرا می‌شود، مانند انجام یک دریافت اولیه (checkout) از سیستم کنترل نسخه.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_CHECKOUT_COMMAND\fP \%<#\:variable:CTEST_CHECKOUT_COMMAND>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: هیچ‌کدام (none)
.UNINDENT
.UNINDENT
.SS "مرحله به‌روزرسانی CTest (CTest Update Step)"
.sp
در یک اسکریپت CTest، دستور \fBctest_update()\fP \%<#\:command:ctest_update> این مرحله را اجرا می‌کند.
آرگومان‌های ارائه‌شده به این دستور ممکن است برخی از تنظیمات مرحله را مشخص کنند.
.sp
تنظیمات پیکربندی برای تعیین ابزار کنترل نسخه شامل موارد زیر است:
.INDENT 0.0
.TP
.B \fBBZRCommand\fP
ابزار خط فرمان \fBbzr\fP برای استفاده در صورتی که درخت سورس توسط Bazaar مدیریت می‌شود.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_BZR_COMMAND\fP \%<#\:variable:CTEST_BZR_COMMAND>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: هیچ‌کدام (none)
.UNINDENT
.TP
.B \fBBZRUpdateOptions\fP
گزینه‌های خط فرمان برای \fBBZRCommand\fP هنگام به‌روزرسانی سورس.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_BZR_UPDATE_OPTIONS\fP \%<#\:variable:CTEST_BZR_UPDATE_OPTIONS>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: هیچ‌کدام (none)
.UNINDENT
.TP
.B \fBCVSCommand\fP
ابزار خط فرمان \fBcvs\fP برای استفاده در صورتی که درخت سورس توسط CVS مدیریت می‌شود.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_CVS_COMMAND\fP \%<#\:variable:CTEST_CVS_COMMAND>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCVSCOMMAND\fP
.UNINDENT
.TP
.B \fBCVSUpdateOptions\fP
گزینه‌های خط فرمان برای \fBCVSCommand\fP هنگام به‌روزرسانی سورس.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_CVS_UPDATE_OPTIONS\fP \%<#\:variable:CTEST_CVS_UPDATE_OPTIONS>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCVS_UPDATE_OPTIONS\fP
.UNINDENT
.TP
.B \fBGITCommand\fP
ابزار خط فرمان \fBgit\fP برای استفاده در صورتی که درخت سورس توسط Git مدیریت می‌شود.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_GIT_COMMAND\fP \%<#\:variable:CTEST_GIT_COMMAND>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBGITCOMMAND\fP
.UNINDENT
.sp
درخت سورس با اجرای \fBgit fetch\fP و به دنبال آن
\fBgit reset \-\-hard\fP روی \fBFETCH_HEAD\fP\& به‌روزرسانی می‌شود. نتیجه همانند
\fBgit pull\fP است، با این تفاوت که هرگونه تغییرات محلی بازنویسی می‌شود.
از \fBGITUpdateCustom\fP برای تعیین یک رویکرد متفاوت استفاده کنید.
.TP
.B \fBGITInitSubmodules\fP
در صورت تنظیم، CTest زیرماژول‌های مخزن را پیش از به‌روزرسانی، به‌روز می‌کند.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_GIT_INIT_SUBMODULES\fP \%<#\:variable:CTEST_GIT_INIT_SUBMODULES>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCTEST_GIT_INIT_SUBMODULES\fP
.UNINDENT
.TP
.B \fBGITUpdateCustom\fP
یک خط فرمان سفارشی (به عنوان یک فهرست جداشده با نقطه\-ویرگول) را برای اجرا در درخت سورس (درخت کاری Git) به جهت به‌روزرسانی آن، به جای اجرای \fBGITCommand\fP مشخص می‌کند.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_GIT_UPDATE_CUSTOM\fP \%<#\:variable:CTEST_GIT_UPDATE_CUSTOM>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCTEST_GIT_UPDATE_CUSTOM\fP
.UNINDENT
.TP
.B \fBGITUpdateOptions\fP
گزینه‌های خط فرمان برای \fBGITCommand\fP هنگام به‌روزرسانی سورس.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_GIT_UPDATE_OPTIONS\fP \%<#\:variable:CTEST_GIT_UPDATE_OPTIONS>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBGIT_UPDATE_OPTIONS\fP
.UNINDENT
.TP
.B \fBHGCommand\fP
ابزار خط فرمان \fBhg\fP برای استفاده در صورتی که درخت سورس توسط Mercurial مدیریت می‌شود.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_HG_COMMAND\fP \%<#\:variable:CTEST_HG_COMMAND>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: هیچ‌کدام (none)
.UNINDENT
.TP
.B \fBHGUpdateOptions\fP
گزینه‌های خط فرمان برای \fBHGCommand\fP هنگام به‌روزرسانی سورس.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_HG_UPDATE_OPTIONS\fP \%<#\:variable:CTEST_HG_UPDATE_OPTIONS>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: هیچ‌کدام (none)
.UNINDENT
.TP
.B \fBP4Client\fP
مقدار گزینه \fB\-c\fP برای \fBP4Command\fP\&.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_P4_CLIENT\fP \%<#\:variable:CTEST_P4_CLIENT>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCTEST_P4_CLIENT\fP
.UNINDENT
.TP
.B \fBP4Command\fP
ابزار خط فرمان \fBp4\fP برای استفاده در صورتی که درخت سورس توسط Perforce مدیریت می‌شود.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_P4_COMMAND\fP \%<#\:variable:CTEST_P4_COMMAND>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBP4COMMAND\fP
.UNINDENT
.TP
.B \fBP4Options\fP
گزینه‌های خط فرمان برای \fBP4Command\fP برای تمام فراخوانی‌ها.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_P4_OPTIONS\fP \%<#\:variable:CTEST_P4_OPTIONS>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCTEST_P4_OPTIONS\fP
.UNINDENT
.TP
.B \fBP4UpdateCustom\fP
یک خط فرمان سفارشی (به عنوان یک فهرست جداشده با نقطه\-ویرگول) را برای اجرا در درخت سورس (درخت Perforce) به جهت به‌روزرسانی آن، به جای اجرای \fBP4Command\fP مشخص می‌کند.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: هیچ‌کدام (none)
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCTEST_P4_UPDATE_CUSTOM\fP
.UNINDENT
.TP
.B \fBP4UpdateOptions\fP
گزینه‌های خط فرمان برای \fBP4Command\fP هنگام به‌روزرسانی سورس.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_P4_UPDATE_OPTIONS\fP \%<#\:variable:CTEST_P4_UPDATE_OPTIONS>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCTEST_P4_UPDATE_OPTIONS\fP
.UNINDENT
.TP
.B \fBSVNCommand\fP
ابزار خط فرمان \fBsvn\fP برای استفاده در صورتی که درخت سورس توسط Subversion مدیریت می‌شود.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_SVN_COMMAND\fP \%<#\:variable:CTEST_SVN_COMMAND>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBSVNCOMMAND\fP
.UNINDENT
.TP
.B \fBSVNOptions\fP
گزینه‌های خط فرمان برای \fBSVNCommand\fP برای تمام فراخوانی‌ها.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_SVN_OPTIONS\fP \%<#\:variable:CTEST_SVN_OPTIONS>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCTEST_SVN_OPTIONS\fP
.UNINDENT
.TP
.B \fBSVNUpdateOptions\fP
گزینه‌های خط فرمان برای \fBSVNCommand\fP هنگام به‌روزرسانی سورس.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_SVN_UPDATE_OPTIONS\fP \%<#\:variable:CTEST_SVN_UPDATE_OPTIONS>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBSVN_UPDATE_OPTIONS\fP
.UNINDENT
.TP
.B \fBUpdateCommand\fP
ابزار خط فرمان کنترل نسخه را برای استفاده، بدون شناسایی خودکار VCS مدیریت‌کننده درخت سورس، مشخص می‌کند.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_UPDATE_COMMAND\fP \%<#\:variable:CTEST_UPDATE_COMMAND>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: هنگامی که \fBUPDATE_TYPE\fP برابر \fB<vcs>\fP باشد \fB<VCS>COMMAND\fP، وگرنه \fBUPDATE_COMMAND\fP
.UNINDENT
.TP
.B \fBUpdateOptions\fP
گزینه‌های خط فرمان برای \fBUpdateCommand\fP\&.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_UPDATE_OPTIONS\fP \%<#\:variable:CTEST_UPDATE_OPTIONS>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: هنگامی که \fBUPDATE_TYPE\fP برابر \fB<vcs>\fP باشد \fB<VCS>_UPDATE_OPTIONS\fP، وگرنه \fBUPDATE_OPTIONS\fP
.UNINDENT
.TP
.B \fBUpdateType\fP
سیستم کنترل نسخه‌ای را که درخت سورس را مدیریت می‌کند مشخص می‌کند، در صورتی که نتوان آن را به طور خودکار شناسایی کرد.
مقدار می‌تواند \fBbzr\fP، \fBcvs\fP، \fBgit\fP، \fBhg\fP،
\fBp4\fP یا \fBsvn\fP\& باشد.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: ندارد، از درخت سورس شناسایی می‌شود
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBUPDATE_TYPE\fP در صورت تنظیم شدن،
وگرنه \fBCTEST_UPDATE_TYPE\fP
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \fBUpdateVersionOnly\fP
مشخص می‌کند که می‌خواهید دستور به‌روزرسانی کنترل نسخه فقط نسخه فعلی دریافت‌شده (checkout شده) را شناسایی کند، و به نسخه متفاوتی به‌روزرسانی نکند.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_UPDATE_VERSION_ONLY\fP \%<#\:variable:CTEST_UPDATE_VERSION_ONLY>
.IP \(bu 2
گزینه \fBctest_update()\fP \%<#\:command:ctest_update>: \fBVERSION_ONLY\fP
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \fBUpdateVersionOverride\fP
نسخه فعلی درخت سورس شما را مشخص می‌کند.
.sp
هنگامی که این متغیر روی یک رشته غیرخالی تنظیم شود، CTest مقداری را که شما مشخص کرده‌اید گزارش می‌دهد، به جای این که از دستور به‌روزرسانی برای شناسایی نسخه فعلی دریافت‌شده استفاده کند. استفاده از این متغیر جایگزین
\fBUpdateVersionOnly\fP\&
می‌شود. مانند \fBUpdateVersionOnly\fP، استفاده از این متغیر به CTest اعلام می‌کند که درخت سورس را به نسخه متفاوتی به‌روز نکند.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_UPDATE_VERSION_OVERRIDE\fP \%<#\:variable:CTEST_UPDATE_VERSION_OVERRIDE>
.IP \(bu 2
گزینه \fBctest_update()\fP \%<#\:command:ctest_update>: \fBVERSION_OVERRIDE <version>\fP
.UNINDENT
.UNINDENT
.sp
تنظیمات پیکربندی اضافی شامل موارد زیر است:
.INDENT 0.0
.TP
.B \fBNightlyStartTime\fP
در حالت داشبورد \fBNightly\fP، \(dqزمان شروع شبانه\(dq را مشخص می‌کند.
در سیستم‌های کنترل نسخه متمرکز (\fBcvs\fP و \fBsvn\fP)، مرحله
\fBUpdate\fP
نسخه نرم‌افزار را تا این زمان دریافت می‌کند تا چندین کلاینت نسخه مشترکی را برای آزمون انتخاب نمایند.
این مفهوم در سیستم‌های کنترل نسخه توزیع‌شده به خوبی تعریف نشده است، بنابراین این تنظیم نادیده گرفته می‌شود.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_NIGHTLY_START_TIME\fP \%<#\:variable:CTEST_NIGHTLY_START_TIME>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBNIGHTLY_START_TIME\fP در صورت تنظیم شدن،
وگرنه \fBCTEST_NIGHTLY_START_TIME\fP
.UNINDENT
.UNINDENT
.SS "مرحله پیکربندی CTest (CTest Configure Step)"
.sp
در یک اسکریپت CTest، دستور \fBctest_configure()\fP \%<#\:command:ctest_configure> این مرحله را اجرا می‌کند.
آرگومان‌های ارائه‌شده به این دستور می‌توانند برخی از تنظیمات مرحله را مشخص کنند.
.sp
تنظیمات پیکربندی شامل موارد زیر است:
.INDENT 0.0
.TP
.B \fBConfigureCommand\fP
خط فرمانی برای راه‌اندازی فرآیند پیکربندی نرم‌افزار.
این فرمان در مکان مشخص‌شده توسط تنظیم
\fBBuildDirectory\fP
اجرا خواهد شد.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_CONFIGURE_COMMAND\fP \%<#\:variable:CTEST_CONFIGURE_COMMAND>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCMAKE_COMMAND\fP \%<#\:variable:CMAKE_COMMAND>
که پس از آن \fBPROJECT_SOURCE_DIR\fP \%<#\:variable:PROJECT_SOURCE_DIR> قرار می‌گیرد
.UNINDENT
.TP
.B \fBLabelsForSubprojects\fP
فهرستی از برچسب‌ها که با نقطه\-ویرگول از هم جدا شده‌اند و به عنوان زیرپروژه در نظر گرفته می‌شوند را مشخص می‌کند. این نگاشت هنگام ارسال نتایج پیکربندی، آزمون یا ساخت به CDash تحویل داده خواهد شد.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_LABELS_FOR_SUBPROJECTS\fP \%<#\:variable:CTEST_LABELS_FOR_SUBPROJECTS>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCTEST_LABELS_FOR_SUBPROJECTS\fP
.UNINDENT
.sp
بخش خلاصه برچسب و زیرپروژه (Label and Subproject Summary)\& را ببینید.
.TP
.B \fBCMakeGenerator\fP
تولیدکننده CMake برای استفاده در مرحله پیکربندی هنگامی که
\fBConfigureCommand\fP تنظیم نشده است.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_CMAKE_GENERATOR\fP
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: هیچ‌کدام (none)
.UNINDENT
.TP
.B \fBCMakeGeneratorPlatform\fP
سکوی تولیدکننده CMake برای استفاده در مرحله پیکربندی هنگامی که
\fBConfigureCommand\fP تنظیم نشده است.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_CMAKE_GENERATOR_PLATFORM\fP
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: هیچ‌کدام (none)
.UNINDENT
.TP
.B \fBCMakeGeneratorToolset\fP
مجموعه‌ابزار تولیدکننده CMake برای استفاده در مرحله پیکربندی هنگامی که
\fBConfigureCommand\fP تنظیم نشده است.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_CMAKE_GENERATOR_TOOLSET\fP
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: هیچ‌کدام (none)
.UNINDENT
.UNINDENT
.SS "مرحله ساخت CTest (CTest Build Step)"
.sp
در یک اسکریپت CTest، دستور \fBctest_build()\fP \%<#\:command:ctest_build> این مرحله را اجرا می‌کند.
آرگومان‌های ارائه‌شده به این دستور می‌توانند برخی از تنظیمات مرحله را مشخص کنند.
.sp
تنظیمات پیکربندی شامل موارد زیر است:
.INDENT 0.0
.TP
.B \fBDefaultCTestConfigurationType\fP
هنگامی که سیستم ساختِ فراخوانی‌شده امکان انتخاب پیکربندی در زمان ساخت (مانند \fBDebug\fP یا \fBRelease\fP) را می‌دهد، این گزینه پیکربندی پیش‌فرضی را مشخص می‌کند که در صورت عدم ارائه گزینه \fB\-C\fP به دستور \fBctest\fP ساخته خواهد شد. این مقدار در مقدار \fBMakeCommand\fP جایگزین رشته دقیق \fB${CTEST_CONFIGURATION_TYPE}\fP (در صورت وجود) می‌شود.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_CONFIGURATION_TYPE\fP \%<#\:variable:CTEST_CONFIGURATION_TYPE>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBDEFAULT_CTEST_CONFIGURATION_TYPE\fP،
که با متغیر محیطی \fBCMAKE_CONFIG_TYPE\fP \%<#\:envvar:CMAKE_CONFIG_TYPE> مقداردهی اولیه می‌شود
.UNINDENT
.TP
.B \fBLabelsForSubprojects\fP
فهرستی از برچسب‌ها که با نقطه\-ویرگول از هم جدا شده‌اند و به عنوان زیرپروژه در نظر گرفته می‌شوند را مشخص می‌کند. این نگاشت هنگام ارسال نتایج پیکربندی، آزمون یا ساخت به CDash تحویل داده خواهد شد.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_LABELS_FOR_SUBPROJECTS\fP \%<#\:variable:CTEST_LABELS_FOR_SUBPROJECTS>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCTEST_LABELS_FOR_SUBPROJECTS\fP
.UNINDENT
.sp
بخش خلاصه برچسب و زیرپروژه (Label and Subproject Summary)\& را ببینید.
.TP
.B \fBMakeCommand\fP
خط فرمانی برای راه‌اندازی فرآیند ساخت نرم‌افزار.
این فرمان در مکان مشخص‌شده توسط تنظیم
\fBBuildDirectory\fP
اجرا خواهد شد.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_BUILD_COMMAND\fP \%<#\:variable:CTEST_BUILD_COMMAND>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBMAKECOMMAND\fP،
که با دستور \fBbuild_command()\fP \%<#\:command:build_command> مقداردهی اولیه می‌شود
.UNINDENT
.TP
.B \fBUseLaunchers\fP
برای درخت‌های ساخت ایجادشده توسط CMake با استفاده از یکی از
تولیدکننده‌های Makefile \%<#\:makefile-generators> یا تولیدکننده \fBNinja\fP \%<#\:generator:Ninja>،
مشخص می‌کند که آیا ویژگی
\fBCTEST_USE_LAUNCHERS\fP توسط ماژول
\fBCTestUseLaunchers\fP \%<#\:module:CTestUseLaunchers> (که در ماژول
\fBCTest\fP \%<#\:module:CTest> نیز گنجانده شده است) فعال است یا خیر. در صورت فعال بودن، سیستم ساخت تولیدشده هر بار فراخوانی کامپایلر، پیونددهنده یا خط فرمان سفارشی را درون یک «راه‌انداز» (launcher) قرار می‌دهد که از طریق متغیرهای محیطی و فایل‌ها با CTest ارتباط برقرار می‌کند تا هشدارهای ساخت و اطلاعات خطای جزئی و تفکیک‌شده را گزارش دهد. در غیر این صورت، CTest باید لاگ خروجی ساخت را برای تحلیل و تشخیص خطاها واکشی («scrape») کند.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_USE_LAUNCHERS\fP \%<#\:variable:CTEST_USE_LAUNCHERS>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCTEST_USE_LAUNCHERS\fP
.UNINDENT
.TP
.B \fBBuildFlags\fP
فلگ‌های اضافی برای ارسال به ابزار ساخت هنگام ساخت پروژه.
فقط زمانی استفاده می‌شود که \fBMakeCommand\fP به‌طور صریح تنظیم نشده باشد.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_BUILD_FLAGS\fP
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: هیچ‌کدام (none)
.UNINDENT
.TP
.B \fBBuildTarget\fP
یک هدف خاص را برای ساخت به جای هدف پیش‌فرض مشخص می‌کند.
فقط زمانی استفاده می‌شود که \fBMakeCommand\fP به‌طور صریح تنظیم نشده باشد.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_BUILD_TARGET\fP
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: هیچ‌کدام (none)
.UNINDENT
.UNINDENT
.SS "مرحله آزمون CTest (CTest Test Step)"
.sp
در یک اسکریپت CTest، دستور \fBctest_test()\fP \%<#\:command:ctest_test> این مرحله را اجرا می‌کند.
آرگومان‌های ارائه‌شده به این دستور می‌توانند برخی از تنظیمات مرحله را مشخص کنند.
.sp
تنظیمات پیکربندی شامل موارد زیر است:
.INDENT 0.0
.TP
.B \fBResourceSpecFile\fP
یک فایل مشخصات منابع (resource specification file)\&
را تعیین می‌کند.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_RESOURCE_SPEC_FILE\fP \%<#\:variable:CTEST_RESOURCE_SPEC_FILE>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCTEST_RESOURCE_SPEC_FILE\fP
.UNINDENT
.sp
برای اطلاعات بیشتر، بخش تخصیص منابع (Resource Allocation) را ببینید.
.TP
.B \fBLabelsForSubprojects\fP
فهرستی از برچسب‌ها که با نقطه\-ویرگول از هم جدا شده‌اند و به عنوان زیرپروژه در نظر گرفته می‌شوند را مشخص می‌کند. این نگاشت هنگام ارسال نتایج پیکربندی، آزمون یا ساخت به CDash تحویل داده خواهد شد.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_LABELS_FOR_SUBPROJECTS\fP \%<#\:variable:CTEST_LABELS_FOR_SUBPROJECTS>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCTEST_LABELS_FOR_SUBPROJECTS\fP
.UNINDENT
.sp
بخش خلاصه برچسب و زیرپروژه (Label and Subproject Summary)\& را ببینید.
.TP
.B \fBTestLoad\fP
هنگام اجرای موازی آزمون‌ها (برای مثال با \fB\-j\fP)،
تلاش می‌کند در صورتی که بار پردازنده (CPU load) ممکن است از یک آستانه مشخص فراتر رود، آزمون‌های جدیدی را شروع نکند.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_TEST_LOAD\fP \%<#\:variable:CTEST_TEST_LOAD>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCTEST_TEST_LOAD\fP
.UNINDENT
.TP
.B \fBTimeOut\fP
مدت زمان انقضای پیش‌فرض (timeout) برای هر آزمون در صورتی که توسط ویژگی آزمون
\fBTIMEOUT\fP \%<#\:prop_test:TIMEOUT> یا فلگ \fB\-\-timeout\fP مشخص نشده باشد.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_TEST_TIMEOUT\fP \%<#\:variable:CTEST_TEST_TIMEOUT>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBDART_TESTING_TIMEOUT\fP
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \fBCoverageTool\fP
در نسخه 4.4 اضافه شد.
.sp
ابزار مورد استفاده برای جمع‌آوری اطلاعات پوشش کد در طول اجرای آزمون‌ها را مشخص می‌کند. این ابزار می‌تواند یکی از موارد زیر باشد:
.INDENT 7.0
.TP
.B \fBLLVM\-COV\fP
این مقدار نشان‌دهنده استفاده از پوشش کد مبتنی بر سورس‌کد Clang است که «مستقیماً روی اطلاعات پیش‌پردازنده و AST عمل می‌کند».
برای اطلاعات بیشتر، به مستندات
پوشش کد مبتنی بر سورس‌کد Clang (Clang Source\-based Code Coverage) \%<https://\:clang\:.llvm\:.org/\:docs/\:SourceBasedCodeCoverage\:.html>
مراجعه کنید.
.sp
دستور CTest هر آزمون را با متغیر محیطی \fBLLVM_PROFILE_FILE\fP تنظیم‌شده روی \fB<directory>/<test\-name>_<process\-id>.profraw\fP اجرا خواهد کرد،
که در آن \fB<directory>\fP مسیر مطلق به پوشه‌ای است که \fBCTestTestfile.cmake\fP توصیف‌کننده آزمون در آن قرار دارد.
این کار پوشش کد مبتنی بر سورس Clang را به گونه‌ای پیکربندی می‌کند که اطلاعات پوشش جمع‌آوری‌شده توسط هر آزمون را به‌طور منحصربه‌فرد و بدون هرگونه تداخل شناسایی کند.
.sp
هرگونه فایل موجود \fB<directory>/<test\-name>_*.profraw\fP برای یک آزمون، پیش از اجرای آن آزمون حذف می‌شود. هر متغیر محیطی موجود \fBLLVM_PROFILE_FILE\fP نادیده گرفته می‌شود.
.UNINDENT
.sp
اگر مقداری مشخص نشود، هیچ کاری انجام نشده و چیزی به متغیرهای محیطی اضافه نمی‌شود.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_TEST_COVERAGE_TOOL\fP \%<#\:variable:CTEST_TEST_COVERAGE_TOOL>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCTEST_TEST_COVERAGE_TOOL\fP \%<#\:variable:CTEST_TEST_COVERAGE_TOOL>
.UNINDENT
.UNINDENT
.sp
برای گزارش مقادیر اضافی آزمون به CDash، بخش اندازه‌گیری‌های اضافی آزمون (Additional Test Measurements) \%<#\:additional-test-measurements>\& را ببینید.
.SS "مرحله پوشش کد CTest (CTest Coverage Step)"
.sp
در یک اسکریپت CTest، دستور \fBctest_coverage()\fP \%<#\:command:ctest_coverage> این مرحله را اجرا می‌کند.
آرگومان‌های ارائه‌شده به این دستور می‌توانند برخی از تنظیمات مرحله را مشخص کنند.
.sp
تنظیمات پیکربندی شامل موارد زیر است:
.INDENT 0.0
.TP
.B \fBCoverageCommand\fP
ابزار خط فرمانی برای انجام تحلیل پوشش کد نرم‌افزار.
این فرمان در مکان مشخص‌شده توسط تنظیم
\fBBuildDirectory\fP
اجرا خواهد شد.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_COVERAGE_COMMAND\fP \%<#\:variable:CTEST_COVERAGE_COMMAND>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCOVERAGE_COMMAND\fP
.UNINDENT
.TP
.B \fBCoverageExtraFlags\fP
گزینه‌های خط فرمان ارسالی به ابزار \fBCoverageCommand\fP را مشخص می‌کند.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_COVERAGE_EXTRA_FLAGS\fP \%<#\:variable:CTEST_COVERAGE_EXTRA_FLAGS>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCOVERAGE_EXTRA_FLAGS\fP
.UNINDENT
.sp
این گزینه‌ها نخستین آرگومان‌های ارسال‌شده به \fBCoverageCommand\fP\& هستند.
.TP
.B \fBExtraCoverageGlob\fP
فهرستی از الگوهای گلوب (glob patterns) جداشده با نقطه\-ویرگول برای فایل‌های منبع اضافی جهت گنجاندن در تحلیل پوشش کد.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_EXTRA_COVERAGE_GLOB\fP \%<#\:variable:CTEST_EXTRA_COVERAGE_GLOB>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: هیچ‌کدام (none)
.UNINDENT
.UNINDENT
.SS "مرحله بررسی حافظه CTest (CTest MemCheck Step)"
.sp
در یک اسکریپت CTest، دستور \fBctest_memcheck()\fP \%<#\:command:ctest_memcheck> این مرحله را اجرا می‌کند.
آرگومان‌های ارائه‌شده به این دستور می‌توانند برخی از تنظیمات این مرحله را تعیین کنند.
.sp
تنظیمات پیکربندی شامل موارد زیر است:
.INDENT 0.0
.TP
.B \fBMemoryCheckCommand\fP
ابزار خط فرمانی برای انجام تحلیل پویا (dynamic analysis). خطوط فرمان
آزمون از طریق این ابزار اجرا خواهند شد.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_MEMORYCHECK_COMMAND\fP \%<#\:variable:CTEST_MEMORYCHECK_COMMAND>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBMEMORYCHECK_COMMAND\fP
.UNINDENT
.TP
.B \fBMemoryCheckCommandOptions\fP
گزینه‌های خط فرمان را برای ابزار \fBMemoryCheckCommand\fP مشخص می‌کند.
این گزینه‌ها پیش از خط فرمان آزمون قرار خواهند گرفت.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_MEMORYCHECK_COMMAND_OPTIONS\fP \%<#\:variable:CTEST_MEMORYCHECK_COMMAND_OPTIONS>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBMEMORYCHECK_COMMAND_OPTIONS\fP
.UNINDENT
.TP
.B \fBMemoryCheckType\fP
نوع بررسی حافظه را برای اجرا مشخص می‌کند.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_MEMORYCHECK_TYPE\fP \%<#\:variable:CTEST_MEMORYCHECK_TYPE>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBMEMORYCHECK_TYPE\fP
.UNINDENT
.TP
.B \fBMemoryCheckSanitizerOptions\fP
گزینه‌های ابزارهای پالایش حافظه (sanitizers) را هنگام اجرا با ساختی که پالایش در آن فعال است (sanitize\-enabled build) مشخص می‌کند.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_MEMORYCHECK_SANITIZER_OPTIONS\fP \%<#\:variable:CTEST_MEMORYCHECK_SANITIZER_OPTIONS>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBMEMORYCHECK_SANITIZER_OPTIONS\fP
.UNINDENT
.TP
.B \fBMemoryCheckSuppressionFile\fP
فایلی شامل قوانین نادیده‌گیری (suppression rules) را برای ابزار
\fBMemoryCheckCommand\fP مشخص می‌کند. این فایل با گزینه‌های متناسب
با آن ابزار ارسال خواهد شد.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_MEMORYCHECK_SUPPRESSIONS_FILE\fP \%<#\:variable:CTEST_MEMORYCHECK_SUPPRESSIONS_FILE>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBMEMORYCHECK_SUPPRESSIONS_FILE\fP
.UNINDENT
.UNINDENT
.sp
تنظیمات پیکربندی اضافی شامل موارد زیر است:
.INDENT 0.0
.TP
.B \fBBoundsCheckerCommand\fP
یک \fBMemoryCheckCommand\fP را تعیین می‌کند که از نظر خط فرمان
با Bounds Checker سازگار است.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: ندارد
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: ندارد
.UNINDENT
.TP
.B \fBPurifyCommand\fP
یک \fBMemoryCheckCommand\fP را تعیین می‌کند که از نظر خط فرمان
با Purify سازگار است.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: ندارد
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBPURIFYCOMMAND\fP
.UNINDENT
.TP
.B \fBValgrindCommand\fP
یک \fBMemoryCheckCommand\fP را تعیین می‌کند که از نظر خط فرمان
با Valgrind سازگار است.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: ندارد
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBVALGRIND_COMMAND\fP
.UNINDENT
.TP
.B \fBValgrindCommandOptions\fP
گزینه‌های خط فرمان را برای ابزار \fBValgrindCommand\fP مشخص می‌کند.
این گزینه‌ها پیش از خط فرمان آزمون قرار خواهند گرفت.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: ندارد
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBVALGRIND_COMMAND_OPTIONS\fP
.UNINDENT
.TP
.B \fBDrMemoryCommand\fP
یک \fBMemoryCheckCommand\fP را تعیین می‌کند که از نظر خط فرمان
با DrMemory سازگار است.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: ندارد
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBDRMEMORY_COMMAND\fP
.UNINDENT
.TP
.B \fBDrMemoryCommandOptions\fP
گزینه‌های خط فرمان را برای ابزار \fBDrMemoryCommand\fP مشخص می‌کند.
این گزینه‌ها پیش از خط فرمان آزمون قرار خواهند گرفت.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: ندارد
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBDRMEMORY_COMMAND_OPTIONS\fP
.UNINDENT
.TP
.B \fBCudaSanitizerCommand\fP
یک \fBMemoryCheckCommand\fP را تعیین می‌کند که از نظر خط فرمان
با cuda\-memcheck یا compute\-sanitizer سازگار است.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: ندارد
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCUDA_SANITIZER_COMMAND\fP
.UNINDENT
.TP
.B \fBCudaSanitizerCommandOptions\fP
گزینه‌های خط فرمان را برای ابزار \fBCudaSanitizerCommand\fP مشخص می‌کند.
این گزینه‌ها پیش از خط فرمان آزمون قرار خواهند گرفت.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: ندارد
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCUDA_SANITIZER_COMMAND_OPTIONS\fP
.UNINDENT
.UNINDENT
.SS "مرحله ارسال CTest (CTest Submit Step)"
.sp
در یک اسکریپت CTest، دستور \fBctest_submit()\fP \%<#\:command:ctest_submit> این مرحله را اجرا می‌کند.
آرگومان‌های ارائه‌شده به این دستور می‌توانند برخی از تنظیمات این مرحله را تعیین کنند.
.sp
تنظیمات پیکربندی شامل موارد زیر است:
.INDENT 0.0
.TP
.B \fBBuildName\fP
پلتفرم کلاینت داشبورد را با یک رشته کوتاه توصیف می‌کند.
(سیستم‌عامل، کامپایلر و غیره)
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_BUILD_NAME\fP \%<#\:variable:CTEST_BUILD_NAME>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBBUILDNAME\fP
.UNINDENT
.TP
.B \fBCDashVersion\fP
گزینه قدیمی (منسوخ). استفاده نمی‌شود.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: ندارد، از سرور شناسایی می‌شود
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCTEST_CDASH_VERSION\fP
.UNINDENT
.TP
.B \fBCTestSubmitRetryCount\fP
تعداد تلاش‌های مجدد برای ارسال در صورت بروز خطای شبکه را مشخص می‌کند.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: ندارد،
از گزینه \fBRETRY_COUNT\fP در دستور \fBctest_submit()\fP \%<#\:command:ctest_submit> استفاده کنید.
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCTEST_SUBMIT_RETRY_COUNT\fP
.UNINDENT
.TP
.B \fBCTestSubmitRetryDelay\fP
میزان تاخیر پیش از تلاش مجدد برای ارسال در صورت بروز خطای شبکه را مشخص می‌کند.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: ندارد،
از گزینه \fBRETRY_DELAY\fP در دستور \fBctest_submit()\fP \%<#\:command:ctest_submit> استفاده کنید.
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCTEST_SUBMIT_RETRY_DELAY\fP
.UNINDENT
.TP
.B \fBCurlOptions\fP
منسوخ‌شده از نسخه 3.30: به جای آن از \fBTLSVerify\fP استفاده کنید.

.sp
فهرستی از گزینه‌های جداشده با نقطه‌ویرگول را جهت کنترل کتابخانه
Curl که CTest در داخل برای اتصال به سرور از آن استفاده می‌کند،
مشخص می‌نماید.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_CURL_OPTIONS\fP \%<#\:variable:CTEST_CURL_OPTIONS>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCTEST_CURL_OPTIONS\fP
.UNINDENT
.sp
گزینه‌های ممکن عبارتند از:
.INDENT 7.0
.TP
.B \fBCURLOPT_SSL_VERIFYPEER_OFF\fP
غیرفعال کردن گزینه \fBCURLOPT_SSL_VERIFYPEER\fP در curl.
.TP
.B \fBCURLOPT_SSL_VERIFYHOST_OFF\fP
غیرفعال کردن گزینه \fBCURLOPT_SSL_VERIFYHOST\fP در curl.
.UNINDENT
.TP
.B \fBDropLocation\fP
گزینه قدیمی (منسوخ). هنگامی که \fBSubmitURL\fP تنظیم نشده باشد، از
\fBDropMethod\fP، \fBDropSiteUser\fP، \fBDropSitePassword\fP، \fBDropSite\fP و
\fBDropLocation\fP\& ساخته می‌شود.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_DROP_LOCATION\fP \%<#\:variable:CTEST_DROP_LOCATION>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBDROP_LOCATION\fP در صورت تنظیم،
در غیر این صورت \fBCTEST_DROP_LOCATION\fP
.UNINDENT
.TP
.B \fBDropMethod\fP
گزینه قدیمی (منسوخ). هنگامی که \fBSubmitURL\fP تنظیم نشده باشد، از
\fBDropMethod\fP، \fBDropSiteUser\fP، \fBDropSitePassword\fP، \fBDropSite\fP و
\fBDropLocation\fP\& ساخته می‌شود.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_DROP_METHOD\fP \%<#\:variable:CTEST_DROP_METHOD>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBDROP_METHOD\fP در صورت تنظیم،
در غیر این صورت \fBCTEST_DROP_METHOD\fP
.UNINDENT
.TP
.B \fBDropSite\fP
گزینه قدیمی (منسوخ). هنگامی که \fBSubmitURL\fP تنظیم نشده باشد، از
\fBDropMethod\fP، \fBDropSiteUser\fP، \fBDropSitePassword\fP، \fBDropSite\fP و
\fBDropLocation\fP\& ساخته می‌شود.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_DROP_SITE\fP \%<#\:variable:CTEST_DROP_SITE>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBDROP_SITE\fP در صورت تنظیم،
در غیر این صورت \fBCTEST_DROP_SITE\fP
.UNINDENT
.TP
.B \fBDropSitePassword\fP
گزینه قدیمی (منسوخ). هنگامی که \fBSubmitURL\fP تنظیم نشده باشد، از
\fBDropMethod\fP، \fBDropSiteUser\fP، \fBDropSitePassword\fP، \fBDropSite\fP و
\fBDropLocation\fP\& ساخته می‌شود.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_DROP_SITE_PASSWORD\fP \%<#\:variable:CTEST_DROP_SITE_PASSWORD>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBDROP_SITE_PASSWORD\fP در صورت تنظیم،
در غیر این صورت \fBCTEST_DROP_SITE_PASSWORD\fP
.UNINDENT
.TP
.B \fBDropSiteUser\fP
گزینه قدیمی (منسوخ). هنگامی که \fBSubmitURL\fP تنظیم نشده باشد، از
\fBDropMethod\fP، \fBDropSiteUser\fP، \fBDropSitePassword\fP، \fBDropSite\fP و
\fBDropLocation\fP\& ساخته می‌شود.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_DROP_SITE_USER\fP \%<#\:variable:CTEST_DROP_SITE_USER>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBDROP_SITE_USER\fP در صورت تنظیم،
در غیر این صورت \fBCTEST_DROP_SITE_USER\fP
.UNINDENT
.TP
.B \fBIsCDash\fP
گزینه قدیمی (منسوخ). استفاده نمی‌شود.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_DROP_SITE_CDASH\fP \%<#\:variable:CTEST_DROP_SITE_CDASH>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCTEST_DROP_SITE_CDASH\fP
.UNINDENT
.TP
.B \fBScpCommand\fP
گزینه قدیمی (منسوخ). استفاده نمی‌شود.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_SCP_COMMAND\fP \%<#\:variable:CTEST_SCP_COMMAND>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBSCPCOMMAND\fP
.UNINDENT
.TP
.B \fBSite\fP
سایت میزبان کلاینت داشبورد را با یک رشته کوتاه توصیف می‌کند.
(نام میزبان، دامنه و غیره)
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_SITE\fP \%<#\:variable:CTEST_SITE>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBSITE\fP،
مقداردهی‌شده توسط دستور \fBsite_name()\fP \%<#\:command:site_name>
.UNINDENT
.TP
.B \fBSubmitURL\fP
نشانی اینترنتی \fBhttp\fP یا \fBhttps\fP مربوط به سرور داشبورد برای
ارسال گزارش به آن.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_SUBMIT_URL\fP \%<#\:variable:CTEST_SUBMIT_URL>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBSUBMIT_URL\fP در صورت تنظیم،
در غیر این صورت \fBCTEST_SUBMIT_URL\fP
.UNINDENT
.TP
.B \fBSubmitInactivityTimeout\fP
مدت زمانی که باید منتظر تکمیل ارسال ماند و در صورت پایان نیافتن،
عملیات لغو می‌شود. برای غیرفعال کردن مهلت زمانی (timeout)، مقدار صفر را مشخص کنید.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_SUBMIT_INACTIVITY_TIMEOUT\fP \%<#\:variable:CTEST_SUBMIT_INACTIVITY_TIMEOUT>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCTEST_SUBMIT_INACTIVITY_TIMEOUT\fP
.UNINDENT
.TP
.B \fBNotesFiles\fP
فهرستی از فایل‌های یادداشت جداشده با نقطه‌ویرگول که همراه با ارسال آپلود می‌شوند.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_NOTES_FILES\fP \%<#\:variable:CTEST_NOTES_FILES>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: ندارد
.UNINDENT
.TP
.B \fBExtraSubmitFiles\fP
فهرستی از فایل‌های \fB\&.xml\fP اضافی جداشده با نقطه‌ویرگول که همراه با
ارسال آپلود می‌شوند.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_EXTRA_SUBMIT_FILES\fP \%<#\:variable:CTEST_EXTRA_SUBMIT_FILES>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: ندارد
.UNINDENT
.TP
.B \fBSubmitParts\fP
فهرستی از نام بخش‌ها جداشده با نقطه‌ویرگول جهت ارسال. در صورت تنظیم، تنها
بخش‌های نام‌برده ارسال می‌شوند و نه تمام بخش‌های موجود. نام‌های معتبر
همان گزینه‌های موجود در گزینه \fBPARTS\fP دستور \fBctest_submit()\fP \%<#\:command:ctest_submit>\& هستند.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_SUBMIT_PARTS\fP \%<#\:variable:CTEST_SUBMIT_PARTS>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: ندارد
.UNINDENT
.TP
.B \fBTimeLimit\fP
حداکثر زمان کل (به ثانیه) مجاز برای کل اجرای داشبورد.
زمانی که زمان باقی‌مانده به کمتر از دو دقیقه کاهش یابد، CTest
مراحل اضافی را آغاز نخواهد کرد.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_TIME_LIMIT\fP
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: ندارد
.UNINDENT
.TP
.B \fBTLSVersion\fP
اضافه‌شده در نسخه 3.30.

.sp
تعیین حداقل نسخه مجاز TLS هنگام ارسال به داشبورد
از طریق نشانی‌های اینترنتی \fBhttps://\fP\&.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_TLS_VERSION\fP \%<#\:variable:CTEST_TLS_VERSION>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCTEST_TLS_VERSION\fP
.UNINDENT
.sp
تغییریافته در نسخه 3.31: مقدار پیش‌فرض TLS 1.2 است.
پیش از این، هیچ حداقل نسخه‌ای به‌طور پیش‌فرض اعمال نمی‌شد.

.TP
.B \fBTLSVerify\fP
اضافه‌شده در نسخه 3.30.

.sp
یک مقدار بولی (boolean) را مشخص می‌کند که تعیین‌کننده اعتبارسنجی گواهی
سرور هنگام ارسال به داشبورد از طریق نشانی‌های اینترنتی \fBhttps://\fP است.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_TLS_VERIFY\fP \%<#\:variable:CTEST_TLS_VERIFY>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBCTEST_TLS_VERIFY\fP
.UNINDENT
.sp
تغییریافته در نسخه 3.31: مقدار پیش‌فرض on (روشن) است. پیش از این، مقدار پیش‌فرض off (خاموش) بود.
کاربران می‌توانند متغیر محیطی \fBCMAKE_TLS_VERIFY\fP \%<#\:envvar:CMAKE_TLS_VERIFY> را
روی \fB0\fP تنظیم کنند تا مقدار پیش‌فرض قبلی بازیابی شود.

.TP
.B \fBTriggerSite\fP
گزینه قدیمی (منسوخ). استفاده نمی‌شود.
.INDENT 7.0
.IP \(bu 2
متغیر اسکریپت CTest: \fBCTEST_TRIGGER_SITE\fP \%<#\:variable:CTEST_TRIGGER_SITE>
.IP \(bu 2
متغیر ماژول \fBCTest\fP \%<#\:module:CTest>: \fBTRIGGER_SITE\fP در صورت تنظیم،
در غیر این صورت \fBCTEST_TRIGGER_SITE\fP
.UNINDENT
.UNINDENT
.SH "نمایش به عنوان مدل شیء JSON (SHOW AS JSON OBJECT MODEL)"
.sp
در نسخه 3.14 اضافه شد.

.sp
هنگامی که گزینه خط فرمان
\fB\-\-show\-only=json\-v1\fP
داده شود، اطلاعات آزمون در قالب JSON خروجی داده می‌شود. نسخه 1.0 از مدل شیء JSON به صورت زیر تعریف می‌شود:
.INDENT 0.0
.TP
.B \fBkind\fP
رشته \(dqctestInfo\(dq.
.TP
.B \fBversion\fP
یک شیء JSON که مولفه‌های نسخه را مشخص می‌کند. اعضای آن عبارتند از:
.INDENT 7.0
.TP
.B \fBmajor\fP
یک عدد صحیح مثبت که مولفه نسخه اصلی (major) مدل شیء JSON را مشخص می‌کند.
.TP
.B \fBminor\fP
یک عدد صحیح غیرمنفی که مولفه نسخه فرعی (minor) مدل شیء JSON را مشخص می‌کند.
.UNINDENT
.TP
.B \fBbacktraceGraph\fP
شیء JSON نمایانگر اطلاعات ردگیری فراخوانی (backtrace) با اعضای زیر:
.INDENT 7.0
.TP
.B \fBcommands\fP
فهرستی از نام دستورات.
.TP
.B \fBfiles\fP
فهرستی از نام فایل‌ها.
.TP
.B \fBnodes\fP
فهرستی از اشیاء JSON مربوط به گره‌ها با اعضای زیر:
.INDENT 7.0
.TP
.B \fBcommand\fP
یک عضو اختیاری که هنگام نمایش فراخوانی یک دستور درون فایل توسط گره، وجود دارد. مقدار آن یک شاخص (index) عدد صحیح بدون علامت بر پایه 0 در عضو
\fBcommands\fP
مربوط به
\fBbacktraceGraph\fP\&
است.
.TP
.B \fBfile\fP
یک شاخص عدد صحیح بدون علامت بر پایه 0 در عضو
\fBfiles\fP
مربوط به
\fBbacktraceGraph\fP\&.
.TP
.B \fBline\fP
یک عضو اختیاری که هنگام نمایش یک خط درون فایل توسط گره، وجود دارد. مقدار آن یک شماره خط عدد صحیح بدون علامت بر پایه 1 در فایلی است که ردگیری فراخوانی در آن اضافه شده است.
.TP
.B \fBparent\fP
یک عضو اختیاری که وقتی گره در پایین‌ترین بخش پشته فراخوانی نباشد، وجود دارد. مقدار آن یک شاخص عدد صحیح بدون علامت بر پایه 0 در عضو
\fBnodes\fP
مربوط به
\fBbacktraceGraph\fP
است که والد را در گراف نشان می‌دهد.
.UNINDENT
.UNINDENT
.TP
.B \fBtests\fP
یک آرایه JSON شامل فهرستی از اطلاعات مربوط به هر آزمون. هر ورودی یک شیء JSON با اعضای زیر است:
.INDENT 7.0
.TP
.B \fBname\fP
نام آزمون. این مقدار نمی‌تواند خالی باشد.
.TP
.B \fBconfig\fP
فیلد اختیاری مشخص‌کننده پیکربندی که آزمون تحت آن اجرا خواهد شد. این مقدار همیشه با گزینه
\fB\-C\fP
مشخص‌شده در خط فرمان
\fBctest\fP
تطابق خواهد داشت. اگر چنین گزینه‌ای داده نشده باشد، این فیلد وجود نخواهد داشت.
.TP
.B \fBcommand\fP
آرایه اختیاری که در آن عنصر نخست دستور آزمون و عناصر باقی‌مانده آرگومان‌های دستور هستند. معمولاً این فیلد باید وجود داشته و غیرخالی باشد، اما در موارد خاص مربوط به عبارات تولیدکننده (generator expressions)، این امکان وجود دارد که یک آزمون دستوری نداشته باشد و در نتیجه این فیلد وجود نداشته باشد.
.TP
.B \fBbacktrace\fP
شاخص در عضو
\fBnodes\fP
مربوط به
\fBbacktraceGraph\fP\&.
.TP
.B \fBproperties\fP
آرایه اختیاری از ویژگی‌های آزمون.
هر آیتم آرایه یک شیء JSON با اعضای زیر خواهد بود:
.INDENT 7.0
.TP
.B \fBname\fP
نام ویژگی آزمون. این مقدار نمی‌تواند خالی باشد.
.TP
.B \fBvalue\fP
مقدار ویژگی، که می‌تواند یک رشته، یک عدد، یک مقدار بولی (boolean) یا آرایه‌ای از رشته‌ها باشد.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
در نسخه 4.1 اضافه شد: قالب خروجی JSON در قالبی خوانا برای ماشین توسط
\fBاین طرح‌واره JSON (JSON schema)\fP\&
توصیف شده است.

.SH "تخصیص منابع (RESOURCE ALLOCATION)"
.sp
ابزار CTest مکانیزمی را برای آزمون‌ها فراهم می‌کند تا منابع مورد نیاز خود را به روشی دقیق و ریزدانه (fine\-grained) مشخص کنند، و همچنین به کاربران اجازه می‌دهد منابع موجود در ماشین در حال اجرا را تعیین نمایند. این قابلیت به CTest امکان می‌دهد تا به طور داخلی ردیابی کند کدام منابع در حال استفاده و کدام آزاد هستند، و آزمون‌ها را به‌گونه‌ای زمان‌بندی کند که مانع از تلاش آن‌ها برای درخواست منابعی شود که در دسترس نیستند.
.sp
هنگامی که قابلیت تخصیص منابع استفاده می‌شود، CTest منابع را بیش از ظرفیت تخصیص نخواهد داد (oversubscribe نمی‌کند). برای مثال، اگر یک منبع دارای 8 اسلات (slot) باشد، CTest آزمون‌هایی را که در مجموع به طور همزمان بیش از 8 اسلات مصرف می‌کنند اجرا نخواهد کرد. این امر موجب محدود شدن تعداد آزمون‌های در حال اجرا در هر لحظه می‌شود، حتی اگر آرگومان بالای
\fB\-j\fP
استفاده شده باشد، به شرطی که تمام آن آزمون‌ها از اسلات‌های همان منبع استفاده کنند. علاوه بر این، بدین معناست که یک آزمون منفرد که بیش از میزان موجود در ماشین از یک منبع استفاده می‌کند اصلاً اجرا نخواهد شد (و وضعیت آن به صورت
\fBNot Run\fP
گزارش می‌شود).
.sp
یک کاربرد رایج این قابلیت برای آزمون‌هایی است که نیاز به استفاده از یک GPU دارند. چندین آزمون می‌توانند به طور همزمان حافظه‌ای از یک GPU را تخصیص دهند، اما اگر آزمون‌های بیش از حدی همزمان برای این کار تلاش کنند، تخصیص حافظه در برخی از آن‌ها با شکست مواجه می‌شود که نتیجه آن یک آزمون مردود است؛ حتی در حالی که اگر آزمون حافظه مورد نیازش را داشت، با موفقیت سپری می‌شد. با استفاده از قابلیت تخصیص منابع، هر آزمون می‌تواند مشخص کند چه میزان حافظه از GPU نیاز دارد، و به CTest امکان می‌دهد آزمون‌ها را طوری زمان‌بندی کند که اجرای همزمان چند مورد از این آزمون‌ها استخر حافظه (memory pool) پردازنده گرافیکی را تمام نکند.
.sp
لطفاً توجه داشته باشید که CTest هیچ مفهومی از اینکه GPU چیست یا چه مقدار حافظه دارد ندارد. این ابزار هیچ روشی برای برقراری ارتباط با یک GPU جهت دریافت این اطلاعات یا انجام مدیریت حافظه ندارد، هرچند پروژه می‌تواند آزمونی تعریف کند که جزئیات مربوط به ماشین آزمون را ارائه دهد (به بخش «فایل مشخصات منابع تولیدشده پویا (Dynamically\-Generated Resource Specification File)» مراجعه کنید).
.sp
ابزار CTest فهرستی از انواع منابع انتزاعی (abstract resource types) را ردیابی می‌کند که هر کدام تعداد معینی اسلات (slot) در دسترس برای استفاده آزمون‌ها دارند. هر آزمون تعداد اسلات‌های مورد نیاز خود از یک منبع خاص را مشخص می‌کند، و سپس CTest آن‌ها را طوری زمان‌بندی می‌کند که از فراتر رفتن تعداد کل اسلات‌های در حال استفاده از ظرفیت فهرست‌شده جلوگیری شود. هنگامی که یک آزمون اجرا می‌شود، و اسلات‌هایی از یک منبع به آن آزمون اختصاص می‌یابد، آزمون‌ها می‌توانند فرض کنند که در طول مدت فرایند آزمون، استفاده انحصاری از آن اسلات‌ها را در اختیار دارند.
.sp
قابلیت تخصیص منابع CTest حداقل از دو ورودی تشکیل شده است:
.INDENT 0.0
.IP \(bu 2
فایل مشخصات منابع (resource specification file) که در زیر شرح داده شده و منابع موجود در سیستم را توصیف می‌کند.
.IP \(bu 2
ویژگی
\fBRESOURCE_GROUPS\fP \%<#\:prop_test:RESOURCE_GROUPS>
آزمون‌ها، که منابع مورد نیاز آزمون را توصیف می‌کند.
.UNINDENT
.sp
هنگامی که CTest آزمونی را اجرا می‌کند، منابع تخصیص‌یافته به آن آزمون در قالب مجموعه‌ای از متغیرهای محیطی که در زیر شرح داده شده است، ارسال می‌شوند. استفاده از این اطلاعات برای تصمیم‌گیری در مورد اینکه به کدام منبع متصل شوند بر عهده نویسنده آزمون گذاشته شده است.
.sp
ویژگی
\fBRESOURCE_GROUPS\fP \%<#\:prop_test:RESOURCE_GROUPS>
به CTest می‌گوید آزمون انتظار دارد از چه منابعی استفاده کند که به شیوه‌ای معنادار برای آزمون گروه‌بندی شده‌اند. خود آزمون باید متغیرهای محیطی را بخواند تا تعیین کند چه منابعی به هر گروه اختصاص یافته است. برای مثال، هر گروه ممکن است متناظر با فرایندی باشد که آزمون هنگام اجرا ایجاد (spawn) می‌کند.
.sp
توجه داشته باشید که حتی اگر یک آزمون ویژگی
\fBRESOURCE_GROUPS\fP \%<#\:prop_test:RESOURCE_GROUPS>
را مشخص کند، در صورتی که کاربر یک فایل مشخصات منابع را ارائه ندهد، همچنان این امکان وجود دارد که آن آزمون بدون هیچ‌گونه تخصیص منابع (و بدون متغیرهای محیطی متناظر) اجرا شود. ارائه این فایل، چه از طریق آرگومان خط فرمان
\fB\-\-resource\-spec\-file\fP
یا آرگومان
\fBRESOURCE_SPEC_FILE\fP
در
\fBctest_test()\fP \%<#\:command:ctest_test>،
چیزی است که قابلیت تخصیص منابع را فعال می‌کند. آزمون‌ها باید متغیر محیطی
\fBCTEST_RESOURCE_GROUP_COUNT\fP
را بررسی کنند تا دریابند که آیا تخصیص منابع فعال است یا خیر. این متغیر همیشه (و تنها) در صورتی تعریف خواهد شد که تخصیص منابع فعال باشد. اگر تخصیص منابع فعال نباشد، آنگاه متغیر
\fBCTEST_RESOURCE_GROUP_COUNT\fP
وجود نخواهد داشت، حتی اگر برای فرایند والد
\fBctest\fP
وجود داشته باشد. اگر یک آزمون قطعاً باید دارای تخصیص منابع باشد، می‌تواند یک کد خروج شکست‌خورده برگرداند یا از ویژگی‌های
\fBSKIP_RETURN_CODE\fP \%<#\:prop_test:SKIP_RETURN_CODE>
یا
\fBSKIP_REGULAR_EXPRESSION\fP \%<#\:prop_test:SKIP_REGULAR_EXPRESSION>
برای نشان دادن رد شدن (skip) آزمون استفاده کند.
.SS "فایل مشخصات منابع (Resource Specification File)"
.sp
فایل مشخصات منابع یک فایل JSON است که به یکی از چندین روش به CTest ارسال می‌شود. این فایل می‌تواند در خط فرمان با گزینه
\fB\-\-resource\-spec\-file\fP
مشخص شود، با استفاده از آرگومان
\fBRESOURCE_SPEC_FILE\fP
در
\fBctest_test()\fP \%<#\:command:ctest_test>
تعیین گردد، یا می‌تواند به‌طور پویا به عنوان بخشی از اجرای آزمون تولید شود (به
«فایل مشخصات منابع تولید شده پویا»
مراجعه کنید).
.sp
اگر از یک اسکریپت داشبورد استفاده شود و
\fBRESOURCE_SPEC_FILE\fP
مشخص نشده باشد، مقدار
\fBCTEST_RESOURCE_SPEC_FILE\fP \%<#\:variable:CTEST_RESOURCE_SPEC_FILE>
در اسکریپت داشبورد به جای آن استفاده می‌شود. اگر
\fB\-\-resource\-spec\-file\fP،
\fBRESOURCE_SPEC_FILE\fP
و
\fBCTEST_RESOURCE_SPEC_FILE\fP \%<#\:variable:CTEST_RESOURCE_SPEC_FILE>
در اسکریپت داشبورد مشخص نشده باشند، مقدار
\fBCTEST_RESOURCE_SPEC_FILE\fP \%<#\:variable:CTEST_RESOURCE_SPEC_FILE>
در بیلد CMake به جای آن استفاده می‌شود. اگر هیچ‌یک از این موارد مشخص نشده باشند، هیچ فایل مشخصات منبعی استفاده نخواهد شد.
.sp
فایل مشخصات منابع باید یک شیء JSON باشد. تمامی مثال‌های این سند فایل مشخصات منابع زیر را فرض می‌کنند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqversion\(dq: {
    \(dqmajor\(dq: 1,
    \(dqminor\(dq: 0
  },
  \(dqlocal\(dq: [
    {
      \(dqgpus\(dq: [
        {
          \(dqid\(dq: \(dq0\(dq,
          \(dqslots\(dq: 2
        },
        {
          \(dqid\(dq: \(dq1\(dq,
          \(dqslots\(dq: 4
        },
        {
          \(dqid\(dq: \(dq2\(dq,
          \(dqslots\(dq: 2
        },
        {
          \(dqid\(dq: \(dq3\(dq
        }
      ],
      \(dqcrypto_chips\(dq: [
        {
          \(dqid\(dq: \(dqcard0\(dq,
          \(dqslots\(dq: 4
        }
      ]
    }
  ]
}
.EE
.UNINDENT
.UNINDENT
.sp
اعضای این شیء عبارتند از:
.INDENT 0.0
.TP
.B \fBversion\fP
یک شیء شامل یک فیلد عدد صحیح \fBmajor\fP و یک فیلد عدد صحیح \fBminor\fP\&. در حال حاضر، تنها نسخه پشتیبانی‌شده نسخه اصلی (major) \fB1\fP و نسخه فرعی (minor) \fB0\fP است. هر مقدار دیگری خطا محسوب می‌شود.
.TP
.B \fBlocal\fP
یک آرایه JSON از مجموعه‌های منابع موجود در سیستم. در حال حاضر، اندازه این آرایه به ۱ محدود شده است.
.sp
هر عنصر آرایه یک شیء JSON با اعضایی است که نام‌های آن‌ها برابر با انواع منابع مورد نظر، مانند
\fBgpus\fP
است. این نام‌ها باید با یک حرف کوچک انگلیسی یا زیرخط شروع شوند، و کاراکترهای بعدی می‌توانند یک حرف کوچک، یک رقم یا یک زیرخط باشند. حروف بزرگ مجاز نیستند، زیرا برخی از پلتفرم‌ها متغیرهای محیطی بدون حساسیت به حروف کوچک و بزرگ دارند. برای اطلاعات بیشتر، بخش «متغیرهای محیطی (Environment Variables)» در زیر را ببینید. توصیه می‌شود نام نوع منبع جمع یک اسم باشد، مانند
\fBgpus\fP
یا
\fBcrypto_chips\fP
(و نه
\fBgpu\fP
یا
\fBcrypto_chip\fP\&).
.sp
لطفاً توجه داشته باشید که نام‌های
\fBgpus\fP
و
\fBcrypto_chips\fP
صرفاً مثال هستند و CTest به هیچ وجه آن‌ها را تفسیر نمی‌کند. شما آزادید هر نوع منبعی را که می‌خواهید برای برآوردن نیازمندی‌های خود تعریف کنید.
.sp
مقدار مربوط به هر نوع منبع، یک آرایه JSON متشکل از اشیاء JSON است که هر یک از آن‌ها یک نمونه خاص از منبع مشخص‌شده را توصیف می‌کنند. این اشیاء دارای اعضای زیر هستند:
.INDENT 7.0
.TP
.B \fBid\fP
رشته‌ای متشکل از یک شناسه برای منبع. هر کاراکتر در شناسه می‌تواند یک حرف کوچک انگلیسی، یک رقم یا یک زیرخط باشد. حروف بزرگ مجاز نیستند.
.sp
شناسه‌ها باید در یک نوع منبع یکتا باشند. با این حال، نیازی نیست که در بین انواع مختلف منابع یکتا باشند. به عنوان مثال، داشتن یک منبع
\fBgpus\fP
با نام
\fB0\fP
و یک منبع
\fBcrypto_chips\fP
با نام
\fB0\fP
معتبر است، اما وجود دو منبع
\fBgpus\fP
که هر دو دارای نام
\fB0\fP
باشند مجاز نیست.
.sp
لطفاً توجه داشته باشید که شناسه‌های
\fB0\fP،
\fB1\fP،
\fB2\fP،
\fB3\fP
و
\fBcard0\fP
صرفاً مثال هستند و CTest به هیچ وجه آن‌ها را تفسیر نمی‌کند. شما آزادید هر شناسه‌ای را که برای برآوردن نیازمندی‌های خود می‌خواهید بسازید.
.TP
.B \fBslots\fP
یک عدد بدون علامت اختیاری که تعداد اسلات‌های موجود در منبع را مشخص می‌کند. به عنوان مثال، این می‌تواند مگابایت رم روی یک پردازنده گرافیکی (GPU)، یا واحدهای رمزنگاری موجود در یک تراشه رمزنگاری باشد. اگر
\fBslots\fP
مشخص نشده باشد، مقدار پیش‌فرض
\fB1\fP
در نظر گرفته می‌شود.
.UNINDENT
.UNINDENT
.sp
در فایل نمونه بالا، چهار GPU با شناسه‌های 0 تا 3 وجود دارند. پردازنده گرافیکی 0 دارای ۲ اسلات، GPU 1 دارای ۴ اسلات، GPU 2 دارای ۲ اسلات، و GPU 3 دارای مقدار پیش‌فرض ۱ اسلات است. همچنین یک تراشه رمزنگاری با ۴ اسلات وجود دارد.
.SS "ویژگی \fBRESOURCE_GROUPS\fP"
.sp
برای شرح این ویژگی، به
\fBRESOURCE_GROUPS\fP \%<#\:prop_test:RESOURCE_GROUPS>
مراجعه کنید.
.SS "متغیرهای محیطی (Environment Variables)"
.sp
هنگامی که CTest تصمیم گرفت چه منابعی را به یک آزمون اختصاص دهد، این اطلاعات را به عنوان مجموعه‌ای از متغیرهای محیطی به فایل اجرایی آزمون ارسال می‌کند. برای هر مثال زیر، فرض می‌کنیم که آزمون مورد نظر دارای ویژگی
\fBRESOURCE_GROUPS\fP \%<#\:prop_test:RESOURCE_GROUPS>
با مقدار
\fB2,gpus:2;gpus:4,gpus:1,crypto_chips:2\fP
است.
.sp
متغیرهای زیر به فرآیند آزمون ارسال می‌شوند:
.INDENT 0.0
.TP
.B CTEST_RESOURCE_GROUP_COUNT
تعداد کل گروه‌های مشخص‌شده توسط ویژگی
\fBRESOURCE_GROUPS\fP \%<#\:prop_test:RESOURCE_GROUPS>\&.
برای مثال:
.INDENT 7.0
.IP \(bu 2
\fBCTEST_RESOURCE_GROUP_COUNT=3\fP
.UNINDENT
.sp
این متغیر تنها زمانی تعریف خواهد شد که به
\fBctest(1)\fP
گزینه
\fB\-\-resource\-spec\-file\fP
داده شده باشد، یا به
\fBctest_test()\fP \%<#\:command:ctest_test>
آرگومان
\fBRESOURCE_SPEC_FILE\fP
ارائه شده باشد. اگر هیچ فایل مشخصات منبعی داده نشده باشد، این متغیر تعریف نخواهد شد.
.UNINDENT
.INDENT 0.0
.TP
.B CTEST_RESOURCE_GROUP_<num>
فهرست انواع منابع تخصیص‌یافته به هر گروه، در حالی که هر مورد با کاما از دیگری جدا شده است.
\fB<num>\fP
عددی از صفر تا
\fBCTEST_RESOURCE_GROUP_COUNT\fP
منهای یک است.
\fBCTEST_RESOURCE_GROUP_<num>\fP
برای هر
\fB<num>\fP
در این محدوده تعریف می‌شود. برای مثال:
.INDENT 7.0
.IP \(bu 2
\fBCTEST_RESOURCE_GROUP_0=gpus\fP
.IP \(bu 2
\fBCTEST_RESOURCE_GROUP_1=gpus\fP
.IP \(bu 2
\fBCTEST_RESOURCE_GROUP_2=crypto_chips,gpus\fP
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B CTEST_RESOURCE_GROUP_<num>_<resource\-type>
فهرست شناسه‌های منابع و تعداد اسلات‌های اختصاص‌یافته از هر شناسه به هر گروه برای یک نوع منبع مشخص. این متغیر شامل مجموعه‌ای از جفت‌ها است که هر جفت با یک نقطه ویرگول (سیکولن) جدا شده و دو مورد داخل هر جفت با کاما تفکیک شده‌اند. اولین مورد در هر جفت
\fBid:\fP
به دنبال شناسه منبعی از نوع
\fB<resource\-type>\fP
است، و دومین مورد
\fBslots:\fP
به دنبال تعداد اسلات‌های تخصیص‌یافته از آن منبع به گروه داده‌شده است. برای مثال:
.INDENT 7.0
.IP \(bu 2
\fBCTEST_RESOURCE_GROUP_0_GPUS=id:0,slots:2\fP
.IP \(bu 2
\fBCTEST_RESOURCE_GROUP_1_GPUS=id:2,slots:2\fP
.IP \(bu 2
\fBCTEST_RESOURCE_GROUP_2_GPUS=id:1,slots:4;id:3,slots:1\fP
.IP \(bu 2
\fBCTEST_RESOURCE_GROUP_2_CRYPTO_CHIPS=id:card0,slots:2\fP
.UNINDENT
.sp
در این مثال، گروه 0 تعداد ۲ اسلات از پردازنده گرافیکی
\fB0\fP،
گروه 1 تعداد ۲ اسلات از پردازنده گرافیکی
\fB2\fP،
و گروه 2 تعداد ۴ اسلات از پردازنده گرافیکی
\fB1\fP،
۱ اسلات از پردازنده گرافیکی
\fB3\fP،
و ۲ اسلات از تراشه رمزنگاری
\fBcard0\fP
دریافت می‌کند.
.sp
\fB<num>\fP
عددی از صفر تا
\fBCTEST_RESOURCE_GROUP_COUNT\fP
منهای یک است.
\fB<resource\-type>\fP
نام یک نوع منبع است که به حروف بزرگ تبدیل شده است.
\fBCTEST_RESOURCE_GROUP_<num>_<resource\-type>\fP
برای حاصل‌ضرب هر
\fB<num>\fP
در محدوده ذکرشده در بالا و هر نوع منبع ذکرشده در
\fBCTEST_RESOURCE_GROUP_<num>\fP
تعریف می‌شود.
.sp
از آنجا که برخی پلتفرم‌ها برای متغیرهای محیطی نام‌های غیرحساس به حروف بزرگ و کوچک دارند، نام‌های انواع منابع نباید در یک محیط بدون حساسیت به حروف تداخل داشته باشند. به همین دلیل، برای سادگی، تمام انواع منابع باید در فایل مشخصات منابع و در ویژگی
\fBRESOURCE_GROUPS\fP \%<#\:prop_test:RESOURCE_GROUPS>
به صورت کاملاً با حروف کوچک ذکر شوند، و در متغیر محیطی
\fBCTEST_RESOURCE_GROUP_<num>_<resource\-type>\fP
به حروف کاملاً بزرگ تبدیل می‌شوند.
.UNINDENT
.SS "فایل مشخصات منابع تولید شده پویا"
.sp
افزوده‌شده در نسخه 3.28.
.sp
یک پروژه می‌تواند به صورت اختیاری یک آزمون واحد را مشخص کند که برای تولید پویای فایل مشخصات منابع استفاده می‌شود؛ فایلی که CTest از آن برای زمان‌بندی آزمون‌های مصرف‌کننده منابع استفاده خواهد کرد. آزمونی که فایل را تولید می‌کند باید ویژگی
\fBGENERATED_RESOURCE_SPEC_FILE\fP \%<#\:prop_test:GENERATED_RESOURCE_SPEC_FILE>
را تنظیم کرده باشد، و باید دقیقاً یک فیکسچر در ویژگی
\fBFIXTURES_SETUP\fP \%<#\:prop_test:FIXTURES_SETUP>
خود داشته باشد. این فیکسچر از نظر CTest معنای ویژه‌ای دارد: این فیکسچری است که فایل مشخصات منبع را تولید می‌کند. این فیکسچر می‌تواند هر نامی داشته باشد. در صورت وجود چنین فیکسچری، تمام آزمون‌هایی که ویژگی
\fBRESOURCE_GROUPS\fP \%<#\:prop_test:RESOURCE_GROUPS>
را تنظیم کرده‌اند باید این فیکسچر را در
\fBFIXTURES_REQUIRED\fP \%<#\:prop_test:FIXTURES_REQUIRED>
خود داشته باشند، و فایل مشخصات منبع نباید با آرگومان
\fB\-\-resource\-spec\-file\fP
یا متغیر
\fBCTEST_RESOURCE_SPEC_FILE\fP \%<#\:variable:CTEST_RESOURCE_SPEC_FILE>
مشخص شده باشد.
.SH "یکپارچگی با سرور کارها (JOB SERVER INTEGRATION)"
.sp
افزوده‌شده در نسخه 3.29.
.sp
در سیستم‌های پازیکس (POSIX)، هنگام اجرا در زمینه یک سرور کارها (Job Server)
\%<https://\:www\:.gnu\:.org/\:software/\:make/\:manual/\:html_node/\:Job-Slots\:.html>،
برنامه CTest اسلات‌های کاری خود را به اشتراک می‌گذارد. این امر مستقل از ویژگی آزمون
\fBPROCESSORS\fP \%<#\:prop_test:PROCESSORS>
است که همچنان در سطح موازی‌سازی
\fB\-j\fP
برنامه CTest محاسبه می‌شود. برنامه CTest پیش از اجرای هر آزمون دقیقاً یک توکن از سرور کارها دریافت می‌کند و پس از اتمام آزمون آن را بازمی‌گرداند.
.sp
برای مثال، این
\fBMakefile\fP
را در نظر بگیرید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
test:
	+ctest \-j 8

.EE
.UNINDENT
.UNINDENT
.sp
هنگام فراخوانی از طریق
\fBmake \-j 2 test\fP،
برنامه CTest به سرور کارها متصل می‌شود، یک توکن برای هر آزمون دریافت می‌کند، و حداکثر ۲ آزمون را به طور همزمان اجرا می‌کند.
.sp
در سیستم‌های ویندوز، یکپارچگی با سرور کارها هنوز پیاده‌سازی نشده است.
.SH "همچنین ببینید (SEE ALSO)"
.sp
منابع زیر برای دریافت راهنما در استفاده از CMake در دسترس هستند:
.INDENT 0.0
.TP
.B Home Page
\%<https://\:cmake\:.org>
.sp
نقطه شروع اصلی برای یادگیری درباره CMake.
.TP
.B Online Documentation and Community Resources
\%<https://\:cmake\:.org/\:documentation>
.sp
پیوندهای مربوط به مستندات موجود و منابع انجمن را می‌توان در این صفحه وب یافت.
.TP
.B Discourse Forum
\%<https://\:discourse\:.cmake\:.org>
.sp
تالار گفتگوی Discourse میزبان گفتگوها و پرسش‌ها پیرامون CMake است.
.UNINDENT
.SH "حق نشر (COPYRIGHT)"
2000-2026 Kitware, Inc. and Contributors
.\" End of generated man page.