manpath - 매뉴얼 페이지 탐색 경로 확인 및 설정

manpath - Manual Page Path

사용자가 man 명령어를 입력했을 때, 시스템이 매뉴얼 파일을 검색할 디렉터리 경로를 출력하는 명령어이다. 주로 시스템 관리자나 사용자가 특정 소프트웨어의 매뉴얼이 정상적으로 등록되었는지 확인하거나, 환경 변수를 설정할 때 사용된다.

1. 명령어 용도

• 특정 사용자의 환경 설정에서 man 명령어가 참고하는 경로가 올바른지 검증할 때 사용된다.
• 새로운 소프트웨어를 설치한 후 해당 프로그램의 매뉴얼 디렉터리가 시스템 검색 경로에 포함되어 있는지 확인할 때 유용하다.

# 현재 시스템의 manpath를 확인하는 일반적인 상황
$ manpath
/usr/local/man:/usr/local/share/man:/usr/share/man

2. 명령어 서식

manpath [-qgdwV] [-m 시스템] [-C 파일]

3. 명령어 옵션

옵션	설명	사용가능 OS 및 쉘
-d, --debug	디버깅 정보를 출력한다.
-q, --quiet	경고 메시지를 출력하지 않는다.
-g, --global	시스템 전역(global) 매뉴얼 경로를 생성하여 출력한다.
-w, --where	manpath를 출력하는 대신, 경로 리스트를 컴포넌트 단위로 나열한다.
-m, --systems	다른 운영체제의 매뉴얼 경로를 지정하여 확인한다.
-C, --config-file	기본 설정 파일 대신 사용할 구성 파일을 지정한다.
-V, --version	버전 정보를 출력한다.

# 디버깅 모드로 경로 탐색 과정을 상세히 확인하는 예시
$ manpath -d
# 사용 중인 설정 파일 위치 및 경로 추가 프로세스가 표준 오류(stderr)로 상세히 출력되다.

# 전역 매뉴얼 경로만 깔끔하게 확인하는 예시
$ manpath -g
# /usr/man:/usr/share/man:/usr/local/man

4. 명령어 특이사항(유의사항)

• manpath 명령어의 출력 결과는 사용자의 환경 변수 MANPATH가 설정되어 있을 경우 해당 변수 값을 최우선으로 반영한다.
• 환경 변수가 비어 있다면 /etc/manpath.config (또는 시스템에 따라 /etc/man_db.conf) 설정 파일을 기반으로 경로를 자동 계산하게 된다. [Debian] [Ubuntu]