pkgrecv

- utilidad de recuperación de contenido de Image Packaging System

Sinopsis

/usr/bin/pkgrecv [-s uri_origen] [-a] [-d (ruta|uri_destino)]
    [-c dir_antem] [-kr] [-m coincidencia] [-n] [--raw]
    [--key archivo_clave --cert archivo_cert] (fmri|modelo) ...

/usr/bin/pkgrecv [-s uri_origen] --newest

Descripción

pkgrecv permite al usuario recuperar paquetes de un archivo de paquetes o un depósito pkg(5). pkgrecv también le permite al usuario volver a publicar los paquetes recuperados en otro depósito de paquetes o archivarlos. De manera predeterminada, los paquetes se recuperan en un formato de depósito de paquetes adecuado para utilizar con pkg(1), pkg.depotd(1M), y herramientas de publicación de paquetes.

Después de una operación de pkgrecv, ejecute pkgrepo refresh o pkgrepo rebuild en el repositorio para crear índices de búsqueda.

Opciones

Se admiten las siguientes opciones:

-a

Almacena los datos de paquetes recuperados en un archivo pkg(5), en la ubicación especificada por -d. El archivo no puede existir previamente. Esta opción se puede utilizar sólo con destinos basados en sistemas de archivos. Aunque no sea obligatorio, se recomienda utilizar una extensión de archivo .p5p (por ejemplo, archive.p5p). Esta opción no se puede combinar con --raw.

-c dir_antem

La ruta de un directorio que se utilizará para almacenar el contenido descargado en la antememoria. Si este directorio no se suministra, el cliente selecciona automáticamente un directorio de antememoria. En el caso de que se interrumpa la descarga y se haya elegido automáticamente un directorio de antememoria, utilice esta opción para reanudar la descarga. Consulte la sección “Variables de entorno” a continuación, para ver más detalles sobre cómo establecer la ubicación utilizada para el almacenamiento temporal de datos.

-d ruta_o_uri

El URI o la ruta del sistema de archivos del destino en el que volverán a publicar los paquetes. Si se especifica -a, el destino es un archivo de paquetes nuevo que ya no puede existir. De lo contrario, el destino tiene que ser un repositorio de paquetes que ya existe. Se pueden crear nuevos depósitos mediante pkgrepo(1).

-h

Muestra un mensaje de uso.

-k

Mantiene comprimido el contenido del paquete recuperado. Esta opción se ignora al volver a publicar. El contenido del paquete comprimido no se debe utilizar con pkgsend(1).

-m coincidencia

Controla el comportamiento de las coincidencias mediante los valores siguientes:

all-timestamps

Incluye todos los indicadores de fecha y hora, no sólo el más reciente (incluye all-versions).

all-versions

Incluye todas las versiones coincidentes, no sólo la última.

-n

Lleva a cabo una ejecución de prueba sin realizar cambios.

-r

Recupera recursivamente todas las dependencias para la lista de paquetes suministrada.

-s uri_dep_origen

Un URI que representa la ubicación de un archivo de paquetes o un depósito pkg(5) desde el que se recibirán los datos de los paquetes.

--cert archivo

Especifica el archivo de certificados SSL de cliente que se utilizará para recuperar paquetes desde un depósito HTTPS.

--key archivo

Especifica el archivo de claves SSL de cliente que se utilizará para recuperar paquetes desde un depósito HTTPS.

--newest

Muestra las versiones más recientes de los paquetes disponibles en el depósito especificado y se cierra. (Se ignoran todas las demás opciones excepto -s).

--raw

Recupera y guarda los datos de paquetes sin formato en un conjunto de estructuras de directorio, por recurso y versión, en la ubicación especificada por -d. Esta opción se puede utilizar sólo con destinos basados en sistemas de archivos. Estos datos de paquete se pueden utilizar para modificar y volver a publicar paquetes de manera conveniente, tal vez, mediante la corrección del contenido del archivo o el suministro de metadatos adicionales del paquete. Esta opción no se puede combinar con -a.

Ejemplos

Ejemplo 1 Visualización de los paquetes más recientes

