[Shell] 서브 프로세스의 실행 종료를 대기하는 wait 커맨드

wait는 Bash·POSIX 셸 빌트인으로, 백그라운드로 실행한 서브프로세스(또는 job)의 종료를 대기할 때 사용한다. 특정 PID·job 번호만 기다리거나, 모든 백그라운드 자식 프로세스가 끝날 때까지 기다릴 수 있어, 병렬 작업 스크립트와 배치 자동화에서 필수적으로 쓰인다.

사용법

1

wait [-fn] [-p varname] [id ...]

• 인자 없음: 현재 셸이 알고 있는 모든 백그라운드 job·프로세스 치환(process substitution)이 종료될 때까지 대기한 뒤, 반환값 0을 돌려준다.
• id 있음: 각 id는 PID 또는 job 명세(jobspec) 이다. job 명세는 %1, %2, %+ 등 jobs로 보이는 형태다. 지정한 id들이 모두 종료될 때까지 대기하며, 마지막 id의 종료 상태가 wait의 반환값이 된다.

옵션

job control이 꺼져 있으면 wait와 kill은 job 명세를 받지 못하고 PID만 받을 수 있다.

동작 흐름 요약

아래 Mermaid는 “여러 백그라운드 작업을 띄운 뒤 wait로 모두 기다리는” 전형적인 흐름을 나타낸다.

flowchart LR
  subgraph scriptRun["스크립트 실행"]
    nodeA["스크립트 시작"] --> nodeB["a & b & c 백그라운드 실행"]
    nodeB --> nodeC["wait 호출"]
    nodeC --> nodeD["모든 자식 종료 대기"]
    nodeD --> nodeE["echo end 출력"]
    nodeE --> nodeF["스크립트 종료"]
  end

예시

1. 전체 백그라운드 작업 종료 대기

a, b, c를 백그라운드로 실행한 뒤, 셸은 wait에서 세 작업이 모두 끝날 때까지 대기한 다음 "end"를 출력한다.

1
2
3
4
5
6
7
8

#!/bin/bash

a &
b &
c &

wait
echo "end"

2. job 번호로 특정 job만 대기

jobs로 확인하는 백그라운드 job 번호(%1, %2 등)로 대기할 수 있다.

1
2
3
4
5

sleep 10 &
sleep 5 &
wait %2   # 두 번째 job(5초 sleep)만 기다림
echo "두 번째 작업만 완료됨"
wait      # 나머지 job도 모두 대기

3. PID로 특정 프로세스만 대기

$!로 마지막 백그라운드 프로세스의 PID를 저장한 뒤, 해당 PID만 기다린다.

1
2
3
4

long_running_task &
pid=$!
wait $pid
echo "long_running_task 종료, 종료 코드: $?"

4. 여러 PID를 순서대로 대기

여러 개의 id를 넘기면, 모두 종료될 때까지 대기하고, 마지막 id의 종료 상태가 반환된다.

1
2
3
4
5
6

job1 &
p1=$!
job2 &
p2=$!
wait $p1 $p2
echo "두 작업 모두 완료, 마지막 종료 코드: $?"

5. 첫 번째로 끝나는 작업만 대기 (Bash -n)

-n을 사용하면 id 중 하나라도 끝나면 즉시 반환한다. 먼저 끝난 작업의 종료 상태를 알 수 있다.

1
2
3
4
5

slow_task &
fast_task &
wait -n
echo "먼저 끝난 작업의 종료 코드: $?"
wait

6. -n과 -p로 “어떤 job이 끝났는지” 확인

-n과 -p를 함께 쓰면, 완료된 job/프로세스의 식별자가 변수에 들어간다.

1
2
3
4
5

task_a &
task_b &
wait -n -p done_id
echo "완료된 ID: $done_id, 종료 코드: $?"
wait

7. 병렬 다운로드 후 한꺼번에 대기

여러 파일을 동시에 받은 뒤, 모두 끝날 때까지 기다리는 패턴이다.

1
2
3
4

wget -q -O file1.zip "https://example.com/file1.zip" &
wget -q -O file2.zip "https://example.com/file2.zip" &
wait
echo "다운로드 모두 완료"

8. 종료 코드 검사

wait의 반환값은 마지막으로 대기한 id의 종료 상태이므로, 실패 여부를 판단할 수 있다.

1
2
3
4
5
6
7
8

failing_cmd &
pid=$!
wait $pid
exitcode=$?
if [ "$exitcode" -ne 0 ]; then
  echo "작업 실패, 종료 코드: $exitcode"
  exit "$exitcode"
fi

9. 시그널로 종료된 프로세스 대기

프로세스를 시그널로 종료한 뒤 wait로 정리하면, 반환값이 128보다 클 수 있다(시그널 번호 + 128 등). POSIX 동작은 구현에 따라 다를 수 있다.

1
2
3
4
5

sleep 1000 &
pid=$!
kill -TERM "$pid"
wait $pid
echo "종료 코드: $?"

10. 서브쉘에서의 주의점

( wait ) 또는 nohup wait ...처럼 서브쉘·별도 실행 환경에서 wait를 호출하면, 그 환경에는 “알고 있는” 자식이 없으므로 wait는 곧바로 반환한다. 대기하려면 현재 셸에서 wait를 실행해야 한다.

반환값 요약

참고 문헌

• GNU Bash Manual – Job Control Builtins (wait)
• man7.org – wait(1p)
• GNU Bash Manual – Job Control Basics