본문으로 건너뛰기
Previous
Next
C++ Semaphore | '세마포어' 가이드 | 핵심 개념과 실전 활용

C++ Semaphore | '세마포어' 가이드 | 핵심 개념과 실전 활용

C++ Semaphore | '세마포어' 가이드 | 핵심 개념과 실전 활용

이 글의 핵심

C++20 std::counting_semaphore·binary_semaphore로 동시 접근 수를 제한하고, 생산자-소비자·리소스 풀을 구현하는 방법을 정리합니다. 뮤텍스와의 차이, try_acquire, 실무 함정까지 다룹니다.

세마포어란?

카운팅 동기화 도구 (C++20)

#include <semaphore>

// 최대 3개 스레드
std::counting_semaphore<3> sem(3);

void worker() {
    sem.acquire();  // 카운트 감소
    // 작업
    sem.release();  // 카운트 증가
}

counting_semaphore

// 최대 카운트 지정
std::counting_semaphore<10> sem(5);  // 초기값 5

sem.acquire();  // 5 -> 4
sem.release();  // 4 -> 5

binary_semaphore

C/C++ 예제 코드입니다.

// 0 또는 1
std::binary_semaphore sem(1);

sem.acquire();  // 1 -> 0
// ...
sem.release();  // 0 -> 1

실전 예시

예시 1: 자원 풀

#include <semaphore>
#include <thread>
#include <vector>

std::counting_semaphore<3> poolSem(3);  // 최대 3개

void worker(int id) {
    poolSem.acquire();
    std::cout << "스레드 " << id << " 시작" << std::endl;
    
    std::this_thread::sleep_for(std::chrono::seconds(1));
    
    std::cout << "스레드 " << id << " 완료" << std::endl;
    poolSem.release();
}

int main() {
    std::vector<std::thread> threads;
    
    for (int i = 0; i < 10; i++) {
        threads.emplace_back(worker, i);
    }
    
    for (auto& t : threads) {
        t.join();
    }
}

예시 2: Producer-Consumer

std::counting_semaphore<10> empty(10);  // 빈 슬롯
std::counting_semaphore<10> full(0);    // 찬 슬롯
std::mutex mtx;
std::queue<int> buffer;

void producer() {
    for (int i = 0; i < 20; i++) {
        empty.acquire();
        
        {
            std::lock_guard lock(mtx);
            buffer.push(i);
        }
        
        full.release();
    }
}

void consumer() {
    for (int i = 0; i < 20; i++) {
        full.acquire();
        
        int value;
        {
            std::lock_guard lock(mtx);
            value = buffer.front();
            buffer.pop();
        }
        
        empty.release();
        std::cout << value << std::endl;
    }
}

예시 3: 동시 접근 제한

class Database {
    std::counting_semaphore<5> connSem{5};  // 최대 5개 연결
    
public:
    void query() {
        connSem.acquire();
        
        try {
            executeQuery();
        } catch (...) {
            connSem.release();
            throw;
        }
        
        connSem.release();
    }
};

예시 4: 신호 전달

producer 함수의 구현 예제입니다.

std::binary_semaphore signal(0);

void producer() {
    prepareData();
    signal.release();  // 신호
}

void consumer() {
    signal.acquire();  // 대기
    processData();
}

try_acquire

std::counting_semaphore<3> sem(3);

if (sem.try_acquire()) {
    // 획득 성공
    sem.release();
} else {
    // 획득 실패
}

// 타임아웃
if (sem.try_acquire_for(std::chrono::seconds(1))) {
    // 획득 성공
    sem.release();
}

자주 발생하는 문제

문제 1: release 누락

// ❌ release 누락
sem.acquire();
process();
// sem.release();  // 누락

// ✅ RAII 래퍼
class SemaphoreGuard {
    std::counting_semaphore<>& sem;
public:
    SemaphoreGuard(std::counting_semaphore<>& s) : sem(s) {
        sem.acquire();
    }
    ~SemaphoreGuard() {
        sem.release();
    }
};

