Mac 터미널에서 man과 apropos로 도움말 찾기
macOS의 man과 apropos(man -k)로 설치된 명령 설명서를 찾고 셸 내장 명령과 외부 프로그램을 구분합니다.
발행·오류 제보: infostoa · 편집 기준
이 글의 개별 작성자와 전문 검토자 정보는 제공되지 않습니다.
터미널에서 명령의 사용법을 확인할 때는 Mac에 설치된 매뉴얼 페이지를 확인할 수 있습니다. man 명령어는 이름에 대응하는 설명 페이지를 엽니다. 읽을 수 있는 내용은 해당 컴퓨터에 설치된 문서와 도구 버전에 한정되므로 모든 명령이나 최신 릴리스를 보장하지 않습니다. Apple의 명령줄 입문서는 명령줄 환경을 이해하는 공식 출발점입니다.
개념 삽화이며 실제 macOS 화면이나 명령 실행 결과가 아닙니다.
이름을 알고 있다면 man으로 열기
예를 들어 man ls를 입력하면 ls라는 이름의 매뉴얼 페이지를 요청합니다. 화면에 문서가 열리지 않으면 해당 페이지가 설치되지 않았거나 현재 검색 경로에서 찾을 수 없는 경우일 수 있습니다. 페이지 제목과 첫 설명이 찾는 프로그램과 일치하는지 먼저 확인하고, 예시에 나온 옵션은 실행 전에 의미와 영향을 읽으세요. 이 방법은 이름을 이미 아는 명령의 설명을 찾을 때 가장 간단합니다.
페이지의 버전과 적용 범위 확인
키워드로 페이지를 찾을 때는 man -k socket처럼 사용할 수 있습니다. Apple 배포판의 man(1)은 -k를 apropos와 같은 방식으로 안내하며, 문서에는 특정 키워드를 인수로 받는 형식이 적혀 있습니다. 결과는 설치된 매뉴얼 집합에 좌우되므로 내부 색인 방식이나 결과의 완전성을 추정하지 마세요. 특정 페이지의 파일 위치가 궁금하면 man -w ls처럼 확인할 수 있습니다. -w는 페이지 내용을 여는 대신 위치를 표시합니다. 로컬 문서는 인터넷이 없어도 참고할 수 있지만, 설치된 시스템 또는 패키지와 함께 제공된 버전을 반영합니다. 같은 이름의 명령이라도 macOS 기본 도구와 별도로 설치한 프로그램이 다를 수 있으므로, 페이지 제목과 설명이 현재 실행하려는 도구에 맞는지 비교하세요. 문서가 없거나 오래된 듯하면 개발사나 배포자의 공식 온라인 자료를 추가로 확인합니다. 매뉴얼에 항목이 없다는 사실만으로 기능이 존재하지 않는다고 단정할 수는 없습니다.
Terminal 앱과 명령의 동작을 구분
Apple Support의 Mac용 Terminal 사용자 안내는 Terminal을 명령줄과 상호작용하는 앱으로 설명합니다. 따라서 Terminal의 버전만 확인하는 것으로 명령의 동작을 모두 설명할 수는 없습니다. 실제 셸과 실행 파일, 설치된 설명 문서를 함께 확인해야 다른 Mac이나 온라인 절차와 결과를 비교할 수 있습니다. 명령이 파일이나 시스템 설정을 변경한다면 실행 전 대상 경로와 되돌리는 방법도 확인하세요.
전문가 관점 — 로컬 매뉴얼은 시작점.
Apple의 Terminal 안내와 명령줄 입문서는 앱과 명령줄 환경을 구분해 소개합니다. 이 관점에서 로컬 매뉴얼은 현재 설치본을 파악하는 첫 참고 자료이며, 온라인 지침을 재현할 때는 도구의 출처와 버전까지 일치시키는 것이 중요합니다. 키워드 검색의 내부 색인 방식이나 결과의 완전성은 주장하지 않으며, Apple 문서에 적힌 옵션의 범위만 설명합니다.