Параметры командной строки SymChk

SymChk использует следующий синтаксис:

symchk [/r] [/v | /q ] FileNames /s[Opts] SymbolPath Options

symchk [/r] [/v | /q ] /ie ExeFile /s[Opts] SymbolPath Options

symchk [/r] [/v | /q ] /id DumpFile /s[Opts] SymbolPath Options

symchk [/r] [/v | /q ] /ih HotFixFile /s[Opts] SymbolPath Options

symchk [/r] [/v | /q ] /ip ProcessID /s[Opts] SymbolPath Options

symchk [/r] [/v | /q ] /it TextFileList /s[Opts] SymbolPath Options

symchk [/r] [/v | /q ] /om Manifest FileNames

symchk [/v | /q ] /im ManifestList /s[Opts] SymbolPath Options

symchk [/v | /q ] /om Manifest /ie ExeFile

symchk [/v | /q ] /om Manifest /id DumpFile

symchk [/v | /q ] /om Manifest /ih HotFixFile

symchk [/v | /q ] /om Manifest /ip ProcessFile

symchk [/v | /q ] /om Manifest /it TextFileList

Параметры

/r
Если файл указывает каталог, параметр /r приводит к рекурсивному поиску всех подкаталогов в этом каталоге для файлов программы.

/v
Отображает подробные сведения. К ним относятся имя каждого файла программы, символы которого были расследованы и были ли переданы, пропущены или пропущены.

/q
Включает тихий режим. Все выходные данные будут подавляться (если параметр /ot не включен).

Имена
Указывает файлы программы, символы которых необходимо проверить. Разрешены абсолютные пути, относительные пути и UNC-пути. Допускается подстановочный знак звездочки (*). Если *FileNames заканчивается косой чертой, он должен быть именем каталога, а все файлы в этом каталоге проверяются. Если fileNames содержит пробелы , он должен быть заключен в кавычки.

/ie ExeFile
Указывает имя программы, выполняемой в настоящее время. Будут проверены символы для этой программы. ExeFile должен содержать имя файла и расширения (обычно .exe), но нет сведений о пути. Если существует два разных исполняемых файла с одинаковым именем, этот параметр не рекомендуется. ExeFile может указать любую программу, включая драйвер в режиме ядра. Если ExeFile является одной звездочкой (*), SymChk проверяет символы для всех выполняемых процессов, включая драйверы.

/идентификатор DumpFile
Указывает файл дампа памяти. Будут проверены символы этого файла дампа.

/ih HotFixFile
Задает самораспаковывающийСЯ CAB-файл исправлений.

/протокол IP ProcessID
Указывает идентификатор процесса программы, выполняемой в данный момент. Будут проверены символы для этой программы. ProcessID должен быть указан как десятичное число. Поддерживаются два специальных подстановочных знака:

• Если ProcessID равно нулю ( 0 ), SymChk проверяет символы для всех запущенных драйверов.

• Если ProcessID является одной звездочкой (*), SymChk проверяет символы для всех выполняемых процессов, включая драйверы.

/оно TextFileList
Указывает текстовый файл, содержащий список программных файлов. Будут проверены символы для всех этих программ. TextFileList должен указывать ровно один файл (по относительному, абсолютному или UNC-пути, но без подстановочных знаков); если он содержит пробелы, они должны быть заключены в кавычки. В этом файле каждая строка указывает файл программы (по относительным, абсолютным или UNC-путям), а звездочка* () разрешена. Однако любая строка с помощью этого подстановочного знака должна использовать относительный путь.

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

/im ManifestList
Указывает, что входные данные команды — это файл манифеста, созданный ранее с помощью параметра /om . Файл манифеста содержит сведения о файлах, для которых извлекаются символы. Дополнительные сведения об использовании файла манифеста см. в разделе "Использование файла манифеста" с SymChk.

/Ом Очевидный
Указывает, что создается файл манифеста. Файл манифеста содержит сведения о наборе файлов, для которых будут извлекаться символы с помощью параметра /im в дальнейшем.

/s[Opts] SymbolPath
Указывает каталоги, содержащие символы. Разрешены абсолютные пути, относительные пути и UNC-пути. Любое количество каталогов можно указать. Несколько каталогов должны быть разделены точкой с запятой. Если SymbolPath содержит пробелы, он должен быть заключен в кавычки. Если вы хотите указать сервер символов в этом пути, следует использовать один из следующих синтаксисов:

srv*DownstreamStore*\\Server\Share
srv*\\Server\Share

Не рекомендуется пропускать параметр /s[Opts] SymbolPath, но если он опущен, SymChk будет указывать на общедоступное хранилище символов с помощью следующего пути по умолчанию:

srv*%SystemRoot%\symbols*https://msdl.microsoft.com/download/symbols

Любое число следующих параметров может следовать /s. Между /s и этими параметрами не может быть пробела:

e
SymChk проверяет каждый путь по отдельности вместо проверки всех путей одновременно.

u
Последующие хранилища будут обновлены. Если путь к символам включает в себя нижнее хранилище, хранилище символов будет искать файлы символов. Будут обновлены только хранилища символов, которые проверяются SymChk.

