JavaScript is required to for searching.
Ignorer les liens de navigation
Quitter l'aperu
Pages de manuel d'Image Packaging System     Oracle Solaris 11 Information Library (Français)
search filter icon
search icon

Informations document

Préface

Commandes utilisateur

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)

Commandes d'administration système

Normes, environnements et macros

pkgrecv

- Utilitaire de récupération de contenu Image Packaging System

Synopsis

/usr/bin/pkgrecv [-s src_uri] [-a] [-d (path|dest_uri)]
    [-c cache_dir] [-kr] [-m match] [-n] [--raw]
    [--key keyfile --cert certfile] (fmri|pattern) ...
/usr/bin/pkgrecv [-s src_uri] --newest

Description

pkgrecv permet à l'utilisateur de récupérer des packages à partir d'un référentiel pkg(5) ou d'une archive de packages. pkgrecv peut également publier de nouveau les packages récupérés vers un autre référentiel de packages ou les archiver. Par défaut, les packages sont récupérés au format de référentiel de package approprié pour une utilisation avec pkg(1), pkg.depotd(1M) et des outils de publication de packages.

Après une opération pkgrecv, exécutez pkgrepo refresh ou pkgrepo rebuild sur le référentiel pour construire des index de recherche.

Options

Les options suivantes sont prises en charge :

-a

Stocke les données du package récupéré dans une archive pkg(5) à l'emplacement spécifié par -d. Le fichier ne doit pas déjà exister. Cette option peut être utilisée uniquement avec des destinations de système de fichiers. Bien que cela ne soit pas nécessaire, l'utilisation d'une extension de fichiers .p5p (par exemple, archive.p5p) est vivement recommandée. Cette option ne peut pas être combinée à --raw.

-c cache_dir

Chemin d'un répertoire qui sera utilisé pour la mise en cache du contenu téléchargé. Si ce répertoire n'est pas fourni, le client sélectionne automatiquement un répertoire de cache. Dans le cas où un téléchargement est interrompu et qu'un répertoire de cache a été automatiquement sélectionné, utilisez cette option pour reprendre le téléchargement. Reportez-vous à la section Variables d'environnement ci-dessous pour plus de détails sur la manière de définir l'emplacement utilisé pour le stockage temporaire des données.

-d path_or_uri

Chemin de système de fichiers ou URI de la cible vers lesquels republier les packages. Si -a est spécifié, la cible est une nouvelle archive de package (qui n'existe pas encore). Autrement, la cible doit être un référentiel de packages qui existe déjà. Les nouveaux référentiels peuvent être créés à l'aide de pkgrepo(1).

-h

Affiche un message d'utilisation.

-k

Conserve le contenu du package récupéré compressé. Cette option est ignorée en cas de nouvelle publication. Le contenu du package compressé ne doit pas être utilisé avec pkgsend(1).

-m match

Contrôle le comportement de correspondance à l'aide des valeurs suivantes :

all-timestamps

Inclut tous les horodatages correspondants et pas seulement le dernier (implique all-versions).

all-versions

Inclut toutes les versions correspondantes, et pas seulement la dernière.

-n

Effectue une série de tests sans apporter de modifications.

-r

Récupère de manière récursive toutes les dépendances de la liste des packages fournie.

-s src_repo_uri

URI représentant l'emplacement d'un référentiel pkg(5) ou d'une archive de packages à partir desquels recevoir des données de package.

--cert file

Spécifie un fichier de certificat SSL client à utiliser pour la récupération de package à partir d'un référentiel HTTPS.

--key file

Spécifie un fichier clé SSL client à utiliser pour la récupération de package à partir d'un référentiel HTTPS.

--newest

Répertorie les dernières versions des packages disponibles depuis le référentiel, puis quitte. (Toutes les autres options, à l'exception de -s, sont ignorées.)

--raw

Récupère et stocke les données brutes de package dans un ensemble de structures de répertoire par racine et version à l'emplacement spécifié par -d. Cette option peut être utilisée uniquement avec des destinations de système de fichiers. Ces données de package peuvent être utilisées pour modifier et publier à nouveau des packages de manière commode, par exemple en corrigeant des contenus de fichiers ou en fournissant des métadonnées de package supplémentaires. Cette option ne peut pas être combinée à -a.

Exemples

Exemple 1 Liste des packages les plus récents

Répertorie les packages les plus récents disponibles à partir du référentiel sur le système nommé 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

Exemple 2 Récupération des données de package brutes

Recevez le package c++-runtime de l'exemple 1 dans un format adapté pour une utilisation avec 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

Exemple 3 Récupération des dépendances d'un système

Recevez le package editor/vim et toutes ses dépendances à partir du système nommé test.

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

Exemple 4 Récupération de toutes les versions

Recevez toutes les versions du package editor/vim depuis le système nommé 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

Exemple 5 Récupération de toutes les versions et republication à distance

Recevez toutes les versions du package library/zlib depuis le système nommé test et publiez-les de nouveau vers un référentiel distant nommé remote.

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

Exemple 6 Récupération des dépendances d'un référentiel

Recevez le package editor/gnu-emacs et toutes ses dépendances à partir du référentiel situé dans /export/repo.

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

Exemple 7 Récupération de packages supplémentaires

Recevez tous les packages qui n'existent pas déjà dans le référentiel à l'emplacement http://example.com:10000.

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

Exemple 8 Création d'une archive de packages

Créez une archive de packages contenant le package editor/gnu-emacs et toutes ses dépendances à partir du référentiel situé dans http://example.com:10000.

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

Exemple 9 Copie de packages d'une archive vers un référentiel

Copiez tous les packages dans une archive de packages vers un référentiel existant situé dans /export/repo.

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

Variables d'environnement

Les variables d'environnement suivantes sont prises en charge :

PKG_DEST

Chemin d'un répertoire pour enregistrer le package récupéré, ou le chemin système fichiers ou l'URI d'un référentiel ou d'une archive de packages où les packages seront copiés.

PKG_SRC

URI ou chemin système fichiers représentant l'emplacement d'un référentiel pkg(5) ou d'une archive de packages à partir desquels récupérer des packages.

TMPDIR

Chemin absolu au répertoire dans lequel les données temporaires doivent être stockées lors de l'exécution du programme. Si elle n'est pas définie, la valeur par défaut est de stocker des données temporaires dans /var/tmp.

État de sortie

Les valeurs de sortie renvoyées sont les suivantes :

0

La commande a réussi.

1

Une erreur s'est produite.

2

Des options de ligne de commande incorrectes ont été spécifiées.

3

Plusieurs opérations ont été demandées, mais seules certaines d'entre elles ont réussi.

99

Une exception imprévue est survenue.

Attributs

Reportez-vous à attributes(5) pour obtenir la description des attributs suivants :

TYPE D'ATTRIBUT
VALEUR DE L'ATTRIBUT
Disponibilité
package/pkg
Stabilité de l'interface
Non validé

Voir aussi

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

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