문제 2: 초기값

C/C++ 예제 코드입니다.

// ❌ 초기값 0
std::counting_semaphore<10> sem(0);
sem.acquire();  // 영원히 대기

// ✅ 적절한 초기값
std::counting_semaphore<10> sem(10);

문제 3: 데드락

C/C++ 예제 코드입니다.

std::counting_semaphore<1> sem1(1);
std::counting_semaphore<1> sem2(1);

// Thread 1
sem1.acquire();
sem2.acquire();  // 데드락 가능

// Thread 2
sem2.acquire();
sem1.acquire();

문제 4: 예외 안전성

sem.acquire();
try {
    process();
} catch (...) {
    sem.release();  // 필수
    throw;
}
sem.release();

mutex vs semaphore

C/C++ 예제 코드입니다.

// mutex: 소유권 있음
std::mutex mtx;
mtx.lock();
mtx.unlock();  // 같은 스레드

// semaphore: 소유권 없음
std::counting_semaphore<1> sem(1);
sem.acquire();  // 스레드 A
sem.release();  // 스레드 B (OK)

세마포어 vs 뮤텍스 (언제 무엇을 쓰나)

  • 뮤텍스는 보통 상호 배제(mutual exclusion)소유권 모델입니다. 같은 스레드가 lock한 뮤텍스를 다른 스레드가 unlock하면 정의되지 않은 동작(UB) 에 가깝습니다(구현에 따라 검사).
  • 세마포어카운터입니다. acquire로 하나 빼고, release로 하나 더합니다. 어느 스레드가 release해도 대기 중인 다른 스레드가 깨어날 수 있어, “풀에서 자리 반납” 같은 모델에 잘 맞습니다.

직관: 뮤텍스는 “화장실 한 칸(한 번에 한 명, 들어간 사람만 나올 수 있음)”에 가깝고, 세마포어는 “주차장 빈 칸 N개”에 가깝습니다.

중요: 카운트가 1인 세마포어(바이너리)와 뮤텍스는 겉보기 비슷하지만, 소유권·재진입 규칙·조건 변수와의 관습적 조합이 다릅니다. 공유 데이터를 보호하는 기본 도구는 여전히 뮤텍스 + RAII 락이고, 세마포어는 동시 실행 개수·슬롯 수를 제한하는 쪽에 강합니다.

counting_semaphore vs binary_semaphore

  • std::counting_semaphore: 템플릿 인자 LeastMax최대치의 하한입니다. 구현은 그 이상을 허용할 수 있지만, 최소한 LeastMax까지는 지원합니다. 초기값은 생성자로 주며, 현재 카운트는 max() 이하로 유지됩니다.
  • std::binary_semaphorecounting_semaphore<1>에 대한 별칭으로 생각하면 됩니다. 0 또는 1만 표현하므로, 이벤트 시그널링(“준비됨”)이나 단일 슬롯 같은 패턴에 씁니다.

C/C++ 예제 코드입니다.

std::binary_semaphore ready{0};  // 아직 준비 안 됨

// 생산자
data = produce();
ready.release();  // 0 -> 1, 대기자 깨움

// 소비자
ready.acquire();  // 1 -> 0 이 될 때까지 대기
consume(data);

생산자-소비자 패턴 (세마포어 관점)

앞의 예시처럼 빈 슬롯(empty)찬 슬롯(full) 을 세마포어로 세고, 큐 자체는 mutex로 보호하는 전형적인 구조입니다.

  • empty 초기값 = 버퍼 크기, full 초기값 = 0.
  • 생산자: empty.acquire() → 큐에 pushfull.release()
  • 소비자: full.acquire() → 큐에서 popempty.release()

