BinPlace 명령줄 구문

BinPlace는 명령줄에서 다음 구문을 사용합니다.

    binplace [Options] File [ [Options] [@PlaceFile] File [...] ]

매개 변수

옵션
여기에는 다음 스위치가 포함될 수 있습니다. 스위치 앞에 하이픈(-) 또는 슬래시(/)가 와야 합니다. 하이픈 또는 슬래시 뒤에 여러 옵션을 결합할 수 있지만 추가 매개 변수를 사용하는 옵션 뒤에 공백이 있어야 합니다. 따라서 다음 두 명령은 동일합니다.

binplace -q -k -g LCFile -v -s SymbolRoot File 
binplace -qkg LCFile -vs SymbolRoot File 

다음 스위치를 사용할 수 있습니다.

-a
BinPlace가 기호 파일을 배치할 때 프라이빗 기호를 제거하도록 합니다. 이렇게 하면 공용 기호를 포함하지만 프라이빗 기호는 포함하지 않는 제거된 기호 파일이 만들어집니다. -a 스위치를 사용하는 경우 -s 및 -x도 사용해야 합니다. -a를 사용하면 제거된 기호 파일이 -sSymbolRoot로 지정된 경로에 배치됩니다. -nFullSymbolRoot도 있는 경우 전체 기호 파일은 FullSymbolRoot에 배치됩니다. 그렇지 않으면 어디에도 배치되지 않습니다.

-b ExtraSubdirectory
BinPlace가 파일을 평소보다 다른 위치에 배치하도록 합니다. 루트 대상 디렉터리, 클래스 하위 디렉터리 및 파일 형식 하위 디렉터리를 평소와 같이 연결한 후 BinPlace는 이 경로에 ExtraSubdirectory를 추가하여 최종 대상 디렉터리를 만듭니다. ExtraSubdirectory는 백슬래시로 시작하거나 끝나서는 안 됩니다. 자세한 내용은 BinPlace 대상 디렉터리를 참조 하세요 .

-e
파일을 배치할 수 없는 경우 BinPlace가 실행을 계속하도록 합니다. 이 오류가 발생하면 기본적으로 BinPlace가 종료됩니다.

-f
BinPlace가 최신 파일을 덮어쓰는 경우에도 파일을 강제로 배치합니다. 기본적으로 BinPlace가 파일을 배치하려고 하면 이전 버전을 덮어쓰지만 최신 버전은 덮어쓰지 않습니다.

-g LCFile
BinPlace가 실행 파일을 확인하도록 합니다. LCFile 은 이 확인에 사용할 지역화 제약 조건 파일을 지정합니다.

-h
파일을 배치할 때 파일을 복사하는 대신 BinPlace가 하드 링크를 만들도록 합니다. 이 옵션은 NTFS 파일 시스템에서만 사용할 수 있습니다.

-j
실행 파일을 복사하기 전에 BinPlace가 적절한 기호가 있는지 확인합니다. 이 옵션을 사용하려면 SymChk 도구가 경로에 있어야 합니다. (SymChk는 Windows용 디버깅 도구 패키지의 일부입니다. 자세한 내용은 Windows 디버깅을 참조하세요.)

-k
BinPlace가 파일 특성을 유지하도록 합니다. 기본적으로 BinPlace는 보관 특성을 해제합니다.

-n FullSymbolRoot
전체 기호 파일(공용 및 프라이빗 기호를 모두 포함하는 기호 파일)의 루트 디렉터리를 지정합니다. 이렇게 하려면 -a, -x 및 -s 스위치도 필요합니다. 자세한 내용은 BinPlace 대상 디렉터리를 참조 하세요 .

-o RootSubdirectory
사용할 루트 대상 디렉터리의 하위 디렉터리를 지정합니다. 대상 디렉터리가 만들어 지면 루트 대상 디렉터리 뒤와 클래스 하위 디렉터리 앞에 RootSubdirectory가 삽입됩니다. 자세한 내용은 BinPlace 대상 디렉터리를 참조 하세요 .

-p PlaceFile
위치 파일의 경로 및 파일 이름을 지정합니다. -p 스위치를 사용하지 않으면 BinPlace는 \tools\placefil.txt 위치를 사용합니다. 장소 파일의 내용에 대한 설명은 파일 구문 배치를 참조하세요.

참고 - p 스위치 및 위치 파일은 이제 사용되지 않으므로 사용하면 안 됩니다.

