mandb - 설명서 페이지 색인
캐시를 만들거나
업데이트합니다
mandb [
-dqsucpt?V] [
-C 파일]
[
맨_페이지_경로]
mandb [
-dqsut] [
-C 파일]
-f
파일이름 ...
mandb는
색인
데이터베이스 캐시를
초기화하거나 직접
업데이트할 때
사용합니다. 캐시에는
설명서 페이지
시스템의 현재 상태
관련 정보가
들어있으며, 여기에
저장한 정보는 man-db
유틸리티에서 속도와
기능을 개선하는데
활용합니다.
색인을 만들거나
업데이트할 때,
mandb는 ROFF
.so 요청의 문제, 어떤
설명서 페이지 파일
이름이 잘못되었는지,
어떤 설명서 페이지가
whatis 행을 해석할 수
없는지 경고할 수
있습니다.
추가 콜론 구분 경로로
mandb를 제공하면 내부
시스템 설명서 페이지
계층 검색 경로보다
우선할 수 있으며, man-db
설정 파일에서 찾을 수
있는 정보로
결정합니다.
mandb는 다음
데이터베이스 형식 중
하나를 지원하도록
컴파일할 수 있습니다.
| 이름 |
비동기 |
파일 이름 |
|
| 버클리 DB |
예 |
index.bt |
| GNU GDBM |
예 |
index.db |
| 유닉스 NDBM |
아니요 |
index.(dir|pag) |
이 데이터베이스
형식은 비정상 종료
상황에서 가능한
손상을 개선된 속도로
감당하기 위해 비동기
업데이트를
지원합니다. 이런 일이
일어났을 경우
mandb에
-c 옵션을 추가하여
바닥부터
데이터베이스를 다시
만드는 과정의 실행이
필요합니다.
-
-d, --debug
- 디버깅 정보를
출력합니다.
-
-q, --quiet
- 경고 메시지를
표시하지 않습니다.
-
-s, --no-straycats
- 위치가 잘못된 cat
페이지를 찾거나
데이터에 정보를
추가하는데 시간을
소요하지 않습니다.
-
-p, --no-purge
- 데이터베이스에서
설명서 페이지를
삭제하거나
소거하는동안 소요
시간 검사를 하지
않습니다.
-
-c, --create
- 기본적으로
mandb는 앞서 만든
데이터베이스
업데이트를
시도합니다.
데이터베이스가
없다면 만듭니다. 이
옵션은 mandb로 하여금
이전 데이터베이스를
삭제하고 바닥부터
다시 만드는 동작을
강제하며 --no-purge
옵션을 암묵적으로
실행합니다.
데이터베이스가
깨졌거나 새
데이터베이스 저장소
스킴을 앞으로 도입할
예정이라면 필요한
과정일 수 있습니다.
-
-u, --user-db
- 사용자
데이터베이스만
만듭니다만, 시스템
데이터베이스를 만들
때는 쓰기 권한이
필요합니다.
-
-t, --test
- 계층 검색 경로
상에서 설명서
페이지의 정확성
검사를 수행합니다.
mandb에서는 이
옵션으로 기존
데이터베이스를
대체하지 않습니다.
-
-f, --filename
- 주어진 파일 이름
항목만
업데이트합니다. 이
옵션은 평시 활용
옵션이 아닙니다.
MAN_DB_UPDATES 옵션으로
컴파일 했고 페이지가
오래됐음을 발견했을
때 man에서
내부적으로
사용합니다. -p
동작을 암묵적으로
실행하며 -c 와 -s
옵션의 동작을
멈춥니다.
-
-C 파일, --config-file=파일
-
~/.manpath 기본값 대신
사용자 설정 파일을
활용합니다.
-
-?, --help
- 사용법 메시지를
표시하고 나갑니다.
- --usage
- 간단한 사용법
메시지를 출력하고
나갑니다.
-
-V, --version
- 버전을 표시하고
나갑니다.
- 0
- 프로그램 실행
성공.
- 1
- 사용법, 문법,
구성 파일 오류.
- 2
- 처리 오류.
- 3
- 하위 프로세스
실행에
실패했습니다.
다음 경고 메시지는
데이터베이스 구성을
진행하는 동안 나타날
수 있습니다.
- <파일이름>:
페이지(섹션)의 whatis
해석에
실패했습니다
- <파일이름>에서
whatis 행 추출 시도에
실패했습니다. 보통
설명서 페이지를
제대로 작성하지
않았기 때문이긴
하지만, 상당수의
메시지가 나타났다면
man-db whatis 해석 프로그램과
호환성이 없는 비표준
설명서 페이지가
시스템에
들어있어서일지도
모릅니다. 자세한
내용은 lexgrog(1)의 WHATIS
해석 섹션을
살펴보십시오.
- <파일이름>: 은
연속 심볼릭
링크입니다
- <파일이름>은
없는데 심볼릭 링크가
참조하는 경우입니다.
더 자세한 진단에서는
제공하는 링크의
<파일이름>을
식별합니다.
- <파일이름>:
잘못된 심볼링 링크
또는 ROFF `.so'
요청입니다
- <파일이름>이
어딘가를 가리키는
심볼릭 링크거나 없는
파일에 요청을 보내는
ROFF가 들어있습니다.
- <파일이름>:
가짜 파일 이름 무시
- <파일이름>이
적절한 설명서
페이지일 수도, 아닐
수도 있지만, 이름이
잘못됐습니다. 보통
<x> 섹션 확장자가
붙은 설명서 페이지가
설명서 페이지 섹션
<y>에 있어서일 수도
있습니다.
- <파일이름_마스크>:
여러 확장자가
있습니다
- <파일이름_마스크>의
와일드카드 결과가
유일 값이 아닙니다.
이 메시지는 보통
동일한 설명서
페이지의 같은 버전이
압축 버전과 비압축
버전이 공존할 경우에
나타납니다. 최근
대부분의 경우는
무시합니다.
- /etc/manpath.config
- man-db 구성 파일.
- /var/cache/man/index.(bt|db|dir|pag)
- FHS 준수 전역
색인 데이터베이스
캐시입니다.
데이터베이스 캐시의
이전 위치는 다음과
같습니다:
- /usr/man/index.(bt|db|dir|pag)
- 전통 전역 색인
데이터베이스
캐시입니다.
- /var/catman/index.(bt|db|dir|pag)
- 대체 또는 FSSTND 준수
전역 색인
데이터베이스
캐시입니다.
lexgrog(1),
man(1),
manpath(5),
catman(8)
이 설명서 페이지의
WHATIS
해석 섹션은 이제
lexgrog(1)의 일부입니다.
Wilf. ([email protected]).
Fabrizio Polacco ([email protected]).
Colin Watson ([email protected]).
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db