이 름
manpath - /etc/manpath.config 파 일 형 식
설 명
맨 페 이 지 경 로 구 성 파 일 은 설 명 서 페 이 지 유 틸 리 티 에 서 실 행 시 간 동 안 사 용 자 의 맨 페 이 지 경 로 에 접 근 할 때 사 용 하 며 , 어 떤 설 명 서 페 이 지 계 층 (맨 페 이 지 경 로 )을 시 스 템 계 층 으 로 다 루 는 지 , 캣 페 이 지 파 일 을 저 장 할 때 어 떤 디 렉 터 리 를 할 당 할 지 를 나 타 냅 니 다 .
$MANPATH 환 경 변 수 를 이 미 설 정 했 다 면 , /etc/manpath.config에 있 는 정 보 는 이 변 수 값 을 무 시 하 지 않 습 니 다 .
검 색 경 로
기 본 적 으 로 man-db는 사 용 자 $PATH 변 수 를 확 인 합 니 다 . 경 로 요 소 제 각 각 을 찾 아 낸 다 음 , 검 색 경 로 에 멘 _페 이 지 _경 로 요 소 를 추 가 합 니 다 .
설 정 파 일 에 주 어 진 경 로 _요 소 의 MANPATH_MAP 행 이 없 다 면 , 디 렉 터 리 로 존 재 하 는 모 든 경 로 _요 소 /../man, 경 로 _요 소 /man, 경 로 _요 소 /../share/man, 경 로 _요 소 /share/man 항 목 을 검 색 경 로 에 추 가 합 니 다 .
그 다 음 설 정 파 일 의 MANDATORY_MANPATH 항 목 을 검 색 경 로 에 추 가 합 니 다 .
마 지 막 으 로 --systems 옵 션 을 사 용 했 거 나 $SYSTEM 환 경 변 수 를 설 정 했 다 면 , 쉼 표 또 는 콜 론 으 로 순 차 구 분 한 운 영 체 제 이 름 이 들 어 가 야 합 니 다 . 이 동 작 은 다 른 운 영 체 제 설 명 서 페 이 지 에 접 근 할 수 있 게 1회 이 상 검 색 경 로 를 확 장 하 는 양 식 으 로 활 용 합 니 다 : 각 시 스 템 이 름 에 대 해 man-db는 검 색 경 로 상 에 서 해 당 이 름 이 들 어 간 하 위 디 렉 터 리 를 검 색 하 고 , 최 종 검 색 경 로 가 있 다 면 추 가 합 니 다 . man의 시 스 템 이 름 을 하 위 디 렉 터 리 를 넣 지 않 고 일 반 검 색 경 로 에 추 가 합 니 다 . 예 를 들 면 검 색 경 로 에 /usr/share/man:/usr/local/man 경 로 가 들 어 갔 고 , $SYSTEM 환 경 변 수 에 newOS:man 값 이 들 어 갔 다 면 , 최 종 검 색 경 로 설 정 값 은 /usr/share/man/newOS:/usr/share/man:/usr/local/man/newOS:/usr/local/man 값 이 됩 니 다 .
$MANPATH 환 경 변 수 값 은 man-db 기 본 설 명 서 페 이 지 검 색 경 로 값 보 다 우 선 합 니 다 . 대 부 분 사 용 자 는 설 정 할 필 요 가 없 습 니 다 . 문 법 은 $PATH 환 경 변 수 와 유 사 합 니 다 . 순 서 대 로 적 은 디 렉 터 리 이 름 을 콜 론 으 로 구 분 합 니 다 . 위 에 서 설 명 한 기 본 검 색 경 로 값 보 다 우 선 합 니 다 .
$MANPATH 값 이 콜 론 으 로 시 작 하 면 , 기 본 검 색 경 로 를 시 작 부 분 에 추 가 합 니 다 . $MANPATH 값 이 콜 론 으 로 끝 나 면 기 본 검 색 경 로 를 끝 에 추 가 합 니 다 . $MANPATH에 이 중 콜 론 (::)이 들 어 있 다 면 , 기 본 검 색 경 로 는 콜 론 사 이 에 값 중 간 에 들 어 갑 니 다 .
형 식
현 재 다 음 필 드 형 식 을 인 식 합 니 다 :
|
# 주 석 |
빈 줄 이 나 # 문 자 로 시 작 하 는 행 은 주 석 으 로 취 급 하 며 무 시 합 니 다 . |
MANDATORY_MANPATH 맨 _페 이 지 _경 로 요 소
이 러 한 모 양 새 를 가 진 행 은 매 번 자 동 으 로 만 드 는 $MANPATH 환 경 변 수 에 들 어 있 는 맨 페 이 지 경 로 를 나 타 냅 니 다 . 보 통 /usr/man이 들 어 갑 니 다 .
MANPATH_MAP 경 로 _요 소 맨 _페 이 지 _경 로 요 소
이 러 한 모 양 새 를 가 진 행 은 $PATH 값 을 $MANPATH에 대 응 하 도 록 구 성 합 니 다 . 각 경 로 _요 소 는 사 용 자 의 $PATH 환 경 변 수 에 있 으 며 , 맨 _페 이 지 _경 로 요 소 는 $MANPATH 환 경 변 수 에 추 가 합 니 다 .
MANDB_MAP 맨 _페 이 지 _경 로 요 소 [ 캣 _페 이 지 _경 로 요 소 ]
이 러 한 모 양 새 를 가 진 행 은 어 떤 맨 페 이 지 경 로 를 시 스 템 맨 페 이 지 경 로 로 취 급 하 는 지 이 경 로 에 들 어 간 캣 페 이 지 파 일 을 어 디 에 저 장 해 야 하 는 지 를 나 타 냅 니 다 . 이 필 드 형 식 은 man이 setuid 프 로 그 램 일 경 우 (사 용 자 별 .manpath 구 성 파 일 이 아 닌 /etc/manpath.config 시 스 템 구 성 파 일 일 경 우 ) 어 떤 설 명 서 페 이 지 계 층 에 setuid 사 용 자 가 접 근 하 고 어 떤 사 용 자 가 실 행 사 용 자 로 접 근 하 는 지 를 나 타 낼 때 와 같 이 일 부 중 요 한 면 이 있 습 니 다 .
시 스 템 설 명 서 페 이 지 계 층 은 /usr/man, /usr/local/man, /usr/X11R6/man과 같 이 보 통 /usr 하 위 계 층 에 저 장 합 니 다 .
맨 _페 이 지 _경 로 요 소 일 부 의 캣 페 이 지 를 저 장 하 지 않 거 나 원 래 사 용 하 던 위 치 로 저 장 한 다 면 캣 _페 이 지 _경 로 요 소 를 생 략 할 수 도 있 습 니 다 .
원 래 캣 페 이 지 위 치 로 의 복 사 는 설 명 서 페 이 지 계 층 을 읽 기 전 용 으 로 마 운 트 하 는 문 제 로 불 가 능 한 데 , 설 명 서 페 이 지 저 장 소 의 적 절 한 디 렉 터 리 계 층 지 정 이 가 능 하 기 때 문 입 니 다 . Linux FSSTND를 확 인 해 보 려 면 검 색 어 FSSTND를 실 제 디 렉 터 리 위 치 에 서 활 용 해 볼 수 있 습 니 다 .
불 행 하 게 도 , /usr/man/sun과 같 은 대 체 운 영 체 제 경 로 와 같 이 모 든 시 스 템 의 man 트 리 경 로 를 지 정 해 야 하 며 , 심 지 어 는 /usr/man/de_DE.88591와 같 은 NLS 로 캘 경 로 도 지 정 해 야 합 니 다 .
앞 서 기 록 한 방 식 대 로 행 별 로 정 보 를 분 석 하 고 나 면 , 우 선 목 록 에 나 타 내 야 하 는 다 른 계 층 의 하 위 계 층 맨 페 이 지 경 로 에 필 요 하 며 , 그 렇 지 않 으 면 부 정 확 한 일 치 내 용 을 만 들 어 냅 니 다 . 예 제 에 서 는 /usr/man/de_DE.88591이 /usr/man보 다 앞 에 와 야 함 을 보 여 줍 니 다 .
DEFINE 키 값
이 러 한 모 양 새 를 가 진 행 은 기 타 설 정 변 수 를 지 정 합 니 다 . 설 명 서 페 이 저 유 틸 리 티 에 서 사 용 하 는 변 수 의 기 본 설 정 파 일 을 참 고 하 십 시 오 . 다 양 한 프 로 그 램 (grep과 tbl 등 )의 기 본 경 로 가 들 어 가 며 , 인 자 기 본 설 정 이 이 프 로 그 램 에 들 어 갑 니 다 .
SECTION 섹 션 ...
이 러 한 모 양 새 를 가 진 행 은 검 색 해 야 할 설 명 서 의 섹 션 순 서 를 지 정 합 니 다 . 설 정 파 일 에 SECTION 지 시 자 가 없 으 면 기 본 동 작 은 :
SECTION 1 n l 8 3 0 2 3type 5 4 9 6 7
다 중 SECTION 지 시 자 를 지 정 했 다 면 , 섹 션 목 록 을 합 칩 니 다 .
각 확 장 이 이 목 록 (1mh라 합 니 다 )에 없 으 면 목 록 에 속 한 섹 션 의 나 머 지 를 나 타 냅 니 다 . 이 결 과 에 대 해 제 각 각 의 순 서 를 강 제 하 고 싶 다 면 확 장 자 목 록 을 분 명 하 게 지 정 하 는 것 뿐 입 니 다 . 확 장 자 가 붙 은 섹 션 은 주 섹 션 에 인 접 해 야 합 니 다 (예 : "1 1mh 8 ...").
SECTIONS는 이 지 시 자 의 대 체 이 름 으 로 수 용 합 니 다 .
MINCATWIDTH 너 비
터 미 널 너 비 가 너 비 값 보 다 작 으 면 , (없 을 경 우 ) 캣 페 이 지 를 만 들 지 않 거 나 표 시 하 지 않 습 니 다 . 기 본 값 은 80입 니 다 .
MAXCATWIDTH 너 비
터 미 널 너 비 가 너 비 값 보 다 크 면 , (없 을 경 우 ) 캣 페 이 지 를 만 들 지 않 거 나 표 시 하 지 않 습 니 다 . 기 본 값 은 80입 니 다 .
CATWIDTH 너 비
너 비 값 이 0이 아 니 면 , 터 미 널 의 폭 이 실 제 로 어 느 정 도 인 지 여 부 와 는 관 계 없 이 항 상 주 어 진 터 미 널 너 비 값 으 로 캣 페 이 지 를 서 식 화 처 리 합 니 다 . 이 값 은 MINCATWIDTH값 과 MAXCATWIDTH값 에 우 선 합 니 다 .
NOCACHE
이 플 래 그 는 man(1) 이 캣 페 이 지 를 자 동 으 로 만 드 는 동 작 을 막 아 줍 니 다 .
버 그
위 규 칙 을 제 대 로 따 라 가 지 않 으 면 , 설 명 서 페 이 저 유 틸 리 티 는 원 하 는 대 로 동 작 하 지 않 습 니 다 . 규 칙 은 전 반 적 으 로 복 잡 합 니 다 .
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db