.TH ct_run 1 "common_test 1.31.1" "Ericsson AB" "Erlang Module Definition"
.SH "نام (NAME)"
ct_run \- اجرای چارچوب Common Test از خط فرمان سیستم‌عامل
.SH "توضیحات (DESCRIPTION)"
.PP
برنامه \fIct_run\fR به صورت خودکار به همراه Erlang/OTP و برنامه کاربردی \fICommon Test\fR نصب می‌شود (برای اطلاعات بیشتر، بخش Installation را در User's Guide ببینید). این برنامه فلگ‌های شروع متعددی را می‌پذیرد. برخی از فلگ‌ها موجب می‌شوند \fIct_run\fR برنامه \fICommon Test\fR را راه‌اندازی کرده و داده‌ها را به آن منتقل کند. برخی دیگر از فلگ‌ها یک گره (نود) ارلنگ آماده‌شده برای اجرای \fICommon Test\fR در حالتی خاص را آغاز می‌نمایند.

.PP
تابع رابط \fIct:run_test/1\fR، متناظر با برنامه \fIct_run\fR، برای اجرای \fICommon Test\fR از شل ارلنگ (یا از یک برنامه ارلنگ) استفاده می‌شود. برای جزئیات، صفحه راهنمای \fIct\fR را ببینید.

.PP
برنامه \fIct_run\fR همچنین فلگ‌های شبیه‌ساز ارلنگ (Erlang emulator) را می‌پذیرد. این فلگ‌ها زمانی به کار می‌روند که \fIct_run\fR دستور \fIerl\fR را برای راه‌اندازی گره ارلنگ فراخوانی می‌کند (این امر افزودن دایرکتوری‌ها به مسیر سرور کد، تغییر کوکی در گره، آغاز برنامه‌های بیشتر و مواردی از این دست را ممکن می‌سازد).

.PP
با استفاده از فلگ اختیاری \fI\-erl_args\fR، گزینه‌های موجود در خط فرمان \fIct_run\fR می‌توانند به دو گروه تقسیم شوند:


.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}.PP
یک گروه که \fICommon Test\fR باید آن‌ها را پردازش کند (آن‌هایی که پیش از \fI\-erl_args\fR قرار دارند).

.RE

.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}.PP
یک گروه که \fICommon Test\fR باید آن‌ها را نادیده گرفته و مستقیماً به شبیه‌ساز ارسال کند (آن‌هایی که پس از \fI\-erl_args\fR قرار دارند).

.RE

.PP
گزینه‌های قبل از \fI\-erl_args\fR که توسط \fICommon Test\fR شناسایی نمی‌شوند نیز بدون تغییر به شبیه‌ساز منتقل می‌گردند. با کمک \fI\-erl_args\fR کاربر می‌تواند فلگ‌هایی با نام یکسان اما با مقصدهای متفاوت در خط فرمان \fIct_run\fR مشخص کند.

.PP
اگر فلگ‌های \fI\-pa\fR یا \fI\-pz\fR در گروه گزینه‌های \fICommon Test\fR (قبل از \fI\-erl_args\fR) مشخص شوند، دایرکتوری‌های نسبی به دایرکتوری‌های مطلق تبدیل شده و توسط \fICommon Test\fR مجدداً به مسیر کد اضافه می‌شوند. این کار به منظور جلوگیری از بروز مشکل در بارگذاری ماژول‌های کاربر هنگام تغییر دایرکتوری کاری توسط \fICommon Test\fR در طول اجرای آزمون‌ها انجام می‌شود. با این حال، \fICommon Test\fR فلگ‌های \fI\-pa\fR و \fI\-pz\fR پس از \fI\-erl_args\fR در خط فرمان را نادیده می‌گیرد. این دایرکتوری‌ها به صورت عادی (به همان فرمت تعیین‌شده) به مسیر کد افزوده می‌شوند.

.PP
وضعیت خروج (Exit status) پیش از خاتمه برنامه تنظیم می‌شود. مقدار \fI0\fR نشان‌دهنده موفقیت‌آمیز بودن نتیجه آزمون، مقدار \fI1\fR نشان‌دهنده شکست یا رد شدن خودکار (auto-skip) یک یا چند مورد آزمون، و مقدار \fI2\fR نشان‌دهنده بروز خطا در روند اجرای آزمون است.

.PP
اگر \fIct_run\fR با گزینه \fI\-help\fR فراخوانی شود، تمام گزینه‌های معتبر شروع را در \fIstdout\fR چاپ می‌کند.

.SS "اجرای آزمون‌ها از خط فرمان (Run Tests from Command Line)"

