SourceSafeCommandLine

UserPreferences

1. 커맨드 라인에서 소스 세이프 사용하기
2. 커맨드 라인에서 명령 실행하기
3. 명령어 문법
4. 명령어 옵션
5. 자주 쓰이는 명령어들
1. GET
2. ADD
3. CHECKOUT
4. CHECKIN
5. CP
6. WORKFOLD
6. 실제 사용법

1 커맨드 라인에서 소스 세이프 사용하기

소스 세이프는 일괄 파일이나 매크로에서 사용할 수 있는 커맨드 라인 명령어를 지원한다. 사실 GUI 기반의 VSS 익스플로러에서 할 수 있는 모든 일을 할 수 있다. 그렇다면 왜 GUI에서 할 수 있는 일을 굳이 커맨드 라인에서 하려하는가? 바로 일괄 빌드(?)의 일환으로서 사용하기 위해서이다. 즉 소스 세이프에서 특정 버전을 받아와, 컴파일하고, 각종 리소스를 집어넣고 인스톨 실드까지 스크립트 처리해서 한번에 준비를 마치는 것이다. 게임 서비스를 생각한다면 여기에 이전 버전과의 차이점을 비교하고, 업데이트할 파일을 준비하고, 압축하고, 업로드하는 과정까지 포함될 수 있다 하겠다. 그리고 바이너리 파일을 소스 세이프에 백업해두는 경우, 일괄 파일로 처리하면 편할 때가 많다.

2 커맨드 라인에서 명령 실행하기

커맨드 라인에서 소스 세이프를 사용하기 위해서는 다음과 같은 환경 변수를 설정해줘야한다.


• PATH 환경 변수는 소스 세이프 실행 파일을 액세스하기 위해서 필요하다. 소스 세이프 실행 파일이 있는 디렉토리를 PATH 환경 변수에다 추가해야한다. 예를 들어 실행 파일이 c:\program files\vss\win32 디렉토리에 있다면, PATH=%PATH%;c:\Program Files\vss\win32 이런 식으로 지정해준다. 패스를 타이핑하는 데 별로 부담을 느끼지 않는다거나, 일괄 파일을 사용한다면 굳이 등록할 필요 없다.
  
• SSDIR 환경 변수는 소스 세이프 설정 파일(SRCSAFE.INI) 파일이 있는 디렉토리를 지정해야한다. 예를 들어 설정 파일이 SSS 컴퓨터의 SourceDir 안에 있다면 SSDIR=\\SSS\SourceDir 이런 식으로 지정해준다. 당연히 해당 컴퓨터에 로그온할 수 있는 계정이 있어야 한다.
  
• 소스세이프 로그온 프롬프트가 귀찮다면, SSUSER 및 SSPWD 변수를 설정해주면 된다.
  

  SET SSUSER=excel96 
  SET SSPWD=sample_password 
  

  
  
물론 윈도우 시작 메뉴에 있는 '실행' 명령을 사용할 수도 있다. 예를 들어 실행 창에다가 ss Get *.*이란 명령을 입력하면, 현재 프로젝트에 있는 모든 파일을 받아온다.

3 명령어 문법

커맨드 라인 명령어들은 다음과 같은 일반적 문법을 가진다.


ss command [하나 이상의 아이템] [옵션] 

아이템이 어떤 것인지는 앞부분의 명령어에 달려있다. 예를 들어 GET 명령어 같은 경우, 뒤에 오는 아이템은 소스 세이프 내부의 파일 또는 프로젝트 이름이다. ADD 명령어 같은 경우에는 현재 사용자 운영 체재 내에 있는 파일 이름이다.

아이템을 인수로서 받아들이는 대부분의 명령어들은 하나 이상의 아이템을 인수로서 줄 수 있다. 예를 들어 GET 명령어를 사용하는 방법을 보자.


ss Get HELLO.C 
ss Get HELLO.C HELLO.H TEST.H makefile 
ss Get *.C *.H makefile linkfile 
ss Get *.* 

대소문자의 구분은 명령어마다 틀리다. 예를 들어 GET 명령어 같은 경우에는 대소문자를 구분하지 않는다. 즉 Get HELLO.C와 get Hello.c를 같은 걸로 취급한다는 말이다. 하지만 FIND 명령어 같은 경우, 대소문자를 구분한다.


SS find post alias.txt 

이 명령어를 실행하면, "post"가 포함된 곳은 모두 찾을 수 있지만, "Post"가 포함된 곳은 찾을 수 없다. 하지만 "-ic" 옵션을 사용하면 찾을 문자열에서 대소문자 차이를 무시할 수도 있다.

