Команды Tracefmt

Чтобы использовать Tracefmt, введите команды в окне командной строки. Следующий синтаксис отображает элементы команды Tracefmt.

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

Чтобы указать TMF-файл или путь к каталогу файлов TMF:

    tracefmt [EtlFile | -rt SessionName][-tmf TMFFile | -p TMFPath ] [Options]

Чтобы создать TMF-файл, выполните следующее:

    tracefmt [EtlFile | -rt SessionName]-i ImageFiles [-r SymbolPath ] [-p TmfPath ] [Options]

Отображение синтаксиса в командной строке.

    tracefmt -h | /?

Параметры

EtlFile
Указывает файл журнала трассировки событий (ETL), содержащий сообщения трассировки. Введите путь (необязательно) и имя файла. Значение по умолчанию — c:\logfile.etl.

-rtSessionName
В режиме реального времени. Форматирует сообщения трассировки из указанных сеансов трассировки в режиме реального времени, а не из журнала трассировки.

SessionName — это имя сеанса трассировки. Значение по умолчанию — NT Kernel Logger.

-tmfTMFFile
Указывает путь (необязательно) и имя файла формата сообщений трассировки (TMF) для сообщений трассировки. Значение по умолчанию — Default.tmf, файл, включенный в WDK.

-iImageFiles
Направляет Tracefmt на поиск файлов символов PDB для указанных файлов изображений и создание TMF-файла на основе инструкций по форматированию в PDB-файлах.

ImageFiles представляет путь и имена файлов одного или нескольких двоичных файлов (.exe, .dll или .sys) для поставщиков трассировки. Использование точки с запятой (;) для разделения имен файлов изображений.

-rSymbolPaths
Указывает расположение частных файлов символов PDB для файлов изображений, указанных в параметре -i.

SymbolPaths представляет один или несколько путей к каталогам, в которые хранятся частные символы или пути к серверу символов. Использование точки с запятой (;) для разделения имен путей. Имена путей в SymbolPaths могут содержать подстановочные знаки, например звездочку (*) для представления нескольких символов и вопросительный знак (?) для представления одного символа.

Если включить -i в команду, но опустить -r, Tracepdb выполняет поиск PDB-файлов для указанных изображений по путям, указанным в переменной среды %_NT_SYMBOL_PATH%. Если переменная среды не задана, Tracepdb выполняет поиск по пути символов по умолчанию srv*\\\symbols\\symbols.

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

Если параметр -p используется без -i, Tracefmt выполняет поиск существующего файла TMF по пути, указанному параметром -p . Если параметр -p опущен, Tracefmt ищет файл TMF в значении переменной среды %TRACE_FORMAT_SEARCH_PATH%, если он задан. В противном случае Tracefmt попытается применить инструкции по форматированию в файле Default.tmf.

Если параметр -p используется с параметром -i, Tracefmt помещает создаваемый файл TMF в каталог, указанный параметром -p. Если параметр -p опущен, Tracefmt помещает файл TMF в каталог, указанный значением переменной среды %TRACE_FORMAT_SEARCH_PATH%, если он задан. В противном случае Tracefmt помещает файл в локальный каталог.

-H | /?
Вывод справки.

-oOutputFile
Задает альтернативные имена для выходного файла Tracefmt и файла сводного сообщения Tracefmt. Значения по умолчанию: FmfFile.txt (для выходного файла) и FmtSum.txt.sum (для суммарного файла) в локальном каталоге.

OutputFile — это путь и имя файла с расширением имени файла .txt, например c:\traces\trace.txt.

Если этот параметр используется с параметрами -displayonly или -summaryonly , он влияет только на файл сводного сообщения.

-Csv
Форматирует выходной файл Tracefmt как файл переменной длины (.csv), разделенный запятыми. В этом формате к каждому сообщению добавляется подробный структурированный префикс в дополнение к стандартному префиксу сообщения трассировки.

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

-csvheader
Добавляет строку описательных заголовков столбцов в CSV-файл. Этот заголовок особенно полезен для интерпретации структурированного префикса, который Tracefmt добавляет в CSV-файлы. По умолчанию CSV-файлы Tracefmt не имеют заголовков столбцов.

