Пакет: dejagnu

runtest(1)		    Общие команды		    runtest(1)



NAME
       runtest - Драйвер тестов DejaGnu

SYNOPSIS
       runtest [OPTION]...

DESCRIPTION
       DejaGnu — это фреймворк для тестирования программ с использованием Expect.  runtest — это программа-драйвер для DejaGnu.  Она управляет тем, какие тесты запускать и как их запускать.

OPTIONS
       --all, -a
	      Выводить все результаты тестов. По умолчанию отображаются только неожиданные результаты.

       --build TRIPLET
	      Конфигурационный TRIPLET для системы сборки.

       --debug
	      Включить внутренний отладочный вывод Expect. Вывод логируется в файл с именем dbg.log.

       --directory DIRECTORY
	      Запускать только тесты в указанном DIRECTORY.

       --global_init NAME
	      Имя для глобального файла инициализации в libdir. Значение по умолчанию — site.exp, если эта опция не указана.

       --help Выводит сообщение с использованием и выходит.

       --host TRIPLET
	      Конфигурационный TRIPLET для хост-системы.

       --host_board NAME
	      Определение хост-платы для использования.

       --ignore test1.exp test2.exp ...
	      Не запускать указанные тесты.

       --local_init NAME
	      Имя для локального файла инициализации тестового набора как в текущем каталоге, так и в objdir. Значение по умолчанию — site.exp, если эта опция не указана.

       --log_dialog
	      Выводить вывод Expect в стандартный вывод.

       --mail ´name1 name2 ...´
	      Электронные адреса для получения результатов тестов.

       --objdir PATH
	      PATH — каталог, содержащий скомпилированный тестовый код.

       --outdir DIRECTORY
	      Имя DIRECTORY для вывода логов тестов.

       --reboot
	      Перезагружать целевую плату при инициализации runtest (если поддерживается).

       --srcdir PATH
	      PATH — каталог, содержащий каталоги тестов.

       --strace N
	      Включить внутреннее трассирование Expect на глубину N уровней. Вывод логируется в файл с именем dbg.log.

       --target TRIPLET
	      Конфигурационный TRIPLET для цели.

       --target_board NAME
	      Список имён целевых плат NAME, на которых запускать тесты.

       --tool TOOLNAME
	      Указать инструмент для тестирования. TOOLNAME управляет применяемым тестовым набором и связанным модулем инициализации.

       --tool_exec PATH
	      Указать PATH к исполняемому файлу для тестирования.

       --tool_opts OPTIONS
	      Дополнительные OPTIONS для передачи инструменту.

       -v, --verbose
	      Включить больше отладочного вывода из тестовых случаев и утилит DejaGnu. Используйте несколько раз для увеличения вывода.

       -V, --version
	      Выводит версии DejaGnu, Expect и Tcl.

       -x, --xml
	      Генерировать вывод в формате XML. Файл вывода будет назван в соответствии с инструментом с расширением .xml.

       -D[number]
	      Активировать отладчик Tcl. number может быть 1 или 0. Если это 1, то оболочка Expect прервётся при запуске. Клавиша прерывания вызовет переход DejaGnu к приглашению отладчика. Если это 0, DejaGnu запускается как обычно, но Control-C переходит к приглашению отладчика.

       Любое имя файла в командной строке считается подмножеством имён тестов для запуска. Обычно это имена скриптов тестов (например, foo.exp).

       Переменные в стиле Makefile используются для указания имён инструментов и их флагов; эти и другие значения, зависящие от конфигурации, сохраняются в файле site.exp, создаваемом во время конфигурации.

   Код возврата:
       0      если все тесты прошли, включая ожидаемые сбои и неподдерживаемые тесты,

       1      если любой тест провалился, прошёл неожиданно или остался неразрешённым,

       2      если Expect столкнулся с любой ошибкой в скриптах тестов.

AUTHOR
       Rob Savoye (rob@welcomehome.org)

REPORTING BUGS
       Сообщайте об ошибках по адресу <bug-dejagnu@gnu.org>.

COPYRIGHT
       Copyright © 2005-2016, 2018, 2020 Free Software Foundation, Inc.

       Это свободное программное обеспечение. Вы можете распространять копии этого программного обеспечения на условиях GNU General Public License <http://www.gnu.org/licenses/gpl.html>. НЕТ НИКАКИХ ГАРАНТИЙ, насколько это разрешено законом.

SEE ALSO
       Полная документация для DejaGnu поддерживается в виде руководства Texinfo. Если программа info правильно установлена на вашем сайте, команда

	      info dejagnu

       должна предоставить вам доступ к полному руководству.



				  2018-12-01			    runtest(1)

DEJAGNU-REPORT-CARD(1)	    Справочник пользователя	DEJAGNU-REPORT-CARD(1)

NAME
     dejagnu report card — подведение итогов результатов тестирования нескольких инструментов

SYNOPSIS
     dejagnu report card [⟨option⟩ | ⟨tool⟩ | ⟨file⟩] ...

