54.1: Reference 내의 객체 이름 변경하기

본 문서는 Git Notes for Professionals (라이센스:CC-BY-SA) 를 한글로 번역한 문서입니다. 번역상 오류가 있을 수 있으므로 정확한 내용은 원본 문서를 참고하세요.

Section 54.1: Reference 내의 객체 이름 변경하기

사용 목적

reference 에 저장된 객체의 이름을 갱신하기 위해 사용한다

명령어 개요

git update-ref [-m <reason>] (-d <ref> [<oldvalue>] | [--no-deref] [--create-reflog] <ref> <newvalue> [<oldvalue>] | --stdin [-z])

일반적인 사용법

1. 기존 symbolic ref 를 참조 해제하여, 현재 브랜치의 head 로 하여금 새로운 객체를 가리키도록 갱신한다.

   git update-ref HEAD <newvalue>
   

2. ref 의 현재 값이 oldvalue 와 동일한지를 검사한 후에 newvalue 를 ref 에 저장한다.

   git update-ref refs/head/master <newvalue> <oldvalue>
   

   위 명령은 현재 master 브랜치가 oldvalue 를 가리키고 있는 경우에 한하여 master 브랜치의 head 를 newvalue 로 갱신할 것이다.

-d 옵션을 이용하여 <ref> 의 현재 값이 oldvalue 와 동일한지를 검사한 후에 삭제를 수행하도록 할 수 있다.

--create-reflog 옵션을 이용하여, update-ref 명령어로 하여금 일반적으로 reflog 가 생성되는 상황이 아닐지라도 각 ref 에 대한 reflog 를 생성하게 할 수 있다.

-z 옵션을 이용하여, update, create, delete, verify 와 같은 명령어 사용에 있어서 NUL 로 끝나는 형식의 파라미터를 사용할 것임을 명시할 수 있다.

Update

<ref> 로 하여금 <oldvalue> 가 주어진 경우 이를 확인한 후 <newvalue> 로 설정한다. Update 이후에 ref 가 존재하지 않도록 하려면 빈 <newvalue> 를 기술하도록 하고, update 전에 ref 가 존재하지 않는 것을 확인하려면 빈 <oldvalue> 를 기술하도록 한다.

Create

존재 여부를 먼저 검사한 후, <newvalue> 를 값으로 하는 <ref> 를 생성한다. <newvalue> 는 빈 값이어서는 안된다.

Delete

<oldvalue> 가 주어진 경우, 해당 값과 비교를 수행한 다음 <ref> 를 삭제한다. <oldvalue> 값이 존재한다면, 그 값이 빈 상태여서는 안된다.

Verify

<ref> 와 <oldvalue> 값의 일치 여부에 대한 검사를 수행하나 값을 변경하지는 않는다. <oldvalue> 가 주어지지 않았거나 빈 값이라면, 해당 ref 는 존재하지 않는 상태여야 한다.

[출처] https://books.goalkicker.com/GitBook/ (CC BY-SA)