geninfo - Интернет в облаке

ПРОГРАММА:

ИМЯ

geninfo - генерирует файлы трассировки из файлов .da

СИНТАКСИС

генинфо [-h|--Помогите] [-v|--версия] [-q|--тихий]
[-i|--исходный] [-t|--test-имя название теста]
[-o|--имя выходного файла имя файла] [-f|--следить]
[-b|--base-каталог каталог]
[- контрольная сумма] [--нет контрольной суммы]
[--compat-libtool] [--no-compat-libtool]
[--gcov-инструмент инструментом] [- игнорировать ошибки Ошибки]
[- без рекурсии] каталог [--внешний] [- без внешнего]
[--config-файл config-файл] [--без маркеров]
[--получить-функции-данные] [--compat Режим= вкл | выкл | авто]
[--rc ключевое слово=ценностное ]

ОПИСАНИЕ

генинфо конвертирует все файлы данных покрытия GCOV, найденные в каталог в файлы трассировки, которые
домен генхтмл инструмент может конвертировать в вывод HTML.

Если не указан параметр --output-filename, генинфо записывает свой вывод в один файл
на файл .da, имя которого создается путем простого добавления ".info" к соответствующему
Имя файла .da.

Обратите внимание, что текущему пользователю требуется доступ на запись к обоим каталог а также к оригиналу
расположение исходного кода. Это необходимо, потому что необходимо создать некоторые временные файлы.
там в процессе преобразования.

Отметим также, что генинфо вызывается изнутри Лков, так что обычно нет необходимости
позвони прямо.

Исключение маркеры

Чтобы исключить определенные строки кода из файла трассировки, вы можете добавить маркеры исключения в
исходный код. Кроме того, вы можете исключить определенные ветки из покрытия веток без
исключение задействованных линий из покрытия линий и функций. Маркеры исключения
ключевые слова, которые можно, например, добавить в виде комментария. Видеть lcovrc(5) как
перекрыть некоторые из них.

Geninfo распознает следующие маркеры:

LCOV_EXCL_LINE
Строки, содержащие этот маркер, будут исключены.
LCOV_EXCL_START
Обозначает начало исключенного раздела. Текущая строка является частью этого
.
LCOV_EXCL_STOP
Обозначает конец исключенного раздела. Текущая строка не является частью этого раздела.
LCOV_EXCL_BR_LINE
Строки, содержащие этот маркер, будут исключены из покрытия ветки.
LCOV_EXCL_BR_START
Обозначает начало раздела, который исключается из покрытия ветки. В
Текущая строка является частью этого раздела.
LCOV_EXCL_BR_STOP
Обозначает конец раздела, который исключен из покрытия ветки. Текущая строка
не входит в этот раздел.

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

-b каталог
--base-каталог каталог
Используйте каталог как базовый каталог для относительных путей.

Используйте эту опцию, чтобы указать базовый каталог среды сборки, когда geninfo
выдает сообщения об ошибках, например:

ОШИБКА: не удалось прочитать исходный файл
/home/user/project/subdir1/subdir2/subdir1/subdir2/file.c

В этом примере используйте / home / user / project в качестве базового каталога.

Эта опция требуется при использовании geninfo в проектах, созданных с помощью libtool или
аналогичные среды сборки, которые работают с базовым каталогом, т. е. среды,
где текущий рабочий каталог при вызове компилятора не совпадает
каталог, в котором находится файл с исходным кодом.

Обратите внимание, что этот параметр не будет работать в средах, где несколько базовых каталогов
используются. В этом случае используйте настройку файла конфигурации geninfo_auto_base = 1 (См.
lcovrc(5 г.)).

- контрольная сумма
--нет контрольной суммы
Укажите, следует ли генерировать данные контрольной суммы при записи файлов трассировки.

Используйте --checksum, чтобы включить генерацию контрольной суммы, или --no-checkum, чтобы отключить ее.
Генерация контрольной суммы инвалид по умолчанию.

Когда генерация контрольной суммы включена, контрольная сумма будет генерироваться для каждого источника.
кодовая строка и сохраняется вместе с данными покрытия. Эта контрольная сумма будет использоваться для
предотвращать попытки объединения данных покрытия из разных версий исходного кода.

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

--compat Режим=ценностное [,Режим=ценностное , ...]
Установите режим совместимости.

Используйте --compat, чтобы указать, что geninfo должен включать один или несколько режимов совместимости.
при сборе данных о покрытии. Вы можете указать разделенный запятыми список mode = value
пары, чтобы указать значения для нескольких режимов.

Действительный ценности составляют:

on
Включите режим совместимости.
от
Отключить режим совместимости.
автоматический
Примените автоматическое обнаружение, чтобы определить, требуется ли режим совместимости. Примечание
это автоматическое определение доступно не для всех режимов совместимости.

Если значение не указано, в качестве значения по умолчанию принимается «on».

Действительный Режимы составляют:

Libtool
Включите этот режим, если вы собираете данные о покрытии для проекта, который был
построен с использованием механизма libtool. См. Также --compat-libtool.

Значение по умолчанию для этого параметра - «включено».

забивать
Включите этот режим, если вы собираете данные о покрытии для проекта, который был
построен с использованием версии GCC 3.3, которая содержит модификацию (патч молотка)
более поздних версий GCC. Вы можете идентифицировать модифицированный GCC 3.3, проверив
каталог сборки вашего проекта для файлов с расширением '.bbg'.
В немодифицированных версиях GCC 3.3 эти файлы называются «.bb».