DESCRIPTION
     Команда dejagnu report card отображает результаты тестирования нескольких
     инструментов в табличном формате.  Сгенерированная таблица перечисляет,
     для каждого инструмента (и, если были выполнены несколько проходов, для
     каждого прохода) количество тестов, которые прошли, провалились,
     не поддерживаются, не разрешены и не тестировались.  Тесты, которые
     ожидалось, что провалятся, учитываются в отдельных столбцах от тестов,
     которые ожидалось, что пройдут, но "известные" сбои и "ожидаемые" сбои
     суммируются вместе.  Если тест сгенерировал предупреждения или ошибки,
     в конце соответствующей строки добавляется метка ‘!W!’ или ‘!E!’.

     Помимо опций, список аргументов может включать имена инструментов или
     файлов.  Команда dejagnu report card предпочитает читать файлы сводок
     DejaGnu и будет преобразовывать имена соответственно:

     *.sum  Используется как есть.

     *.log  Перезаписывается как *.sum с тем же основанием.

     *.	    К строке добавляется "sum", чтобы выбрать файл сводки.  Это
	    обработка выполняется для удобства при использовании автодополнения
	    имён файлов Readline в оболочке, которое будет дополнять до точки.

     *	    Воспринимается как имя инструмента; к нему добавляется .sum.

OPTIONS
     -v, --verbose  Выводить дополнительный вывод, описывающий работу
		    dejagnu report card.

FILES
     Команда dejagnu report card генерирует свой вывод, читая файлы сводок,
     созданные DejaGnu, и подсчитывая "PASS", "FAIL" и т.д.

     Если аргументы не указаны, читаются все файлы, соответствующие *.sum,
     в текущем каталоге.

EXAMPLES
   Простой пример из собственного тестового набора DejaGnu
     $ dejagnu report card
		  __________________________________________________
		 /    PASS   FAIL  ?PASS  ?FAIL	 UNSUP	UNRES UNTEST
		 |--------------------------------------------------
       launcher	 |	52	0      0      0	     0	    0	   0
     libdejagnu	 |	 5	0      0      0	     0	    0	   0
	runtest	 |     135	0      0      0	     0	    0	   0
		 |--------------------------------------------------
		 |     192	0      0      0	     0	    0	   0
		 \__________________________________________________

     Было протестировано три инструмента, с общим количеством 192 тестов,
     все из которых ожидалось, что пройдут.  В этом примере все тесты прошли,
     поэтому все остальные столбцы равны нулю.  Столбцы ‘?PASS’ и ‘?FAIL’
     подсчитывают тесты, которые известны или ожидалось, что провалятся, и
     которые либо неожиданно прошли, либо провалились, как ожидалось.
     Оставшиеся три столбца подсчитывают исключительные результаты для
     неподдерживаемых тестов, неразрешённых тестов и заглушек, которые
     просто объявляют себя не тестированными.




   Тот же пример после добавления тестов для dejagnu-report-card
     $ dejagnu report-card
			 __________________________________________________
			/    PASS   FAIL  ?PASS	 ?FAIL	UNSUP  UNRES UNTEST
			|--------------------------------------------------
	launcher	|      52      0      0	     0	    0	   0	  0
      libdejagnu	|	5      0      0	     0	    0	   0	  0
     report-card / awk	|      36      0      0	     0	    0	   0	  0
     report-card / sh	|      36      0      0	     0	    0	   0	  0
     report-card / tcl	|      36      0      0	     0	    0	   0	  0
	 runtest	|     135      0      0	     0	    0	   0	  0
			|--------------------------------------------------
		   awk	|      36      0      0	     0	    0	   0	  0
		   sh	|      36      0      0	     0	    0	   0	  0
		   tcl	|      36      0      0	     0	    0	   0	  0
			|--------------------------------------------------
			|     300      0      0	     0	    0	   0	  0
			\__________________________________________________

     Инструмент ‘report-card’ был добавлен с тремя проходами, по одному
     для каждой реализации.  (Реализации для оболочки и Tcl позже были
     удалены, чтобы уменьшить будущую нагрузку на обслуживание.)  Как и
     раньше, все тесты прошли, как ожидалось.  Интересное отличие от
     предыдущего примера — использование функции многопроходного тестирования
     DejaGnu и добавление дополнительных строк сводки на проход.  В этом
     примере только инструмент ‘report-card’ использует многопроходное
     тестирование, поэтому общий итог для каждого прохода просто представляет
     собой количество тестов для ‘report-card’, а не отдельный итог.

     Также обратите внимание, что команда для вызова dejagnu report card
     здесь немного отличается.  Запускатель dejagnu(1) также принимает
     несколько слов, объединённых дефисами, в один аргумент.  Это позволяет
     разделять отдельные слова в имени команды дефисами или пробелами
     на командной строке взаимозаменяемо.

SEE ALSO
     dejagnu(1) runtest(1)

     Полная документация для DejaGnu поддерживается в виде руководства Texinfo.
     Если программа info правильно установлена на вашем сайте, команда info
     dejagnu должна предоставить вам доступ к полному руководству.