주의: 버퍼가 한 칸이면 생산자·소비자가 동시에 접근할 때 여전히 데이터 레이스가 나지 않도록 큐 연산은 반드시 뮤텍스 안에서 하세요. 세마포어는 “몇 개의 아이템이 있는가”만 세 줄 뿐, 메모리 일관성은 뮤텍스가 담당합니다.

리소스 풀 관리 (연결 풀·워커 슬롯)

counting_semaphore<N>(N) 패턴은 최대 N개의 동시 사용자를 허용합니다. DB 커넥션 풀처럼 실제 객체는 풀 안에 고정해 두고, 세마포어는 “꺼내 쓸 수 있는 권한”만 나눠 줍니다.

std::counting_semaphore<8> db_slots{8};

void handle_request() {
    db_slots.acquire();
    try {
        run_query();
    } catch (...) {
        db_slots.release();
        throw;
    }
    db_slots.release();
}

예외 안전을 위해 RAII 래퍼(앞서 나온 SemaphoreGuard)를 두면 release 누락을 줄일 수 있습니다.

C++20 표준 세마포어가 제공하는 것

  • <semaphore> 헤더, std::counting_semaphore, std::binary_semaphore.
  • acquire, release (인자로 한 번에 여러 카운트 증가 가능), try_acquire, try_acquire_for, try_acquire_until.
  • 기본 생성은 없음 — 반드시 초기 카운트를 넘겨야 합니다.
  • 복사·이동 불가 — 세마포어 객체는 스레드 간 공유용으로 두고, 여러 스레드가 같은 객체에 acquire/release합니다.

표준이 아닌 플랫폼 API( POSIX 세마포어 등)를 쓰던 코드를 이식성 있게 옮길 때 C++20 세마포어가 유용합니다.

FAQ

Q1: latch vs barrier?

A:

  • latch: 한 번만
  • barrier: 재사용

Q2: 언제 사용?

A:

  • 자원 풀
  • Producer-Consumer
  • 동시 접근 제한

Q3: mutex와 차이?

A:

  • mutex: 소유권
  • semaphore: 카운팅

Q4: 성능?

A: 가볍고 빠름.

Q5: C++20 필수?

A: 네.

Q6: 세마포어 학습 리소스는?

A:

  • “C++20 The Complete Guide”
  • “Operating System Concepts”
  • cppreference.com

같이 보면 좋은 글 (내부 링크)

이 주제와 연결되는 다른 글입니다.

관련 글

심화 부록: 구현·운영 관점

이 부록은 앞선 본문에서 다룬 주제(「C++ Semaphore | ‘세마포어’ 가이드」)를 구현·런타임·운영 관점에서 다시 압축합니다. 도메인별 세부 구현은 글마다 다르지만, 입력 검증 → 핵심 연산 → 부작용(I/O·네트워크·동시성) → 관측의 흐름으로 장애를 나누면 원인 추적이 빨라집니다.

내부 동작과 핵심 메커니즘

flowchart TD
  A[입력·요청·이벤트] --> B[파싱·검증·디코딩]
  B --> C[핵심 연산·상태 전이]
  C --> D[부작용: I/O·네트워크·동시성]
  D --> E[결과·관측·저장]
sequenceDiagram
  participant C as 클라이언트/호출자
  participant B as 경계(런타임·게이트웨이·프로세스)
  participant D as 의존성(API·DB·큐·파일)
  C->>B: 요청/이벤트
  B->>D: 조회·쓰기·RPC
  D-->>B: 지연·부분 실패·재시도 가능
  B-->>C: 응답 또는 오류(코드·상관 ID)
  • 불변 조건(Invariant): 버퍼 경계, 프로토콜 상태, 트랜잭션 격리, FD 상한 등 단계별로 문장으로 적어 두면 디버깅 비용이 줄어듭니다.
  • 결정성: 순수 층과 시간·네트워크·스케줄에 의존하는 층을 분리해야 테스트와 장애 분석이 쉬워집니다.
  • 경계 비용: 직렬화, 인코딩, syscall 횟수, 락 경합, 할당·GC, 캐시 미스를 의심 목록에 둡니다.
  • 백프레셔: 생산자가 소비자보다 빠를 때 버퍼·큐·스트림에서 속도를 줄이는 신호를 어디에 둘지 정의합니다.