Значение по умолчанию для этого параметра - «авто».

Split_crc
Включите этот режим, если вы собираете данные о покрытии для проекта, который был
построен с использованием версии GCC 4.6, которая содержит модификацию (split
контрольные суммы функций) более поздних версий GCC. Типичные сообщения об ошибках при
запуск geninfo для данных о покрытии, произведенных такими версиями GCC, не входит в
память 'и' достигнут неожиданный конец файла '.

Значение по умолчанию для этого параметра - «авто».

--compat-libtool
--no-compat-libtool
Укажите, следует ли включить режим совместимости с libtool.

Используйте --compat-libtool, чтобы включить режим совместимости с libtool, или --no-compat-libtool, чтобы
отключи это. Режим совместимости с libtool: включен по умолчанию.

Когда включен режим совместимости с libtool, geninfo будет считать, что исходный код
код, относящийся к файлу .da, расположенному в каталоге с именем ".libs", можно найти в
его родительский каталог.

Если у вас есть каталоги с именем ".libs" в среде сборки, но не используйте
libtool, отключите эту опцию, чтобы предотвратить проблемы при захвате данных покрытия.

--config-файл config-файл
Укажите файл конфигурации для использования.

Когда указана эта опция, ни общесистемный файл конфигурации
/ etc / lcovrc, ни файл конфигурации для каждого пользователя ~ / .lcovrc читается

Эта опция может быть полезна, когда необходимо запустить несколько экземпляров генинфо
с различными параметрами файла конфигурации параллельно.

--получить-функции-данные
Рассчитайте данные о покрытии функций на основе данных о покрытии линий.

Используйте эту опцию для сбора данных о покрытии функций, даже если версия gcov
Инструмент, установленный в тестовой системе, не предоставляет эти данные. ICOV вместо этого
получить данные о покрытии функций из данных о покрытии линий и информацию о том, какие
линии принадлежат функции.

--внешний
- без внешнего
Укажите, следует ли записывать данные покрытия для внешних исходных файлов.

Внешние исходные файлы - это файлы, которые не находятся ни в одном из каталогов.
указывается --directory или --base-directory. Используйте --external, чтобы включить внешний
исходные файлы при захвате данных покрытия или --no-external, чтобы игнорировать эти данные.

Данные для внешних исходных файлов включены по умолчанию.

-f
--следить
Следуйте ссылкам при поиске файлов .da.

--gcov-инструмент инструментом
Укажите расположение инструмента gcov.

-h
--Помогите
Распечатайте короткий справочный текст и выйдите.

- игнорировать ошибки Ошибки
Укажите список ошибок, после которых следует продолжить обработку.

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

Ошибки может быть разделенным запятыми списком следующих ключевых слов:

гков: инструмент gcov возвратил ненулевой код возврата.

Источник: не удалось найти файл исходного кода для набора данных.

-i
--исходный
Захватите начальные данные нулевого покрытия.

Запустите geninfo с этой опцией для каталогов, содержащих файлы .bb, .bbg или .gcno.
перед запуском любого тестового примера. Результатом является "базовый" файл данных о покрытии, который
содержит нулевое покрытие для каждой инструментальной линии и функции. Объедините эти данные
файл (с помощью lcov -a) с файлами данных покрытия, записанными после пробного запуска, чтобы гарантировать
что процент охваченных строк верен, даже если не весь объектный код
файлы были загружены во время теста.

Примечание: в настоящее время параметр --initial не генерирует покрытие ветки.
Информация.

--без маркеров
Используйте эту опцию, если хотите получить данные о покрытии без учета исключения.
маркеры в файле исходного кода.

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

-o имя выходного файла
--имя выходного файла имя выходного файла
Записать все данные в имя выходного файла.

Если вы хотите, чтобы все данные были записаны в один файл (для упрощения обработки), используйте
этот параметр, чтобы указать соответствующее имя файла. По умолчанию один файл трассировки будет
создается для каждого обработанного файла .da.

-q
--тихий
Не печатать сообщения о ходе выполнения.

Подавляет весь вывод информации о прогрессе. Когда этот переключатель включен, только
печатаются сообщения об ошибках или предупреждениях.

--rc ключевое слово=ценностное
Отменить директиву конфигурации.

Используйте эту опцию, чтобы указать ключевое слово=ценностное заявление, которое отменяет
соответствующий оператор конфигурации в файле конфигурации lcovrc. Вы можете
укажите эту опцию более одного раза, чтобы переопределить несколько операторов конфигурации.
Читать lcovrc(5) для списка доступных ключевых слов и их значения.

-t имя теста
--test-имя имя теста
Использовать название тестового примера имя теста для результирующих данных. Допустимые имена тестовых примеров могут состоять из
букв, десятичных цифр и символа подчеркивания ('_').

Это оказывается полезным, когда данные из нескольких тестовых случаев объединяются (т. Е. Просто
объединение соответствующих файлов трассировки), и в этом случае имя теста может использоваться для
различать данные из каждого тестового примера.

-v
--версия
Напечатайте номер версии и выйдите.

Используйте geninfo онлайн с помощью сервисов onworks.net