VSInstr
VSInstr 도구는 이진 파일을 계측하는 데 사용됩니다. 다음 구문을 사용하여 이 도구를 호출합니다.
VSInstr [/U] filename [/options]
아래 표에는 VSInstr 도구의 옵션에 대한 설명이 나와 있습니다.
| 옵션 | 설명 |
|---|---|
| Help 또는 ? | 도움말을 표시합니다. |
| U | 리디렉션된 콘솔 출력을 유니코드로 기록합니다. 첫 번째 옵션으로 지정해야 합니다. |
@filename |
명령 옵션이 한 줄에 하나씩 포함된 지시 파일의 이름을 지정합니다. 따옴표는 사용하지 마세요. |
OutputPath :path |
계측된 이미지의 대상 디렉터리를 지정합니다. 출력 경로를 지정하지 않으면 같은 디렉터리에서 파일 이름에 "Orig "가 추가되어 원래 이진 파일 이름이 바뀌며 이진 파일의 복사본이 계측됩니다. |
Exclude: funcspec |
프로브를 통한 계측에서 제외할 함수 사양을 지정합니다. 함수에 프로파일링 프로브를 삽입할 때 예기치 않은 결과 또는 원치 않는 결과가 발생하는 경우 유용합니다. 같은 이진 파일의 함수를 참조하는 Exclude 및 Include 옵션은 사용하지 마세요. 개별 Exclude 옵션을 여러 개 포함하여 여러 함수 사양을 지정할 수 있습니다. funcspec은 다음과 같이 정의됩니다.[namespace<separator1>] [class<separator2>]function <separator1>은 네이티브 코드의 경우 ::이고 관리형 코드의 경우 .입니다.<separator2>는 항상 ::입니다.Exclude는 코드 검사에서 지원됩니다. 와일드카드 문자 *가 지원됩니다. 예를 들어 네임스페이스에서 모든 함수를 제외하려면 다음 구문을 사용합니다. MyNamespace::* VSInstr /DumpFuncs를 사용하면 지정한 이진 파일의 전체 함수 이름 목록을 확인할 수 있습니다. |
Include: funcspec |
프로브를 사용하여 계측할 이진 파일의 함수 사양을 지정합니다. 이진 파일의 기타 모든 함수는 계측되지 않습니다. 개별 Include 옵션을 여러 개 포함하여 여러 함수 사양을 지정할 수 있습니다. 같은 이진 파일의 함수를 참조하는 Include 및 Exclude 옵션은 사용하지 마세요. Include는 코드 검사에서 지원되지 않습니다. funcspec은 다음과 같이 정의됩니다.[namespace<separator1>] [class<separator2>]function <separator1>은 네이티브 코드의 경우 ::이고 관리형 코드의 경우 .입니다.<separator2>는 항상 ::입니다.와일드카드 문자 *가 지원됩니다. 예를 들어 네임스페이스의 모든 함수를 포함하려면 다음 구문을 사용합니다. MyNamespace::* VSInstr /DumpFuncs를 사용하면 지정한 이진 파일의 전체 함수 이름 목록을 확인할 수 있습니다. |
| DumpFuncs | 지정된 이미지 내의 함수 목록을 표시합니다. 계측은 수행되지 않습니다. |
| ExcludeSmallFuncs | 함수를 호출하지 않는 짧은 함수인 작은 함수를 계측에서 제외합니다. ExcludeSmallFuncs 옵션을 사용하는 경우 계측 오버헤드가 감소하므로 계측 속도를 높일 수 있습니다. 또한 작은 함수를 제외하면 .vsp 파일의 크기와 분석에 필요한 시간도 감소합니다. |
Mark:{Before|After|Top|Bottom},funcname,markid |
.vsp 보고서 파일에서 데이터 범위의 시작이나 끝을 식별하는 데 사용할 수 있는 프로필 표시(보고서의 데이터를 구분하는 데 사용되는 식별자)를 삽입합니다. Before - 대상 함수 진입 위치 바로 앞에 삽입합니다. After - 대상 함수 종료 위치 바로 뒤에 삽입합니다. Top - 대상 함수의 진입 위치 바로 뒤에 삽입합니다. Bottom - 대상 함수의 각 반환 바로 앞에 삽입합니다. funcname - 대상 함수의 이름입니다.Markid - 프로필 표시의 식별자로 사용할 양의 정수(long)입니다. |
| 적용 범위 | 검사 계측을 수행합니다. 자세한 정보 표시, OutputPath, 제외 및 로그 파일 옵션에서만 사용할 수 있습니다. |
| 자세한 정보 표시 | Verbose 옵션은 계측 프로세스에 대한 자세한 정보를 확인하는 데 사용됩니다. |
NoWarn [:[Message Number[;Message Number]]] |
모든 경고를 표시하지 않거나 특정 경고를 표시하지 않습니다.Message Number - 경고 번호입니다. Message Number를 생략 하면 모든 경고가 표시되지 않습니다.자세한 내용은 VSInstr 경고를 참조하세요. |
제어: { 스레드 | 프로세스전역 | } |
다음 VSInstr 데이터 수집 제어 옵션의 프로파일링 수준을 지정합니다. Start StartOnly 일시 중단됨 StopOnly SuspendOnly ResumeOnly Thread - 스레드 수준 데이터 수집 제어 함수를 지정합니다. 현재 스레드에 대해서만 프로파일링이 시작되거나 중지됩니다. 다른 스레드의 프로파일링 상태는 영향을 받지 않습니다. 기본값은 thread입니다. Process - 프로세스 수준 프로파일링 데이터 수집 제어 함수를 지정합니다. 현재 프로세스의 모든 스레드에 대해 프로파일링이 시작되거나 중지됩니다. 다른 프로세스의 프로파일링 상태는 영향을 받지 않습니다. Global - 전역 수준(프로세스 간) 데이터 수집 제어 함수를 지정합니다. 프로파일링 수준을 지정하지 않으면 오류가 발생합니다. |
시작: { 외부 내부 | },funcname |
대상 함수 및 해당 함수가 호출하는 자식 함수로 데이터 수집을 제한합니다. Inside - 대상 함수로의 진입 위치 바로 뒤에 StartProfile 함수를 삽입합니다. 대상 함수의 각 반환 바로 앞에 StartProfile 함수를 삽입합니다. Outside - 각 대상 함수 호출 바로 앞에 StartProfile 함수를 삽입합니다. 각 대상 함수 호출 바로 뒤에 StopProfile 함수를 삽입합니다. funcname - 대상 함수의 이름입니다. |
일시 중단: { 외부 내부 | },funcname |
대상 함수 및 해당 함수가 호출하는 자식 함수에 대한 데이터 수집을 제외합니다. Inside - 대상 함수로의 진입 위치 바로 뒤에 SuspendProfile 함수를 삽입합니다. 대상 함수의 각 반환 바로 앞에 ResumeProfile 함수를 삽입합니다. Outside - 대상 함수로의 진입 위치 바로 앞에 SuspendProfile 함수를 삽입합니다. 대상 함수의 종료 위치 바로 뒤에 ResumeProfile 함수를 삽입합니다. funcname - 대상 함수의 이름입니다.대상 함수가 StartProfile 함수를 포함하는 경우에는 그 앞에 SuspendProfile 함수가 삽입됩니다. 대상 함수가 StopProfile 함수를 포함하는 경우에는 그 뒤에 ResumeProfile 함수가 삽입됩니다. |
StartOnly: { 위쪽 | 아래쪽 이후 이전 | | },funcname |
프로파일링 실행 중에 데이터 수집을 시작합니다. 지정된 위치에 StartProfile API 함수를 삽입합니다. Before - 대상 함수 진입 위치 바로 앞에 삽입합니다. After - 대상 함수 종료 위치 바로 뒤에 삽입합니다. Top - 대상 함수의 진입 위치 바로 뒤에 삽입합니다. Bottom - 대상 함수의 각 반환 바로 앞에 삽입합니다. funcname - 대상 함수의 이름입니다. |
StopOnly:{Before|After|Top|Bottom},funcname |
프로파일링 실행 중에 데이터 수집을 중지합니다. 지정된 위치에 StopProfile 함수를 삽입합니다. Before - 대상 함수 진입 위치 바로 앞에 삽입합니다. After - 대상 함수 종료 위치 바로 뒤에 삽입합니다. Top - 대상 함수의 진입 위치 바로 뒤에 삽입합니다. Bottom - 대상 함수의 각 반환 바로 앞에 삽입합니다. funcname - 대상 함수의 이름입니다. |
SuspendOnly:{Before|After|Top|Bottom},funcname |
프로파일링 실행 중에 데이터 수집을 중지합니다. 지정된 위치에 SuspendProfile API를 삽입합니다. Before - 대상 함수 진입 위치 바로 앞에 삽입합니다. After - 대상 함수 종료 위치 바로 뒤에 삽입합니다. Top - 대상 함수의 진입 위치 바로 뒤에 삽입합니다. Bottom - 대상 함수의 각 반환 바로 앞에 삽입합니다. funcname - 대상 함수의 이름입니다.대상 함수가 StartProfile 함수를 포함하는 경우에는 그 앞에 SuspendProfile 함수가 삽입됩니다. |
ResumeOnly:{Before|After|Top|Bottom},funcname |
프로파일링 실행 중에 데이터 수집을 시작하거나 다시 시작합니다. 일반적으로 SuspendOnly 옵션이 프로파일링을 중지한 후 프로파일링을 시작하는 데 사용됩니다. 지정된 위치에 ResumeProfile API를 삽입합니다. Before - 대상 함수 진입 위치 바로 앞에 삽입합니다. After - 대상 함수 종료 위치 바로 뒤에 삽입합니다. Top - 대상 함수의 진입 위치 바로 뒤에 삽입합니다. Bottom - 대상 함수의 각 반환 바로 앞에 삽입합니다. funcname - 대상 함수의 이름입니다.대상 함수가 StopProfile 함수를 포함하는 경우에는 그 뒤에 ResumeProfile 함수가 삽입됩니다. |