프로덕션 운영 패턴

영역운영 관점 질문
관측성요청 단위 상관 ID, 에러율·지연 p95/p99, 의존성 타임아웃·재시도가 대시보드에 보이는가
안전성입력 검증·권한·비밀·감사 로그가 코드 경로마다 일관적인가
신뢰성재시도는 멱등 연산에만 적용되는가, 서킷 브레이커·백오프·DLQ가 있는가
성능캐시·배치 크기·커넥션 풀·인덱스·백프레셔가 데이터 규모에 맞는가
배포롤백 룬북, 카나리/블루그린, 마이그레이션·피처 플래그가 문서화되어 있는가
용량피크 트래픽·디스크·FD·스레드 풀 상한을 주기적으로 검증하는가

스테이징은 데이터 양·네트워크 RTT·동시성을 프로덕션에 가깝게 맞출수록 재현율이 올라갑니다.

확장 예시: 엔드투엔드 미니 시나리오

앞선 본문 주제(「C++ Semaphore | ‘세마포어’ 가이드」)를 배포·운영 흐름에 맞춰 옮긴 체크리스트입니다. 도메인에 맞게 단계 이름만 바꿔 적용할 수 있습니다.

  1. 입력 계약 고정: 스키마·버전·최대 페이로드·타임아웃·에러 코드를 경계에 둔다.
  2. 핵심 경로 계측: 요청 ID, 단계별 지연, 외부 호출 결과 코드를 로그·메트릭·트레이스에서 한 흐름으로 본다.
  3. 실패 주입: 의존성 타임아웃·5xx·부분 데이터·락 대기를 스테이징에서 재현한다.
  4. 호환·롤백: 설정/마이그레이션/클라이언트 버전을 되돌릴 수 있는지 확인한다.
  5. 부하 후 검증: 피크 대비 p95/p99, 에러율, 리소스 상한, 알림 임계값을 점검한다.
handle(request):
  ctx = newCorrelationId()
  validated = validateSchema(request)
  authorize(validated, ctx)
  result = domainCore(validated)
  persistOrEmit(result, idempotentKey)
  recordMetrics(ctx, latency, outcome)
  return result

문제 해결(Troubleshooting)

증상가능 원인조치
간헐적 실패레이스, 타임아웃, 외부 의존성, DNS최소 재현 스크립트, 분산 트레이스·로그 상관관계, 재시도·서킷 설정 점검
성능 저하N+1, 동기 I/O, 락 경합, 과도한 직렬화, 캐시 미스프로파일러·APM으로 핫스팟 확인 후 한 가지씩 제거
메모리 증가캐시 무제한, 구독/리스너 누수, 대용량 버퍼, 커넥션 미반납상한·TTL·힙/FD 스냅샷 비교
빌드·배포만 실패환경 변수, 권한, 플랫폼 차이, lockfileCI 로그와 로컬 diff, 런타임·이미지 버전 핀
설정 불일치프로필·시크릿·기본값, 리전스키마 검증된 설정 단일 소스와 배포 매트릭스 표준화
데이터 불일치비멱등 재시도, 부분 쓰기, 캐시 무효화 누락멱등 키·아웃박스·트랜잭션 경계 재검토

권장 순서: (1) 최소 재현 (2) 최근 변경 범위 축소 (3) 환경·의존성 차이 (4) 관측으로 가설 검증 (5) 수정 후 회귀·부하 테스트.

배포 전에는 git addgit commitgit pushnpm run deploy 순서를 권장합니다.


이 글에서 다루는 키워드 (관련 검색어)

C++, semaphore, synchronization, C++20, concurrency 등으로 검색하시면 이 글이 도움이 됩니다.