[Linux] mkdir -p 실무 활용법부터 오류 해결까지 한 번에 배우기 📂

리눅스 mkdir 사용법을 가장 쉽게 정리한 실전형 가이드입니다. 옵션 설명, 예제, 오류 해결, OpenWrt·임베디드 활용까지 포함한 최고의 설명서입니다.

리눅스에서 가장 먼저 배우는 명령어 중 하나가 바로 mkdir이다.
하지만 그냥 “폴더 만드는 명령어” 정도로만 이해하면 실제 운영·개발 환경에서 예상치 못한 문제가 매우 자주 발생한다.

예를 들어:

• 서비스 초기화 스크립트가 로그 디렉토리 미존재로 크래시
• OpenWrt 같은 임베디드 장비에서 디렉토리를 잘못된 영역에 만들어 설정이 날아감
• 설치/배포 스크립트에서 상위 디렉토리가 없어 실행 실패
• C 코드 작성 중 mkdir 실패 원인을 몰라 errno 분석 난항

이런 문제는 대부분 mkdir 사용법을 정확히 이해하지 못했기 때문이다.

이 글에서는 mkdir의 기본부터 실전 패턴, 오류 해결, OpenWrt·임베디드 환경까지 완전히 정리해 "mkdir로 리눅스 파일시스템을 이해할 수 있는 수준"으로 안내한다.

---

1. mkdir 기본 사용법

기본 명령 형식은 매우 단순하다.

mkdir [옵션] 디렉토리명

 

예:

mkdir test

 

현재 디렉토리에 test라는 폴더가 생성된다.
하지만 실무에서는 이 단순 명령만으로는 해결되지 않는다.
그래서 아래 옵션들이 매우 중요해진다.

---

2. mkdir 핵심 옵션 완벽 정리

1) -p 옵션: 상위 디렉토리까지 자동 생성 (가장 중요)

실무 사용 비중 90% 이상을 차지하는 옵션이다.

mkdir -p /opt/myapp/config

 

상위 디렉토리가 존재하지 않아도 순차적으로 생성한다.

왜 필수인가?

• 자동 설치 스크립트에서 필수
• CI/CD 파이프라인 환경에서 재현성 확보
• OpenWrt·임베디드 장비의 초기 설정시 사용
• 크론(cron) 기반 자동 백업 경로 생성 시 오류 방지

상위 디렉토리 없으면 에러가 발생하는데 mkdir -p는 그 문제를 해결한다.

상위 디렉터리를 자동 생성하는 mkdir -p의 구조

2) -v 옵션: 생성 과정 출력

mkdir -v logs

 

결과:

mkdir: created directory 'logs'

 

• 설치 스크립트나 빌드 일부에서 로그 출력이 필요할 때 유용
• 장애/오류 재현 테스트에 도움

3) -m 옵션: 생성 시 권한 지정

mkdir -m 755 /srv/www

 

중요 포인트:

• 퍼미션을 즉시 설정할 수 있다
• 단, umask의 영향을 받으므로 타 환경과 퍼미션이 다르게 나올 수 있어 주의

mkdir -m 퍼미션과 umask 상호 작용

4) -Z 옵션: SELinux 컨텍스트 적용

SELinux가 활성화된 서버 환경에서 사용한다.

mkdir -Z httpd_sys_rw_content_t /var/www/html/upload

 

웹 서비스나 보안 정책이 엄격한 시스템에서 유용하다.

---

3. mkdir 사용 시 발생하는 오류와 해결책

실무에서 흔히 만나는 오류들을 실제 원인과 함께 정리했다.

오류 1: Permission denied

mkdir: cannot create directory 'data': Permission denied

 

원인:

• 현재 사용자에게 쓰기 권한 없음
• 시스템 경로는 root만 생성 가능

해결:

sudo mkdir data

 

또는

chmod u+w .

 

오류 2: File exists

mkdir: cannot create directory 'logs': File exists

 

해결:

mkdir -p logs

 

이미 존재하더라도 에러 없이 넘어간다.
스크립트 환경에서는 사실상 표준 옵션이다.

오류 3: No such file or directory

상위 디렉토리가 없는 경우.

mkdir: cannot create directory '/opt/a/b/c': No such file or directory

 

해결:

mkdir -p /opt/a/b/c

 

Permission denied, File exists, No such file 해결 구조

---

4. 실무에서 가장 많이 쓰는 mkdir 패턴 TOP 7

아래 7가지는 실제 서버·임베디드·OpenWrt 개발 환경에서 하루에도 수십 번 쓰는 패턴이다.

① 서비스 로그 디렉토리 생성

mkdir -p /var/log/myservice

 

로그 디렉토리가 없으면 데몬 실행 자체가 실패하는 경우가 많다.

② 설정파일 보관 디렉토리 준비

mkdir -p /etc/myapp/conf.d

 

여러 설정 파일을 분리해 관리하기 위한 구조.

③ OpenWrt overlay 환경에서 영구 저장 경로 생성

OpenWrt는 파일 시스템 특성이 다르다.