-csvquote
Удваивает все кавычки (") в CSV-файле. Эта функция предназначена для приложений, которые отображают кавычки только в том случае, если они заключены в кавычки.

-Отображения
Отображает сообщения трассировки в окне командной строки, а также записывает их в выходной файл.

-displayonly
Отображает сообщения трассировки только в окне командной строки и не создает выходной файл.

-nosummary
Не создает файл сводных сообщений.

-summaryonly
Создает только файл сводного сообщения. Tracefmt не создает выходной файл.

-noprefix
Пропускает префикс сообщения трассировки. Этот параметр влияет на сообщения трассировки в выходном файле и на дисплее Tracefmt.

-Нанимает
Высокое разрешение. Отображает количество микросекунд и наносекунд в метке времени сообщения трассировки. По умолчанию отображаются только миллисекунда.

Используйте этот параметр, если для метки времени сообщения трассировки используется значение счетчика производительности вместо системного таймера, например при использовании параметра Tracelog -UsePerfCounter . Сведения о командах Tracelog см. в разделе Синтаксис команд Tracelog.

-Seq
Отображает локальные или глобальные порядковые номера в префиксе сообщения трассировки. Если порядковые номера не были записаны в сообщении, поле не инициализируется или заполняется нулями или f.

-Ods
Отправляет отформатированные сообщения трассировки отладчику для отображения.

-Gmt
Отображает метку времени для каждого сообщения трассировки в среднем по Гринвичу (GMT).

Этот параметр влияет только на выходной файл Tracefmt. Метки времени в файле журнала трассировки событий (ETL) не преобразуются. Часовой пояс журнала трассировки отображается при отправке команды Tracefmt.

-Utc
Отображает метку времени для каждого сообщения трассировки в формате UTC. UTC почти идентично GMT, но представляет полночь как ноль.

Этот параметр влияет только на выходной файл Tracefmt. Метки времени в файле журнала трассировки событий (ETL) не преобразуются. Часовой пояс файла журнала трассировки отображается при отправке команды Tracefmt.

-Трассировки
Отображает действия Tracefmt по мере их возникновения. Эти сведения полезны, если форматирование неправильно или tracefmt сообщает об ошибке или исключении.

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

-V
Подробного. Отображает подробные сведения в окне командной строки, так как Tracefmt обрабатывает каждый блок или буфер сообщений трассировки. Используйте этот параметр, если вы подозреваете повреждение файла или несоответствие.

Комментарии

Поиск TMF-файла

Если опустить параметр -i , Tracefmt использует следующие методы для поиска TMF-файла. Методы перечислены в том порядке, в котором tracefmt использует их.

• Параметр -tmf .

• Параметр -p .

• Переменная среды %TRACE_FORMAT_SEARCH_PATH%.

• Default.tmf, файл, включенный в WDK.

Если Tracefmt не может найти TMF-файл или TMF-файл не содержит сведения о форматировании для сообщений трассировки, Tracefmt не сможет отобразить сообщения. Вместо этого он записывает следующее сообщение об ошибке вместо сообщения трассировки

No Format Information found.

Возникло исключение

Если Tracefmt не может отформатировать параметр сообщения трассировки, он создает исключение и отображает следующее сообщение:

*****FormatMessage Header(Header) of EventTrace, parameter 23 raised an exception*****

Если вы видите аналогичное исключение, просмотрите определение сообщения в исходном коде с особым вниманием к любым типам переменных, заданным пользователем. Дополнительные сведения см. в разделе DoTraceMessage.

Файлы TMF с именами файлов без GUID

Если имя файла TMF не является GUID сообщения, необходимо использовать параметр -tmf для идентификации файла и ввести полный путь к файлу.

Форматирование сообщений трассировки средства ведения журнала ядра NT

Чтобы отформатировать сообщения из сеанса трассировки nt Kernel Logger или сеанса трассировки глобального средства ведения журнала, используйте параметр -tmf, чтобы указать файл system.tmf, файл формата сообщений трассировки , включенный в WDK..

Форматирование сообщений трассировки из сеансов трассировки в режиме реального времени

При использовании параметра -rt (в режиме реального времени) Tracefmt отображает сообщение, подтверждающее, что он находится в режиме реального времени, а затем ожидает сообщений трассировки от указанного поставщика трассировки. Он не возвращается в командную строку, пока не остановится сеанс трассировки.

Форматирование меток времени QPC

Tracefmt неправильно форматируют значения системных счетчиков производительности (QueryPerformanceCounter). Если вы используете это время с высоким разрешением, используйте средство Tracerpt, входящее в состав Windows, для форматирования сообщений трассировки. Дополнительные сведения см. в описании параметра -UsePerfCounter в разделе Синтаксис команды Tracelog.

Сообщения трассировки вне последовательности

Если вы просматриваете файл сообщений трассировки на компьютере под управлением Windows XP, на экране могут отображаться сообщения трассировки, которые находятся вне последовательности. Чтобы устранить эту проблему, можно использовать параметр порядкового номера при запуске сеанса трассировки и просмотре трассировки с помощью Tracefmt. Затем можно просмотреть трассировку с помощью Traceview и выполнить сортировку в соответствии с порядковой номером. Вы также можете просмотреть трассировку на компьютере под управлением Windows Server 2003 или более поздних версий Windows.