JavaScript is required to for searching.
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)
search filter icon
search icon

Información del documento

Prefacio

Comandos de usuario

packagemanager(1)

pkg(1)

pkgdepend(1)

pkgdiff(1)

pkgfmt(1)

pkglint(1)

pkgmerge(1)

pkgmogrify(1)

pkgrecv(1)

pkgrepo(1)

pkgsend(1)

pkgsign(1)

pm-updatemanager(1)

Comandos de administración del sistema

Estándares, entornos y macros

pkgrepo

- utilidad de gestión de depósitos de Image Packaging System

Sinopsis

/usr/bin/pkgrepo create [--version ver] uri_o_ruta
/usr/bin/pkgrepo add-publisher -s uri_o_ruta_dep editor ...
/usr/bin/pkgrepo get [-F formato] [-p editor ...]
    -s uri_o_ruta_dep [sección/propiedad ...]
/usr/bin/pkgrepo info [-F formato] [-H] [-p editor ...]
    -s uri_o_ruta_dep
/usr/bin/pkgrepo list [-F formato] [-H] [-p editor ...]
    -s uri_o_ruta_dep [mod_ID rec ges err_paq ...]
/usr/bin/pkgrepo rebuild [-p editor ...]
    -s uri_o_ruta_dep [--no-catalog] [--no-index]
/usr/bin/pkgrepo refresh [-p editor ...]
    -s uri_o_ruta_dep [--no-catalog] [--no-index]
/usr/bin/pkgrepo remove [-n] [-p editor ...]
    -s uri_o_ruta_dep mod_ID rec ges err_paq ...
/usr/bin/pkgrepo set [-p editor] -s uri_o_ruta_dep
    sección/propiedad=[valor] ... or
    sección/propiedad=([valor]) ...
/usr/bin/pkgrepo help
/usr/bin/pkgrepo version

Descripción

pkgrepo ofrece la posibilidad de crear y gestionar depósitos de paquetes pkg(5). Los depósitos de paquetes son un conjunto predefinido de directorios y archivos que permiten el almacenamiento y la recuperación de los datos de los paquetes mediante pkg(1) y clientes de publicación, como pkgsend (1) o pkgrecv(1). Además, cuando se necesita acceso basado en red a un depósito de paquetes, pkg.depotd(1m) puede ofrecer a los clientes acceso al depósito para almacenar y/o recuperar los datos de los paquetes.

Opciones

Se admiten las siguientes opciones:

--help o -?

Muestra un mensaje de uso.

Subcomandos

Se admiten los subcomandos siguientes:

create [--version ver] uri_o_ruta

Crea un depósito pkg(5) en la ubicación especificada.

Este subcomando se puede utilizar sólo con depósitos basados en sistemas de archivos.

Con --version, puede crear un depósito en un formato compatible con la versión especificada. De manera predeterminada, se crean depósitos de versión 4. Las versiones admitidas son:

3

Admite el almacenamiento de paquetes para un único editor, la versión de catálogo 1 y la versión de búsqueda 1.

4

Admite el almacenamiento de paquetes para múltiples editores, la versión de catálogo 1 y la versión de búsqueda 1.

add-publisher -s uri_o_ruta_dep editor ...

Agrega los editores especificados al depósito. Los editores nuevos no tienen paquetes ni contenido.

Este subcomando se puede utilizar sólo con depósitos basados en sistemas de archivos versión 4.

get [-F formato] [-p editor ...] -s uri_o_ruta_dep [sección/propiedad ...]

Muestra la información de propiedad para el depósito o sus editores.

De manera predeterminada, cada propiedad y su valor se imprimen en líneas diferentes. Los valores de cadena ASCII vacíos están representados por un par de comillas dobles (""). Los siguientes metacaracteres de shell Bourne, y nueva línea, espacio y tabulación, en los valores de cadena ASCII deben llevar el carácter de escape de la barra diagonal inversa (\):

; & ( ) | ^ < > \ " ' `

Consulte la sección “Ejemplos”.

Para obtener una lista de las propiedades posibles, y el objetivo y el valor de cada propiedad, consulte el subcomando set a continuación.

