이 름
whatis - 설 명 서 페 이 지 설 명 한 줄 을 표 시 합 니 다
개 요
whatis [-dlv?V] [-r|-w] [-s 목 록 ] [-m 시 스 템 [,...]] [-M 경 로 ] [-L 로 캘 ] [-C 파 일 ] 이 름 ...
설 명
각 설 명 서 페 이 지 에 는 간 단 한 설 명 이 들 어 있 습 니 다 . whatis는 설 명 서 페 이 지 이 름 을 검 색 하 며 , 이 름 과 일 치 하 는 설 명 서 페 이 지 설 명 부 분 을 출 력 합 니 다 .
이 름 에 는 와 일 드 카 드 (-w)가 들 어 가 거 나 정 규 표 현 식 -r)이 들 어 갑 니 다 . 이 옵 션 을 활 용 하 면 , 이 름 을 따 옴 표 로 둘 러 쌓 거 나 특 수 문 자 를 이 스 케 이 핑 (\) 처 리 하 여 셸 에 서 해 석 하 거 나 실 행 하 지 못 하 게 막 아 야 합 니 다 .
색 인 데 이 터 베 이 스 는 검 색 시 활 용 하 며 , mandb 프 로 그 램 에 서 업 데 이 트 합 니 다 . 설 치 상 태 에 따 라 크 론 작 업 으 로 주 기 적 으 로 실 행 하 거 나 새 설 명 서 페 이 지 를 설 치 한 후 직 접 실 행 해 야 합 니 다 . 상 대 색 인 데 이 터 베 이 스 에 서 구 세 대 방 식 whatis 데 이 터 베 이 스 를 만 들 려 면 , 다 음 명 령 을 실 행 합 니 다 :
whatis -M 맨 _페 이 지 _경 로 -w ’*’ | sort > 맨 _페 이 지 _경 로 /WHATIS
맨 _페 이 지 _경 로 는 /usr/man과 같 은 설 명 서 페 이 지 계 층 입 니 다 .
옵 션
-d, --debug
디 버 깅 정 보 를 출 력 합 니 다 .
-v, --verbose
경 고 메 시 지 를 자 세 하 게 출 력 합 니 다 .
-r, --regex
각 이 름 을 정 규 표 현 식 으 로 해 석 합 니 다 . 이 름 이 페 이 지 이 름 일 부 와 일 치 하 면 , 일 치 항 목 으 로 간 주 합 니 다 . 이 옵 션 은 whatis의 데 이 터 베 이 스 검 색 방 식 으 로 인 해 조 금 느 리 게 할 수 있 습 니 다 .
-w, --wildcard
각 이 름 을 셸 방 식 와 일 드 카 드 문 자 가 들 어 간 패 턴 으 로 해 석 합 니 다 . 일 치 항 목 이 되 려 면 , 확 장 이 름 이 전 체 페 이 지 이 름 과 일 치 해 야 합 니 다 . 이 옵 션 은 whatis의 데 이 터 베 이 스 검 색 방 식 으 로 인 해 조 금 느 리 게 할 수 있 습 니 다 .
-l, --long
터 미 널 폭 에 맞 춰 출 력 을 자 르 지 않 습 니 다 . 보 통 , 정 돈 이 제 대 로 안 된 NAME 섹 션 의 깔 끔 하 지 못 한 출 력 을 다 듬 을 목 적 으 로 터 미 널 폭 으 로 자 릅 니 다 .
-s 목 록 , --sections=목 록 , --section=목 록
주 어 진 설 명 서 섹 션 에 대 해 서 만 검 색 합 니 다 . 목 록 은 콜 론 또 는 쉼 표 로 구 분 한 섹 션 목 록 입 니 다 . 목 록 의 항 목 이 "3"과 같 은 단 순 섹 션 이 라 면 , "3", "3perl", "3x" 과 같 은 식 으 로 설 명 목 록 이 페 이 지 에 들 어 갑 니 다 . 목 록 에 들 어 간 항 목 이 "3perl" 과 같 은 확 장 자 일 경 우 , 설 명 서 섹 션 의 정 확 한 페 이 지 부 분 만 목 록 에 들 어 갑 니 다 .
-m 시 스 템 [,...], --systems=시 스 템 [,...]
시 스 템 에 서 다 른 운 영 체 제 의 설 명 서 페 이 지 이 름 에 접 근 할 수 있 다 면 , 이 옵 션 으 로 접 근 할 수 있 습 니 다 . NewOS의 설 명 서 페 이 지 이 름 을 검 색 하 려 면 -m NewOS 옵 션 을 사 용 하 십 시 오 .
시 스 템 에 는 쉼 표 로 구 분 한 여 러 운 영 체 제 이 름 을 지 정 할 수 있 습 니 다 . 자 체 운 영 체 제 설 명 서 페 이 지 이 름 의 검 색 대 상 을 넣 으 려 면 시 스 템 이 름 man을 인 자 문 자 열 에 반 드 시 넣 어 야 합 니 다 . 이 옵 션 은 $SYSTEM 환 경 변 수 를 대 체 합 니 다 .
-M 경 로 , --manpath=경 로
콜 론 으 로 구 분 한 검 색 대 상 설 명 서 페 이 지 계 층 을 대 신 지 정 합 니 다 . 기 본 적 으 로 whatis은 $MANPATH 환 경 변 수 가 비 어 있 거 나 설 정 하 지 않 는 한 이 를 활 용 하 는 데 , 비 어 있 거 나 설 정 하 지 않 았 을 경 우 에 는 $PATH 환 경 변 수 를 기 반 으 로 적 절 한 맨 페 이 지 경 로 를 지 정 합 니 다 . 이 옵 션 은 $MANPATH 내 용 을 대 신 합 니 다 .
-L 로 캘 , --locale=로 캘
whatis은 보 통 $LC_MESSAGES와 $LANG 같 은 다 양 한 환 경 변 수 를 조 사 하 는 C 함 수 setlocale(3)을 호 출 하 여 현 재 로 캘 을 결 정 합 니 다 . 결 정 한 값 을 임 시 로 대 체 적 용 하 려 면 로 캘 문 자 열 을 바 로 whatis에 전 달 하 는 이 옵 션 을 사 용 하 십 시 오 . 참 고 로 페 이 지 가 실 제 로 시 작 하 는 부 분 을 검 색 하 기 전 까 지 는 아 무 런 영 향 을 주 지 않 습 니 다 . 도 움 말 메 시 지 와 같 은 출 력 결 과 는 항 상 로 캘 을 초 기 에 결 정 한 다 음 나 타 납 니 다 .
-C 파 일 , --config-file=파 일
~/.manpath 기 본 값 대 신 사 용 자 설 정 파 일 을 활 용 합 니 다 .
-?, --help
도 움 말 메 시 지 를 출 력 하 고 나 갑 니 다 .
--usage
간 단 한 사 용 법 메 시 지 를 출 력 하 고 나 갑 니 다 .
-V, --version
버 전 정 보 를 출 력 합 니 다 .
종 료 상 태
|
0 |
프 로 그 램 실 행 성 공 . |
|||
|
1 |
사 용 법 , 문 법 , 구 성 파 일 오 류 . |
|||
|
2 |
처 리 오 류 . |
|||
|
16 |
지 정 한 단 어 에 일 치 하 는 요 소 를 찾 지 못 했 습 니 다 . |
환 경
|
SYSTEM |
$SYSTEM을 설 정 했 다 면 , -m 옵 션 의 인 자 지 정 과 같 이 동 작 합 니 다 . |
MANPATH
$MANPATH를 설 정 했 다 면 , 콜 론 으 로 구 분 한 설 명 서 페 이 지 검 색 경 로 로 값 을 해 석 합 니 다 .
환 경 변 수 처 리 방 식 의 기 본 동 작 및 자 세 한 내 용 은 manpath(5)의 검 색 경 로 섹 션 을 살 펴 보 십 시 오 .
MANWIDTH
$MANWIDTH를 설 정 하 면 , 이 값 을 터 미 널 폭 으 로 사 용 합 니 다 (--long 옵 션 참 조 ). 이 값 을 설 정 하 지 않 으 면 터 미 널 폭 을 $COLUMNS 값 으 로 계 산 하 며 , 가 능 하 다 면 ioctl(2) 값 을 활 용 합 니 다 . 앞 서 두 가 지 방 식 의 처 리 에 실 패 하 면 80문 자 폭 으 로 대 체 합 니 다 .
파 일
/usr/share/man/index.(bt|db|dir|pag)
전 통 전 역 색 인 데 이 터 베 이 스 캐 시 입 니 다 .
/var/cache/man/index.(bt|db|dir|pag)
FHS 준 수 전 역 색 인 데 이 터 베 이 스 캐 시 입 니 다 .
/usr/share/man/.../whatis
전 통 WHATIS 텍 스 트 데 이 터 베 이 스 입 니 다 .
추 가 참 조
저 작 자
Wilf.
(G.Wilford [AT] ee.uk).
Fabrizio Polacco (fpolacco [AT] debian.org).
Colin Watson (cjwatson [AT] debian.org).
버 그
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db