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

ПРОГРАММА:

ИМЯ

lcov - графический интерфейс GCOV

СИНТАКСИС

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

Лков -z|- нулевые счетчики
[-d|- каталог каталог] [- без рекурсии] [-f|--следить]
[-q|--тихий]

Лков -l|--список файл трассировки
[-q|--тихий] [--list-полный путь] [--no-list-полный путь]
[--config-файл config-файл] [--rc ключевое слово=ценностное ]

Лков -a|--add-файл трассировки файл трассировки
[-o|--выходной файл файл трассировки] [- контрольная сумма] [--нет контрольной суммы]
[-q|--тихий] [--config-файл config-файл] [--rc ключевое слово=ценностное ]

Лков -e|--извлекать файл трассировки описания
[-o|--выходной файл файл трассировки] [- контрольная сумма] [--нет контрольной суммы]
[-q|--тихий] [--config-файл config-файл] [--rc ключевое слово=ценностное ]

Лков -r|--Удалить файл трассировки описания
[-o|--выходной файл файл трассировки] [- контрольная сумма] [--нет контрольной суммы]
[-q|--тихий] [--config-файл config-файл] [--rc ключевое слово=ценностное ]

Лков --diff файл трассировки Разница
[-o|--выходной файл файл трассировки] [- контрольная сумма] [--нет контрольной суммы]
[--convert-имена файлов] [--полоска глубина] [--дорожка путь] [-q|--тихий]
[--config-файл config-файл] [--rc ключевое слово=ценностное ]

Лков --резюме файл трассировки
[-q|--тихий]

Лков [-h|--Помогите] [-v|--версия]

ОПИСАНИЕ

Лков - это графический интерфейс для инструмента тестирования покрытия GCC gcov. Собирает строчку,
данные о функциях и ветвях для нескольких исходных файлов и создание HTML-страниц
содержащий исходный код, аннотированный информацией о покрытии. Он также добавляет обзор
страницы для удобной навигации по файловой структуре.

Используйте Лков для сбора данных о покрытии и генхтмл для создания HTML-страниц. Данные о покрытии могут
либо собираться из работающего в данный момент ядра Linux, либо из пользовательского пространства
заявление. Для этого вам необходимо выполнить следующие подготовительные шаги:

Для покрытия ядра Linux:
Следуйте инструкциям по настройке инфраструктуры gcov-kernel:
http://ltp.sourceforge.net/coverage/gcov.php

Для покрытия приложений пользовательского пространства:
Скомпилируйте приложение с GCC, используя параметры "-fprofile-arcs" и
"-ftest-охват".

Обратите внимание, что эта страница руководства относится к формату вывода Лков как ".info файл" или
"файл трассировки", а вывод GCOV называется "файлом .da".

Также обратите внимание, что при печати процентов 0% и 100% печатаются только тогда, когда значения
ровно 0% и 100% соответственно. Другие значения, которые обычно округляются до 0%.
или 100% вместо этого печатаются как ближайшее не граничное значение. Такое поведение соответствует
с этим из gcov(1) инструмент.

ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

-a файл трассировки
--add-файл трассировки файл трассировки
Добавить содержимое файл трассировки.

Укажите несколько файлов трассировки с помощью переключателя -a для объединения данных покрытия
содержащиеся в этих файлах, суммируя счетчики выполнения для сопоставления теста и
комбинации имен файлов.

Результат операции добавления будет записан в стандартный вывод или в файл трассировки.
указывается с помощью -o.

Только один из -z, -c, -a, -e, -r, -l, --diff или --summary может быть указан в
времени.

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

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

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

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

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

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

-c
--захватывать
Сбор данных о покрытии.

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

Результат операции захвата будет записан в стандартный вывод или в файл трассировки.
указывается с помощью -o.

Только один из -z, -c, -a, -e, -r, -l, --diff или --summary может быть указан в
времени.

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

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

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

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

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

Используйте --compat, чтобы указать, что lcov должен включать один или несколько режимов совместимости.
при сборе данных о покрытии. Вы можете указать разделенный запятыми список 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. Типичные сообщения об ошибках при
запуск lcov на данных о покрытии, созданных такими версиями GCC, находится вне
память 'и' достигнут неожиданный конец файла '.

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

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

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

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

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

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

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

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

