MANDB(8) 설명서 페이저 유틸리티 MANDB(8)
이름
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. (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Colin Watson (cjwatson@debian.org).
버그
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db
2.11.2 2023-01-08 MANDB(8)
Generated by dwww version 1.15 on Mon Jul 1 04:44:44 CEST 2024.