| Omitir V�nculos de navegaci�n | |
| Salir de la Vista de impresi�n | |
|
Páginas del comando man de Image Packaging System Oracle Solaris 11 Information Library (Español) |
| Omitir V�nculos de navegaci�n | |
| Salir de la Vista de impresi�n | |
|
|
Páginas del comando man de Image Packaging System Oracle Solaris 11 Information Library (Español) |
- cliente de recuperación de Image Packaging System
/usr/bin/pkg [options] command [cmd_options] [operands]
/usr/bin/pkg refresh [--full] [publisher ...]
/usr/bin/pkg install [-nvq] [-g path_or_uri ...] [--accept]
[--licenses] [--no-be-activate] [--no-index] [--no-refresh]
[--no-backup-be | --require-backup-be] [--backup-be-name name]
[--deny-new-be | --require-new-be] [--be-name name]
[--reject pkg_fmri_pattern ...] pkg_fmri_pattern .../usr/bin/pkg uninstall [-nvq] [--no-be-activate] [--no-index]
[--no-backup-be | --require-backup-be] [--backup-be-name name]
[--deny-new-be | --require-new-be] [--be-name name]
pkg_fmri_pattern .../usr/bin/pkg update [-fnvq] [-g path_or_uri ...] [--accept]
[--licenses] [--no-be-activate] [--no-index] [--no-refresh]
[--no-backup-be | --require-backup-be] [--backup-be-name name]
[--deny-new-be | --require-new-be] [--be-name name]
[--reject pkg_fmri_pattern ...] [pkg_fmri_pattern ...]/usr/bin/pkg list [-Hafnsuv] [-g path_or_uri ...]
[--no-refresh] [pkg_fmri_pattern ...]/usr/bin/pkg info [-lr] [-g path_or_uri ...] [--license]
[pkg_fmri_pattern ...]/usr/bin/pkg contents [-Hmr] [-a attribute=pattern ...]
[-g path_or_uri ...] [-o attribute ...] [-s sort_key]
[-t action_type ...] [pkg_fmri_pattern ...]/usr/bin/pkg search [-HIaflpr] [-o attribute ...]
[-s repo_uri] query/usr/bin/pkg verify [-Hqv] [pkg_fmri_pattern ...]
/usr/bin/pkg fix [--accept] [--licenses] [pkg_fmri_pattern ...]
/usr/bin/pkg revert [-nv] [--no-be-activate]
[--no-backup-be | --require-backup-be] [--backup-be-name name]
[--deny-new-be | --require-new-be] [--be-name name]
(--tagged tag-name ... | path-to-file ...)/usr/bin/pkg mediator [-aH] [-F format] [mediator ...]
usr/bin/pkg set-mediator [-nv] [-I implementation]
[-V version] [--no-be-activate]
[--no-backup-be | --require-backup-be] [--backup-be-name name]
[--deny-new-be | --require-new-be] [--be-name name]
mediator .../usr/bin/pkg unset-mediator [-nvIV] [--no-be-activate]
[--no-backup-be | --require-backup-be] [--backup-be-name name]
[--deny-new-be | --require-new-be] [--be-name name]
mediator .../usr/bin/pkg variant [-H] [variant.variant_name ...]
/usr/bin/pkg change-variant [-nvq] [-g path_or_uri ...]
[--accept] [--licenses] [--no-be-activate]
[--no-backup-be | --require-backup-be] [--backup-be-name name]
[--deny-new-be | --require-new-be] [--be-name name]
variant_name=value .../usr/bin/pkg facet [-H] [facet_name ...]
/usr/bin/pkg change-facet [-nvq] [-g path_or_uri ...]
[--accept] [--licenses] [--no-be-activate]
[--no-backup-be | --require-backup-be] [--backup-be-name name]
[--deny-new-be | --require-new-be] [--be-name name]
facet_name=[True|False|None] .../usr/bin/pkg avoid [pkg_fmri_pattern ...]
/usr/bin/pkg unavoid [pkg_fmri_pattern ...]
/usr/bin/pkg freeze [-n] [-c reason] [pkg_fmri_pattern] ...
/usr/bin/pkg unfreeze [-n] [pkg_name_pattern] ...
/usr/bin/pkg property [-H] [propname ...]
/usr/bin/pkg set-property propname propvalue
/usr/bin/pkg add-property-value propname propvalue
/usr/bin/pkg remove-property-value propname propvalue
/usr/bin/pkg unset-property propname ...
/usr/bin/pkg publisher [-HPn] [publisher ...]
/usr/bin/pkg set-publisher [-Ped] [-k ssl_key] [-c ssl_cert]
[-g origin_to_add | --add-origin origin_to_add ...]
[-G origin_to_remove | --remove-origin origin_to_remove ...]
[-m mirror_to_add | --add-mirror mirror_to_add ...]
[-M mirror_to_remove | --remove-mirror mirror_to_remove ...]
[--enable] [--disable] [--no-refresh]
[--reset-uuid] [--non-sticky] [--sticky]
[--search-after publisher] [--search-before publisher]
[--search-first]
[--approve-ca-cert path_to_CA]
[--revoke-ca-cert hash_of_CA_to_remove]
[--unset-ca-cert hash_of_CA_to_remove]
[--set-property name_of_property=value]
[--add-property-value name_of_property=value_to_add]
[--remove-property-value name_of_property=value_to_remove]
[--unset-property name_of_property_to_delete]
publisher/usr/bin/pkg set-publisher -p repo_uri
[-Ped] [-k ssl_key] [-c ssl_cert]
[--non-sticky] [--sticky]
[--search-after publisher] [--search-before publisher]
[--search-first]
[--approve-ca-cert path_to_CA]
[--revoke-ca-cert hash_of_CA_to_remove]
[--unset-ca-cert hash_of_CA_to_remove]
[--set-property name_of_property=value]
[--add-property-value name_of_property=value_to_add]
[--remove-property-value name_of_property=value_to_remove]
[--unset-property name_of_property_to_delete]
[publisher]/usr/bin/pkg unset-publisher publisher ...
/usr/bin/pkg history [-Hl] [-t [time | time-time],...]
[-o column,...] [-n number]/usr/bin/pkg purge-history
/usr/bin/pkg rebuild-index
/usr/bin/pkg update-format
/usr/bin/pkg version
/usr/bin/pkg help
/usr/bin/pkg image-create [-FPUfz] [--force]
[--full | --partial | --user] [--zone]
[-k ssl_key] [-c ssl_cert]
[--no-refresh] [--variant variant_name=value ...]
[-g path_or_uri | --origin path_or_uri ...]
[-m uri | --mirror uri ...]
[--set-property name_of_property=value]
[--facet facet_name=(True|False) ...]
[(-p | --publisher) [name=]repo_uri] dirpkg es el cliente de recuperación de Image Packaging System. Con una configuración válida, pkg se puede invocar para crear ubicaciones para los paquetes que se instalarán, llamar imágenes e instalar los paquetes en esas imágenes. Los paquetes son publicados por los editores, que pueden colocar sus paquetes en uno o varios depósitos, o en archivos de paquetes para que estén disponibles. pkg recupera los paquetes desde archivos de paquetes o depósitos del editor, e instala los paquetes en una imagen.
Un nombre de editor identifica a una persona, un grupo de personas o una organización como el origen de uno o varios paquetes. Para evitar conflictos entre nombres de editores y ayudar a identificar al editor, se aconseja utilizar como nombre de editor un nombre de dominio que represente a la entidad que publica los paquetes.
Un depósito es una ubicación donde los clientes pueden publicar y recuperar el contenido de los paquetes (archivos incluidos en del paquete, como programas y documentos) y los metadatos (información sobre el paquete, como el nombre y la descripción). Por ejemplo, un editor llamado example.org podría tener su depósito ubicado en el URI http://example.org/repository.
pkg también puede desinstalar paquetes, refrescar metadatos del editor (como la lista de paquetes disponibles), validar la instalación de paquetes en una imagen y consultar distintos tokens en una imagen. Estas consultas también se puede crear a partir de depósitos pkg(5).
Las imágenes pueden ser de tres tipos: imágenes completas, que pueden proporcionar un sistema completo; imágenes parciales, que están enlazadas a una imagen completa (imagen principal), pero no pueden proporcionar un sistema completo por sí solas; e imágenes de usuario.
Se admiten las siguientes opciones:
Realiza operaciones en la imagen con raíz en directorio. Si no se especificó ningún directorio, o si no se determinó ninguno en función del entorno, el valor predeterminado es /. Para obtener más información, consulte la sección "Variables del entorno".
Muestra un mensaje de uso.
Se admiten los subcomandos siguientes:
Actualiza la lista de paquetes disponibles del cliente y los metadatos del editor para cada editor especificado. Si no se especifica ningún editor, la operación se realiza para todos los editores.
Con --full, se puede forzar una recuperación completa de todos los metadatos del editor, en lugar de intentar una actualización incremental, y solicitar que los proxies utilizados durante la operación ignoren los datos almacenados en la antememoria. Esta opción existe para solucionar problemas y no se debe utilizar con regularidad.
Instala los paquetes y los actualiza con la versión más reciente que coincide con el valor mod_ID rec ges err_paq permitido por los paquetes instalados en la imagen. Para solicitar de forma explícita la versión más reciente de un paquete, use latest para la parte de la versión del patrón_fmri_paquete. Por ejemplo, especifique vim@latest.
Es posible que durante el proceso de instalación se reemplacen algunos archivos de configuración o se les cambie el nombre. Para obtener más información sobre cómo el sistema de paquetes determina los archivos que se van a preservar y cómo se preservan dichos archivos durante las operaciones de paquetes, consulte "Acciones de archivo" en la página del comando man pkg(5).
Si un paquete está en la lista de paquetes que se deben evitar, una vez que se instala, se elimina de esa lista.
Con -g, puede agregar temporalmente el archivo o depósito de paquetes especificado a la lista de orígenes de la imagen desde donde se recuperarán los datos del paquete. Si los paquetes de los orígenes especificados también están disponibles en los editores configurados en la imagen, el cliente recuperará el contenido de esos paquetes sólo desde los orígenes especificados. Al decidir qué versión de un paquete se utilizará, los editores configurados en la imagen, pero no encontrados en los orígenes determinados, tienen prioridad. Después de la instalación o actualización, los paquetes proporcionados por los editores no se hayan encontrado en la imagen se agregarán a la configuración de la imagen sin un origen. Esta opción se puede especificar varias veces.
Con -n, puede llevar a cabo una ejecución de prueba de la operación sin realizar cambios en los paquetes.
Con -q, puede ocultar los mensajes de progreso durante la operación solicitada.
Con -v, puede enviar mensajes de progreso detallados durante la operación solicitada y mostrar información detallada de planificación (como el cambio de facetas, mediadores y variantes). Esta opción se puede especificar varias veces para aumentar la cantidad de información de planificación que se muestra.
Con --accept, puede indicar que está de acuerdo con las condiciones de las licencias de los paquetes que está actualizando o instalando y que las acepta. Si no proporciona esta opción, y alguna licencia de paquete requiere aceptación, la operación de instalación fallará.
Con --licenses, puede mostrar todas las licencias para los paquetes que se instalan o actualizan como parte de esta operación.
Con --no-backup-be, no puede crear un entorno de inicio de copia de seguridad.
Con --no-be-activate, si se crea un entorno de inicio, no lo establezca como el entorno de inicio activo en el inicio siguiente. Consulte beadm para obtener más información.
Con --no-index, no puede actualizar los índices de búsqueda una vez que la operación se ha completado correctamente.
Con --no-refresh, no intente contactar con los depósitos de los editores de la imagen para recuperar la lista más reciente de paquetes disponibles y otros metadatos.
Con --backup-be-name, puede nombrar el entorno de inicio de copia de seguridad creado utilizando el argumento proporcionado. El uso de --backup-be-name implica el uso de --require-backup-be. Consulte también beadm(1M).
Con --be-name, puede cambiar el nombre del entorno de inicio recién creado para que sea el argumento especificado. El uso de --be-name implica --require-new-be. Consulte también beadm(1M).
Con --require-backup-be, siempre cree un entorno de inicio de copia de seguridad si no creará un nuevo entorno de inicio. Sin esta opción, se crea un entorno de inicio de copia de seguridad basado en la política de imagen. Consulte be-policy en "Propiedades de la imagen" a continuación, para obtener una explicación de cuándo los entornos de inicio de copia de seguridad se crean automáticamente.
Con --require-new-be, siempre cree un entorno de inicio nuevo. Sin esta opción, se crea un entorno de inicio basado en la política de imagen. Consulte· be-policy ·en·"Propiedades·de·la·imagen"·a·continuación,·para·obtener·una·explicación·de·cuándo los entornos de inicio se crean automáticamente. Esta opción no se puede combinar con --require-backup-be.
Con --deny-new-be, no puede crear un entorno de inicio nuevo. Esta operación no se realiza si se requiere un entorno de inicio nuevo.
Con --reject, puede impedir que se instalen los paquetes con nombres que coincidan con el modelo determinado. Si los paquetes coincidentes ya están instalados, se eliminan como parte de esta operación. Los paquetes rechazados que son el destino de las dependencias de grupo se colocan en la lista para evitar.
Elimina los paquetes instalados que coinciden con el mod_ID rec ges err_paq.
Si un paquete es el tema de una dependencia de grupo, su desinstalación lo coloca en la lista para evitar. Consulte el subcomando avoid a continuación.
Para todas las demás opciones, consulte el comando install anterior para ver el uso y sus efectos.
Sin argumentos, o si asterisco ( *) es uno de los modelos proporcionados, actualice todos los paquetes instalados en la imagen actual a la versión más reciente permitida por las restricciones impuestas al sistema por los paquetes instalados y la configuración del editor. Para solicitar de manera explícita la versión más reciente de un paquete, use latest para la parte de la versión de mod_ID rec ges err_paq. Por ejemplo, especifique vim@latest.
Si se proporciona mod_ID rec ges err_paq, update sustituye los paquetes que están instalados, y que coinciden con mod_ID rec ges err_paq, con la versión más reciente permitida por los modelos y las restricciones impuestas al sistema por los paquetes instalados y la configuración del editor. Se pueden especificar versiones más antiguas o más recientes que las que ya están instaladas para realizar cambios de versión de paquetes específicos en el lugar. No se admite la actualización de paquetes específicos con nombres cambiados o límites obsoletos.
A los archivos de configuración preservados que forman parte de los paquetes que se van a actualizar a una versión inferior mediante update y que han sido modificados desde la instalación de la versión original se les cambia el nombre mediante la adición de la extensión .update. Para obtener más información sobre cómo el sistema de paquetes determina los archivos que se van a preservar y cómo se preservan dichos archivos durante las actualizaciones de paquetes, consulte "Acciones de archivo" en la página del comando man pkg(5).
Con la opción -f no ejecute la comprobación de actualizaciones de cliente al actualizar todos los paquetes instalados.
Para todas las demás opciones, consulte el comando install anterior para ver el uso y sus efectos.
Sin argumentos, visualice una lista de los paquetes de la imagen actual, así como información sobre la versión y el estado de instalación. Con argumentos, visualice información sobre los paquetes especificados. De manera predeterminada, las variantes de paquete para un tipo de zona o una arquitectura diferente se excluyen. La salida habitual es en tres columnas:
NAME (PUBLISHER) VERSION IFO system/core-os 0.5.11-0.169 i-- x11/wm/fvwm (fvwm.org) 2.6.1-3 i--
La primera columna contiene el nombre del paquete. Si el editor desde el que se instala el paquete (o donde está disponible el paquete, si aún no está instalado) no es el primero en el orden de búsqueda de editor, el nombre del editor aparece entre paréntesis a continuación del nombre del paquete. La segunda columna contiene la versión de lanzamiento y ramificación del paquete. Consulte la página del comando man pkg(5) para obtener información sobre las versiones de lanzamiento y ramificación, y sobre las variantes.
La última columna presenta un conjunto de indicadores que muestran el estado del paquete:
Una i en la columna I indica que el paquete está instalado.
Una f en la columna F indica que el paquete está congelado.
Una o en la columna O indica que el paquete es obsoleto. Una r en la columna O indica que se ha cambiado el nombre del paquete (una forma de ser obsoleto).
Con -H, puede omitir los encabezados de la lista.
Con -a, puede mostrar los paquetes instalados y la versión más reciente de los paquetes que están disponibles para la instalación. Se considera que los paquetes están disponibles para la instalación si están permitidos por las incorporaciones instaladas y por las variantes de la imagen. Si se especifica uno o varios modelos, se muestra la versión más reciente que coincide con el modelo especificado y permitido por cualquiera de las incorporaciones instaladas y las variantes de la imagen. Sin -a, se muestran sólo los paquetes instalados.
Con -f y -a, se muestran todas las versiones de todos los paquetes para todas las variantes independientemente de las restricciones de incorporación o del estado de instalación. Para mostrar explícitamente la última versión de un paquete al utilizar estas opciones, utilice latest para la parte de la versión de mod_ID rec ges err_paq. Por ejemplo, especifique vim@latest.
Con -g, puede utilizar el archivo o el depósito de paquetes especificado como el origen de los datos del paquete para la operación. Esta opción se puede especificar varias veces. El uso de -g implica el uso de -a si -n no se ha especificado.
Con -n, puede mostrar las versiones más recientes de todos los paquetes conocidos, independientemente del estado de instalación.
Con -s, puede mostrar una forma abreviada de una línea con el nombre del paquete y el resumen. Esta opción se puede utilizar con -a, -n, -u o -v.
Con -u, puede mostrar sólo los paquetes con versiones más recientes disponibles. Esta opción no se puede utilizar con -g.
Con -v, puede mostrar identificadores de recursos de gestión de errores del paquete completo, incluidos el editor y la versión completa, todo en la primera columna (la columna de versión desaparece). Esta opción se puede utilizar con -a, -n o -u.
Con --no-refresh, no intente contactar con los depósitos de los editores de la imagen para recuperar la lista más reciente de paquetes disponibles.
Puede mostrar información sobre los paquetes en un formato legible. Se pueden especificar varios modelos de identificador de recurso de gestión de errores. Sin modelos, puede mostrar información sobre todos los paquetes instalados en la imagen.
Con -g, puede utilizar el archivo o el depósito de paquetes especificado como el origen de los datos del paquete para la operación. Esta opción se puede especificar varias veces. El uso de -g implica el uso de -r.
Con -l, sólo se muestra la información de los paquetes instalados. Ésta es la opción predeterminada.
Con -r, puede confrontar los paquetes según las versiones más recientes disponibles, y recuperar información para paquetes no instalados actualmente (si es necesario) de los depósitos de los editores configurados de la imagen. Si se utiliza esta opción, se debe especificar al menos un paquete. Sin -r, sólo se muestran los paquetes instalados de manera predeterminada.
Con --license, puede mostrar los textos de las licencias de los paquetes. Esta opción se puede combinar con -l o -r.
Visualice el contenido (atributos de acción) de los paquetes. Sin operandos u opciones, visualice el valor del atributo path para las acciones instaladas en la imagen actual, ordenadas alfabéticamente por el valor del atributo. Para obtener información sobre las acciones y sus atributos, consulte "Acciones" en la página del comando man pkg(5). Consulte también la lista de nombres de pseudoatributos que aparece a continuación.
Con -a, puede limitar la salida a las acciones que tengan un atributo que aparezca en el argumento de opción con un valor que coincida con el modelo (glob) en el argumento de opción (a continuación del nombre de atributo con un signo igual). Si se proporcionan varias opciones -a, se muestran las acciones que coincidan con cualquiera de ellas.
Con -g, visualice información de paquetes que se pueden instalar en esta imagen desde el archivo o el repositorio de paquetes especificado. Los paquetes que se pueden instalar incluyen paquetes que están instalados actualmente y otros paquetes que cumplen los criterios para la instalación en esta imagen, como restricciones de facetas y variantes. Esta opción se puede especificar varias veces. El uso de -g implica el uso de -r.
Con -m, visualice todos los atributos de todas las acciones de los paquetes especificados, incluidas las acciones que no se pueden instalar en esta imagen.
Con -o, visualice los atributos enumerados, ordenados en función de los valores del primer atributo de la lista. La opción -o se puede especificar varias veces, o se pueden especificar varios atributos como argumento para una opción -o separando los nombres de atributo con comas. Sólo se muestran las acciones que tienen los atributos solicitados.
Con -r, visualice información de las versiones disponibles más nuevas de los paquetes que se pueden instalar en esta imagen desde los repositorios de los editores configurados en esta imagen. Los paquetes que se pueden instalar incluyen paquetes que están instalados actualmente y otros paquetes que cumplen los criterios para la instalación en esta imagen, como restricciones de facetas y variantes. Si se utiliza esta opción, se debe especificar al menos un paquete.
Con -s, puede ordenar las acciones según el atributo de acción especificado. Si no se especifica, de manera predeterminada se ordena por ruta o por el primer atributo especificado por la opción -o. La opción -s se puede especificar varias veces.
Con -t, sólo se muestran las acciones del tipo especificado. Se pueden especificar varios tipos en una lista separada por comas. Esta opción se puede especificar varias veces.
Con -H, puede omitir los encabezados de la lista.
Con pkg_fmri_pattern, visualice información solamente para los paquetes especificados.
Hay diversos nombres de pseudoatributos especiales disponibles para su comodidad:
El valor del hash de la acción si la acción lleva una carga útil.
El valor del atributo clave de la acción. Por ejemplo, para una acción file, el atributo clave es la ruta al archivo. Algunas acciones no tienen un atributo clave.
El nombre de la acción. Por ejemplo, para una acción de archivo, es file.
Todos los atributos de acciones coincidentes.
El FMRI completo del paquete que contiene la acción, como pkg://solaris/web/amp@0.5.11,5.11-0.169:20110705T153434Z.
El nombre del paquete que contiene la acción, como web/amp.
El editor del paquete que contiene la acción, como solaris.
La forma abreviada del FMRI del paquete que contiene la acción, como pkg://solaris/web/amp@0.5.11,5.11-0.169.
Los subcomandos contents y search se relacionan: ambos consultan al sistema el contenido de los paquetes. El subcomando contents muestra acciones en uno o más paquetes instalables o instalados, y filtra la salida en función de las opciones especificadas. El subcomando search encara la consulta desde la dirección contraria, y muestra los nombres de todos los paquetes que contienen un token proporcionado por el usuario.
Cada subcomando puede formular algunas consultas que el otro subcomando puede realizar. El subcomando se debe seleccionar cuidadosamente, ya que una consulta determinada se puede formular con mayor naturalidad en un subcomando que en el otro.
Permite buscar coincidencias con la consulta y mostrar los resultados. Los tokens que se indexan dependen de la acción, pero pueden incluir hashes de contenido y nombres de ruta. Para obtener información sobre las acciones y sus atributos, consulte "Acciones" en la página del comando man pkg(5). También consulte la lista de nombres de pseudoatributos en pkg contents arriba y en -o abajo.
De manera predeterminada, las consultas se interpretan como una serie de términos con los que se debe coincidir con exactitud. Los caracteres ? y * se pueden utilizar como comodines glob(3C), lo que permite más flexibilidad en las coincidencias de las consultas.
Con -H, se pueden omitir los encabezados.
Con -I, se pueden realizar búsquedas con distinción entre mayúsculas y minúsculas.
De manera predeterminada, y con -a, se puede realizar una búsqueda y mostrar la información de las acciones coincidentes.
De manera predeterminada, search elimina los resultados de los paquetes de versiones anteriores a la versión instalada actualmente y de paquetes de versiones excluidas por las incorporaciones actuales. Utilice -f para mostrar todos los resultados, independientemente de la versión del paquete.
Con -l, puede buscar los paquetes instalados de la imagen.
Con -o, se pueden controlar las columnas de los resultados. La opción -o se puede especificar varias veces, o se pueden especificar varios atributos como argumento para una opción -o separando los nombres de atributo con comas. Además de los pseudoatributos mencionados anteriormente, se definen los siguientes atributos para los resultados de la búsqueda:
Corresponde a la cadena que coincide con la consulta de búsqueda.
Corresponde al atributo que contiene la cadena que coincide con la consulta de búsqueda.
Con -p, puede mostrar los paquetes que tienen algunas acciones que coinciden con cada término de consulta. Utilizar esta opción es equivalente a colocar paréntesis angulares (<>) alrededor de cada término en la consulta. Consulte la información que aparece a continuación para obtener una descripción más detallada del operador <>.
De manera predeterminada, y con -r, puede buscar los depósitos correspondientes a los editores de la imagen.
Con -s, puede buscar el depósito pkg(5) ubicado en el URI proporcionado. Esta opción se puede especificar varias veces. No se admiten archivos de paquetes.
Ambos -l y -r (o -s) se pueden especificar juntos, en cuyo caso se realizan búsquedas tanto locales como remotas.
Además de la confrontación simple de tokens y la búsqueda con caracteres comodín, se admite un lenguaje de consulta más complicado. Se pueden buscar frases mediante comillas simples o dobles (' o "). Asegúrese de tener en cuenta el shell para que pkg vea realmente ' o ".
Se admite la búsqueda booleana con AND y OR. Se admiten las consultas de campo, o estructuradas. La sintaxis para ellas es nombre_paquete: tipo_acción:clave:token. Los campos vacíos implícitamente se llenan con caracteres comodín. Una búsqueda de :basename:pkg coincide con todos los tipos de acciones en todos los paquetes con una clave de basename y que coinciden con el token pkg. En los campos pkg_name y token se admiten caracteres comodín explícitos. Los campos action_type y key deben coincidir exactamente.
Para convertir acciones para los paquetes que contienen esas acciones, utilice <>. Con la opción -a, la búsqueda de token genera información sobre las acciones que coinciden con token, mientra que la búsqueda de <token> genera una lista de paquetes que contienen las acciones que coinciden con token.
Valida la instalación de paquetes en la imagen actual. Si la política de firmas actual para los editores relacionados no es ignore, las firmas de cada paquete se validan en función de la política. Consulte signature-policy en "Propiedades de la imagen" a continuación, para obtener una explicación de cómo se aplican las políticas de firmas.
Con -H, puede omitir los encabezados de la salida de la verificación.
Con -q, no puede imprimir nada, pero puede revertir el fallo si hay errores fatales.
Con -v, puede incluir mensajes informativos acerca de los paquetes.
Corrija los errores informados por pkg verify. La verificación del contenido de paquetes instalados se basa en un análisis de contenido personalizado que podría devolver resultados distintos de los de otros programas.
Con --accept, puede indicar que está de acuerdo con las condiciones de las licencias de los paquetes que está actualizando o instalando y que las acepta. Si no proporciona esta opción, y alguna licencia de paquete requiere aceptación, la operación fallará.
Con --licenses, puede mostrar todas las licencias de los paquetes que se instalarán o actualizarán como parte de esta operación.
Permite revertir la condición de los archivos a la condición de entrega. Se pueden revertir todos los archivos etiquetados con un valor determinado o archivos individuales. También se restauran las protecciones y la propiedad de archivo.
 | Precaución - La restitución de los valores predeterminados de algunos archivos editables puede provocar que el sistema no se pueda iniciar u otras fallas. |
Para todas las demás opciones, consulte el comando install anterior para ver el uso y sus efectos.
Permite mostrar la implementación y/o versión seleccionada actual de todos mediadores o, mediante argumentos, sólo los mediadores especificados.
Con -a, puede enumerar los mediaciones que se pueden definir para los paquetes instalados actualmente.
Con -F, puede especificar una formato de salida alternativo. Actualmente, sólo tsv (valores separados por tabulaciones) es válido.
Con -H, puede omitir los encabezados de la lista.
Permite establecer la versión y/o la implementación para los mediadores especificados en la imagen actual.
Con -I, puede establecer la implementación de la interfaz de mediación para utilizar. De manera predeterminada, si no se especifica ninguna versión, se permiten todas las versiones de implementación. Para especificar una implementación sin ninguna versión, agregue el símbolo arroba (@).
Con -V, puede establecer la versión de la interfaz de mediación para utilizar.
Si la implementación y/o la versión del mediador especificado no están disponibles actualmente, se eliminan todos los enlaces que utilizan los mediadores especificados.
Para todas las demás opciones, consulte el comando install anterior para ver el uso y sus efectos.
Permite revertir la versión y/o la implementación de los mediadores especificados a los valores predeterminados del sistema.
Con -I, puede revertir sólo la implementación la interfaz de mediación.
Con -V, puede revertir sólo la versión la interfaz de mediación.
Para todas las demás opciones, consulte el comando install anterior para ver el uso y sus efectos.
Sin argumentos, visualice los valores actuales de todas las variantes definidas en esta imagen. Con argumentos, visualice el valor de cada variant.variant_name especificada en esta imagen.
Con -H, puede omitir los encabezados de la lista.
Consulte "Facetas y variantes" en la página del comando man pkg(5) para obtener más información sobre las variantes.
Cambie los valores de las variantes especificadas en la imagen actual.
Para obtener información sobre el uso de la opción y sus efectos, consulte el comando install anterior.
El cambio del valor de una variante puede provocar que el contenido del paquete se elimine, actualice o instale. El cambio del valor de una variante también puede provocar que paquetes enteros se instalen, actualicen o eliminen para ajustarse a la configuración de la nueva imagen. Consulte "Facetas y variantes" en la página del comando man pkg(5) para obtener más información sobre las variantes.
Sin argumentos, visualice los valores actuales de todas las facetas que se han establecido explícitamente en esta imagen mediante el comando pkg change-facet. Con argumentos, visualice el valor de cada facet_name especificada en esta imagen.
Con -H, puede omitir los encabezados de la lista.
Consulte "Facetas y variantes" en la página del comando man pkg(5) para obtener más información sobre las facetas.
Cambie los valores de las facetas especificadas en la imagen actual.
Las facetas se pueden establecer en True o False. Si se establece una faceta en None, se aplica el valor predeterminado True a esa faceta; por lo tanto, se instalará cualquier acción sujeta a la faceta. Consulte "Acciones" en la página del comando man pkg(5) para obtener información sobre las acciones.
Para obtener información sobre el uso de la opción y sus efectos, consulte el comando install anterior.
El cambio del valor de una faceta puede provocar que el contenido del paquete se elimine, actualice o instale. El cambio del valor de una faceta también puede provocar que paquetes enteros se instalen, actualicen o eliminen para ajustarse a la configuración de la nueva imagen. Consulte "Facetas y variantes" en la página del comando man pkg(5) para obtener más información sobre las facetas.
Permite evitar los paquetes especificados si son el destino de una dependencia de grupo colocando los nombres de los paquetes que actualmente coinciden con los modelos especificados en la lista para evitar. Sólo se pueden evitar los paquetes que no están instalados actualmente. Si un paquete actualmente es el destino de una dependencia de grupo, su desinstalación lo coloca en la lista para evitar.
Sin argumentos, permite mostrar cada paquete evitado junto con cualquier paquete que tenga una dependencia de grupo en ese paquete.
Los paquetes incluidos en la lista para evitar se instalan, si es necesario, para satisfacer un dependencia necesaria. Si se elimina esa dependencia, se desinstala el paquete.
Permite eliminar los paquetes especificados de la lista para evitar. Los paquetes incluidos en la lista para evitar que coinciden con una dependencia de grupo de un paquete instalado no se pueden eliminar mediante este subcomando. Para eliminar un paquete que coincide con una dependencia de grupo de la lista para evitar, instale el paquete.
Sin argumentos, permite mostrar la lista de paquetes evitados.
Permite congelar los paquetes especificados para las versiones especificadas. Si no se proporciona ninguna versión, se debe instalar el paquete, y éste se congela en la versión instalada. Cando se instala o actualiza un paquete que está congelado, éste debe terminar en una versión que coincida con la versión en la que fue congelado. Por ejemplo, si un paquete se congeló en 1.2, se podría actualizar a 1.2.1, 1.2.9, 1.2.0.0.1, etc. Ese paquete no podría terminar en 1.3 ni 1.1. Un editor especificado en pkg_fmri_pattern se utiliza para buscar paquetes coincidentes. Sin embargo, la información del editor no se registra como parte de la congelación. Un paquete se inmoviliza con respecto a su versión únicamente, no a su editor. La congelación de un paquete que ya está congelado sustituye la versión congelada por la nueva versión especificada.
Si no se proporcionan paquetes, se muestra la información sobre los paquetes congelados actualmente: nombres de paquete, versiones, cuándo se congeló el paquete y los motivos relacionados.
La congelación de un paquete no impide la eliminación del paquete. Si se elimina el paquete, no aparece ningún mensaje de advertencia.
Con -c, puede registrar el motivo en los paquetes congelados. El motivo se muestra si una congelación impide que se lleve a cabo una instalación o actualización.
Con -n, puede efectuar una ejecución de prueba de la operación, y mostrar la lista de paquetes que se congelarían sin congelar ningún paquete.
Permite eliminar las limitaciones que impone la congelación de los paquetes especificados. Se ignoran las versiones proporcionadas.
Con -n, puede efectuar una ejecución de prueba de la descongelación, y mostrar la lista de paquetes que se descongelarían sin descongelar ningún paquete.
Permite mostrar la información de propiedad de la imagen. Sin argumentos, permite mostrar los nombres y los valores de todas las propiedades de la imagen. Si se solicita una lista específica de los nombres de propiedades, permite mostrar los nombres y los valores de dichas propiedades. Consulte “Propiedades de la imagen" que aparece a continuación para obtener descripciones de las propiedades de una imagen.
Con -H, puede omitir los encabezados de la lista.
Permite actualizar una propiedad de imagen existente o agregar una propiedad de imagen nueva.
Permite agregar un valor a una propiedad de imagen existente o agregar una propiedad de imagen nueva.
Permite eliminar un valor de una propiedad de imagen existente.
Permite eliminar una propiedad de imagen existente, o varias.
Permite mostrar información del editor. Sin argumentos, permite mostrar la lista de todos los editores, los reflejos y los URI de origen en orden de preferencia de búsqueda. Si se solicitan editores específicos, permite mostrar la configuración detallada de esos editores.
Con -H, puede omitir los encabezados de la lista.
Con -P, puede mostrar sólo el primer editor en el orden de búsqueda de editor.
Con -n, puede mostrar sólo los editores habilitados.
Permite actualizar un editor existente o agregar un editor de paquete. Si no se especifican opciones que afectan el orden de búsqueda , se agregan editores nuevos al orden de búsqueda y, por tanto, se buscan en último lugar.
Con -P o --search-first, puede establecer el editor especificado en primer lugar en el orden de búsqueda. Cuando se instalen paquetes nuevos, este editor se buscará en primer lugar. Las actualizaciones de los paquetes ya instalados provienen del mismo editor que suministró el paquete originalmente, siempre que este editor sea permanente. Cuando se utiliza -P o --search-first con -p, únicamente los editores agregados se colocan en primer lugar en el orden de búsqueda.
Con --non-sticky, puede especificar que los editores con clasificación superior a la del editor actual pueden proporcionar actualizaciones para los paquetes originalmente instalados desde el editor actual.
Con --sticky, puede especificar que las actualizaciones de los paquetes que se instalaron desde este editor también deben provenir de este editor. Éste es el comportamiento predeterminado.
Con --search-before, puede modificar el orden de búsqueda de editor para que el editor que se va a modificar se busque antes que el editor especificado. Cuando se utiliza con -p, --search-before sólo se aplica a los editores agregados.
Con --search-after, puede modificar el orden de búsqueda de editor para que el editor que se va a modificar se busque después que el editor especificado. Cuando se utiliza con -p, --search-after sólo se aplica a los editores agregados.
Con --approve-ca-cert, puede agregar el certificado proporcionado como un certificado de CA que es de confianza. Los hashes de la representación PEM de los certificados de CA aprobados por el usuario aparecen en la salida detallada del comando pkg publisher.
Con --revoke-ca-cert, puede tratar el certificado con un hash determinado de su representación PEM como revocado. Los hashes de los certificados de CA revocados por el usuario aparecen en la salida detallada del comando pkg publisher.
Con --unset-ca-cert, puede eliminar el certificado con el hash determinado de la lista de certificados aprobados y de la lista de certificados revocados.
Con --set-property, puede actualizar una propiedad de editor existente o agregar una propiedad de editor nueva.
Con --add-property-value, puede agregar un valor a una propiedad de editor existente o agregar una propiedad de editor nueva.
Con --remove-property-value, puede eliminar un valor de una propiedad de editor existente.
Con --unset-property, puede eliminar una propiedad de editor existente.
Con -c y -k, puede especificar un certificado y una clave SSL de cliente respectivamente.
Con -g (--add-origin), puede agregar la ruta o el URI especificado como origen del editor determinado. Esta debe ser la ubicación de un archivo o depósito de paquetes.
Con -G (--remove-origin), puede eliminar la ruta o el URI de la lista de orígenes del editor determinado. El valor especial * se puede utilizar para eliminar todos los orígenes.
Con --no-refresh, no intente contactar con los depósitos de los editores de la imagen para recuperar la lista más reciente de paquetes disponibles y otros metadatos.
Con --reset-uuid, puede seleccionar un nuevo identificador único que identifique esta imagen con su editor.
Con -m (--add-mirror), puede agregar el URI como un reflejo del editor determinado.
Con -M (--remove-mirror), puede eliminar el URI de la lista de reflejos de un editor determinado. El valor especial * se puede utilizar para eliminar todos los reflejos.
Con -p, puede recuperar la información de configuración del editor desde el URI del depósito especificado. Si se especifica un editor, sólo se agrega o actualiza el editor coincidente. Si no se especifica ningún editor, se agregan o actualizan todos los editores según corresponda. Esta opción no se puede combinar con las opciones -g, --add-origin, --G, --remove-origin, -m, --add-mirror, - M, --remove-mirror, --disable, --enable , --no-refresh, ni --reset-uuid.
Con -e (--enable), puede habilitar el editor. Con -d (--disable), puede deshabilitar el editor. Un editor deshabilitado no se utiliza para completar la lista de paquetes o ni para determinadas operaciones de paquetes (instalación, desinstalación y actualización). Sin embargo, las propiedades de un editor deshabilitado se pueden configurar y ver. Si existe sólo un editor, éste no se puede deshabilitar.
Con -p, puede recuperar la información de configuración del editor desde el URI del depósito especificado. Si se especifica un editor, sólo se agrega o actualiza el editor coincidente. Si no se especifica ningún editor, se agregan o actualizan todos los editores según corresponda. Consulte pkg set-publisher arriba para obtener descripciones de otras opciones que se pueden utilizar con la opción -p. La opción -p no se puede combinar con las opciones -g, --add-origin, -G, --remove-origin, -m, --add-mirror, -M, --remove-mirror, --disable, --enable, --no-refresh o --reset-uuid.
Permite eliminar la configuración asociada al editor determinado.
Permite mostrar el historial de comandos. de la imagen aplicable.
Con -H, puede omitir los encabezados de la lista.
Con -t, puede mostrar registros para una lista separada por comas de indicadores de fecha y hora, con el formato %Y-%m-%dT%H:%M:%S (consulte strftime(3C)). Para especificar un rango de fecha y hora, utilice un guión ( -) entre el indicador de fecha y hora de inicio y el de finalización. La palabra clave now se puede utilizar como un alias para la fecha y hora actual. Si los indicadores de fecha y hora especificados contienen indicadores de fecha y hora duplicados o rangos de fechas superpuestos, sólo se imprimirá una única instancia de cada evento de historial duplicado.
Con -l, puede mostrar registros en formato largo, que, además de lo incluido en el formato estándar, incluyen el resultado del comando, la hora en la que se completó el comando, la versión y el nombre del cliente utilizado, el nombre del usuario que realizó la operación y los errores detectados durante la ejecución del comando.
Con -n, puede mostrar sólo el número especificado de entradas más recientes.
Con -o, puede mostrar la salida utilizando la lista especificada de nombres de columna separados por comas. Los nombres de columna válidos son:
El nombre del entorno de inicio en el que se inició esta operación.
El uuid del entorno de inicio en el que se inició esta operación.
El nombre del cliente.
La versión del cliente.
La línea de comandos utilizada para esta operación.
La fecha y hora en que finalizó esta operación.
El identificador de usuario que inició esta operación.
El entorno de inicio nuevo creado por esta operación.
El uuid del entorno de inicio nuevo creado por esta operación.
El nombre de la operación.
Un resumen del resultado de esta operación.
Información adicional sobre el resultado de esta operación.
La instantánea tomada durante esta operación. Ésta se registra solamente si la instantánea no se eliminó automáticamente después de la finalización correcta de la operación.
La fecha y hora en que se inició esta operación.
Tiempo total que llevó realizar esta operación. Para las operaciones que llevan menos de un segundo, se muestra 0:00:00.
El nombre del usuario que inició esta operación.
Si se especifican las columnas command o reason, deben ser el último elemento de la lista de -o, a fin de conservar separación de campo de salida. Estas dos columnas no se pueden mostrar en el mismo comando history.
Aparece un asterisco (*) después los valores para be o new_be, si el entorno de inicio ya no está presente en el sistema.
Los valores de be y new_be se obtienen consultando el nombre del entorno de inicio actual, utilizando los campos be_uuid o new_be_uuid. Si posteriormente el entorno de inicio cambia de nombre y, después, se suprime, los valores que aparecerán para be y new_be serán los valores registrados en el momento de la operación pkg.
Permite suprimir la información de todo el historial existente.
Permite volver a generar el índice utilizado por pkg search. Se trata de una operación de recuperación que no está pensada para uso general.
Permite actualizar el formato de la imagen a la versión actual. Una vez finalizada esta operación, la imagen ya no se podrá utilizar con versiones anteriores del sistema pkg(5).
Permite mostrar una cadena única que identifica la versión de pkg(1). No se garantiza que esta cadena sea comparable de ninguna manera entre versiones.
Permite crear una imagen adecuada para operaciones de paquetes en la ubicación determinada por directorio. El tipo de imagen predeterminado es usuario, según lo establecido por la opción -U (--user). El tipo de imagen se puede establecer en una imagen completa (--F o --full) o en una imagen parcial (-P o --partial) enlazada a la imagen completa que abarca la ruta de directorio. Se pueden especificar orígenes adicionales mediante -g u --origin. Se pueden especificar reflejos adicionales mediante --m o --mirror.
Se debe proporcionar un URI de depósito de paquetes mediante la opción -p o - -publisher. Si también se proporciona un nombre de editor, al crear la imagen sólo se agregará dicho editor. Si no se proporciona un nombre de editor, todos los editores conocidos por el depósito especificado se agregarán a la imagen. Después de las operaciones iniciales de creación, se realiza un intento para recuperar el catálogo asociado a este editor.
Para los editores que utilizan la autenticación SSL de cliente, se puede registrar una clave de cliente y un certificado de cliente mediante las opciones -c y -k. Esta clave y este certificado se utilizan para todos los editores agregados durante la creación de la imagen.
Si la imagen se ejecutará en un contexto de zona no global, se puede utilizar la opción -z (--zone) para definir una variante adecuada.
Con -f (--force), puede forzar la creación de una imagen respecto de una imagen existente. Esta opción se debe utilizar con cuidado.
Con --no-refresh, no intente contactar con los depósitos de los editores de la imagen para recuperar la lista más reciente de paquetes disponibles y otros metadatos.
Con --variant, puede establecer la variante especificada en el valor indicado. Consulte "Facetas y variantes" en la página del comando man pkg(5) para obtener más información sobre las variantes.
Con --facet, puede establecer la faceta especificada en el valor indicado. Consulte "Facetas y variantes" en la página del comando man pkg(5) para obtener más información sobre las facetas.
Con --set-property, establezca la propiedad de la imagen especificada en el valor indicado. Consulte "Propiedades de la imagen" a continuación para obtener descripciones de las propiedades de una imagen.
Las siguientes propiedades definen las características de la imagen. Estas propiedades almacenan información sobre la finalidad, el contenido y el comportamiento de la imagen. Para ver los valores actuales de estas propiedades en la imagen, use el comando pkg property. Para modificar los valores de estas propiedades, use los comandos pkg set-property y pkg unset-property.
(Cadena). Permite especificar cuándo se crea un entorno de inicio durante las operaciones de empaquetado. Se admiten los siguientes valores:
Permite aplicar la política de creación de entorno de inicio predeterminado, create-backup.
Requiere reiniciar todas las operaciones de paquetes en un nuevo entorno de inicio establecido como habilitado en el siguiente inicio. La copia de seguridad del entorno de inicio no se crea a menos que se solicite de manera explícita.
Esta política es la más segura, pero es más estricta de lo que necesitan la mayoría de sitios, ya que no se pueden agregar paquetes sin reiniciar.
Para las operaciones de paquetes que requieren un reinicio, se crea un entorno de inicio nuevo que se define como activo en el inicio siguiente. Si se modifican los paquetes o se instala contenido que puede afectar el núcleo y la operación afecta el entorno de inicio activo, se crea una copia de seguridad del entorno de inicio pero no se establece como activa. La copia de seguridad de un entorno de inicio también se puede solicitar de manera explícita.
Esta política puede ser riesgosa sólo si el software recién instalado provoca inestabilidad del sistema, lo cual es posible, pero relativamente raro.
Para las operaciones de paquetes que requieren un reinicio, se crea un entorno de inicio nuevo que se define como activo en el inicio siguiente. La copia de seguridad del entorno de inicio no se crea a menos que se solicite de manera explícita.
Esta política es la más riesgosa, ya que si un cambio de empaquetado en el entorno de inicio activo imposibilita la realización de otros cambios, es posible que no haya ningún entorno de inicio reciente con el que se pueda contar.
(Cadena). Un nombre de ruta que apunta a un directorio donde se conservan los certificados de CA para operaciones SSL. El formato de este directorio es específico de la implementación SSL subyacente. Para utilizar una ubicación alternativa para los certificados de CA de confianza, cambie este valor para apuntar a un directorio diferente. Consulte las partes CApath de SSL_CTX_load_verify_locations(3openssl) para los requisitos del directorio de CA.
Valor predeterminado: /etc/openssl/certs
(Booleano). Si se define en True, el cliente del paquete intenta contactar a alguno de los puntos de distribución de CRL en los certificados utilizados para la verificación de firmas con el fin de determinar si el certificado se ha revocado desde que se emitió.
Valor predeterminado: False
(Booleano). Si se define en True, el cliente del paquete elimina los archivos de la antememoria del contenido cuando las operaciones de instalación o actualización se completan. En las operaciones de actualización, el contenido se elimina sólo del entorno de inicio de origen. Cuando se produce la siguiente operación de empaquetado en el entorno de inicio de destino, el cliente de paquete vacía su antememoria de contenido si esta opción no se ha cambiado.
Esta propiedad se puede utilizar para mantener una antememoria de contenido pequeña en los sistemas con espacio limitado en disco. Esta propiedad puede provocar que se demore la finalización de las operaciones.
Valor predeterminado: True
(Booleano). Esta propiedad indica al cliente que detecte reflejos de contenido local enlazado mediante mDNS y DNS-SD. Si esta propiedad se define en True, el cliente intenta descargar contenido de paquetes de reflejos que detecta de forma dinámica. Para ejecutar un reflejo que anuncia su contenido por medio de mDNS, consulte pkg.depotd(1M).
Valor predeterminado: False
(Booleano). Permite enviar el identificador único universal (UUID) de la imagen cuando se realizan operaciones de red. Si bien los usuarios pueden deshabilitar esta opción, es posible que algunos depósitos de red rechacen la comunicación con los clientes que no proporcionan un UUID.
Valor predeterminado: True
(Cadena). Permite determinar qué controles se realizarán en los manifiestos al instalar, actualizar, modificar o verificar los paquetes de la imagen. La política final que se aplica a un paquete depende de la combinación de política de imagen y política de editor. La combinación será, como mínimo, tan estricta como la más estricta de las dos políticas tomadas individualmente. De manera predeterminada, el cliente de paquete no comprueba si los certificados han sido revocados. Para activar dichas comprobaciones, que pueden requerir que el cliente contacte sitios web externos, establezca la propiedad de la imagen check-certificate-revocation en True. Se admiten los siguientes valores:
Omite firmas para todos los manifiestos.
Verifica que todos los manifiestos con firmas estén firmados de manera válida, pero no requiere que todos los paquetes instalados estén firmados. Éste es el valor predeterminado.
Requiere que todos los paquetes recién instalados tengan al menos una firma válida. Los comandos pkg fix y pkg verify también advierten si un paquete instalado no tiene una firma válida.
Tiene los mismos requisitos que require-signatures pero también requiere que las cadenas que aparecen en la propiedad signature-required-names aparezcan como un nombre común de los certificados utilizados para verificar las cadenas de confianza de las firmas.
(Lista de cadenas). Una lista de nombres que se deben ver como nombres comunes de certificados durante la validación de firmas de un paquete.
(Cadena). El nombre de la ruta del directorio que contiene los anclajes de confianza de la imagen. Esta ruta es relativa a la imagen. El valor predeterminado es ignore.
(Booleano). Esta propiedad indica si la imagen debe utilizar el depósito del sistema como origen para la configuración de la imagen y el editor, y como proxy para comunicarse con los editores proporcionados. El valor predeterminado es False. Consulte pkg.sysrepo(1M) para obtener información sobre los depósitos del sistema.
Las siguientes propiedades definen la política de firmas de un editor particular. Las propiedades de la imagen del mismo nombre definen la política de firmas de la imagen. Para ver los valores actuales de las propiedades de un editor particular, use el comando pkg publisherpublisher_name. Para modificar los valores de las propiedades de la política de firmas del editor, use las opciones --set-property y --unset-property del comando pkg set-publisher.
(Cadena). Esta propiedad funciona de la misma manera que la propiedad de imagen del mismo nombre, con la excepción de que sólo se aplica a los paquetes del editor determinado.
(Lista de cadenas). Esta propiedad funciona de la misma manera que la propiedad de imagen del mismo nombre, con la excepción de que sólo se aplica a los paquetes del editor determinado.
Ejemplo 1 Creación de una imagen con un editor configurado
Cree una imagen completa nueva con el editor example.com, almacenado en /aux0/example_root.
$ pkg image-create -F -p example.com=http://pkg.example.com:10000 \ /aux0/example_root
Ejemplo 2 Creación de una imagen especificando reflejos y orígenes adicionales
Cree una imagen completa nueva con el editor example.com que también tiene un reflejo adicional y dos orígenes adicionales, y está almacenado en /aux0/example_root.
$ pkg image-create -F -p example.com=http://pkg.example.com:10000 \ -g http://alternate1.example.com:10000/ \ -g http://alternate2.example.com:10000/ \ -m http://mirror.example.com:10000/ \ /aux0/example_root
Ejemplo 3 Creación de una imagen sin un editor configurado
Cree una imagen completa nueva sin editores configurados en /aux0/example_root.
$ pkg image-create -F /aux0/example_root
Ejemplo 4 Instalar un paquete
Instale la última versión del paquete widget en la imagen actual.
$ pkg install application/widget
Ejemplo 5 Visualización del contenido especificado de un paquete
Visualice el contenido del paquete system/file-system/zfs. Muestre el nombre de la acción, el modo del archivo (si se ha definido), el tamaño (si se ha definido), la ruta y el destino (si es un enlace). Limite la acción a los tipos dir, file, link y hardlink, ya que al especificar el atributo action.name, que está disponible para todas las acciones, se muestra una línea para todas las acciones, y no es lo que se desea aquí.
$ pkg contents -t dir,file,link,hardlink \ -o action.name,mode,pkg.size,path,target system/file-system/zfs ACTION.NAME MODE PKG.SIZE PATH TARGET dir 0755 etc dir 0755 etc/fs dir 0755 etc/fs/zfs link etc/fs/zfs/mount ../../../usr/sbin/zfs link etc/fs/zfs/umount ../../../usr/sbin/zfs dir 0755 etc/zfs dir 0755 kernel dir 0755 kernel/drv dir 0755 kernel/drv/amd64 file 0755 1706744 kernel/drv/amd64/zfs file 0644 980 kernel/drv/zfs.conf dir 0755 kernel/fs dir 0755 kernel/fs/amd64 hardlink kernel/fs/amd64/zfs ../../../kernel/drv/amd64/zfs ...
Ejemplo 6 Visualización del contenido especificado de dos paquetes
Visualice el contenido de web/browser/firefox y mail/thunderbird, y limite la visualización sólo a los atributos de ruta y nombre de paquete de las acciones cuyo atributo path termine en .desktop o .png.
$ pkg contents -o pkg.name,path -a path=\*.desktop \ -a path=\*.png web/browser/firefox mail/thunderbird PKG.NAME PATH web/browser/firefox usr/share/applications/firefox.desktop mail/thunderbird usr/share/applications/thunderbird.desktop web/browser/firefox usr/share/pixmaps/firefox-icon.png mail/thunderbird usr/share/pixmaps/thunderbird-icon.png ...
Ejemplo 7 Buscar un paquete
Busque la base de datos de paquetes para el token bge.
$ pkg search bge INDEX ACTION VALUE PACKAGE driver_name driver bge pkg:/driver/network/bge@0.5.11-0.169 basename file kernel/drv/sparcv9/bge pkg:/driver/network/bge@0.5.11-0.169 basename file kernel/drv/amd64/bge pkg:/driver/network/bge@0.5.11-0.169 pkg.fmri set solaris/driver/network/bge pkg:/driver/network/bge@0.5.11-0.169
El token está en el paquete driver/network/bge como el nombre de base de la acción de archivo que representa /kernel/drv,10x,/ arch/bge y como un nombre de controlador.
Ejemplo 8 Búsqueda de paquetes que dependen del paquete especificado
Busque los paquetes instalados que dependen de package/pkg.
$ pkg search -l 'depend::package/pkg' INDEX ACTION VALUE PACKAGE incorporate depend package/pkg@0.5.11-0.169 pkg:/consolidation/ips/ips-incorporation@0.5.11-0.169 require depend package/pkg@0.5.11-0.169 pkg:/system/install@0.5.11-0.169 require depend package/pkg@0.5.11-0.169 pkg:/package/pkg/system-repository@0.5.11-0.169
Ejemplo 9 Búsqueda de dependencias
Busque todas las dependencias de incorporate en los paquetes instalados.
$ pkg search -l 'depend:incorporate:' INDEX ACTION VALUE PACKAGE incorporate depend pkg:/BRCMbnx@0.5.11,5.11-0.133 pkg:/consolidation/osnet/osnet-incorporation@0.5.11-0.169 incorporate depend pkg:/BRCMbnxe@0.5.11,5.11-0.133 pkg:/consolidation/osnet/osnet-incorporation@0.5.11-0.169 ...
Ejemplo 10 Adición de un editor
Agregue un nuevo editor example.com, con un depósito ubicado en Http://www.example.com/repo.
$ pkg set-publisher -g http://www.example.com/repo example.com
Ejemplo 11 Adición de un editor con clave y certificado
Agregue un nuevo editor example.com, con un depósito seguro ubicado en https://secure.example.com/repo, y una clave y un certificado almacenados en el directorio /root/creds.
$ pkg set-publisher -k /root/creds/example.key \ -c /root/creds/example.cert -g https://secure.example.com/repo \ example.com
Ejemplo 12 Adición y configuración automática de un editor
Agregue un nuevo editor con un depósito ubicado en /export/repo mediante la configuración automática.
$ pkg set-publisher -p /export/repo
Ejemplo 13 Adición y configuración manual de un editor
Agregue un nuevo editor example.com con un depósito ubicado en /export/repo/example.com mediante la configuración manual.
$ pkg set-publisher -g /export/repo example.com
Ejemplo 14 Verificación de todos los paquetes firmados
Configure una imagen para verificar todos paquetes firmados.
$ pkg set-property signature-policy verify
Ejemplo 15 Requerimiento de que todos los paquetes estén firmados
Configure una imagen para requerir que todos los paquetes estén firmados y solicite que la cadena example.com se vea como un nombre común para uno de los certificados de la cadena de confianza.
$ pkg set-property signature-policy require-names example.com
Ejemplo 16 Requerimiento de que todos los paquetes de un editor especificado estén firmados
Configure una imagen para que todos los paquetes instalados desde el editor example.com deban estar firmados.
$ pkg set-publisher --set-property signature-policy=require-signatures \ example.com
Ejemplo 17 Requerimiento de una cadena especificada en la cadena de confianza
Agregue la cadena foo a la lista de nombres comunes de la imagen que se deben ver en una cadena de confianza de firma para que se considere válida.
$ pkg add-property-value signature-require-names foo
Ejemplo 18 Eliminación de una cadena de la cadena de confianza para un editor especificado
Elimine la cadena foo de la lista de nombres comunes que se deben ver para validar una firma para el editor example.com.
$ pkg set-publisher --remove-property-value signature-require-names=foo \ example.com
Ejemplo 19 Adición de un certificado de CA de confianza
Agregue el certificado almacenado en /tmp/example_file.pem como certificado de CA de confianza para el editor example.com.
$ pkg set-publisher --approve-ca-cert /tmp/example_file.pem \ example.com
Ejemplo 20 Revocación de un certificado
Revoque el certificado con el hash a12345 del editor example.com e impida que el certificado valide firmas de los paquetes de example.com.
$ pkg set-publisher --revoke-ca-cert a12345 example.com
Ejemplo 21 Olvido de un certificado
Haga que pkg olvide que el certificado a12345 ha sido agregado o revocado por el usuario.
$ pkg set-publisher --unset-ca-cert a12345 example.com
Ejemplo 22 Actualización de un paquete a una versión anterior
Actualice el paquete instalado foo@1.1 a una versión anterior.
$ pkg update foo@1.0
Ejemplo 23 Cambio de instalación de paquete en conflicto
En el caso de dos paquetes en conflicto, cambie uno de los paquetes que se están instalando. Supongamos que el paquete A depende del paquete B o el paquete C, y B y C se excluyen mutuamente. Si instala A y B, utilice el siguiente comando para pasar a usar C en lugar de B sin desinstalar A:
$ pkg install --reject B C
Ejemplo 24 Visualización de paquetes de un archivo de paquetes
Visualice todas las versiones de todos los paquetes de un archivo de paquetes.
$ pkg list -f -g /my/archive.p5p
Ejemplo 25 Visualización de paquetes de un depósito de paquetes
Visualice todas las versiones de todos los paquetes de un depósito.
$ pkg list -f -g http://example.com:10000
Ejemplo 26 Visualización de información sobre un paquete de un archivo de paquetes
Visualice la información del paquete para ver la versión más reciente de un paquete de un archivo de paquetes. El paquete puede estar instalado actualmente o no.
$ pkg info -g /my/archive.p5p pkg_name
Ejemplo 27 Visualización del contenido de un paquete de un archivo de paquetes
Visualice el contenido de un paquete de un archivo de paquetes. El paquete no está instalado actualmente.
$ pkg contents -g /my/archive.p5p pkg_name
Ejemplo 28 Eliminación de todos los reflejos y orígenes de un editor
Elimine todos los reflejos y orígenes de un editor y agregue un nuevo origen.
$ pkg set-publisher -G '*' -M '*' -g http://example.com:10000 \ example.com
El directorio que contiene la imagen que se va a utilizar para las operaciones de paquetes. Si se especifica -R, se omite.
Los segundos que se debe esperar para la conexión durante las operaciones de transporte (para cada intento) antes de que el cliente anule la operación. Un valor de 0 significa que espere de manera indefinida.
Valor predeterminado: 60
La cantidad de segundos inferior al límite lowspeed (1024 bytes/s) que deben transcurrir durante las operaciones de transporte antes de que el cliente anule la operación. Un valor de 0 significa que no cancele la operación.
Valor predeterminado: 30
El número máximo de errores temporales de transporte que se pueden producir antes de que el cliente anule la operación. Un valor de 0 significa que no cancele la operación.
Valor predeterminado: 4
El número máximo de redireccionamientos de HTTPS o HTTP permitidos durante las operaciones de transporte antes de que se anule una conexión. Un valor de 0 significa que no cancele la operación.
Valor predeterminado: 5
El número máximo de intentos de transporte por host antes de que el cliente anule la operación. Un valor de 0 significa que no cancele la operación.
Valor predeterminado: 4
Servidor proxy HTTP o HTTPS.
Se devolvieron los siguientes valores de salida:
El comando se ejecutó correctamente.
Se produjo un error.
Se especificaron opciones de línea de comandos no válidas.
Se solicitaron varias operaciones, pero sólo algunas se realizaron correctamente.
No se realizaron cambios, no se requiere ninguna acción.
La operación solicitada no se puede realizar en una imagen activa.
La operación solicitada no se puede finalizar debido a que las licencias de los paquetes que se están instalando o actualizando no han sido aceptadas.
La imagen actualmente se está utilizando en otro proceso y no se puede modificar.
Se produjo una excepción no anticipada.
Se puede ubicar una imagen pkg(5) arbitrariamente en un sistema de archivos más grande. En las siguientes descripciones de archivo, el token $IMAGE_ROOT se utiliza para distinguir rutas relacionadas Para una instalación de sistema típica, $IMAGE_ROOT es equivalente a /
Directorio de metadatos para una imagen completa o parcial.
Directorio de metadatos para una imagen de usuario.
Dentro de los metadatos de una imagen determinada, algunos archivos y directorios pueden contener información útil durante la reparación y la recuperación. El token $IMAGE_META hace referencia al directorio de nivel superior que contiene los metadatos. $IMAGE_META generalmente es una de las dos rutas especificadas anteriormente.
Ubicación de los archivos y directorios conflictivos movidos durante una operación de paquetes. Ubicación del contenido desempaquetado de un directorio eliminado.
Contiene un directorio para cada editor. Cada directorio almacena los metadatos específicos de un editor.
Otras rutas dentro de la jerarquía de directorios de $IMAGE_META son privadas y están sujetas a cambios.
Consulte attributes(5) para ver descripciones de los atributos siguientes:
|
pkgsend(1), pkg.depotd(1m), glob(3C), pkg(5), beadm(1M)
http://hub.opensolaris.org/bin/view/Project+pkg/
|