Folly Code Review · 76/89

folly::Init — main() 부트스트랩

2026년 6월 8일 · Hawk · 4분 읽기

한 줄 요약: folly::Init은 main() 첫 줄에 두는 부트스트랩 객체다. gflags 파싱, glog 초기화, signal handler 설치, 기본 thread name까지 손볼 곳을 한 줄로 줄인다.

#동기

C++ 서버 코드의 main()은 대개 다음을 한다.

1
int main(int argc, char* argv[]) {
2
  google::ParseCommandLineFlags(&argc, &argv, true);
3
  google::InitGoogleLogging(argv[0]);
4
  google::InstallFailureSignalHandler();
5
  // signal mask, locale, OOM score, jemalloc tuning, ...
6
  RunServer();
7
  return 0;
8
}

라이브러리마다 자기 init 함수가 있고 순서·옵션이 미묘하게 다르다. 어떤 환경 변수를 읽을지, 어떤 시그널을 잡을지 일관성을 유지하기 어렵다.

folly::Init은 이 boilerplate를 RAII 객체 하나로 묶는다.

1
#include <folly/init/Init.h>
2

3
int main(int argc, char* argv[]) {
4
  folly::Init init(&argc, &argv);
5
  RunServer();
6
  return 0;
7
}

생성자에서 일괄 초기화, 소멸자에서 일괄 정리. main()이 정상/비정상 종료되든 cleanup이 일관되게 호출된다.

#무엇이 일어나는가

folly::Init 생성자가 다음을 순서대로 실행한다.

gflags 파싱 — --flag=value argv 처리. --help 응답.
glog 초기화 — log 디렉토리, severity threshold, stderr alsologto.
signal handler 설치 — SIGSEGV/SIGABRT 등에 stacktrace dumper.
symbolizer 초기화 — addr2line 캐시 prewarm.
boost::context size 조정 (fiber 사용 시).
HHWheelTimer global instance 준비.
jemalloc/RSS 통계 prewarm (옵션).

소멸자는 (역순으로) glog flush, gflags shutdown 정도.

#API

1
namespace folly {
2

3
class Init {
4
 public:
5
  enum class InitFlags {
6
    NO_GLOG     = 0x01,
7
    NO_GFLAGS   = 0x02,
8
    NO_SIGNAL_HANDLERS = 0x04,
9
  };
10

11
  Init(int* argc, char*** argv, bool removeFlags = true);
12
  Init(int* argc, char*** argv, InitOptions options);
13
  ~Init();
14

15
  Init(const Init&) = delete;
16
  Init& operator=(const Init&) = delete;
17
};
18

19
}

argc/argv를 pointer로 받는다 — gflags 파싱 후 컨슈머 flag을 제거해 application flag만 남긴다.
removeFlags=false로 원본 argv 보존 가능 (parser에 직접 넘기는 경우).
InitOptions로 세부 동작 조절.

1
folly::InitOptions opts;
2
opts.useGFlags(false);   // gflags 사용 안 함
3
opts.removeFlags(false); // argv 원본 유지
4
opts.installSignalHandlers(false);
5

6
folly::Init init(&argc, &argv, opts);

#사용 패턴

#기본

1
int main(int argc, char* argv[]) {
2
  folly::Init init(&argc, &argv);
3
  LOG(INFO) << "starting";
4
  RunServer();
5
  return 0;
6
}

가장 흔한 형태. fbcode 새 binary의 95%가 이 한 줄로 시작.

#테스트 fixture

1
int main(int argc, char* argv[]) {
2
  testing::InitGoogleTest(&argc, argv);
3
  folly::Init init(&argc, &argv);
4
  return RUN_ALL_TESTS();
5
}

gtest의 InitGoogleTest를 먼저, folly::Init이 나머지 처리.

#라이브러리에서

1
// Library code — main() 없음
2
class MyService {
3
 public:
4
  void Start() {
5
    static folly::Init init{nullptr, nullptr, folly::InitOptions{}.useGFlags(false)};
6
    // ↑ argv 없는 모드 — gflags 건너뜀
7
  }
8
};

라이브러리가 self-contained init을 원하면 nullptr argv. 단 이렇게 쓰면 사용자가 main()에서 별도 init했을 때 충돌 가능. 라이브러리는 보통 init을 호출자에 맡긴다.

#Signal handler가 하는 일

1
// SIGSEGV / SIGABRT / SIGBUS / SIGFPE / SIGILL
2
void SignalHandler(int sig) {
3
  // 1. 현재 thread의 stack trace dump
4
  folly::symbolizer::dumpStackTrace(STDERR_FILENO);
5
  // 2. core dump 유도 (default action)
6
  std::signal(sig, SIG_DFL);
7
  std::raise(sig);
8
}

crash 시 stacktrace를 stderr에 토해낸 뒤 default action (보통 core dump). google’s InstallFailureSignalHandler와 비슷하나 folly의 symbolizer를 쓴다 — 더 풍부한 inline / template instantiation info.

#glog 초기화 vs xlog

1
folly::Init init(&argc, &argv);
2

3
LOG(INFO) << "with glog";          // OK
4
XLOG(INFO) << "with xlog";          // OK — folly의 logger

folly::Init은 glog와 xlog 둘 다 초기화한다. xlog는 folly 자체 logger로 더 풍부한 category/scope 모델. 새 코드는 xlog 선호.

#코드 리뷰 포인트

folly::Init을 main() 첫 줄에 두지 않음 — flag/log가 일관되지 않음.
folly::Init 객체가 stack이 아닌 heap에 — 소멸 시점이 main() 끝과 다름. RAII 깨짐.
Init 호출 전에 LOG 매크로 사용 — glog initialized 안 된 상태에서 동작 미정.
라이브러리 코드에서 Init 호출 → main()에서 또 호출하면 중복 / 충돌 가능.

#자주 보는 안티패턴

1
// 1. Init 후 다시 google::ParseCommandLineFlags 호출
2
folly::Init init(&argc, &argv);
3
google::ParseCommandLineFlags(&argc, &argv, true);   // 두 번 — flag 사라짐
4
// → Init이 이미 처리. 추가 호출 불필요.
5

6
// 2. Init 객체를 polymorphic하게 못 쓰는데 시도
7
std::unique_ptr<folly::Init> init = std::make_unique<folly::Init>(&argc, &argv);
8
// → OK는 하지만 stack RAII가 자연스러움
9

10
// 3. atexit에서 LOG 호출
11
std::atexit([] { LOG(INFO) << "bye"; });
12
// → Init 소멸자가 glog shutdown 후라 LOG 결과가 lost 가능

#glog와의 관계

항목	google glog	folly::Init + xlog
init	`InitGoogleLogging`	`folly::Init`
category	severity (INFO/WARNING/ERROR)	severity + 계층 category
빠른 path	`LOG(INFO)`	`XLOG(DBG1)` (compile-time off)
structured fields	직접	category로 부분