macOS에서 stat -c가 illegal option 오류를 낼 때: 같은 서식 글자가 다른 값을 내는 경우까지 직접 시험한 결과
리눅스식 stat -c 스크립트를 macOS에서 돌려 오류를 만났거나 오류 없이 값이 이상한 독자가 원인을 가려내고 양쪽에서 같은 값을 내는 형태로 바꾸게 돕는다.
이 맥의 stat 에는 -c 가 없고 -f 서식을 쓴다. 그러나 %z, %m, %n, %Y, %a 는 두 stat 에서 뜻이 달라 오류 없이 다른 값이 나오고, GNU stat 에 맥 문법을 주면 종료 코드 1과 함께 파일시스템 정보 5줄이 표준 출력으로 나와 변수에 담긴다.
스크립트에서 stat -c 와 stat -f 를 쓰는 곳을 찾아 GNU 문법을 먼저 시험하는 함수로 바꾸고, 맥과 리눅스에서 같은 파일의 크기·수정 시각·권한이 같은지 비교한다.
목차
한 줄 요약: 이 맥(26.6.2)의 stat 에는 -c 가 없어 -f 서식으로 바꾸되, 같은 글자가 두 stat 에서 뜻이 달라 오류 없이 값이 어긋나므로 GNU 문법을 먼저 시험하는 함수로 감싼다.
리눅스에서 쓰던 stat -c %s 파일 을 맥 터미널에 붙였더니 아래처럼 실패한다. 이 글은 무엇으로 바꾸면 되는지, 그리고 바꾼 뒤 종료 코드 0 으로 끝나는데 값이 어긋나는 경우와 GNU stat 에 맥 문법을 줬을 때 변수에 쓰레기가 담기는 경우를 이 맥에서 직접 만들어 보인다.
/usr/bin/stat: illegal option -- c
usage: stat [-FLnq] [-f format | -l | -r | -s | -x] [-t timefmt] [file ...]같은 오류는 2018년 Jenkins 이슈 JENKINS-48783 에 macOS 10.13.2 에서 스크립트 로그 줄 ++ stat -c %a **** 와 함께 그대로 남아 있다. PATH 로 실행하면 앞부분이 /usr/bin/stat: 대신 stat: 으로 찍힌다. 확인한 환경은 macOS 26.6.2 arm64 의 /usr/bin/stat(file_cmds-479, BSD 계열), Homebrew 의 GNU gstat 9.11(coreutils), bash 3.2.57, 시간대 Asia/Seoul(KST)이다. GNU 쪽은 리눅스가 아니라 이 맥에 설치한 gstat 으로 시험했다.
용어 몇 개. stat 은 파일의 크기·권한·시각을 보여 주는 명령이다. 서식 글자는 %s 처럼 어떤 값을 찍을지 고르는 기호다. 에포크 초는 1970-01-01 00:00 UTC 부터 센 초이고, 종료 코드는 0이 정상, 그 밖은 실패다.
표준 출력은 명령의 결과가 나가는 통로다. 표준 오류는 오류 메시지가 나가는 별도의 통로이고, $(...) 는 표준 출력만 변수에 담는다. 이 구분이 아래 세 번째 절의 핵심이다.
이 맥의 stat 에는 -c 가 없고 -f 서식이 있다
/usr/bin/stat 에 -c %s, -c '%a %n', --format=%s 를 주면 각각 illegal option -- c 또는 illegal option -- - 와 usage 줄이 나오고 종료 코드는 1이다. 맥의 stat 은 서식을 -f 로 받는다. 이 맥의 man stat 서식 절은 %n 이 줄바꿈이고 z 가 파일 크기(바이트), a m c B 가 접근·수정·상태 변경·생성 시각, N 이 파일 이름, Y 가 심볼릭 링크 대상 문자열이라고 적는다.
6바이트 파일 a.txt(권한 640, 수정 시각 2026-01-02 15:30:45 KST)로 같은 값을 뽑는 형태를 나란히 놓으면 이렇다.
| 알고 싶은 값 | GNU(gstat) |
이 맥의 /usr/bin/stat |
결과 |
|---|---|---|---|
| 크기(바이트) | -c %s |
-f %z |
둘 다 6 |
| 이름 | -c %n |
-f %N |
둘 다 a.txt |
| 권한(8진수) | -c %a |
-f %p 의 끝 4자리 |
640 / 100640 |
| 수정 시각(에포크 초) | -c %Y |
-f %m |
둘 다 1767335445 |
| 수정 시각(글자) | -f %Sm -t '%Y-%m-%d %H:%M:%S' |
2026-01-02 15:30:45 |
권한 줄에는 함정이 둘 더 있다. %p 는 파일 종류 비트까지 붙은 8진수(640 파일이 100640)라 끝 4자리가 권한이다. 이 자리를 %Lp 로 읽으면 안 된다. 권한을 4755(setuid), 2755(setgid)로 두거나 스티키 디렉터리를 1777 로 만들고 읽으니 맥 %Lp 는 755, 755, 777 이었고 GNU -c %a 는 4755, 2755, 1777 이었다. 특수 비트가 빠진 것이다. %Mp%Lp 로 이어 붙이면 이 셋은 맞지만 모드 4005, 4044, 1000, 2070 에서 45, 444, 10, 270 이 나와 GNU 의 4005, 4044, 1000, 2070 과 달랐다. 앞자리 0 이 줄어들기 때문이다. 아래 함수는 %p 의 끝 4자리를 8진수 숫자로 바꿔 쓴다.
심볼릭 링크는 따로 봐야 한다. link 가 a.txt 를 가리킬 때 stat -f %z link 와 gstat -c %s link 는 링크 자체의 크기 5를 냈고, 둘 다 -L 을 붙여야 대상 파일의 6이 나왔다.
같은 글자인데 뜻이 달라 오류 없이 다른 값이 나온다
표의 글자만 바꿔 끼우면 될 것 같지만, 같은 글자가 두 stat 에서 다른 것을 가리킨다. 같은 파일에 같은 글자를 주고 비교했다.
| 글자 | 이 맥의 -f |
GNU 의 -c |
|---|---|---|
%z |
6 (크기) | 시각 문자열(상태 변경 시각) |
%m |
1767335445 (수정 시각) | / (마운트 지점) |
%n |
빈 출력 (줄바꿈) | a.txt (파일 이름) |
%Y |
빈 출력 (링크가 아닌 파일) | 1767335445 (수정 시각) |
%a |
1767335445 (접근 시각) | 640 (권한) |
여기까지 모두 종료 코드 0이다. %a 값이 수정 시각과 같은 것은 touch -t 가 접근·수정 시각을 함께 맞췄기 때문이다. touch -a 로 접근 시각만 2020-01-01 로 바꾼 파일에서는 맥 %a 가 1577804400, %m 이 그대로 1767335445 였고 GNU 는 %X 가 1577804400, %Y 가 1767335445 였다. 맥 %n 의 “빈 출력”은 줄바꿈 한 글자(\n)이고, $(...) 에 담으면 길이 0 이 된다. 리눅스에서 stat -c %a 로 권한을 읽던 코드의 -c 를 -f 로만 바꾸면 맥에서는 오류 없이 에포크 초가 나온다. 반대로 맥 쪽 %s, %U, %G 는 bad format 과 종료 코드 1이어서 이쪽은 소리가 난다.
GNU stat 에 맥 문법을 주면 변수에 쓰레기가 담긴다
방향을 뒤집어 맥에서 쓰던 -f %z 를 GNU stat 에 주면 어떻게 될까. GNU 의 -f 는 파일이 아니라 파일시스템 정보를 보는 옵션이다.
$ gstat -f %z a.txt
gstat: cannot read file system information for '%z': No such file or directory
File: "a.txt"
ID: 10000110000001a Namelen: ? Type: apfs
Block size: 4096 Fundamental block size: 4096
Blocks: Total: 120699413 Free: 33468270 Available: 33468270
Inodes: Total: 1342626181 Free: 1338730800종료 코드는 1이다. 오류는 표준 오류로 나가고 아래 5줄은 표준 출력으로 나온다. 그래서 size=$(gstat -f %z a.txt 2>/dev/null) 처럼 오류를 버려도 size 에 5줄이 담겼고 첫 줄은 File: "a.txt" 였다(숫자는 실행마다 달랐다).
이게 폴백 순서와 만나면 조용히 사고가 난다. stat -f %z 파일 2>/dev/null || stat -c %s 파일 을 GNU stat 환경에서 돌리면 앞 명령이 실패하며 5줄을 이미 내보낸 뒤 뒤 명령이 6을 내서, 종료 코드 0, 6줄(앞 5줄 쓰레기와 6)이 나왔다. 순서를 뒤집은 stat -c %s 파일 2>/dev/null || stat -f %z 파일 은 맥 stat 과 GNU stat 모두 한 줄 6과 종료 코드 0이었다. 이 시험의 두 환경은 PATH 앞에 /usr/bin/stat 또는 gstat 을 stat 이름으로 건 심볼릭 링크를 두어 만들었다.
이 글의 해석으로는 Homebrew coreutils 의 gnubin 디렉터리를 PATH 앞에 둔 맥이 바로 이 상황이다. stat 이 GNU 판이 되어 맥 문법으로 쓴 스크립트가 위처럼 쓰레기를 만들 것이다. 실제 gnubin 은 쓰지 않았고 심볼릭 링크로 흉내만 냈다.
두 쪽에서 모두 도는 함수
GNU 문법을 먼저 파일에 직접 시험하고, 되면 그걸 쓰고, 안 되면 맥 문법을 쓰면 된다. 시험은 표준 출력과 표준 오류를 모두 버리므로 맥의 오류도 GNU 의 쓰레기도 변수로 새지 않는다. 처음 만든 함수는 구멍 셋이 나왔다. 없는 파일을 주면 GNU 쪽이 -f 가지로 떨어져 cannot read file system information for '%z' 라는 엉뚱한 오류를 냈고, 이름이 -n.txt 인 파일은 맥 stat 이 옵션으로 읽어 illegal option 으로 실패했다. 셋째는 위의 권한 서식이었다. 존재 확인, --, %p 정규화를 넣어 고친 최종 함수다.
stat_field() { # stat_field 크기|수정|권한 파일
local what=$1 f=$2 gnu bsd v
case $what in
크기) gnu='%s' bsd='%z' ;;
수정) gnu='%Y' bsd='%m' ;;
권한) gnu='%a' bsd='%p' ;;
*) echo "stat_field: 모르는 항목 $what" >&2; return 2 ;;
esac
[ -e "$f" ] || [ -L "$f" ] || { echo "stat_field: $f 없음" >&2; return 1; }
if stat -c "$gnu" -- "$f" >/dev/null 2>&1; then
stat -c "$gnu" -- "$f"
else
v=$(stat -f "$bsd" -- "$f") || return
# 맥 %p 는 파일 종류 비트까지 낸다(100640). 끝 4자리(특수 비트+권한)만 8진수로 정규화해 GNU %a 와 맞춘다.
[ "$what" = 권한 ] && v=$(printf '%o' "$((8#${v: -4}))")
echo "$v"
fi
}이 함수를 맥 stat 과 GNU stat 에 각각 돌리면 크기 6, 수정 1767335445, 권한 640 이 같았고, setuid 파일 4755, setgid 파일 2755, 스티키 디렉터리 1777 도 두 쪽이 같았다. 권한은 파일 모드 0000 부터 7777 까지 4096개를 모두 바꿔 가며 비교했고 맥 쪽 함수, GNU 쪽 함수, gstat -c %a 가 전부 같았다(불일치 0). 없는 파일은 두 쪽 모두 stat_field: nofile 없음 과 종료 코드 1이었고, 이름이 -n.txt 인 1바이트 파일은 두 쪽 모두 1과 종료 코드 0이었다. 시험 출력은 두 번 실행해 같았다.
크기만 필요하면 wc -c < 파일 도 있다. 다만 맥에서는 6 처럼 앞에 공백이 붙어, 따옴표 없이 쓴 [ $(wc -c < a.txt) = 6 ] 은 같다고 나오지만 따옴표를 친 비교는 다르다고 나왔다. gwc -c 는 6 이었다.
시험하지 못한 것
리눅스에서 도는 GNU stat 과 다른 coreutils 버전, BusyBox stat, zsh 내장 zstat, 다른 macOS 버전, APFS 가 아닌 파일시스템, 읽기 권한이 없는 디렉터리 안의 파일은 확인하지 않았고 gstat 9.11 이 GNU 쪽을 대신했다. 서식 글자 표는 다섯 개만 실었고 %c 같은 나머지 글자는 넣지 않았다.
세 줄 요약
- 이 맥의 stat 에는 -c 가 없으므로 크기는 -f %z, 수정 시각은 -f %m, 권한은 -f %p 의 끝 4자리로 바꾼다.
- %z, %m, %n, %Y, %a 는 두 stat 에서 뜻이 달라 종료 코드 0으로 다른 값이 나오고, 이 맥의 gstat 9.11 은 -f 를 받으면 파일시스템 정보 5줄을 표준 출력으로 낸다.
- GNU 문법을 먼저 시험하고 존재 확인과 – 를 넣은 함수로 감싸 두 stat 에서 같은 값이 나오는지 비교한다.