Visualice los paquetes más recientes disponibles en el depósito, en el sistema denominado test.

$ pkgrecv -s http://test --newest
pkg://solaris/system/library/c++-runtime@0.5.11,5.11-0.174.0.0.0.0.0:20110921T190358Z
pkg://solaris/system/library/freetype-2@2.4.8,5.11-0.175.1.0.0.7.1234:20120109T215840Z
pkg://solaris/system/library/math@0.5.11,5.11-0.174.0.0.0.0.0:20110921T190432Z

Ejemplo 2 Recuperación de datos de paquetes sin formato

Reciba el paquete c++-runtime del Ejemplo 1 en un formato adecuado para utilizar con pkgsend publish.

$ pkgrecv -s http://test \
-d /local/repo --raw \
c++-runtime@0.5.11,5.11-0.174.0.0.0.0.0:20110921T190358Z
Processing packages for publisher solaris ...
Retrieving and evaluating 1 package(s)...
PROCESS                                         ITEMS     GET (MB)    SEND (MB)
Completed                                         1/1      3.5/3.5      0.0/0.0
$ ls /local/repo
pkg5.repository  publisher  system%2Flibrary%2Fc%2B%2B-runtime

Ejemplo 3 Recuperación de dependencias de un sistema

Reciba el paquete editor/vim y todas sus dependencias del sistema denominado test.

$ pkgrecv -s http://test -d /local/repo -r editor/vim

Ejemplo 4 Recuperación de todas las versiones

Reciba todas las versiones del paquete editor/vim del sistema denominado test.

$ pkgrecv -s http://test -d /local/repo -m all-versions editor/vim
Processing packages for publisher solaris ...
Retrieving and evaluating 2 package(s)...
PROCESS                                        ITEMS     GET (MB)    SEND(MB)
Completed                                        2/2    16.7/16.7    44.9/44.9

Ejemplo 5 Recuperación de todas las versiones y nueva publicación remota

Reciba todas las versiones del paquete library/zlib del sistema denominado test y vuelva a publicarlo en un repositorio remoto, en el sistema denominado remote.

$ pkgrecv -s http://test -d http://remote:10000 -m all-versions library/zlib

Ejemplo 6 Recuperación de dependencias de un depósito

Reciba el paquete editor/gnu-emacs y todas sus dependencias del repositorio ubicado en /export/repo.

$ pkgrecv -s /export/repo -d /local/repo -r editor/gnu-emacs

Ejemplo 7 Recuperación de paquetes adicionales

Reciba todos los paquetes que no existan previamente del depósito ubicado en http://example.com:10000.

$ pkgrecv -s http://example.com:10000 -d /my/pkg/repo '*'

Ejemplo 8 Creación de un archivo de paquetes

Cree un archivo de paquetes que contenga el paquete editor/gnu-emacs y todas sus dependencias del repositorio ubicado en http://example.com:10000.

$ pkgrecv -s http://example.com:10000 -d /my/emacs.p5p -a -r editor/gnu-emacs

Ejemplo 9 Copia de paquetes de un archivo a un depósito

Copie todos los paquetes de un archivo de paquetes a un depósito existente ubicado en /export/repo.

$ pkgrecv -s /my/archive.p5p -d /export/repo '*'

Variables del entorno

Se admiten las siguientes variables de entorno:

PKG_DEST

La ruta de un directorio para guardar el paquete recuperado, o el URI o la ruta del sistema de archivos de un archivo de paquetes o un depósito donde se copiarán los paquetes.

PKG_SRC

Un URI o una ruta del sistema de archivos que representa la ubicación de un archivo de paquetes o un depósito pkg(5) desde el cual se recuperarán paquetes.

TMPDIR

La ruta absoluta del directorio donde se deben almacenar los datos temporales durante la ejecución del programa. Si no se establece, de manera predeterminada los datos temporales se almacenan en /var/tmp.

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.

99

Se produjo una excepción no anticipada.

Atributos

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

Véase también

pkgrepo(1), pkgsend(1), pkg(5)

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