Con -F, puede especificar una formato de salida alternativo. El valor de formato puede ser tsv (valores separados por tabuladores), json (JavaScript Object Notation, como una sola línea) o json-formatted (JavaScript Object Notation, en formato para mejorar la legibilidad).

Con -H, puede omitir los encabezados de la lista.

Con -p, puede mostrar la información de las propiedades del editor determinado. El valor especial all muestra las propiedades de todos los editores. Esta opción se puede especificar varias veces.

Con -s, puede realizar operaciones en el depósito ubicado en la ruta del sistema de archivos o el URI determinados.

info [-F formato] [-H] [-p editor ...] - s uri_o_ruta_dep

Muestra una lista de los editores de paquetes conocidos por el depósito. La lista incluye el número de paquetes para cada editor, cuándo se actualizaron por última vez los datos de los paquetes del editor y el estado de los datos de los paquetes del editor (por ejemplo, si se están procesando en ese momento).

Con -F, puede especificar una formato de salida alternativo. El valor de formato puede ser tsv (valores separados por tabuladores), json (JavaScript Object Notation, como una sola línea) o json-formatted (JavaScript Object Notation, en formato para mejorar la legibilidad).

Con -H, puede omitir los encabezados de la lista.

Con -p, sólo puede mostrar los datos del editor determinado. Si no se proporciona, se muestran los datos de todos los editores. Esta opción se puede especificar varias veces.

Con -s, puede realizar operaciones en el depósito ubicado en la ruta del sistema de archivos o el URI determinados.

list [-F formato] [-H] [-p editor ...] - s uri_o_ruta_dep [mod_ID rec ges err_paq ...]

Muestra los paquetes del depósito uri_o_ruta_dep que coinciden con los modelos especificados mod_ID rec ges err_paq. Si no se especifica ningún modelo, se muestran todos los paquetes del depósito.

En la salida predeterminada, la primera columna contiene el nombre del editor del paquete. La segunda columna contiene el nombre del paquete. La tercera columna es un indicador que muestra el estado del paquete. El valor o en la columna de estado indica que el paquete es obsoleto. El valor r en la columna de estado indica que se ha cambiado el nombre del paquete, lo cual es una manera de convertirse en obsoleto. La cuarta columna contiene las versiones de lanzamiento y ramificación del paquete. Consulte pkg(5) para obtener información sobre las versiones de lanzamiento y ramificación.

Con -F, puede especificar una formato de salida alternativo. El valor de formato puede ser tsv (valores separados por tabuladores), json (JavaScript Object Notation, como una sola línea) o json-formatted (JavaScript Object Notation, en formato para mejorar la legibilidad).

Con -H, puede omitir los encabezados de la lista.

Con -p, sólo puede mostrar los paquetes del editor determinado. Si no se proporciona, se muestran los paquetes de todos los editores. Esta opción se puede especificar varias veces.

Con -s, puede realizar operaciones en el depósito ubicado en la ruta del sistema de archivos o el URI determinados.

rebuild [-p publisher ...] - s repo_uri_or_path [--no-catalog] [--no-index]

Descarta toda la información de catálogo, búsqueda, y otra información almacenada en la antememoria encontrada en el depósito y, a continuación, la vuelve a crear según el contenido actual del depósito.

Con -p, puede realizar la operación sólo para un editor determinado. Si no se proporciona, o si se especifica el valor especial all, la operación se realiza para todos los editores. Esta opción se puede especificar varias veces.

Con -s, puede realizar operaciones en el depósito ubicado en la ruta del sistema de archivos o el URI determinados.

Con --no-catalog, no puede volver a generar los datos de los paquetes.

Con --no-index, no puede volver a generar índices de búsqueda.

refresh [-p editor ...] - s uri_o_ruta_dep [--no-catalog] [--no-index]

Cataloga los paquetes nuevos encontrados en el depósito y actualiza todos los índices de búsqueda. Esto está pensado para ser utilizado con la publicación diferida (las opciones --no-catalog o --no-index de pkgsend).

Con -p, puede realizar la operación sólo para un editor determinado. Si no se proporciona, o si se especifica el valor especial all, la operación se realiza para todos los editores. Esta opción se puede especificar varias veces.

Con -s, puede realizar operaciones en el depósito ubicado en la ruta del sistema de archivos o el URI determinados.