-q
BinPlace가 로그 파일을 사용하지 못하도록 합니다. -q 스위치를 생략하면 BINPLACE_LOG 환경 변수에 지정된 파일이 로그 파일로 사용됩니다.

-r RootDestinationPath
루트 대상 디렉터리를 지정합니다. 생략하면 기본값은 각각 x86 기반, Itanium 기반 또는 x64 기반 컴퓨터의 _NT386TREE, _NTIA64TREE 또는 _NTAMD64TREE 환경 변수에 의해 결정됩니다. 자세한 내용은 BinPlace 대상 디렉터리를 참조 하세요 .

-s SymbolRoot
기호 파일의 루트 디렉터리를 지정합니다. -a 및 -x 스위치도 사용되는 경우 프라이빗 기호가 기호 파일에서 제거되고 제거된 기호 파일은 SymbolRoot에서 지정한 디렉터리에 배치됩니다. 제거된 기호 파일과 전체 기호 파일을 모두 배치하려면 -a -x -s SymbolRoot -n FullSymbolRoot를 사용해야 합니다. 자세한 내용은 BinPlace 대상 디렉터리를 참조 하세요 .

-t
테스트 모드입니다. 이 스위치를 사용하면 파일이 복사되지 않지만 BinPlace는 파일을 배치하는 것처럼 경고 및 오류 메시지를 표시합니다. -v 스위치를 사용하여 메시지 수를 늘릴 수도 있습니다.

-u
BinPlace가 \up 클래스 하위 디렉터리에 추가되도록 합니다. 이는 UP(유니프로세서) 드라이버를 분리하는 데 유용합니다. 또한 이 스위치를 사용할 때마다 BinPlace는 기호가 포함된 실행 파일을 분할하지 않습니다. 자세한 내용은 BinPlace 대상 디렉터리를 참조 하세요 .

-v
자세한 정보 표시 모드입니다. BinPlace가 더 자세한 오류, 경고 및 진행률 메시지를 표시하도록 합니다.

-w
BinPlace가 Windows 95 기호 파일(.sym)을 기호 트리에 추가하도록 합니다.

-x
BinPlace에서 이전 기호 시스템을 사용하는 파일이 발견되면 이 스위치를 사용하면 실행 파일에서 모든 기호를 제거하고 이 정보를 별도의 기호 파일로 이동합니다. 자세한 내용은 기호 파일 시스템을 참조하세요. -x 스위치를 사용하는 경우 -s 및 -a도 사용해야 합니다.

-y
BinPlace가 클래스 하위 디렉터리를 사용하지 못하도록 합니다. 대상 디렉터리가 루트 대상 디렉터리와 파일 형식 하위 디렉터리에서만 만들어집니다. 자세한 내용은 BinPlace 대상 디렉터리를 참조 하세요 .

-z
-x 스위치를 취소합니다. 여러 대상에서 BinPlace를 사용하는 경우 유용할 수 있습니다. binplace 인수Target1argumentsTarget2 형식의 명령을 사용할 수 있으며 명령줄이 왼쪽에서 오른쪽으로 구문 분석되므로 Target1 및 Target2는 서로 다른 인수의 영향을 받습니다. (구문 분석 순서 섹션은 다음을 참조하세요). -z 스위치가 발견되면 이전 -x 스위치의 효과가 취소됩니다.

-ci ReturnCode, Application,Argument,Argument, ...
BinPlace가 사용자 지정 애플리케이션을 사용하여 모든 실행 파일의 유효성을 검사하도록 합니다. BinPlace가 다른 애플리케이션을 사용하여 유효성 검사를 수행하도록 하려면 -ci 스위치를 사용할 수 있습니다.

ReturnCode 는 실행 파일에서 오류를 발견한 경우 이 애플리케이션에서 반환되는 값이어야 합니다. 추가 매개 변수는 이 애플리케이션을 시작하는 데 사용됩니다. 모두 쉼표로 구분해야 합니다. 애플리케이션 은 프로그램의 이름을 지정합니다. 그 뒤에는 임의의 수의 명령줄 인수가 있을 수 있습니다. 프로그램은 애플리케이션을 포함하는 명령줄과 모든 인수(쉼표가 아닌 공백으로 구분됨)로 시작하고 마지막으로 검사할 실행 파일의 이름으로 끝납니다.

-:호
BinPlace가 보관 특성이 설정된 파일만 배치하도록 합니다.