p
Принудительное проверка частных символов. Общедоступные символы будут рассматриваться как не соответствующие. Параметр p подразумевает e и u и не может использоваться с s.

s
Принудительное проверка общедоступных (разделенных) символов. Закрытые символы будут рассматриваться как не соответствующие. Параметр s подразумевает e и u, и не может использоваться с p.

r
Разверните все элементы сервера, отличные от символов, в указанном пути, чтобы выполнить глубокий поиск пути. ПРИМЕЧАНИЕ. Этот параметр может создавать совпадения, которые не будут возникать внутри отладчика, так как он изменяет указанный путь символа.

Параметры доступные параметры разделены на несколько классов. Каждый класс параметров управляет различным набором функций.

Параметры вывода. Можно указать любое количество следующих параметров. Эти параметры можно сократить с помощью /o только один раз. Например, /oi /oe можно записать как /oie.

Вариант	Действие
/oe	Выходные данные включают отдельные ошибки. Этот параметр полезен только в том случае, если используется /q , так как отдельные ошибки автоматически отображаются, если не активирован тихий режим.
/op	Выходные данные будут перечислять каждый файл, который проходит. (По умолчанию SymChk отображает только файлы, которые завершаются сбоем.)
/oi	Выходные данные перечисляют каждый файл, который был проигнорирован. (По умолчанию SymChk отображает только файлы, которые завершаются сбоем.)
/od	Выходные данные будут содержать полные сведения. То же, что и /oe /op /oi.
/ot	Выходные данные будут включать итоги результатов. Этот параметр полезен только в том случае, если используется /q , так как эти итоги автоматически отображаются, если не активирован тихий режим.
/Обь	Полный путь к двоичным файлам будет включен во все выходные сообщения.
/ОС	Полный путь к символам будет включен во все выходные сообщения.
/oc Dir	SymChk создаст традиционное дерево символов в каталоге Dir , который содержит список всех проверенных файлов символов.
/ov	SymChk будет печатать сведения о версии для проверенных двоичных файлов, а также.
/ol File	Помимо сообщений, отправленных в стандартный режим, напишите файл, содержащий разделенный запятыми список всех двоичных файлов и их символов, которые передают проверку символов.

Параметры файла DBG. Эти параметры управляют тем, как SymChk проверяет файлы символов DBG . Можно указать только один из следующих параметров.

Вариант	Действие
/ds	SymChk проверяет, что сведения dbg были удалены из исполняемого файла и отображаются только в DBG-файле и что исполняемый файл указывает на DBG-файл. Если программа была создана без файлов символов DBG, этот параметр не действует. Это значение по умолчанию.
/де	SymChk проверяет, что данные dbg не были удалены из исполняемого файла, и что исполняемый файл не указывает на DBG-файл. Если программа была создана без файлов символов DBG, этот параметр не действует.
/dn	SymChk убедитесь, что сведения dbg отсутствуют в изображении, и что изображение не указывает на DBG-файл.

Параметры PDB-файла. Эти параметры управляют тем, как SymChk проверяет файлы символов PDB. Можно указать только один из следующих параметров.

Вариант	Действие
/pf	SymChk не проверяет содержимое PDB-файла. Он просто проверяет, существуют ли файлы и соответствуют двоичному файлу. Это значение по умолчанию.
/ps	SymChk проверяет, что PDB-файлы были лишены исходной строки, типа данных и глобальной информации.
/точка	SymChk проверяет, содержат ли PDB-файлы сведения о типе данных.

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

Вариант	Действие
Модуль /fm	SymChk проверяет только файлы дампа или процессы, связанные с указанным модулем. Модуль должен содержать полное имя файла, но не должен включать ни одну часть пути к каталогу.

Параметры проверки символов. Можно указать любое количество следующих параметров.

Вариант	Действие
/cs	SymChk не проверяет наличие данных CodeView. (По умолчанию проверяется наличие данных CodeView.)
/кубовый	Когда SymChk проверяет CAB-файл исправления, он не будет искать символы внутри кабины. (По умолчанию SymChk будет искать символы в кабине, а также в указанном пути символа.)
/ea File	SymChk не проверяет символы для программ, перечисленных в указанном файле. Это позволяет ветоировать определенные программы, которые в противном случае будут проверены. Файл должен указывать ровно один файл (относительный, абсолютный или UNC-путь, но без подстановочных знаков); если он содержит пробелы, они должны быть заключены в кавычки. В файле каждая строка указывает файл программы (по относительным, абсолютным или UNC-путям); подстановочные знаки не допускаются. Если строка в этом файле содержит пробелы, они должны быть заключены в кавычки. Точка с запятой в этом файле является символом комментариев. Все между точкой с запятой и окончанием строки будет игнорироваться. Если используется сервер символов, символы для этих программ не будут скопированы в нижнее хранилище.
Файл /ee	Сообщения об ошибках для этих программ, перечисленных в указанном файле, подавляются. Сообщения "Успешно" и "игнорировать" будут отображаться как обычно, и файлы символов будут скопированы в нижнее хранилище как обычно. Формат файла и его содержимого совпадает с форматом файла /ea.

Дополнительная информация

Дополнительные сведения о SymChk см. в разделе "Использование SymChk".