Con --no-catalog, no puede agregar ningún paquete nuevo.

Con --no-index, no puede actualizar índices de búsqueda.

remove [-n] [-p editor ...] -s uri_o_ruta_dep mod_ID rec ges err_paq ...

Elimina los paquetes que coinciden con los modelos especificados del depósito, incluidos los archivos a los que hacen referencia que no estén siendo utilizados por ningún otro paquete.


Nota - Se eliminan todos los datos del índice de búsqueda de los editores relacionados.


Este subcomando se puede utilizar sólo con depósitos basados en sistemas de archivos.


Precaución

Precaución - Esta operación no se puede revertir y no se debe utilizar mientras otros clientes están accediendo al depósito, ya que podría causar fallos durante las operaciones de recuperación.


Con -n, puede llevar a cabo una ejecución de prueba de la operación sin realizar cambios en los paquetes. Antes del cierre, se muestra una lista de los paquetes que se van a eliminar.

Con -p, sólo puede eliminar los paquetes coincidentes para el editor determinado. Si no se proporciona, se eliminan todos los paquetes coincidentes para todos los editores. Esta opción se puede especificar varias veces.

Con -s, puede realizar operaciones en el depósito ubicado en la ruta del sistema de archivos o el URI determinados.

set [-p editor] - s uri_o_ruta_dep sección/propiedad=[valor] ... or sección/propiedad=([valor]) ...

Establece el valor de las propiedades especificadas para el depósito o el editor.

Este subcomando se puede utilizar sólo con depósitos basados en sistemas de archivos.

Con -p, sólo puede establecer datos de propiedad para el editor determinado. Si el editor aún no existe, se agrega. El valor especial all se puede utilizar para establecer la propiedad de todos los editores.

Con -s, puede realizar operaciones en el depósito ubicado en la ruta del sistema de archivos o el URI determinados.

Las propiedades y los valores se pueden especificar de una de las siguientes maneras:

sección/propiedad=

Borra el valor de la propiedad.

sección/propiedad= valor

Sustituye el valor de la propiedad con el valor especificado.

sección/propiedad=( valor1 valor2 valorN)

Sustituye el valor de la propiedad con la lista de valores.

Para las versiones de depósito 3 y 4, se pueden definir las siguientes propiedades:

publisher/prefix

Una cadena que representa el nombre del editor predeterminado. El primer carácter debe estar comprendido entre a y z, A y Z o 0 y 9. El resto de la cadena sólo puede contener los caracteres de 0 a 9, -, ., de a a z y de A a Z. Este valor indica el editor que se debe utilizar cuando hay más de un paquete de editor, o cuando se publican paquetes en el repositorio, pero no se especifica ningún editor.

Para las versiones de depósito 3 y 4, se pueden definir las siguientes propiedades para cada editor del depósito:

publisher/alias

Una cadena que representa el alias predeterminado que deben utilizar los clientes al agregar un editor mediante los datos de configuración del depósito. El primer carácter debe estar comprendido entre a y z, A y Z o 0 y 9. El resto de la cadena sólo puede contener los caracteres de 0 a 9, -, ., de a a z y de A a Z.

repository/collection_type

Puede tener el valor core o supplemental, que indica el tipo de paquetes disponibles en este depósito.

El tipo core indica que el depósito contiene todas las dependencias declaradas por los paquetes del depósito. El tipo core se utiliza principalmente para depósitos del sistema operativo.

El tipo supplemental indica que el depósito contiene paquetes que dependen de paquetes ubicados en otro depósito, o que fueron diseñados para ser utilizados con ellos.

repository/description

Un párrafo de texto sin formato que describe la finalidad y el contenido del depósito.

repository/detailed_url

Un URI que representa la ubicación de un documento (como una página web) que proporciona información adicional sobre el depósito.

repository/legal_uris

Una lista de las ubicaciones (URI) de los documentos que proporcionan más información legal sobre el depósito.

repository/mirrors

Una lista de ubicaciones (URI) de depósitos que contienen una copia del contenido de los paquetes del depósito pero no de los metadatos del paquete.

repository/name

Una cadena de texto sin formato que contiene el nombre del depósito.

repository/origins

Una lista de ubicaciones (URI) de depósitos que contienen una copia completa de los metadatos y el contenido de los paquetes del depósito.