참고 명령어를 입력할 때, 명령어 문자열 전체를 입력할 필요는 없다. 그냥 다른 명령어들과 구분될 정도만 입력하면 된다. 대부분 처음 한두 글자만 입력하면 된다.

4 명령어 옵션

명령어와 아이템 말고도 옵션을 추가적으로 줄 수 있다. 옵션은 '-' 글자로 시작되고, 명령어의 동작을 수정한다. 약간의 옵션은 특정 명령에만 해당되고, 커맨들 라인 헬프에서 이에 대한 정보를 알 수 있다. 또한 많은 명령어에 적용되는 일반적인 옵션도 있다. 그 옵션들은 다음과 같다.



옵션	설명
-C	Use one (or no) comment for all specified items. (The Dir command uses this option in a different way.)
-O	Redirect or paginate the output of the command.
-V	Operate on a specific version of an item.
-R	Perform a command recursively.
-S	Turn SmartMode on or off for the command.
-G	Change the way the Get command works on any file retrieved to the local drive.
-W	Indicate whether local copies are read-only.
-N	Change between long and short file name mode.
-I-	Ignore: Do not ask for input under any circumstances.
-Y	Specify user name and password.
-?, -H	Request online Help with a command: The -H command-line option obtains the same result.


아이템이나 옵션 문자열에 빈 칸이 들어갈 때는 그 인수 전체를 따옴표로 둘러쌓야한다. 즉 -C"This is comment"가 아니라 "-CThis is the comment"를 사용하라는 말이다. 그렇지 않으면 명령어가 제대로 동작하지 않거나 알 수 없는 결과를 가져온다.

5 자주 쓰이는 명령어들

5.1 GET

소스 세이프 데이터베이스 내에 있는 파일을 현재 시스템 상으로 복사해온다.

• 복사해온 파일들은 기본적으로 읽기 전용 파일이다.
  
• 복사해온 파일들이 기본적으로 저장되는 곳은 현재 Working Folder다.
  
• 하위 디렉토리까지 복사해오기 위해서는 -R 옵션을 이용할 수 있다. 복사해온 하위 디렉토리는 현재 Working Folder에 같은 이름의 하위 디렉토리로 복사된다. 단 SS.INI 파일의 Force_Dir 변수값을 Yes로 하면, 하위 디렉토리는 현재 디렉토리의 하위 디렉토리로 가지 않고, 그 각각의 Working Folder로 복사된다.
  
• 복사해온 파일들은 기본적으로 최신 버전이다. 하지만 -V 옵션을 사용해서 가져올 파일의 버전을 지정할 수 있다. 하지만 ss Get -V* 명령은 제대로 동작하지 않는다.
  
• GET 명령어를 사용해서 특정 버전의 프로젝트를 복사해오는 경우, 프로젝트에 속한 각각의 파일들 역시 최신 버전이 아니라 그 프로젝트의 버전에 맞는 것들이 복사된다.
  
  
문법


ss Get VSS items [-G] [-H] [-I-] [-N] [-O] [-R] [-V] [-W] [-Y] [-?] 

옵션	설명
-O	Paginate or redirect the command output.
-R	Recursively get an entire project list.
-V	Get an old file or project version.
-G	Set options for the retrieved local copy.
-W	Make the retrieved local copy writable.
-I-	Ignore: Do not ask for input under any circumstances.
-N	Change between long and short file name mode.
-Y	Specify a username and/or password.
-?, -H	Request online Help on a command.


사용 예

• 현재 프로젝트 내의 TEST.C 파일을 읽기 전용으로 복사해온다.
  

  ss Get TEST.C 
  

• 현재 프로젝트 내의 모든 파일들을 읽기 전용으로 복사해온다.
  

  ss Get * 
  

• $/WORD 프로젝트 내의 모든 파일과 그 하위 프로젝트에 있는 모든 파일들을 읽기 전용으로 복사해온다.
  

  ss Get $/WORD -R 
  

  
  

5.2 ADD

새로운 파일을 소스 세이프 데이터베이스에다 추가한다.

• 추가할 파일은 단순한 파일이 될 수도 있고, 드라이브나 폴더일 수도 있다.
  
• 폴더를 추가할 경우, 그 폴더에 있는 파일 뿐 아니라 하위 폴더에 있는 파일까지 모두 추가하고 싶다면 -R 옵션을 사용할 수 있다.
  
• 추가할 파일로서 *.*를 주거나, -R 옵션을 지정한 경우, ADD 명령어는 VSS 설정 파일에서 관련있는 파일 마스크를 먼저 조사한다.
  
• -D- 옵션을 사용하면 최신 버전의 파일만을 저장할 수 있다. 이 경우 이전 버전의 파일을 받는 것은 불가능하다. 보통 바이너리 파일의 경우 디스크 용량과 속도 문제 때문에 이 옵션을 많이 사용한다.
  