AUTHORS
     Jacob Bachmeyer

GNU			       31 декабря 2018 года			   GNU

DEJAGNU(1)		    User's Reference Manual		    DEJAGNU(1)

NAME
     dejagnu — вспомогательный запускатель команд DejaGnu

SYNOPSIS
     dejagnu ⟨command⟩ [--help | options...]
     dejagnu --help
     dejagnu --version

DESCRIPTION
     Команда dejagnu находит скрипт, который реализует запрошенную команду,
     выбирает из нескольких реализаций, если они доступны, согласно фиксированному
     внутреннему списку, и выполняет команду.

OPTIONS
     --help	Выводит сообщение помощи вместо выполнения команды. Если команда
		не указана, выводит краткое использование для dejagnu.

     -V, --version
		Выводит баннер версии для самого запуска, включая версию
		DejaGnu. Любая указанная команда игнорируется.

     -v, --verbose
		Выводит дополнительную информацию, описывающую работу
		запускателя dejagnu. Этот параметр также передаётся вызываемой
		команде.

     Все аргументы после имени команды передаются вызываемой команде.

ENVIRONMENT
     DEJAGNULIBS  Если установлен, указывает местоположение библиотеки DejaGnu
		  в файловой системе. Поиск, описанный в разделе FILES, не
		  выполняется, если DEJAGNULIBS установлен.

     AWK	  Полное имя файла для интерпретатора Awk, который может или не
		  быть GNU Awk. Если не установлен, в PATH будет произведён
		  поиск программы awk. Если интерпретатор Awk на самом деле
		  является GNU Awk, будет использован параметр --posix, если
		  применяется реализация Awk.

     GAWK	  Полное имя файла для GNU Awk. Если не установлен, в PATH будет
		  произведён поиск программы gawk.

     BASH	  Полное имя файла для GNU Bash. Если не установлен, в PATH будет
		  произведён поиск программы bash. Обратите внимание, что Bash
		  сама устанавливает эту переменную, даже когда запущена как sh,
		  даже при выполнении скрипта.

     EXPECT	  Полное имя файла для Expect, который является интерпретатором
		  Tcl с уже загруженным расширением Expect. Если не установлен,
		  в PATH будет произведён поиск программы expect. Обратите
		  внимание, что ядро DejaGnu написано на Expect, поэтому этот
		  интерпретатор должен всегда быть доступен.

     TCLSH	  Полное имя файла для интерпретатора Tcl. Если не установлен, в
		  PATH будет произведён поиск программы tclsh.

     Обратите внимание, что GNU Awk считается надмножеством Awk, а Expect —
     надмножеством Tcl, что позволяет использовать первое для запуска скриптов,
     написанных для последнего. Это означает, что, хотя программы Awk в общем
     случае будут запускаться с отключёнными расширениями GNU с помощью параметра
     --posix для GNU Awk, программы Tcl могут запускаться либо с tclsh, либо с
     expect и должны быть написаны соответственно.

FILES
     $DEJAGNULIBS/commands  Если DEJAGNULIBS установлен, все скрипты команд
			    ожидаются в этом каталоге.
     В противном случае используется первый каталог, который на самом деле
     существует в следующем списке, где @bindir@ представляет каталог,
     содержащий dejagnu.

	   @bindir@/../share/dejagnu/commands

	   @bindir@/../../share/dejagnu/commands

	   /usr/share/dejagnu/commands

	   /usr/local/share/dejagnu/commands

SEE ALSO
     Полная документация для DejaGnu поддерживается в виде руководства Texinfo.
     Если программа info правильно установлена на вашем сайте, команда info
     dejagnu должна предоставить доступ к полному руководству.

AUTHORS
     Jacob Bachmeyer

BUGS
     Имя команды должно предшествовать всем другим аргументам из-за ограничений
     оболочки.

GNU			       17 декабря 2018 г.			   GNU

DEJAGNU-HELP(1)		    Справочник пользователя	       DEJAGNU-HELP(1)

NAME
     dejagnu help — отображение страниц руководства для вспомогательных команд DejaGnu

SYNOPSIS
     dejagnu help [options...] ⟨command⟩

DESCRIPTION
     Команда dejagnu help отображает подробную документацию для вспомогательных
     команд DejaGnu.

OPTIONS
     -v, --verbose  Выводить дополнительный вывод, описывающий работу
		    самой команды dejagnu help.

     -w, --path	    Эта опция просто передается man.

     -W		    Эта опция просто передается man.

FILES
     Команда dejagnu help проверяет наличие страниц руководства в каталоге doc/,
     расположенном рядом с каталогом commands/, где находится этот скрипт.  Если
     страница найдена там, то man передается полное имя файла.  В противном
     случае передается только имя команды, и выполняется поиск, описанный в man(1).

SEE ALSO
     man(1)

AUTHORS
     Jacob Bachmeyer

BUGS
     В настоящее время поддерживает только страницы руководства.

GNU			       19 декабря 2018			    GNU