WHEREIS(1)

명칭
whereis - 프로그램의 패스를 표시합니다

서식
whereis [-bms] [-u] [-BMS -dir -... -f] program ...

해설
whereis (은)는 표준의 바이너리 디렉토리나 메뉴얼 페이지 그리고, 특정의 프로그램 의 원시 파일 디렉토리를 검색해, 지정된 프로그램의 패스가 발견되면 표시합니다. 주어진 이름은, 처음에 패스명 부분이 제거되어 gzip(1) 또는 compress(1) 에 의한 확장자(extension)를 하나 삭제해, 원시 코드 제어 시스템을 위한 파일명의 초의 ‘s.’ (이)나 마지막 ‘, v’ (을)를 제외해, 패스명으로 됩니다.

검색되는 디렉토리는 sysctl(8) 에 캐릭터 라인 “user.cs_path” (을)를 주었을 때에 돌려주어지는 캐릭터 라인과 /usr/libexec 및 현재의 유저의 $PATH 입니다. 메뉴얼은, 디폴트에서는 $MANPATH 에 따라 검색됩니다. 프로그램 소스는, /usr/src (이)나 /usr/ports 의 모든 서브 디렉토리를 포함한, 표준의 장소의 리스트에 있는 것으로 여겨집니다.

이하와 같은 옵션이 이용 가능합니다.

-B  바이너리를 검색하기 위한 디렉토리를 지정합니다. -f 옵션이 필요합니다.

-M  메뉴얼 페이지를 검색하기 위한 디렉토리를 지정합니다. -f 옵션이 필요합니다.

-S  프로그램 소스를 검색하기 위한 디렉토리를 지정합니다. -f 옵션이 필요합니다.

-b  바이너리를 검색합니다.

-f  -B, -M, -S 옵션이 지정된 다음에, 디렉토리의 리스트의 경계를 설정해, name 리스트의 초를 지정합니다.

-m  메뉴얼 페이지를 검색합니다.

-s  소스 디렉토리를 검색합니다.

-u  “unusual” 엔트리를 검색합니다. 파일은, 요구된 각각의 타입의 엔트리가 없는 경우에 보통이 아닌 (unusual)라고 합니다.

실행예
이하에서는, /usr/bin 이하의 문서가 없는 모든 유틸리티를 찾아냅니다.
    whereis -m -u /usr/bin/*

관련 항목
find, locate(1), man(1), which(1), sysctl(8)

버그
소스의 검색은, 소스 디렉토리의 리스트의 각 요소의 제일 레벨의 서브 디렉토리를 검색하는 퀵 검색으로 실장되고 있습니다. 이것이 성공하지 않는 경우, locate(1) 유틸리티가 서브 디렉토리의 것보다 깊은 곳까지 검색하기 위해서 불려 갑니다. 이것은, 시간이 걸리고, 로케이트데이타베이스가 갱신되고 있을 때에만 성공합니다.

역사
whereis 명령은, 3.0BSD 그리고 도입되었습니다. 이 판은 4.4BSD 그리고 없어진 역사적인 기능을 재실장했습니다.