Команды 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.

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

Имя сеанса трассировки — это имя сеанса трассировки. По умолчанию используется средство ведения журнала ядра NT.

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

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

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

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

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

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

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

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

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

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

-o OutputFile
Задает альтернативные имена выходного файла 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".

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

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

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

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

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

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

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

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

-v
Verbose. Отображает подробные сведения в окне командной строки, так как 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.