기본적으로 검색 질의는, 대소문자를 제외하고 정확히 일치하는 일련의 용어입니다. 대소문자 구분 검색을 지정하려면 -I 옵션을 사용합니다.
질의어에 ? 및 * 와일드카드를 사용할 수 있습니다. 작은따옴표나 큰따옴표를 사용하여 구문을 검색할 수 있습니다. 와일드카드 또는 따옴표를 사용할 때는 셸을 고려해야 합니다.
질의어를 둘 이상 지정할 수 있습니다. 기본적으로 여러 질의어는 AND로 결합됩니다. OR을 사용하여 두 질의어를 명시적으로 결합할 수 있습니다.
다음과 같은 구조적 형태로 검색 질의를 표현할 수 있습니다.
package:action:index:token
검색할 패키지의 이름이거나 여러 패키지와 일치하는 패턴입니다.
pkg(5) 매뉴얼 페이지의 “Actions” 섹션에 나열된 작업의 이름입니다.
pkg(5) 매뉴얼 페이지의 “Actions” 섹션에 나열된 대로 action 속성의 이름입니다.
index 값이거나 index 값과 일치하는 패턴입니다.
누락된 필드는 암시적으로 와일드카드로 처리됩니다.
일부 속성은 검색할 수 없습니다. 예를 들어, mode는 file 작업의 속성이지만 mode는 index에 대한 유효한 값이 아닙니다.
일부 index 값은 다른 속성에서 파생됩니다. 예를 들어 index는 file 또는 dir 작업에 대한 path 속성의 마지막 구성 요소인 basename일 수 있습니다. 유용한 index 값의 예로는 file 및 dir 작업의 basename 및 path, depend 작업의 종속성 유형(예: require 또는 group), driver 작업의 driver_name 및 alias 등이 있습니다.
token 값은 index로 이름이 지정된 속성 값과 비교됩니다. 예를 들어 다음 부분 driver 작업에서 alias는 index에 지정할 수 있는 속성 이름이고 token에는 pci108e*를 지정할 수 있습니다.
driver alias=pci108e,1647 alias=pci108e,16a7
set 작업의 구문은 약간 다릅니다. set 작업의 두 가지 속성은 name과 value입니다. 이 경우 index 값은 name 속성 값이고 token 값은 일치하는 value 속성 값과 비교됩니다. 다음 예제는 드라이버 패키지에 대한 부분 set 작업을 보여줍니다.
set name=pkg.summary value="Broadcom NetXtreme II 10GbE NIC Driver"
다음 예제는 action에 set, index에 pkg.summary, token에 Broadcom을 지정합니다. search.match 및 pkg.name 열 지정자는 의사 속성입니다. pkg(1) 매뉴얼 페이지를 참조하십시오.
$ pkg search -o search.match,pkg.name pkg.summary:Broadcom SEARCH.MATCH PKG.NAME Broadcom NetXtreme II 10GbE NIC Driver driver/network/ethernet/bnxe Broadcom 57xx 1GbE NIC Driver driver/network/ethernet/bge Broadcom NetXtreme II 1GbE NIC Driver driver/network/ethernet/bnx Broadcom BCM4401 NIC Driver driver/network/ethernet/bfe Broadcom HT1000 SATA driver driver/storage/bcm_sata
몇몇 제대로 정의된 set 작업 name 속성 값에는 pkg.fmri, info.classification, pkg.description, pkg.summary가 있습니다. pkg(5) 매뉴얼 페이지의 “Set Actions”를 참조하십시오.
기본적으로 현재 설치된 패키지 또는 최신 패키지 버전에 대해서만 일치하는 항목이 표시됩니다. 일치하는 버전을 모두 표시하려면 -f 옵션을 사용합니다.
기본적으로 일치하는 모든 작업에 대해 결과가 표시되므로 한 패키지에 대해 여러 행의 결과가 생성될 수 있습니다. 일치하는 각 패키지를 한 번만 나열하려면 -p 옵션을 사용합니다.