UUID(Universally Unique Identifier)는 분산 시스템 환경에서 고유성을 보장하기 위해 설계된 128비트 길이의 식별자입니다. 32개의 16진수 문자가 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 형식으로 표현되며, 시간, 하드웨어 주소, 무작위 값 등을 조합하여 생성되므로 전 세계적으로 충돌할 가능성이 거의 없습니다. 이러한 고유성은 데이터베이스 레코드, 분산 객체, 파일 시스템 등 다양한 분야에서 객체의 유일한 식별자로 사용될 때 매우 유용합니다.
리눅스에서 libuuid 라이브러리 설치
리눅스 시스템에서 UUID를 생성하고 관리하기 위해서는 libuuid 라이브러리를 사용할 수 있습니다. 이 라이브러리는 대부분의 리눅스 배포판에서 개발 패키지 형태로 제공되므로, 다음과 같이 간단히 설치할 수 있습니다.
sudo apt update
sudo apt install uuid-dev
소스로부터 설치를 원한다면, libuuid 프로젝트 페이지에서 직접 내려받아 컴파일할 수도 있습니다.
libuuid 주요 함수 살펴보기
libuuid 라이브러리는 UUID를 생성하고 조작하기 위한 다양한 함수를 제공합니다. 핵심적인 데이터 타입은 16바이트 배열인 uuid_t로 정의되어 있습니다:
typedef unsigned char uuid_t[16];
주요 함수들은 다음과 같습니다:
- UUID 생성:
void uuid_generate(uuid_t out);: 시스템의 기본 방식(시간 기반 또는 무작위 기반)으로 UUID를 생성합니다.void uuid_generate_random(uuid_t out);: 암호학적으로 강력한 난수를 기반으로 UUID를 생성합니다.void uuid_generate_time(uuid_t out);: 현재 시간을 기반으로 UUID를 생성합니다. (버전 1 UUID)int uuid_generate_time_safe(uuid_t out);: 시간 기반 UUID를 생성하며, 클럭 시퀀스 충돌 시 안전하게 처리되었는지 여부를 반환합니다. 0은 성공, 1은 클럭 시퀀스 경합으로 인해 안전하지 않은 생성을 나타냅니다.
- UUID 변환 및 비교:
void uuid_unparse(uuid_t uu, char *out);:uuid_t타입의 UUID를 표준 문자열 형태로 변환합니다. (소문자)void uuid_unparse_upper(uuid_t uu, char *out);:uuid_t를 대문자 문자열 형태로 변환합니다.void uuid_unparse_lower(uuid_t uu, char *out);:uuid_t를 소문자 문자열 형태로 변환합니다. (uuid_unparse와 동일)int uuid_parse(char *in, uuid_t uu);: 문자열 형태의 UUID를uuid_t타입으로 파싱합니다. 성공 시 0을 반환합니다.int uuid_compare(uuid_t uu1, uuid_t uu2);: 두 UUID를 비교합니다. 0이면 동일하고, 음수이면uu1이 작고, 양수이면uu1이 큽니다.
- 유틸리티:
void uuid_copy(uuid_t dst, uuid_t src);: 하나의 UUID를 다른 UUID로 복사합니다.void uuid_clear(uuid_t uu);: UUID 내용을 모두 0으로 초기화합니다.int uuid_is_null(uuid_t uu);: UUID가 모두 0으로 초기화된(NULL) 상태인지 확인합니다. NULL이면 1, 아니면 0을 반환합니다.time_t uuid_time(uuid_t uu, struct timeval *ret_tv);: 시간 기반 UUID에서 생성 시간을 추출합니다. 성공 시 0을 반환합니다.
libuuid 활용 예제
다음 C 코드는 libuuid 라이브러리의 다양한 함수를 사용하여 UUID를 생성, 파싱, 비교 및 관리하는 방법을 보여줍니다.
#include <stdio.h>
#include <string.h> // For string operations if needed, though not strictly for uuid functions
#include <uuid/uuid.h>
#include <sys/time.h> // For struct timeval
// UUID 문자열의 표준 길이 (36자 + 널 종료 문자)
#define UUID_STR_LEN 37
int main() {
uuid_t initial_id; // 초기 UUID 저장
uuid_t parsed_id; // 문자열로부터 파싱된 UUID 저장
uuid_t copied_id; // 복사된 UUID 저장
uuid_t empty_id; // 초기화될 UUID 저장
uuid_t random_id; // 무작위 생성 UUID 저장
uuid_t time_id; // 시간 기반 UUID 저장
char id_string_buf[UUID_STR_LEN]; // UUID 문자열을 저장할 버퍼
struct timeval creation_time_info; // 시간 기반 UUID의 생성 시간 정보
printf("--- libuuid 라이브러리 활용 예제 ---\n");
// 1. UUID 생성 (기본 방식)
uuid_generate(initial_id);
uuid_unparse(initial_id, id_string_buf);
printf("1. 생성된 초기 UUID: %s\n", id_string_buf);
// 2. 문자열 UUID를 uuid_t 타입으로 파싱
// 방금 생성한 UUID 문자열을 파싱 예제로 사용합니다.
if (uuid_parse(id_string_buf, parsed_id) == 0) {
char parsed_string_buf[UUID_STR_LEN];
uuid_unparse(parsed_id, parsed_string_buf);
printf("2. 파싱 후 UUID: %s (원본과 동일함을 확인)\n", parsed_string_buf);
} else {
printf("2. UUID 파싱 실패!\n");
}
// 3. 두 UUID 비교
int comparison_result = uuid_compare(initial_id, parsed_id);
if (comparison_result == 0) {
printf("3. 원본 UUID와 파싱된 UUID는 동일합니다.\n");
} else {
printf("3. 원본 UUID와 파싱된 UUID가 다릅니다. (결과: %d)\n", comparison_result);
}
// 4. UUID 복사
uuid_copy(copied_id, initial_id);
uuid_unparse(copied_id, id_string_buf);
printf("4. 복사된 UUID: %s\n", id_string_buf);
// 5. UUID 초기화 및 NULL 여부 확인
uuid_clear(empty_id);
if (uuid_is_null(empty_id)) {
printf("5. UUID가 성공적으로 초기화(NULL)되었습니다.\n");
} else {
printf("5. UUID 초기화 실패 또는 NULL이 아닙니다.\n");
}
// 6. 무작위 UUID 생성 (버전 4)
uuid_generate_random(random_id);
uuid_unparse(random_id, id_string_buf);
printf("6. 무작위 UUID (V4): %s\n", id_string_buf);
// 7. 시간 기반 UUID 생성 (버전 1) 및 시간 추출
uuid_generate_time(time_id);
uuid_unparse(time_id, id_string_buf);
printf("7. 시간 기반 UUID (V1): %s\n", id_string_buf);
if (uuid_time(time_id, &creation_time_info) == 0) {
printf(" 생성 시간: 초 = %ld, 마이크로초 = %ld\n",
(long)creation_time_info.tv_sec, (long)creation_time_info.tv_usec);
} else {
printf(" 시간 기반 UUID에서 시간 추출 실패.\n");
}
printf("--- 예제 종료 ---\n");
return 0;
}
컴파일 및 실행
위 코드를 my_uuid_example.c로 저장한 후, 다음과 같이 컴파일하고 실행할 수 있습니다. 컴파일 시 -luuid 플래그를 사용하여 libuuid 라이브러리를 링크해야 합니다.
gcc my_uuid_example.c -luuid -o my_uuid_example
./my_uuid_example
실행 결과는 시스템 및 시간에 따라 생성되는 UUID 값이 달라지지만, 다음과 유사한 출력을 확인할 수 있습니다:
--- libuuid 라이브러리 활용 예제 ---
1. 생성된 초기 UUID: e7c2a1b0-f4d3-4e5c-9b8a-1a2b3c4d5e6f
2. 파싱 후 UUID: e7c2a1b0-f4d3-4e5c-9b8a-1a2b3c4d5e6f (원본과 동일함을 확인)
3. 원본 UUID와 파싱된 UUID는 동일합니다.
4. 복사된 UUID: e7c2a1b0-f4d3-4e5c-9b8a-1a2b3c4d5e6f
5. UUID가 성공적으로 초기화(NULL)되었습니다.
6. 무작위 UUID (V4): a1b2c3d4-e5f6-7890-1234-567890abcdef
7. 시간 기반 UUID (V1): f0e9d8c7-b6a5-11ea-8000-000000000000
생성 시간: 초 = 1678886400, 마이크로초 = 543210
--- 예제 종료 ---