Manpages

이 름

apropos - 설 명 서 페 이 지 이 름 과 설 명 을 검 색 합 니 다

개 요

apropos [-dalv?V] [-e|-w|-r] [-s 목 록 ] [-m 시 스 템 [,...]] [-M 경 로 ] [-L 로 캘 ] [-C 파 일 ] 검 색 어 ...

설 명

각 설 명 서 페 이 지 에 는 페 이 지 안 에 간 단 한 설 명 이 있 습 니 다 . apropos은 검 색 어 처 럼 설 명 을 검 색 합 니 다 .

검 색 어 는 보 통 (-r)를 썼 을 때 처 럼 정 규 표 현 식 이 들 어 가 거 나 , 와 일 드 카 드 (-w) 문 자 가 들 어 가 거 나 , 정 확 히 일 치 하 는 검 색 어 (-e)가 들 어 갑 니 다 . 이 옵 션 을 활 용 하 면 서 , 검 색 어 에 따 옴 표 로 둘 러 쌓 거 나 , 셸 에 서 특 정 문 자 를 이 스 케 이 핑 (\)하 여 해 석 을 막 아 야 할 수 도 있 습 니 다 .

표 준 일 치 규 칙 에 서 는 페 이 지 이 름 또 는 설 명 서 의 단 어 범 위 내 에 서 일 치 하 는 방 식 으 로 검 색 할 수 있 습 니 다 .

apropos에 서 검 색 한 데 이 터 베 이 스 는 mandb 프 로 그 램 에 서 업 데 이 트 합 니 다 . 설 치 상 태 에 따 라 주 기 적 크 론 작 업 으 로 실 행 핧 수 도 있 고 , 새 설 명 서 페 이 지 를 설 치 할 때 마 다 직 접 실 행 해 야 할 수 도 있 습 니 다 .

옵 션

-d, --debug

디 버 깅 정 보 를 출 력 합 니 다 .

-v, --verbose

경 고 메 시 지 를 자 세 하 게 출 력 합 니 다 .

-r, --regex

각 검 색 어 를 정 규 표 현 식 으 로 해 석 합 니 다 . 기 본 동 작 입 니 다 . 각 검 색 어 는 페 이 지 이 름 및 설 명 과 개 별 적 으 로 비 교 합 니 다 . 양 부 분 어 디 와 도 일 치 여 부 를 비 교 할 수 있 습 니 다 . 일 치 여 부 는 단 어 범 위 로 제 한 하 지 않 습 니 다 .

-w, --wildcard

셸 방 식 와 일 드 카 드 가 들 어 간 패 턴 으 로 각 검 색 어 를 해 석 합 니 다 . 각 검 색 어 를 페 이 지 이 름 과 설 명 에 각 각 비 교 합 니 다 . --exact 옵 션 을 사 용 했 다 면 확 장 검 색 어 가 전 체 설 명 또 는 페 이 지 이 름 에 일 치 하 는 경 우 에 만 일 치 요 소 를 찾 습 니 다 . 이 경 우 가 아 니 라 면 , 검 색 어 의 활 용 범 위 를 설 명 의 단 어 범 위 로 하 여 찾 을 수 있 습 니 다 .

-e, --exact

각 검 색 어 는 페 이 지 이 름 과 설 명 에 정 확 히 일 치 해 야 합 니 다 .

-a, --and

지 정 검 색 어 에 모 두 일 치 하 는 항 목 만 표 시 합 니 다 . 기 본 동 작 은 어 떤 검 색 어 에 든 일 치 하 는 항 목 의 표 시 입 니 다 .

-l, --long

터 미 널 폭 에 맞 춰 출 력 을 자 르 지 않 습 니 다 . 보 통 , 정 돈 이 제 대 로 안 된 NAME 섹 션 의 깔 끔 하 지 못 한 출 력 을 다 듬 을 목 적 으 로 터 미 널 폭 으 로 자 릅 니 다 .

-s 목 록 , --sections=목 록 , --section=목 록

