[Linux] Linux pwd 명령어 완전 정복: 절대경로의 모든 것 🔍

Linux pwd 명령어는 현재 작업 중인 디렉터리의 절대경로를 확인하는 기본 도구다. OpenWrt·서버·임베디드 환경에서도 필수로 사용되는 pwd 활용법을 정리했다.

1. 왜 Linux pwd 명령어가 중요한가?

Linux 쉘을 처음 배우는 사람도, 대규모 OpenWrt 프로젝트를 관리하는 개발자도, 서버를 운영하는 시스템 관리자도 공통으로 반드시 사용하는 명령어가 하나 있다. 바로 pwd(print working directory)이다.

pwd는 “지금 내가 정확히 어디서 작업하고 있는지” 를 알려주는 기본 명령어지만, 실무에서는 이를 기반으로 한 경로 문제, 스크립트 오류, 파일 접근 실패 등이 하루에도 수십 번 발생한다.

특히 다음 환경에서는 pwd 이해도가 매우 중요하다.

• OpenWrt 빌드 시스템에서 디렉터리가 여러 번 변경될 때
• CMake·Makefile에서 상대경로/절대경로로 헤더를 include할 때
• CI/CD 스크립트가 예상과 다른 경로에서 실수로 실행될 때
• rm -rf 같은 위험 명령어를 실행하기 전에 위치 확인이 필요할 때
• 임베디드 Linux 장비에서 최소한의 도구로 현재 위치를 파악해야 할 때

이처럼 pwd는 단순 명령어 같아도 문제 예방·디버깅·자동화·보안의 핵심 요소다.

---

2. pwd 명령어 기본 개념

Linux pwd 명령어 동작 개념도

Linux pwd 명령어는 “Print Working Directory”의 약자로, 현재 셸이 위치한 디렉터리(작업 경로)를 절대경로로 출력한다.

📌 기본 사용법

pwd

 

출력 예:

/home/ubuntu/workspace

 

pwd의 핵심 개념

• 절대경로를 출력한다
• 현재 셸 환경 변수(PWD) 에 저장된 정보를 기반으로 한다
• bash 내부 명령어(builtin)이며, coreutils 버전도 존재한다

---

3. pwd 명령어의 두 가지 방식

pwd는 두 가지 동작 방식이 있다.

1) 논리 경로(Logical Path)

pwd 기본동작
심볼릭 링크를 보존한다.

pwd

 

예:

/home/ubuntu/project -> /mnt/data/project

 

로그ical pwd는 /home/ubuntu/project 를 출력한다.

2) 물리 경로(Physical Path)

-P 옵션
실제 디스크 상의 경로를 출력한다.

pwd -P

 

출력 예:

/mnt/data/project

 

언제 유용한가?

• Docker, chroot, OverlayFS 기반 OpenWrt 빌드
• 심볼릭 링크가 많은 경로 구조
• 실제 ‘리얼’ 경로를 확인해야 하는 디버깅 상황

---

4. pwd 명령어의 옵션 상세 정리

pwd로 현재 디렉터리 검증 후 안전한 명령 실행

옵션	설명
(기본)	logical path 출력
-L	logical path 강제 출력
-P	physical path 출력

예제

pwd -P
pwd -L

 

---

5. pwd 명령어 운영체제별 차이

Linux bash

• 내부 명령(builtin)
• help pwd 로 문서 확인 가능

BusyBox(OpenWrt)

• BusyBox 내장 기능
• 옵션 지원 범위가 좁을 수 있음
• 디버깅 시 오히려 readlink -f . 를 더 많이 쓰기도 함

readlink -f .

 

macOS

• coreutils pwd(gpwd) 별도 설치 가능
• 심볼릭 링크 처리 방식이 리눅스와 미세하게 다를 수 있음

---

6. pwd 명령어 실전 활용 시나리오

아래는 pwd가 실무에서 어떻게 활용되는지 실제 예시 기반으로 설명한다.

1) 경로 확인이 필요한 위험한 명령 실행 전

예: rm 명령어 실행 전에 안전 확인하기

pwd
rm -rf *

 

특히 임베디드 장비에서 root 권한일 때 더 중요하다.
실수로 /etc 나 /overlay 같은 경로에서 rm을 실행하면 시스템 자체가 붕괴된다.

2) 스크립트가 예상 경로에서 실행되는지 검증

bash script 상단에서 찾는 패턴:

#!/bin/sh

if [ "$(pwd)" != "/usr/local/myapp" ]; then
    echo "Error: wrong directory"
    exit 1
fi

 

CI/CD(예: GitHub Actions, Jenkins)에서도 같은 패턴을 활용한다.

3) OpenWrt 빌드 환경에서 경로 이동 추적

OpenWrt는 다음처럼 디렉터리를 여러 번 이동하면서 빌드가 진행된다.

./scripts/feeds update -a
./scripts/feeds install tcpdump
make menuconfig
make V=s

 

문제 발생 시:

pwd

 

으로 현재 빌드 스크립트가 어디서 돌고 있는지 쉽게 확인할 수 있다.

4) Makefile에서 경로 기반 조건 처리

C 기반 프로젝트에서 경로 확인 코드를 넣을 때 pwd가 간접적으로 사용된다.

예:

WORK_DIR := $(shell pwd)