--convert-имена файлов
Преобразуйте имена файлов при применении diff.

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

--diff файл трассировки различный
Преобразование данных о покрытии в файл трассировки с использованием файла сравнения исходного кода различный.

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

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

Результат операции diff будет записан в стандартный вывод или в файл трассировки.
указывается с помощью -o.

Только один из -z, -c, -a, -e, -r, -l, --diff или --summary может быть указан в
времени.

-d каталог
- каталог каталог
Используйте файлы .da в каталог вместо ядра.

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

Обратите внимание, что вы можете указать эту опцию более одного раза.

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

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

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

-e файл трассировки описания
--извлекать файл трассировки описания
Извлечь данные из файл трассировки.

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

Результат операции извлечения будет записан в стандартный вывод или в файл трассировки.
указывается с помощью -o.

Только один из -z, -c, -a, -e, -r, -l, --diff или --summary может быть указан в
времени.

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

--из-пакета пакет
Используйте файлы .da в пакет вместо ядра или каталога.

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

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

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

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

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

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

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

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

график: файл графика не может быть найден или поврежден.

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

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

Рекомендуемая процедура при сборе данных для тестового примера:

1. создать файл данных базового покрытия
# lcov -c -i -d appdir -o app_base.info

2. выполнить тест
# appdir / test

3. создать файл данных тестового покрытия
# lcov -c -d appdir -o app_test.info

4. объедините базовые данные и данные о тестовом покрытии.
# lcov -a app_base.info -a app_test.info -o app_total.info

-k подкаталог
- каталог-ядра подкаталог
Захват данных о покрытии ядра только из подкаталог.

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

Обратите внимание, что вам может потребоваться указать полный путь к подкаталогу ядра.
в зависимости от версии ядра, поддерживаемого gcov.

-l файл трассировки
--список файл трассировки
Перечислите содержание файл трассировки.

Только один из -z, -c, -a, -e, -r, -l, --diff или --summary может быть указан в
времени.

--list-полный путь
--no-list-полный путь
Укажите, следует ли отображать полные пути при работе со списком.

Используйте --list-full-path для отображения полных путей во время работы со списком или
--no-list-full-path, чтобы показать сокращенные пути. Пути укороченный по умолчанию.

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

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

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

Укажите «-» в качестве имени файла, чтобы использовать стандартный вывод.

По соглашению файлы данных покрытия, сгенерированные lcov, называются "файлами трассировки" и
должно иметь расширение имени файла ".info".

--дорожка путь
Удалите путь из имен файлов при применении diff.

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

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

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

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

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

-r файл трассировки описания
--Удалить файл трассировки описания
Удалить данные из файл трассировки.

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

Результат операции удаления будет записан в стандартный вывод или в файл трассировки.
указывается с помощью -o.

Только один из -z, -c, -a, -e, -r, -l, --diff или --summary может быть указан в
времени.

--полоска глубина
Удалите компоненты пути при применении diff.

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

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

Обратите внимание, что вы можете указать эту опцию более одного раза.

Только один из -z, -c, -a, -e, -r, -l, --diff или --summary может быть указан в
времени.

-t имя теста
--test-имя имя теста
Укажите имя теста, которое будет сохранено в файле трассировки.

Это имя идентифицирует набор данных покрытия, когда более одного набора данных объединяются в
комбинированный файл трассировки (см. параметр -a).

Допустимые имена тестов могут состоять из букв, десятичных цифр и символа подчеркивания.
персонаж ("_").

--в-пакет пакет
Сохраните файлы .da для последующей обработки.

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

На тестовой машине:
- запустить тест
- запустите lcov -c [-d каталог] --to-package файл
- копировать файл к строительной машине

На машине сборки:
- запустите lcov -c --from-package файл [-o и другие параметры]

Это работает как для данных ядра, так и для данных о покрытии пользовательского пространства. Обратите внимание, что у вас может быть
чтобы указать путь к каталогу сборки, используя -b с --to-package или
- из пакета. Также обратите внимание, что данные пакета должны быть преобразованы в файл .info.
перед перекомпиляцией программы, иначе она станет недействительной.

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

-z
- нулевые счетчики
Сбросить все счетчики выполнения на ноль.

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

Только один из -z, -c, -a, -e, -r, -l, --diff или --summary может быть указан в
времени.

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