경로	특성
/tmp	RAM 기반, 재부팅 시 삭제
/etc	overlayfs 저장, 영구적
/overlay	플래시 writable 영역

OpenWrt의 overlayfs 저장 방식

재부팅 이후에도 유지하려면:

mkdir -p /etc/myapp

 

반대로 휘발성 데이터를 저장할 경우:

mkdir -p /tmp/myapp

 

④ 빌드 시스템 temp/scratch 디렉토리

Makefile에서 자주 등장하는 구조.

mkdir -p build/tmp

 

⑤ 다운로드/업로드 데이터 경로 분리

mkdir -p /opt/data/upload
mkdir -p /opt/data/download

 

⑥ 사용자 홈 디렉토리 생성

mkdir -m 700 /home/newuser

 

root 홈 구조를 만드는 스크립트에서도 많이 쓰인다.

⑦ 웹/서비스용 정적 파일 경로 준비

mkdir -p /srv/www/assets/css

 

---

5. Shell 스크립트에서 가장 실무적인 mkdir 패턴

아래 스크립트는 매우 실무적이며 대부분의 초기화 스크립트에서 사용된다.

#!/bin/sh

LOGDIR="/var/log/myapp"
CONFDIR="/etc/myapp"
TMPDIR="/tmp/myapp"

[ ! -d "$LOGDIR" ] && mkdir -p "$LOGDIR"
[ ! -d "$CONFDIR" ] && mkdir -p "$CONFDIR"

mkdir -p "$TMPDIR"

echo "All directories prepared."

 

포인트:

• -d로 존재 여부 체크
• 존재하지 않을 때만 생성
• 로그·설정·캐시 경로 구분

---

6. C 언어에서 mkdir 사용하기(임베디드 개발 필수)

임베디드 개발자에게는 C 코드가 더 익숙할 수 있다.

#include <sys/stat.h>
#include <sys/types.h>
#include <stdio.h>

int main(void)
{
    const char *path = "/tmp/testdir";

    if (mkdir(path, 0755) == -1)
    {
        perror("mkdir error");
        return -1;
    }

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

 

핵심 포인트:

• 존재하면 -1 리턴
• errno로 정확한 문제 파악 가능
• 임베디드에서는 플래시/overlay 여부까지 고려해야 함

---

7. mkdir의 시스템콜 관점 이해하기

mkdir 동작은 단순히 “폴더 생성”이 아니라 파일 시스템에 다음을 요청하는 과정이다.

• inode 생성
• directory entry 추가
• parent 디렉토리의 metadata 갱신
• 퍼미션 적용
• 상위 디렉토리가 없으면 에러 처리
• SELinux 등 보안 인증 정책 확인

즉, mkdir는 파일 시스템의 본질적인 동작을 건드리는 매우 기본적인 시스템콜 기반 기능이다.

---

8. 자주 묻는 질문(FAQ)

Q1. mkdir -p는 항상 써도 되나요?

네. 스크립트나 자동화 환경에서는 mkdir -p 사용이 사실상 표준입니다.
이미 디렉토리가 존재해도 에러가 나지 않기 때문에 재실행·배포·부팅 스크립트에서 특히 안정적입니다.

Q2. 이미 존재하는 디렉토리에 mkdir를 실행하면 어떻게 되나요?

기본 mkdir는 에러를 출력하지만(File exists),

mkdir -p dirname

 

을 사용하면 에러 없이 그대로 진행됩니다.
이 때문에 대부분의 실무 스크립트가 -p 기반으로 작성됩니다.

Q3. 여러 개의 디렉토리를 한 번에 만들 수 있나요?

네. 공백으로 구분하여 여러 개를 동시에 생성할 수 있습니다.

mkdir "my folder"mkdir dir1 dir2 dir3

Q4. 디렉토리 이름에 공백이 있으면 어떻게 입력하나요?

따옴표로 감싸야 합니다.

mkdir "my folder"

쉘에서 공백은 구분자로 인식되기 때문에 반드시 따옴표가 필요합니다.

Q5. 퍼미션을 mkdir에서 바로 지정할 수 있나요?

가능합니다.

mkdir -m 755 dirname

단, umask 영향을 받으므로 환경에 따라 실제 생성 퍼미션이 달라질 수 있습니다.
정확한 관리가 필요하면 chmod로 후처리하는 것도 좋은 방법입니다.

---

9. mkdir는 단순 생성 명령이 아니라 시스템 구조의 기초

mkdir는 리눅스의 기반이 되는 파일 시스템을 다루는 가장 중요한 명령어 중 하나다.
특히 OpenWrt·임베디드·운영 스크립트 환경에서는 정확한 mkdir 사용 여부가 시스템 안정성을 좌우한다.

“디렉토리를 잘 만드는 것은 시스템을 안정적으로 만든다.”
— 리눅스 운영의 기본 철학 중 하나

 

 

이전글 보기

[Linux] Linux tree 명령어 완전 정복: 프로젝트 구조를 한눈에! 🌲

 

다음글 보기

[Linux] rmdir 명령어 가이드 – 안전하고 올바르게 폴더 삭제하는 방법 💡