• -B 옵션은 추가할 파일이 바이너리 파일이라는 것을 알려준다. 이 경우 VSS의 바이너리 자동 탐지 기능이 비활성화된다. -B- 옵션은 추가할 파일이 텍스트 파일이라는 것을 알려준다. 마찬가지로 바이너리 자동 탐지 기능이 비활성화된다.
  
• ADD 명령어는 Universal Naming Convention (UNC) 이름을 지원한다. 즉 드라이브 레터를 입력할 필요가 없다는 말이다. 예를 들어 \\COMPUTER\SHARE 폴더의 FILE.TXT를 추가하기 위해서는 \\COMPUTER\SHARE\FILE.TXT와 같은 식으로 입력하면 된다는 말이다.
  
  
문법


ss Add local files [-B] [-C] [-D-] [-H] [-I-] [-K] [-N] [-O] [-R] [-W] [-Y] [-?] 

옵션	설명
-C	Use the same comment for all added files.
-D-	Do not track old versions of this file.
-R	Recursively add an entire folder tree, creating a project list in VSS.
-K	Check out the file immediately after adding it.
-B	Assume the file is binary. Use -B- to assume the file is text.
-W	Leave the local copy of the file writable.
-O	Paginate or redirect the command output.
-I-	Ignore: Do not ask for input under any circumstances.
-N	Change between long and short file name mode.
-Y	Specify a username and/or password.
-?, -H	Request online Help on a command.


사용 예

• 현재 프로젝트에다 HELLO.C 파일을 추가한다.
  

  ss Add C:\HELLO.C 
  

• 현재 프로젝트에다 TEST.C 파일과 MY LONG FILENAME.H 파일을 추가한다.
  

  ss Add TEST.C "My long filename.H" 
  

• 현재 프로젝트에다 현재 폴더 내의 모든 파일들을 추가한다.
  

  ss Add * 
  

• 현재 프로젝트에다 현재 폴더 내의 모든 파일과 하위 폴더의 모든 파일들을 추가한다.
  

  ss Add -R * 
  

  
  

5.3 CHECKOUT

프로젝트 내에 있는 파일을 편집 목적으로 현재 폴더에다 복사해온다.

• 바이너리 파일은 동시에 한 사용자만이 체크아웃할 수 있다.
  
• CHECKOUT 명령어 실행시, VSS는 대상에 포함된 모든 파일에 대한 주석을 요구한다. -C 옵션을 사용하면 모든 파일에 같은 주석을 지정할 수 있다.
  
  
문법


ss Checkout VSS files [-C] [-F] [-G] [-H] [-I-] [-N] [-O] [-R] [-V] [-Y] [-?] 

옵션	설명
-C	Use the same comment for all checked-out files.
-G	Set options for the retrieved local file.
-R	Recursively check out the specified items.
-O	Paginate or redirect the command output.
-V	Specify which file version to check out.
-F	Display files only; do not display projects.
-I-	Ignore: Do not ask for input under any circumstances.
-N	Change between long and short file name mode.
-Y	Specify a username and/or password.
-?, -H	Request online Help on a command.


사용 예

• $/TESTDATA 프로젝트의 TEST.C 파일을 체크아웃한다.
  

  ss Checkout $/TESTDATA/TEST.C 
  

• 현재 프로젝트에서 TEST.C 파일과 TEST.H 파일을 체크아웃한다.
  

  ss Checkout TEST.C TEST.H 
  

• $/TESTDATA 프로젝트에서 모든 파일과 하위 폴더를 체크아웃한다.
  

  ss Checkout -R $/TESTDATA 
  

  
  

5.4 CHECKIN

편집이 끝난 파일로 소스 세이프 데이터베이스를 업데이트한다.

• 여러 파일을 한꺼번에 체크인 하는 경우, VSS는 그 각각의 파일들에 대한 주석을 요구한다. -C 옵션을 사용하면 모든 파일에 똑같은 주석을 지정할 수 있다.
  
• -K 옵션을 사용하면, 체크인을 해 소스 세이프 데이터베이스를 업데이트한 즉시 체크아웃을 실행할 수 있다. SS.INI 파일 내의 Keep_Checkedout 변수를 이용해 즉시 체크아웃하는 것을 기본 동작으로 만들 수도 있다. 이 경우 -K- 옵션을 사용하면 즉시 체크아웃하는 것을 막을 수 있다.
  
• 체크아웃한 뒤 변경하지 않은 파일을 체크인하려는 경우, VSS는 진짜로 체크인하길 원하느냐는 메시지를 보여준다. NO를 선택한 경우, VSS는 체크아웃을 취소한다. SS.INI 파일 내에 있는 Update_No_Change 변수를 이용해 이 메시지를 피할 수 있다.
  