repository/refresh_seconds

Un valor entero que representa el número de segundos que los clientes deben esperar antes de comprobar si existen datos de paquetes actualizados en el depósito después de cada comprobación de actualización.

repository/registration_uri

Un URI que representa la ubicación de un recurso que se debe utilizar para obtener credenciales para acceder al depósito. Un ejemplo es una página web de registro.

repository/related_uris

Una lista de las ubicaciones (URI) de los depósitos que contienen los paquetes en los que los usuarios pueden estar interesados.

Las propiedades que no se documentan aquí, pero que figuran en la salida del subcomandoget, están reservadas para uso interno y no se deben definir.

versión

Muestra una cadena única que identifica la versión del sistema pkg(5). Los valores producidos por la operación version no se pueden clasificar y no son seguros para la comparación más allá igualdad.

Ejemplos

Ejemplo 1 Creación de un depósito de paquetes

$ pkgrepo create /my/repository

Ejemplo 2 Visualización de información

Visualice un resumen de los editores y el número de paquetes de un depósito.

$ pkgrepo info -s /my/repository
PUBLISHER   PACKAGES STATUS UPDATED
example.com 5        online 2011-07-22T18:09:09.769106Z
$ pkgrepo info -s http://pkg.oracle.com/solaris/release/
PUBLISHER PACKAGES STATUS UPDATED
solaris   3941     online 2010-11-12T19:24:25.967246Z

Ejemplo 3 Reconstrucción de catálogos y datos de búsqueda

Reconstruya los catálogos y los datos de búsqueda del depósito.

$ pkgrepo rebuild -s /my/repository

Ejemplo 4 Refrescamiento de catálogos y datos de búsqueda

Refresque los catálogos y los datos de búsqueda del depósito.

$ pkgrepo refresh -s /my/repository
$ pkgrepo refresh -s http://example.com/repository

Ejemplo 5 Visualización de todas las propiedades del depósito

$ pkgrepo get -s /my/repository
SECTION    PROPERTY VALUE
publisher  prefix   ""
repository version  4
$ pkgrepo get -s http://pkg.oracle.com/solaris/release/
SECTION    PROPERTY VALUE
publisher  prefix   solaris
repository version  4

Ejemplo 6 Visualización de todas las propiedades del editor

$ pkgrepo get -s http://pkg.oracle.com/solaris/release/ -p all
PUBLISHER SECTION    PROPERTY         VALUE
solaris   publisher  alias
solaris   publisher  prefix           solaris
solaris   repository collection-type  core
solaris   repository description      This\ repository\ serves\ the\ Oracle\
Solaris\ 11\ Package\ repository.
solaris   repository legal-uris       ()
solaris   repository mirrors          (http://pkg-cdn1.oracle.com/solaris.release/)
solaris   repository name             Oracle\ Solaris\ 11\ Package\ Repository
solaris   repository origins          ()
solaris   repository refresh-seconds
solaris   repository registration-uri ""
solaris   repository related-uris     ()

Ejemplo 7 Establecimiento del editor predeterminado

$ pkgrepo set -s /my/repository publisher/prefix=example.com

Ejemplo 8 Establecimiento de una propiedad de editor

$ pkgrepo set -s /my/repository -p example.com \
repository/origins=http://example.com/repository

Ejemplo 9 Adición de un editor nuevo al depósito

$ pkgrepo add-publisher -s /my/repository example.com

Estado de salida

Se devolvieron los siguientes valores de salida:

0

El comando se ejecutó correctamente.

1

Se produjo un error.

2

Se especificaron opciones de línea de comandos no válidas.

3

Se solicitaron varias operaciones, pero sólo algunas se realizaron correctamente.

4

No se realizaron cambios, no se requiere ninguna acción.

99

Se produjo una excepción no anticipada.

Atributos

Consulte attributes(5) para ver descripciones de los atributos siguientes:

TIPO DE ATRIBUTO
VALOR DEL ATRIBUTO
Disponibilidad
package/pkg
Estabilidad de interfaz
Sin asignar.

Véase también

pkg(1), pkgrecv(1), pkgsend(1), pkg.depotd(1m), pkg(5)

http://hub.opensolaris.org/bin/view/Project+pkg/