리눅스 명령어 · 2 min read · Dec 24, 2025
리눅스 manpath 명령어 튜토리얼 (초보자를 위한 5가지 예제)

리눅스의 매뉴얼 페이지는 명령줄 유틸리티에 대한 1차 지원을 받을 수 있는 장소입니다. 대부분의 여러분이 아시겠지만, ‘man [명령어 이름]’을 입력하면 해당 매뉴얼 페이지가 나타납니다. 하지만 이러한 매뉴얼 페이지가 검색되는 경로를 알고 계신가요?
이 튜토리얼에서는 이 정보를 보여주는 유틸리티인 manpath에 대해 논의할 것입니다. 설명을 시작하기 전에, 여기의 모든 예제가 Ubuntu 18.04 LTS 머신에서 테스트되었다는 점을 언급할 가치가 있습니다.
리눅스 manpath 튜토리얼
리눅스의 manpath 명령어는 매뉴얼 페이지의 검색 경로를 결정하는 데 도움을 줍니다. 다음은 그 구문입니다:
manpath [-qgdc?V] [-m system[,...]] [-C file]그리고 도구의 매뉴얼 페이지는 다음과 같이 설명합니다:
만약 $MANPATH가 설정되어 있다면, manpath는 단순히 그 내용을 표시하고 경고를 발행합니다. 만약 그렇지 않다면, manpath는 적절한 매뉴얼 페이지 계층 검색 경로를 결정하고 결과를 표시합니다.
콜론으로 구분된 경로는 man-db 구성 파일 - (/etc/manpath.config) 및 사용자의 환경에서 얻은 정보를 사용하여 결정됩니다.다음은 manpath 명령어가 어떻게 작동하는지에 대한 좋은 아이디어를 제공할 Q&A 스타일의 예제입니다.
Q1. manpath 명령어는 어떻게 작동하나요?
기본 사용법은 매우 간단합니다 - 옵션 없이 ‘manpath’를 실행하기만 하면 됩니다.
manpath예를 들어, 위 명령어가 내 시스템에서 생성한 출력은 다음과 같습니다:
/usr/local/man:/usr/local/share/man:/usr/share/man따라서 manpath는 매뉴얼 페이지에 대한 경로의 콜론으로 구분된 목록을 생성합니다.
man-db 구성 파일 내에서 ‘global’로 명명된 모든 경로로 구성된 manpath를 생성하려면 -g 명령줄 옵션을 사용할 수 있습니다.
Q2. manpath 대신 catpath를 출력하려면 어떻게 하나요?
이를 위해 -c 명령줄 옵션을 사용합니다.
manpath -c도구의 매뉴얼 페이지는 이 작업을 다음과 같이 설명합니다:
manpath가 결정되면, 각 경로 요소는 해당 상대 catpath로 변환됩니다.예를 들어, 내 시스템에서 생성된 출력은 다음과 같습니다:
/var/cache/man/oldlocal:/var/cache/man/local:/var/cache/manQ3. manpath가 디버깅 정보를 출력하도록 하려면 어떻게 하나요?
이를 위해 -d 명령줄 옵션을 사용합니다.
manpath -d예를 들어, 이 명령어가 내 시스템에서 생성한 출력은 다음과 같습니다:

동의합니다, 이 옵션을 자주 사용하지 않을 수도 있지만, 도구의 출력을 디버깅해야 할 경우에는 적어도 알고 있어야 합니다.
Q4. manpath가 다른 OS의 매뉴얼 계층에 접근하도록 하려면 어떻게 하나요?
이를 위해 -m 명령줄 옵션을 사용합니다. 도구의 매뉴얼 페이지는 이 옵션을 다음과 같이 설명합니다:
-m system[,...], --systems=system[,...]
만약 이 시스템이 다른 운영 체제의 매뉴얼 계층에 접근할 수 있다면, 이 옵션을 사용하여 manpath의 출력에 포함할 수 있습니다. NewOS의 매뉴얼 페이지 계층을 포함하려면 -m NewOS 옵션을 사용하십시오.
지정된 시스템은 콤마로 구분된 운영 체제 이름의 조합일 수 있습니다.
네이티브 운영 체제의 매뉴얼 페이지 계층을 포함하려면, 시스템 이름 man이 인수 문자열에 포함되어야 합니다. 이 옵션은 $SYSTEM 환경 변수를 무시합니다.Q5. manpath가 사용자 정의 구성 파일을 사용하도록 하려면 어떻게 하나요?
기본적으로 manpath는 다음 파일에서 정보를 가져옵니다:
/etc/manpath.config그러나 원하신다면 manpath가 다른 파일을 읽도록 강제할 수 있습니다. 이는 -C 명령줄 옵션을 사용하여 수행할 수 있습니다.
manpath -C NEWFILE-PATH결론
리눅스 명령줄 작업이 매뉴얼 페이지를 다루는 것이라면, manpath 명령어는 유용한 도구입니다. 이 튜토리얼에서는 manpath 명령줄 옵션의 대부분에 대해 논의했습니다. 도구에 대한 더 많은 정보는 해당 매뉴얼 페이지를 참조하십시오.
새 게시물을 받은 편지함에서 받기
스팸은 없습니다. 언제든지 구독 해지 가능합니다.