Perforce: Difference between revisions

From 탱이의 잡동사니
Jump to navigation Jump to search
Line 271: Line 271:
=== revert ===
=== revert ===
변경/수정 된 내용을 다시 이전으로 되돌린다.
변경/수정 된 내용을 다시 이전으로 되돌린다.
<pre>
p4 revert [-a -n -k -w -c changelist#] file ...
</pre>


==== -a ====
==== -a ====

Revision as of 08:31, 7 July 2016

Overview

형상 관리 툴 Peforce(p4) 사용법 정리.

Installation

아래 링크에서 다운받아서 사용하면 된다. 별도의 컴파일 작업이 필요하지 않다.

https://www.perforce.com/ko/downloads/helix

Environment variables

perforce 는 내부적으로 여러가지 환경 변수들을 가지고 있다. 이 환경변수를 수정함으로써, 기본접속 서버와 클라이언트등을 변경할 수 있다. 자세한 내용은 이곳<ref>http://www.perforce.com/perforce/doc.current/manuals/cmdref/envars.html</ref>에서 찾을 수 있다.

Settings

export 명령이 아닌, p4 명령어 set 를 이용해도 환경변수 설정과 확인이 가능하다.

$ p4 set P4CLIENT=client1
$ p4 set P4CLIENT
P4CLIENT=client1

Crucial variables

  • P4CLIENT
현재 client workspace 의 이름.
  • P4PASSWD
사용자의 Password 를 설정한다. 이후 명령어 사용시, 별도로 사용자 Password 를 입력하지 않아도 된다.
  • P4USER
현재 perforce username 을 나타낸다.

Useful variables

  • P4CONFIG
현재 사용중인 P4CONIFG 파일을 나타낸다. P4CONFIG 파일에는 사용자 정보가 입력되어 있으며, 이 P4CONFIG 파일을 이용하여 사용자를 쉽게 전환할 수 있다.
P4CLIENT=joes_client
P4USER=joe
P4PORT=ssl:ida:3548
  • P4DIFF
p4 resolve 및 p4 diff 명령어 사용시 사용되는 diff 프로그램을 지정한다.
  • P4EDITOR
Perforce 에서 사용되는 기본 editor 프로그램을 지정한다.
  • P4MERGE
Perforce 에서 사용되는 기본 merge 프로그램을 지정한다.
  • P4CHARSET
Perforce 에서 사용되는 기본 Character set 을 지정한다.
  • P4TRUST
ssl trust file 을 지정한다. p4 trust 명령어에 의해 사용된다.

Esoteric variables

  • P4PAGER
Page output 에서 사용할 프로그램을 설정한다. p4 resolve 의 diff 옵션에서 사용된다.
  • TMP, TEMP
temporary 파일을 위한 디렉토리를 지정한다.
  • P4TICKETS
p4 login 에서 사용되는 ticket 파일의 위치를 지정한다.
  • P4LANGUAGE
This environment variable is reserved for system integrators.
  • P4LOGINSSO
Client-side single-signon script.
  • P4COMMANDCHARSET
Used to support UTF-16 and UTF-32 character sets from the Command-line Client.
  • P4DIFFUNICODE
Used to support UTF-16 and UTF-32 character sets from the Command-line Client.
  • P4MERGEUNICODE
Used to support UTF-16 and UTF-32 character sets from the Command-line Client.
  • P4CLIENTPATH
A list of directories to which Perforce applications are permitted to write.
Any attempt by a Perforce application to access or modify files outside these areas of the filesystem will result in an error message.
To specify more than one directory, separate the directories with semicolons.

Server variables

  • P4AUDIT
Location of the audit log file.
  • P4JOURNAL
A file that holds the Perforce database's journal data.
  • P4LOG
Name and path of the file to which Perforce errors are written.
  • P4PORT
For the Perforce service (server, broker, or proxy), the port number on which it listens, and the network transport(s) to which it is to bind.
  • P4ROOT
Directory in which the Perforce service stores its files and subdirectories.
  • P4DEBUG
Set Perforce server or proxy trace options.
  • P4NAME
A unique identifiable name for a Perforce server.
On Windows if there is no P4NAME defined in the registry for a service, it is picked up from the name of the service itself.
  • P4SSLDIR
Directory containing a server's SSL keys and/or certificates.

Commands

Common

perforce command 사용시 공통적으로 적용되는 사항 정리.

Directory

perforce 에서는 빈 디렉토리는 생성/변경/삭제가 불가능하다. 만약 디렉토리 내에, 파일이 하나도 없다면 해당 디렉토리는 자동으로 사라지게 된다.

...

만약 디렉토리내의 모든 파일을 선택해야 한다면, '...' 을 사용하면 된다.

help

도움말 내용을 보여준다. simple 입력시 자주 사용되는 명령어의 간단한 쓰임새를 보여준다. 자세한 명령어의 도움말을 보고자 한다면 p4 help <command> 를 입력하면 된다. 사용 가능한 모든 명령어를 보고자 할 때는, "p4 help commands" 를 입력하면 된다.

$ p4 help simple

    Most common Perforce client commands:

	client     Create or edit a client workspace specification and view

	add        Open files for adding to the depot
	edit       Open existing files for editing
	delete     Open existing files for removal from the depot
	opened     List open files 

	update     Update files in the current client workspace 
	resolve    Resolve updates to open workspace files

	submit     Submit open files to the depot
	revert     Revert open files and restore originals to workspace

opened

현재 편집중인 파일 목록을 보여준다.

branch

branch -- Create, modify, or delete a branch view specification 브랜치를 생성하고, 수정 및 삭제한다. 하지만 편의상 populate 옵션을 더 많이 사용한다.

$ p4 branch [-f] name
$ p4 branch -d [-f] name
$ p4 branch [ -S stream ] [ -P parent ] -o name
$ p4 branch -i [-f]

populate

여러개의 파일들을 한번에 Branching 한다. 보통은 프로젝트 MAIN/DEVELOP 브랜치에서 기능추가/버그수정/테스트 등을 위해 별도의 브랜치를 생성할 때 사용한다.

$ p4 populate [options] fromFile[rev] toFile
$ p4 populate [options] -b branch [-r] [toFile[rev] ...]
$ p4 populate [options] -b branch -s fromFile[rev] [toFile ...]
$ p4 populate [options] -S stream [-P parent] [-r] [toFile[rev] ...]
$ p4 populate -o <source>/... <destination>/...

-o

브랜칭을 함과 동시에 명령어로 생성되는 파일들의 리스트들을 보여준다.

$ p4 populate -o <source>/... <destination>/...

$ p4 populate -o //depot/devel/sample/DEVELOP/... //depot/devel/sample/FEATURE_sample_test/...

integrate

integrate -- Integrate one set of files into another

$ p4 integrate [options] fromFile[revRange] toFile
$ p4 integrate [options] -b branch [-r] [toFile[revRange] ...]
$ p4 integrate [options] -b branch -s fromFile[revRange] [toFile ...]
$ p4 integrate [options] -S stream [-r] [-P parent] [file[revRange] ...]

delete

지정된 파일을 삭제한다. 사실, perforce 에서는 파일 삭제가 없다. 단지 앞으로의 버전 컨트롤에서 제외될 뿐이다.

$ p4 delete [-c changelist#] [-n -v -k] file ...

-n 파일 삭제시 나타나게 될 결과를 표시한다. 실제로 파일을 삭제하지는 않는다.

-k client 에 설치된 파일의 변경없이 server에 있는 파일만을 삭제한다. 만약 서버와 클라이언트 간의 파일 불일치가 발견되면 경고를 표시한다.

-v 아직 sync 되지 않은 파일도 같이 삭제할 수 있도록 한다.

client

client 설정을 확인/수정 한다.

View 항목에 명시되어 있지 않은 디렉토리는 동기화되지 않는다. 만약 perforce 설정 이후, 특정 디텍토리가 동기화되지 않는다면, View 항목을 먼저 확인하자.

Client: stk_pbxdevelopment

Update: 2015/10/13 14:14:25

Access: 2015/10/13 14:12:39

Owner:  stk

Host:   test.pchero21.com

Description:
        Created by stk.

Root:   /home/stk

Options:        noallwrite noclobber compress unlocked nomodtime rmdir

SubmitOptions:  submitunchanged

LineEnd:        local

View:
        //depot/devel/helloworld/... //stk_pbxdevelopment/depot/devel/helloworld/...

change, changelist

현재 위치한 디렉토리에서의 상세 변경 내역 내용을 보여준다. change 와 changeslist 는 모두 같은 옵션이다.

p4 change [-s] [-f | -u] [[-O] changelist#]
p4 change -d [-f -s -O] changelist#
p4 change -o [-s] [-f] [[-O] changelist#]
p4 change -i [-s] [-f | -u] 
p4 change -t restricted | public [-U user] [-f | -u | -O] changelist#
p4 change -U user [-t restricted | public] [-f] changelist#

changes, changelists

모든 변경 내역 리스트를 보여준다. change 와 changeslists 는 모두 같은 옵션이다. file 및 경로 지정시, 지정된 파일 및 경로와 관련된 내용만을 보여준다.

p4 changes [options] [file[revRange] ...]

options: -i -t -l -L -f -c client -m max -s status -u user

-m

단순히 p4 changes 를 입력하면 모든 변경 이력을 보여준다. -m 옵션 사용시 가장 최근에서부터 -m <count> 개 까지의 변경이력만을 보여준다.

$ p4 changes -m 1
Change 1692 on 2015/10/23 by pchero@pchero_dev 'Changed tmp file name path.'

-l, -L

변경이력의 상세 내용을 표시한다. 기본적으로 changes 옵션 사용시, 변경 이력의 제일 윗줄만을 표시한다. -l 옵션 사용시, 변경 이력의 상세 내용을 모두 확인할 수 있다. -L 옵션은 -l 옵션 내용과 같으나, 최대 250자 까지의 내용만을 표시한다.

$ p4 changes -m 1 -L
Change 3202 on 2016/06/30 by pchero@pchero_dev

	- RPM testing release build of olive

clean

모든 submit되지 않은 변경 이력들을 원본으로 되돌린다.

$ p4 clean

깔끔히 정리하고 싶을 때 사용하면 좋다. 하지만.. rm -rf 명령어와 같은 힘을 지니고 있으므로 사용시 정말 조심해야 한다...

revert

변경/수정 된 내용을 다시 이전으로 되돌린다.

p4 revert [-a -n -k -w -c changelist#] file ...

-a

Edit/Integrate/Unchanged/Missing 상태인 파일들만 이전상태로 복구한다. Integration pending 상태의 파일은 Open 상태로 남게된다.

-k

파일을 복구하는 것이 아닌, open 상태가 아닌것으로 변경한다. 즉, 파일에는 수정된 내용이 그대로 남아있지만 perforce 메타 데이터가 사라진 상태가 된다. 이후, p4 edit <filename> 을 하게 되면 수정된 내용을 그대로 살릴 수 있다. 혹은 p4 status 명령어로 현재 변경된 파일 목록을 확인할 수도 있다.

-c

특정 changelist 버전으로 되돌린다.

review

changelist 를 보여준다.

p4 review [-c changelist#] [-t counter]

sync, flush, update

Client 를 서버 저장소와 동기화시킨다. flush 와 update 는 sync 와 다른 옵션과의 조합이다.

  • flush : sync -k
  • update : sync -s

ETC

Change the client(workspace) name

기본적으로, perforce에서 client(workspace) 이름을 변경할 수는 없다. 굳이 client 를 변경하고 싶다면, 다른 client 를 생성 후, 해당 client로 변경 뒤, 기존의 client 를 삭제하는 방법을 써야 한다.<ref>http://answers.perforce.com/articles/KB/3428</ref>

Problem	

How do I rename a client workspace?
Solution	
Perforce does not provide a rename mechanism for client workspaces. However, if a user does not have any files checked out the following procedure can be used to create a new workspace using the same specifications as the old one and update the server's meta data.

1. Use the old workspace as a template to create a new one.

p4 client -t old-workspace new-workspace

Double check that the Root: is the same for the old and new workspace.

2. Update the server metadata with the revisions synced to the new workspace.

p4 -c new-workspace sync -k @old-workspace

3. Check the list of files synced to the new client workspace.

p4 -c new-workspace have

4. Delete the old client workspace.

p4 client -d old-workspace

References

<references />