Tmux 환경에서 Vim 컴파일 시 발생하는 termio/termios 감지 오류 해결 방법
리눅스 환경에서 소스코드를 직접 빌드하다 보면 의외의 환경 변수나 터미널 세션 설정 때문에 엉뚱한 빌드 에러를 마주할 때가 있습니다. 대표적인 예로 Tmux 세션 내부에서 Vim 소스를 컴파일할 때 발생하는 termio/termios 감지 오류가 있습니다.
이번 글에서는 해당 에러가 발생하는 원인과, 단순한 clean으로는 해결되지 않는 이유 및 올바른 해결 방법을 정리합니다.
1. 문제 원인
Vim의 소스 코드 빌드 과정(configure)은 시스템이 System V 계열인지 Linux 계열인지 판별하기 위해 termio.h와 termios.h 헤더 파일 및 터미널 인터페이스를 검사(Probe)합니다.
하지만 Tmux 내부(세션 안)에서 컴파일을 진행할 경우, Tmux가 제공하는 PTY(Pseudo-Terminal) 환경과 TERM=screen 등의 특수한 환경 변수 영향으로 인해 Autoconf가 터미널 인터페이스를 검출하는 과정에서 오동작을 일으킵니다. 그 결과, 실제 시스템 조건과 무관하게 설정 에러를 발생시키게 됩니다.
2. 왜 make clean으로는 해결되지 않을까?
일반적인 개발 과정에서는 빌드가 꼬였을 때 make clean을 실행하곤 합니다. 하지만 make clean은 컴파일된 오브젝트 파일이나 바이너리(.o 파일 등)만 삭제할 뿐, Autotools가 시스템 환경을 탐색한 결과로 남긴 캐시(config.cache 또는 내부 매크로 변수)나 설정 파일들은 그대로 유지합니다.
일반적인 상황에서는 시스템의 하드웨어/OS 정보가 바뀌지 않기 때문에 이 잔여물이 문제가 되지 않습니다. 그러나 Tmux나 Screen 같은 터미널 멀티플렉서 환경에서 탐색된 왜곡된 정보가 캐시에 박혀버리면, 나중에 Tmux 외부(일반 터미널)로 나와서 빌드를 시도해도 이전의 오염된 캐시 때문에 계속해서 오류가 발생하게 됩니다.
3. 해결 방법
이 문제를 해결하기 위해서는 반드시 Tmux 외부 환경에서 기존의 오염된 설정 파일을 완전히 제거(distclean)한 후 다시 빌드해야 합니다.
Step 1: Tmux 세션 바깥으로 이동
현재 실행 중인 Tmux 세션 내부라면 세션을 분리(Detach)하거나, Tmux가 실행되지 않은 일반 순수 터미널 창을 열어 소스 코드가 있는 디렉토리로 이동합니다.
# Tmux 세션 분리 (detach)
exit
Step 2: 기존 설정 및 캐시 완전 제거 (distclean)
단순한 make clean이 아니라, 생성된 설정 파일과 캐시를 모두 날려버리는 distclean을 실행합니다.
cd /path/to/vim/src
make distclean
Step 3: 재설정 및 컴파일 수행
환경이 깨끗하게 초기화된 상태에서 다시 configure와 빌드를 진행합니다.
./configure
make
sudo make install
요약
Autotools 기반의 패키지를 빌드할 때 터미널 환경에 의존적인 검사(termio/termios 등)가 포함되어 있다면, 멀티플렉서 환경(Tmux, Screen 등)에서의 빌드는 예상치 못한 캐시 오염을 유발할 수 있습니다.
만약 조건과 무관한 터미널 관련 빌드 에러를 만났다, Tmux 외부에서 make distclean을 통해 환경을 완전히 초기화하고 재시도해 보시기 바랍니다.
댓글
댓글 쓰기