Initial commit

Author: j2doll

.vscode/launch.json

@@ -0,0 +1,34 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "(Remote) Debug main_app with Libraries",
+            "type": "cppdbg",
+            "request": "launch",
+            "program": "/home/user/dev/build/a.out", // [서버] 실행 파일 경로
+            "args": [],
+            "stopAtEntry": false,
+            "cwd": "/home/user/dev/build",           // [서버] 실행 위치
+            "environment": [
+                { "name": "LD_LIBRARY_PATH", "value": "/home/user/dev/build" }
+            ],
+            "MIMode": "gdb",
+            "pipeTransport": {
+                "pipeCwd": "${workspaceFolder}",
+                "pipeProgram": "ssh.exe",
+                "pipeArgs": ["user@192.168.0.100"], // [서버] 접속 정보 수정 필요
+                "debuggerPath": "/usr/bin/gdb"      // [서버] gdb 위치
+            },
+            "sourceFileMap": {
+                "/home/user/dev/apps/main_app": "${workspaceFolder}/apps/main_app",
+                "/home/user/dev/libs/lib_b": "${workspaceFolder}/libs/lib_b",
+                "/home/user/dev/libs/lib_d": "${workspaceFolder}/libs/lib_d"
+            },
+            "additionalSOLibSearchPath": "/home/user/dev/build",
+            "setupCommands": [
+                { "text": "-enable-pretty-printing", "ignoreFailures": true },
+                { "text": "set solib-search-path /home/user/dev/build" }
+            ]
+        }
+    ]
+}

Makefile

