De manera predeterminada, la consulta de búsqueda está compuesta por una serie de términos para los cuales deben encontrarse coincidencias exactas, sin tener en cuenta las mayúsculas y minúsculas. Utilice la opción -I para especificar una búsqueda con distinción entre mayúsculas y minúsculas.
Puede utilizar los comodines ? y * en los términos de consulta. Puede utilizar comillas simples o dobles para buscar frases. Asegúrese de tener en cuenta el shell al utilizar comodines o comillas.
Puede especificar más de un término de consulta. De manera predeterminada, varios términos se unen con AND. Puede unir explícitamente dos términos con OR.
Las consultas de búsqueda se pueden expresar en el siguiente formato estructurado:
package:action:index:token
El nombre del paquete para buscar o un patrón que puede coincidir con varios paquetes.
El nombre de una acción enumerada en la sección "Acciones" de la página del comando man pkg(5).
El nombre de un atributo de action enumerado en la sección "Acciones" de la página del comando man pkg(5).
El valor de index o un patrón que pueda coincidir con el valor de index.
Los campos vacíos implícitamente se llenan con caracteres comodín.
No se pueden realizar búsquedas en todos los atributos. Por ejemplo, mode es un atributo de la acción file, pero mode no es un valor válido para index.
Algunos valores de index son valores derivados de otros atributos. Por ejemplo, index puede ser basename, que es el último componente del atributo path de una acción file o dir. Los ejemplos de valores útiles para index incluyen basename y path para las acciones file y dir, el tipo de dependencia (require o group, por ejemplo) para las acciones depend y driver_name y alias para las acciones driver.
El valor de token se compara con el valor del atributo designado por index. Por ejemplo, en la siguiente acción driver parcial, alias es un nombre de atributo que se puede especificar para index y pci108e* se puede especificar para token.
driver alias=pci108e,1647 alias=pci108e,16a7
La sintaxis de una acción set es ligeramente diferente. Los dos atributos de una acción set son name y value. En este caso, el valor de index es el valor de un atributo name y el valor de tokense compara con el valor del atributo value coincidente. En el siguiente ejemplo, se muestra una acción set parcial para un paquete de controladores:
set name=pkg.summary value="Broadcom NetXtreme II 10GbE NIC Driver"
En el siguiente ejemplo, se especifica set para action, pkg.summary para index y Broadcom para token. Los especificadores de columna search.match y pkg.name son pseudoatributos. Consulte la página del comando man 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
Algunos valores bien definidos de los atributos name de la acción set incluyen pkg.fmri, info.classification, pkg.description y pkg.summary. Consulte "Set Actions" en la página del comando man pkg(5).
De manera predeterminada, las coincidencias sólo se muestran para las versiones de paquetes instaladas actualmente o más recientes. Utilice la opción -f para mostrar todas las versiones coincidentes.
De manera predeterminada, se muestran resultados para todas las acciones coincidentes, lo que puede producir varias líneas de resultados para un paquete. Utilice la opción -p para enumerar cada paquete coincidente solamente una vez.