주 어 진 설 명 서 섹 션 에 대 해 서 만 검 색 합 니 다 . 목 록 은 콜 론 또 는 쉼 표 로 구 분 한 섹 션 목 록 입 니 다 . 목 록 의 항 목 이 "3"과 같 은 단 순 섹 션 이 라 면 , "3", "3perl", "3x" 과 같 은 식 으 로 설 명 목 록 이 페 이 지 에 들 어 갑 니 다 . 목 록 에 들 어 간 항 목 이 "3perl" 과 같 은 확 장 자 일 경 우 , 설 명 서 섹 션 의 정 확 한 페 이 지 부 분 만 목 록 에 들 어 갑 니 다 .

-m 시 스 템 [,...], --systems=시 스 템 [,...]

이 시 스 템 에 서 다 른 운 영 체 제 설 명 서 페 이 지 설 명 에 접 근 한 다 면 이 옵 션 으 로 검 색 할 수 있 습 니 다 . NewOS의 설 명 서 페 이 지 의 설 명 을 검 색 하 려 면 -m NewOS 옵 션 을 사 용 하 십 시 오 .

시 스 템 에 는 쉼 표 로 구 분 한 운 영 체 제 이 름 값 으 로 구 성 합 니 다 . 운 영 체 제 의 whatis 자 체 설 명 검 색 단 어 를 넣 으 려 면 , 인 자 문 자 열 에 시 스 템 이 름 man을 넣 습 니 다 . 이 옵 션 은 $SYSTEM 환 경 변 수 값 을 대 신 합 니 다 .

-M 경 로 , --manpath=경 로

콜 론 으 로 구 분 한 검 색 대 상 설 명 서 페 이 지 계 층 을 대 신 지 정 합 니 다 . 기 본 적 으 로 apropos은 $MANPATH 환 경 변 수 가 비 어 있 거 나 설 정 하 지 않 는 한 이 를 활 용 하 는 데 , 비 어 있 거 나 설 정 하 지 않 았 을 경 우 에 는 $PATH 환 경 변 수 를 기 반 으 로 적 절 한 맨 페 이 지 경 로 를 지 정 합 니 다 . 이 옵 션 은 $MANPATH 내 용 을 대 신 합 니 다 .

-L 로 캘 , --locale=로 캘

apropos은 보 통 $LC_MESSAGES와 $LANG 같 은 다 양 한 환 경 변 수 를 조 사 하 는 C 함 수 setlocale(3)을 호 출 하 여 현 재 로 캘 을 결 정 합 니 다 . 결 정 한 값 을 임 시 로 대 체 적 용 하 려 면 로 캘 문 자 열 을 바 로 apropos에 전 달 하 는 이 옵 션 을 사 용 하 십 시 오 . 참 고 로 페 이 지 가 실 제 로 시 작 하 는 부 분 을 검 색 하 기 전 까 지 는 아 무 런 영 향 을 주 지 않 습 니 다 . 도 움 말 메 시 지 와 같 은 출 력 결 과 는 항 상 로 캘 을 초 기 에 결 정 한 다 음 나 타 납 니 다 .

-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문 자 폭 으 로 대 체 합 니 다 .

POSIXLY_CORRECT

$POSIXLY_CORRECT를 설 정 하 면 , 널 값 이 라 해 도 기 본 apropos 프 로 그 램 은 확 장 정 규 표 현 식 (-r)을 활 용 하 여 검 색 합 니 다 . 최 근 에 는 , 어 쨌 든 지 간 에 기 본 동 작 입 니 다 .

파 일

/usr/share/man/index.(bt|db|dir|pag)

전 통 전 역 색 인 데 이 터 베 이 스 캐 시 입 니 다 .

/var/cache/man/index.(bt|db|dir|pag)

FHS 준 수 전 역 색 인 데 이 터 베 이 스 캐 시 입 니 다 .

/usr/share/man/.../whatis

전 통 WHATIS 텍 스 트 데 이 터 베 이 스 입 니 다 .

추 가 참 조

man(1), whatis(1), mandb(8)

저 작 자

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