all:
    @echo "BUILD PATH = $(WORK_DIR)"

 

임베디드 네트워크 장비를 빌드할 때도 자주 쓰이는 패턴이다.

5) C 프로그래밍 연계 예제(getcwd)

C 언어에서 pwd 기능 구현: getcwd()

C 개발자라면 pwd와 동일한 기능을 수행하는 함수는 getcwd()이다.

/**
 * getcwd_example - Demonstrate how to get current working directory
 *
 * Brief:
 *     Print the current working directory similar to Linux pwd command.
 *
 * Return:
 *     0 on success, -1 on failure.
 */
#include <stdio.h>
#include <unistd.h>
#include <limits.h>

int main(void)
{
    char path[PATH_MAX];

    if (getcwd(path, sizeof(path)) == NULL) {
        perror("getcwd error");
        return -1;
    }

    printf("Current Directory: %s\n", path);
    return 0;
}

 

pwd의 내부 동작과 동일한 기능을 직접 구현하는 형태다.

6) pwd 명령어와 환경 변수의 관계

핵심 환경 변수

• $PWD : 현재 논리 경로
• $OLDPWD : 이전 디렉터리

echo $PWD
echo $OLDPWD

 

차이점

pwd 출력 = $PWD 변수
단, 일부 상황에서는 서로 달라진다(예: chroot, overlay 처리, manual cd -P).

---

7. pwd 명령어로 발생하는 대표 문제들

pwd는 단순하지만, 아래처럼 실제 문제를 많이 일으킨다.

1) 심볼릭 링크 때문에 경로가 혼동될 때

예:

cd /data/logs
pwd
pwd -P

 

출력 경로가 서로 다르면:

• 로그파일 경로 착오
• “파일이 없다”는 오류 발생
• 스크립트에서 상대경로가 꼬임

특히 OpenWrt overlay 파일시스템에서 흔히 발생한다.

2) chroot 환경에서는 pwd가 ‘진짜’가 아님

예:

chroot /tmp/rootfs /bin/sh
pwd

 

겉보기엔 / 이지만 실제는 /tmp/rootfs 내부다.
그러므로 물리 경로(real path) 추적이 필요한 디버깅에서는 반드시 pwd -P 또는 readlink -f . 를 사용한다.

3) 스크립트 자동화에서 PWD 캐시 문제

예:

export PWD="/fake/path"
pwd

 

bash builtin pwd는 $PWD와 상호작용하며, 때로는 스크립트처럼 직접 조작되면 잘못된 경로를 출력할 수 있다.

---

8. pwd 명령어와 자주 함께 사용되는 명령들

1) ls

현재 위치에서 파일 확인

pwd
ls -al

 

2) cd

폴더 이동 후 pwd로 현재 위치 확인

cd /etc
pwd

 

3) readlink

심볼릭 링크 실제 경로 분석

readlink -f .

 

4) dirname / basename

경로 분리

dirname $(pwd)
basename $(pwd)

 

---

9. Linux pwd 명령어를 더 잘 쓰기 위한 팁

✔ 상대경로보다 절대경로를 익혀라

pwd 출력은 항상 절대경로다 → 자동화 스크립트에서 더 안전하다.

✔ rm -rf 실행 전 반드시 pwd 확인

실수 예방의 핵심 습관.

✔ pwd -P 로 실제 경로도 확인

특히 심볼릭 링크가 많은 프로젝트에서 매우 중요하다.

✔ log 파일에 현재 경로를 기록하는 습관

문제 발생 시 경로 기반 디버깅이 쉬워진다.

---

11. Linux pwd 명령어 자주 묻는 질문(FAQ)

Q1. pwd는 어떤 경우에 출력이 달라지나요?

심볼릭 링크 유무, -L/-P 옵션, $PWD 조작 등에서 출력이 달라질 수 있다.

Q2. BusyBox(OpenWrt) pwd는 옵션이 제한되나요?

네, BusyBox는 -P은 있지만 -L 옵션이 없거나 일부 환경에 따라 적용되지 않을 수 있다.

Q3. pwd 없이도 현재 디렉터리를 알 수 있나요?

환경변수 $PWD로 확인 가능하다.

echo $PWD

 

Q4. pwd 내부 구현은 어떤 함수로 동작하나요?

대부분 getcwd() 기반이며, 논리경로 모드에서는 환경변수 $PWD를 우선한다.

Q5. pwd가 틀린 값을 출력하는 상황이 있나요?

스크립트가 $PWD를 덮어쓴 경우, chroot 환경, overlayfs 기반 시스템에서 발생할 수 있다.

---

Linux pwd 명령어는 어떤 효과를 주는가?

Linux pwd 명령어는 단순한 도구 같지만, 경로 기반 사고를 정확하게 잡아주며 위험한 실수를 예방하고 스크립트 자동화·CI/CD·임베디드 디버깅까지 모든 영역에서 중요한 역할을 한다.

“경로를 이해하는 순간 시스템을 지배한다.”
pwd는 그 출발점이다.

 

이전글 보기

[Linux] 리눅스 ls 명령어 모든 것 – 파일·디렉토리 관리 마스터하기 🧭

 

다음글 보기

[Linux] cd 명령어 사용법 200% 이해하기: 실전 사례 + 꿀팁 모음 📘