.IP
.nf
 ct_run -dir TestDir1 TestDir2 .. TestDirN |
  [-dir TestDir] -suite Suite1 Suite2 .. SuiteN
  [-group Groups1 Groups2 .. GroupsN] [-case Case1 Case2 .. CaseN]
  [-step [config | keep_inactive]]
  [-config ConfigFile1 ConfigFile2 .. ConfigFileN]
  [-userconfig CallbackModule1 ConfigString1 and CallbackModule2
   ConfigString2 and .. CallbackModuleN ConfigStringN]
  [-decrypt_key Key] | [-decrypt_file KeyFile]
  [-label Label]
  [-logdir LogDir]
  [-logopts LogOpts]
  [-verbosity GenVLevel | [Category1 VLevel1 and
   Category2 VLevel2 and .. CategoryN VLevelN]]
  [-silent_connections [ConnType1 ConnType2 .. ConnTypeN]]
  [-stylesheet CSSFile]
  [-cover CoverCfgFile]
  [-cover_stop Bool]
  [-event_handler EvHandler1 EvHandler2 .. EvHandlerN] |
  [-event_handler_init EvHandler1 InitArg1 and
   EvHandler2 InitArg2 and .. EvHandlerN InitArgN]
  [-include InclDir1 InclDir2 .. InclDirN]
  [-no_auto_compile]
  [-abort_if_missing_suites]
  [-multiply_timetraps Multiplier]
  [-scale_timetraps]
  [-create_priv_dir auto_per_run | auto_per_tc | manual_per_tc]
  [-repeat N] |
  [-duration HHMMSS [-force_stop [skip_rest]]] |
  [-until [YYMoMoDD]HHMMSS [-force_stop [skip_rest]]]
  [-basic_html]
  [-no_esc_chars]
  [-keep_logs all | NLogs]
  [-ct_hooks CTHModule1 CTHOpts1 and CTHModule2 CTHOpts2 and ..
   CTHModuleN CTHOptsN]
  [-ct_hooks_order test | config]
  [-exit_status ignore_config]
  [-help]

.fi

.SS "اجرای آزمون‌ها با مشخصات آزمون (Run Tests using Test Specification)"

.IP
.nf
 ct_run -spec TestSpec1 TestSpec2 .. TestSpecN
  [-join_specs]
  [-config ConfigFile1 ConfigFile2 .. ConfigFileN]
  [-userconfig CallbackModule1 ConfigString1 and CallbackModule2
   ConfigString2 and .. and CallbackModuleN ConfigStringN]
  [-decrypt_key Key] | [-decrypt_file KeyFile]
  [-label Label]
  [-logdir LogDir]
  [-logopts LogOpts]
  [-verbosity GenVLevel | [Category1 VLevel1 and
   Category2 VLevel2 and .. CategoryN VLevelN]]
  [-allow_user_terms]
  [-silent_connections [ConnType1 ConnType2 .. ConnTypeN]]
  [-stylesheet CSSFile]
  [-cover CoverCfgFile]
  [-cover_stop Bool]
  [-event_handler EvHandler1 EvHandler2 .. EvHandlerN] |
  [-event_handler_init EvHandler1 InitArg1 and
   EvHandler2 InitArg2 and .. EvHandlerN InitArgN]
  [-include InclDir1 InclDir2 .. InclDirN]
  [-no_auto_compile]
  [-abort_if_missing_suites]
  [-multiply_timetraps Multiplier]
  [-scale_timetraps]
  [-create_priv_dir auto_per_run | auto_per_tc | manual_per_tc]
  [-repeat N] |
  [-duration HHMMSS [-force_stop [skip_rest]]] |
  [-until [YYMoMoDD]HHMMSS [-force_stop [skip_rest]]]
  [-basic_html]
  [-no_esc_chars]
  [-keep_logs all | NLogs]
  [-ct_hooks CTHModule1 CTHOpts1 and CTHModule2 CTHOpts2 and ..
   CTHModuleN CTHOptsN]
  [-ct_hooks_order test | config]
  [-exit_status ignore_config]

.fi

.SS "تازه‌سازی فایل‌های ایندکس HTML (Refresh HTML Index Files)"

.IP
.nf
 ct_run -refresh_logs [-logdir LogDir] [-basic_html]
  [-keep_logs all | NLogs]

.fi

.SS "اجرای Common Test در حالت تعاملی (Run Common Test in Interactive Mode)"

.IP
.nf
 ct_run -shell
  [-config ConfigFile1 ConfigFile2 ... ConfigFileN]
  [-userconfig CallbackModule1 ConfigString1 and CallbackModule2
   ConfigString2 and .. and CallbackModuleN ConfigStringN]
  [-decrypt_key Key] | [-decrypt_file KeyFile]

.fi

.SS "راه‌اندازی گره ارشد Common Test (Start a Common Test Master Node)"

.IP
.nf
 ct_run -ctmaster

.fi

.SH "همچنین ببینید (SEE ALSO)"

.PP
برای کسب اطلاعات درباره فلگ‌های شروع، بخش Running Tests and Analyzing Results را در User's Guide مطالعه کنید.