@@ -0,0 +1,14 @@
+# Root 디렉토리에 위치
+SUBDIRS = libs/lib_d libs/lib_b apps/main_app
+
+all:
+	@for dir in $(SUBDIRS); do \
+		$(MAKE) -C $$dir; \
+	done
+
+clean:
+	rm -rf build/*
+	@for dir in $(SUBDIRS); do \
+		$(MAKE) -C $$dir clean; \
+	done
+	

README.md

@@ -0,0 +1,76 @@
+
+# 🚀 vscode-airgapped-cpp-debug
+
+본 프로젝트는 인터넷 연결이 불가능한 **에어갭(Air-gapped) 리눅스 환경**에서 별도의 에이전트(`vscode-server`)나 `gdbserver` 설치 없이, 오직 **SSH 파이프**만을 이용하여 윈도우 VS Code에서 원격 디버깅을 수행할 수 있도록 설계된 C/C++ 프로젝트 템플릿입니다.
+
+## 🌟 주요 특징
+* **Zero-Agent**: 서버에 `curl`, `wget`을 통한 추가 바이너리 설치가 필요 없습니다.
+* **Air-gapped Ready**: 오직 SSH(22번 포트)와 SFTP만 사용하여 작동합니다.
+* **Complex Structure**: 실행 파일(`a.out`)과 다중 공유 라이브러리(`.so`) 간의 의존성 디버깅을 지원합니다.
+* **Step-Into Support**: 메인 로직에서 라이브러리 내부 함수로 진입하는 디버깅이 가능합니다.
+
+---
+
+## 📂 프로젝트 구조
+```text
+.
+├── .vscode/
+│   └── launch.json       # 윈도우 VS Code용 원격 디버그 설정 (핵심)
+├── apps/
+│   └── main_app/         # 메인 실행 프로그램 (a.out)
+├── libs/
+│   ├── lib_b/            # 중간 공유 라이브러리 (libb.so)
+│   └── lib_d/            # 최하위 공유 라이브러리 (libd.so)
+├── Makefile              # 프로젝트 전체 빌드 관리
+└── build/                # 빌드 결과물 저장소 (서버 생성)
+```
+
+---
+
+## 🛠 사전 준비 사항 (Prerequisites)
+
+### 1. 리눅스 서버 (Remote)
+* **GDB**: `gdb`가 설치되어 있어야 합니다. (`gdb --version`으로 확인)
+* **SSH**: SSH 서비스가 활성화되어 있어야 합니다.
+
+### 2. 윈도우 개발 환경 (Local)
+* **VS Code**: `C/C++` 확장(Microsoft)이 설치되어 있어야 합니다.
+* **SSH Client**: 윈도우 기본 `ssh.exe`를 사용합니다.
+* **SSH Key**: 비밀번호 입력 없이 접속 가능하도록 `ssh-copy-id` 등으로 키 등록을 권장합니다.
+
+---
+
+## 🚀 빠른 시작 가이드 (Quick Start)
+
+### Step 1: 소스 코드 동기화
+WinSCP 또는 SFTP 도구를 사용하여 본 프로젝트 전체를 서버의 특정 경로(예: `/home/user/dev`)에 업로드합니다.
+> **Tip:** WinSCP의 "업데이트된 상태로 유지" 기능을 사용하면 로컬 수정 사항이 실시간으로 서버에 반영됩니다.
+
+### Step 2: 서버에서 빌드
+서버 터미널에 접속하여 루트 디렉토리에서 빌드를 수행합니다.
+```bash
+make clean
+make
+```
+`build/` 폴더 내에 `a.out`, `libb.so`, `libd.so`가 생성되었는지 확인합니다.
+
+### Step 3: `launch.json` 수정
+`.vscode/launch.json` 파일을 열어 다음 항목을 자신의 환경에 맞게 수정합니다.
+* `"pipeArgs"`: 서버 접속 주소 (`user@ip`)
+* `"program"`: 서버 내 `a.out` 절대 경로
+* `"sourceFileMap"`: 서버 경로와 윈도우 로컬 경로 매칭
+
+### Step 4: 디버깅 시작
+1. `main.c` 또는 라이브러리 소스에 브레이크포인트를 잡습니다.
+2. `F5`를 눌러 디버깅을 시작합니다.
+3. 변수 조사, 조사식, 콜 스택 등 모든 VS Code 디버깅 기능을 활용합니다.
+
+---
+
+## ⚠️ 주의사항
+* **소스 동기화**: 서버의 소스와 윈도우의 소스가 라인 단위로 일치해야 브레이크포인트가 정확히 작동합니다.
+* **빌드 옵션**: 모든 Makefile에는 `-g` (디버그 심볼) 옵션이 포함되어 있어야 합니다.
+* **LD_LIBRARY_PATH**: 실행 시 라이브러리를 찾지 못한다면 `launch.json`의 `environment` 설정을 확인하세요.
+
+---
+

apps/main_app/Makefile

@@ -0,0 +1,21 @@
+# apps/main_app/Makefile
+CC = gcc
+CFLAGS = -g -I../../libs/lib_b/include -I../../libs/lib_d/include
+LDFLAGS = -L../../build -lb -ld
+TARGET = ../../build/a.out
+SRCS = src/main.c
+OBJS = $(SRCS:.c=.o)
+
+all: $(TARGET)
+
+$(TARGET): $(OBJS)
+	@mkdir -p ../../build
+	$(CC) -o $@ $^ $(LDFLAGS)
+
+%.o: %.c
+	$(CC) $(CFLAGS) -c $< -o $@
+
+clean:
+	rm -f src/*.o $(TARGET)
+	
+	

apps/main_app/src/main.c

@@ -0,0 +1,8 @@
+#include <stdio.h>
+#include "../../libs/lib_b/include/lib_b.h"
+
+int main() {
+    printf("Starting main_app (a.out)...\n");
+    print_b(); // b.so 함수 호출
+    return 0;
+}

libs/lib_b/Makefile

@@ -0,0 +1,21 @@
+# libs/lib_b/Makefile
+CC = gcc
+CFLAGS = -g -fPIC -I./include -I../lib_d/include
+LDFLAGS = -L../../build -ld  # libd.so를 링크함
+TARGET = ../../build/libb.so
+SRCS = src/lib_b.c
+OBJS = $(SRCS:.c=.o)
+
+all: $(TARGET)
+
+$(TARGET): $(OBJS)
+	@mkdir -p ../../build
+	$(CC) -shared -o $@ $^ $(LDFLAGS)
+
+%.o: %.c
+	$(CC) $(CFLAGS) -c $< -o $@
+
+clean:
+	rm -f src/*.o $(TARGET)
+	
+	

libs/lib_b/include/lib_b.h

@@ -0,0 +1,8 @@
+#include <stdio.h>
+#include "../include/lib_b.h"
+#include "../../lib_d/include/lib_d.h"
+
+void print_b() {
+    printf("Hello from lib_b.so (Dependency Depth 1)\n");
+    print_d(); // d.so 함수 호출
+}

libs/lib_b/src/lib_b.c

@@ -0,0 +1,19 @@
+# libs/lib_d/Makefile
+CC = gcc
+CFLAGS = -g -fPIC -I./include
+TARGET = ../../build/libd.so
+SRCS = src/lib_d.c
+OBJS = $(SRCS:.c=.o)
+
+all: $(TARGET)
+
+$(TARGET): $(OBJS)
+	@mkdir -p ../../build
+	$(CC) -shared -o $@ $^
+
+%.o: %.c
+	$(CC) $(CFLAGS) -c $< -o $@
+
+clean:
+	rm -f src/*.o $(TARGET)
+