• -P 옵션을 사용하여, 특정 프로젝트에서 체크아웃한 파일만을 체크인할 수 있다. -P 옵션 뒤에 프로젝트 이름을 주지 않는 경우, 기본적으로 현재 프로젝트가 사용된다.
  
  
문법


ss Checkin VSS files [-C] [-H] [-I-] [-K] [-N] [-O] [-P[project]] [-R] [-W] [-Y] [-?] 

옵션	설명
-C	Use the same comment for all checked-in files.
-K	Keep the file checked out after checking it in.
-G	Set options for the retrieved local file.
-W	Make the retrieved local copy writable.
-R	Check in an entire project list recursively.
-P	Check in only files checked out from the current or specified project.
-O	Paginate or redirect the command output.
-I-	Ignore: Do not ask for input under any circumstances.
-N	Change between long and short file name mode.
-Y	Specify a username and/or password.
-?, -H	Request online Help on a command.


사용 예

• 변경된 TEST.C 파일을 체크인한다.
  

  ss Checkin TEST.C 
  

• 현재 프로젝트에서 체크아웃한 모든 파일들을 체크인한다.
  

  ss Checkin * -P 
  

  
  

5.5 CP

현재 프로젝트를 설정한다.

• 현재 프로젝트를 설정하고 난 후, 다른 명령에다 파일 이름을 인수로 줄 경우, 그 명령어들은 그 파일을 현재 프로젝트에 속한 것으로 간주한다. 예를 들어 ss Cp $/WORD를 실행한 후에, ss Get TEST.C를 실행하면 실제로 수행되는 것은 ss Get $/WORD/TEST.C와 같다.
  
• PROJECT 명령어를 사용하면 현재 프로젝트를 알 수 있다.
  
  
문법


ss Cp project [-H] [-I-] [-Y] [-?] 

옵션	설명
-I-	Ignore: Do not ask for input under any circumstances.
-Y	Specify a username and/or password.
-?, -H	Request online Help on a command.


사용 예

• $/WORD 프로젝트를 현재 프로젝트로 설정한다.
  

  ss Cp $/WORD 
  

• 현재 프로젝트의 한 단계 상위 프로젝트로 이동한다.
  

  ss Cp .. 
  

• 최상위 프로젝트로 이동한다.
  

  ss Cp $/ 
  

  
  

5.6 WORKFOLD

WORKFOLD 명령어는 프로젝트의 작업 디렉토리를 지정할 수 있는 기능을 제공한다.


• 프로젝트와 디렉토리 모두가 필수적인 인수가 아니라는 것을 참고하기 바란다. 둘 중에 하나가 지정되지 않은 경우, 현재 프로젝트 또는 현재 폴더가 사용된다. 즉 작업 디렉토리를 지정하지 않으면 현재 폴더가 작업 디렉토리로서 지정되고, 프로젝트를 지정하지 않으면 현재 프로젝트가 프로젝트로서 사용된다는 말이다.
  
• WORKFOLD 명령의 출력은 간단한 문자열이다.
  

  %s successfully set as the working folder for %s. 
  

• 이 명령이 실행되 후에 SS.INI 파일의 Force_Dir 변수와 Force_Prj 변수는 완전히 무시된다.
  
  
문법


SS Workfold [Project] [Folder] 

옵션	설명
Project	Specifies the VSS project you want to set a working folder for.
Folder	Specifies the working folder for the specified project.
-?, -H	Request online Help on a command.


사용 예

• $/Website 프로젝트의 워킹 디렉토리로서 c:\External Web\Website를 지정한다.
  

  ss Workfold $/WEBSITE c:\External Web\Website 
  

  
  
  

6 실제 사용법

• 특정 디렉토리의 바이너리 파일들을 소스 세이프에 체크인하고, 바로 체크아웃하기 위한 일괄 파일
  

  @echo off 
  SET SSDIR=\\Cutieserver\Develop\SourceSafe 
  SS CP $/Cuvit/SBin 
  SS WORKFOLD $/Cuvit/Stools D:\Cuvit\SBin 
  SS CHECKIN "ServerController.exe" "Blobs.exe" "-C " -K -I- 
  

  
  
• 특정 프로젝트 최신 버전을 현재 폴더에 받아와서 컴파일하기 위한 일괄 파일
  

  @echo off 
  SET SSDIR=\\Cutieserver\Develop\SourceSafe 
  ss CP $/Cuvit/CuvitServer 
  ss GET * -R -I- 
  devenv CuvitServer.sln /build Debug /out build.log 
  

• see also SourceSafe, ConfigurationManagement
  

• CategoryDevelopmentProcess