-:D BG
BinPlace에서 .dbg 파일을 배치하지 못하도록 합니다. -j 스위치도 사용되는 경우 BinPlace에서 .dbg 파일을 가리키는 이진 파일을 배치하지 못하게 됩니다. 이 옵션을 사용하려면 SymChk 도구가 경로에 있어야 합니다. (SymChk는 Windows용 디버깅 도구 패키지의 일부입니다. 자세한 내용은 Windows 디버깅을 참조하세요.)

-:D EST ClassPath
BinPlace가 위치 파일을 무시하고 지정된 ClassPath 를 클래스 하위 디렉터리로 사용하도록 합니다. 자세한 내용은 BinPlace 대상 디렉터리를 참조 하세요 .

-:LOGPDB
BinPlace가 로그 파일에 전체 .pdb 경로를 포함하도록 합니다.

-:REN NewName
BinPlace가 배치되는 파일의 이름을 바꾸도록 합니다. 확장명을 포함한 원래 파일 이름은 NewName으로 바뀝니다. (원래 파일이 분할되는 실행 파일인 경우 새 기호 파일에는 원래 파일 이름과 확장명 .dbg이 지정됩니다.)

-:TMF
BinPlace가 PDB 기호 파일에서 추적 메시지 서식 지정 지침을 추출하여 추적 메시지 형식(.tmf) 파일을 만들도록 합니다. TMF 파일은 BinPlace TRACE_FORMAT_PATH 환경 변수로 지정된 디렉터리에 배치됩니다. BinPlace 매크로 및 환경 변수를 참조 하세요.

-ChangeAsmsToRetailForSymbols
BinPlace가 기호 파일의 대상 디렉터리에서 발생하는 경우 문자열 "asms"를 문자열 "retail"로 바꿉니다. 자세한 내용은 BinPlace 대상 디렉터리를 참조 하세요 .

파일
BinPlace가 작동할 파일의 전체 경로 및 파일 이름을 지정합니다. 원하는 수의 파일을 공백으로 구분하여 나열할 수 있습니다. 경로 및 파일 이름에 공백이 있는 경우 경로와 파일 이름을 따옴표로 묶어야 합니다.

@PlaceFile
파일 이름 앞에 at sign( @ )이 있으면 파일 이름은 위치 파일의 이름을 나타냅니다. 자세한 내용은 다음 파일 섹션의 매개 변수 제공을 참조하세요.

구문 분석 순서

BinPlace는 명령줄을 왼쪽에서 오른쪽으로 구문 분석합니다. 여러 옵션, File 매개 변수, 새 옵션, 다른 File 매개 변수 등을 지정할 수 있습니다. BinPlace가 새 옵션을 발견할 때마다 이전에 본 모순된 옵션을 재정의하여 채택됩니다. 파일 지정자가 발견될 때마다 명령줄에서 이미 발생한 누적된 옵션을 사용하여 해당 파일에 대해 작동합니다.

파일에 매개 변수 제공

텍스트 파일에서 BinPlace에 매개 변수를 전달할 수 있습니다. 여기에는 두 가지 방법이 있습니다.

• BINPLACE_OVERRIDE_FLAGS 환경 변수에서 파일 이름을 지정할 수 있습니다. 이 파일은 BinPlace가 실행될 때마다 읽혀지고 해당 내용이 매개 변수로 사용됩니다. 이 파일의 매개 변수는 실제로 BinPlace 명령줄에 표시되는 매개 변수 앞에 구문 분석됩니다.

• BinPlace 명령줄에서 파일 이름을 at 기호( @ )로 접두사로 지정하여 지정할 수 있습니다. BinPlace의 명령줄에서 이 기호로 시작하는 문자열이 표시되면 문자열을 사용하고, 부호를 제거한 다음, 이 이름의 파일을 찾습니다. 이 파일을 찾으면 at 기호로 시작하는 원래 매개 변수가 있던 위치의 명령줄에 해당 텍스트를 삽입합니다. BinPlace는 왼쪽에서 오른쪽으로 매개 변수를 구문 분석하므로 매번 모든 옵션을 입력하지 않고도 파일의 여러 인스턴스와 함께 이 기술을 사용하여 각각 다른 옵션이 있는 여러 파일에서 BinPlace를 사용할 수 있습니다. (이 파일을 찾을 수 없는 경우 BinPlace는 at 기호를 포함하여 원래 문자열을 >로 처리합니다.파일 매개 변수.)