Ubuntu Manpage: mandb - 설명서 페이지 색인 캐시를 만들거나 업데이트합니다

Provided by: man-db_2.12.0-4build2_amd64

이름

       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