| perlwin32faq11 - Utiliser PPM pour installer des modules |
perlwin32faq11 - Utiliser PPM pour installer des modules
Comment installer et mettre à jour des modules avec PPM
Le Gestionnaire de Paquetage du Programmeur (PPM), autrefois connu sous le nom de Gestionnaire de Paquetage Perl, fournit une interface en ligne de commande pour gérer vos modules et extensions (paquetages). PPM est utilisé pour accéder à des dépôts de paquetages (ou a des collections de paquetages sur d'autres machines), installer et ôter des paquetages de votre système, aussi bien que de mettre à jour des paquetages précédemment installés avec les dernières versions.
La version 3.0 de PPM correspond à une réécriture complète de PPM, se caractérisant par de nombreuses additions et améliorations. Pour maintenir la compatibilité et permettre une migration facile, la version 3 de PPM coexistera avec la version 2 de PPM.
À la fois PPM version 2 (ppm2) et PPM version 3 (ppm) sont
disponibles quand vous installez ActivePerl.
Avant de lancer PPM ou PPM2, vous devez ou bien être connectés à Internet ou bien avoir accès à un dépôt local, comme un disque dur ou le CD d'ActiveState ( http://aspn.activestate.com/ASPN/Downloads/ActiveCD ). Si votre connexion à Internet se fait via un firewall or un serveur mandataire (proxy), vous devez mettre la variable d'environnement «HTTP_proxy» au nom du serveur mandataire. Si votre serveur mandataire exige un nom d'utilisateur et un mot de passe, fixez les variables d'environnement «HTTP_proxy_user» et «HTTP_proxy_pass». Voyez PPM, Proxys et Firewalls pour plus d'information.
Pour lancer PPM version 2, entrez ppm2 dans une fenêtre prompt (Windows), ou
au prompt du shell (Linux / Solaris). Pour lancer PPM version 3, entrez ppm.
Démarrage rapide : au prompt de commande de PPM, tapez search *
pour obtenir une liste de tous les paquetages disponibles, puis tapez
install <nom de paquetage>, où <nom de paquetage>
est le nom d'un paquetage affiché par la commande de recherche.
Pour obtenir la liste des paquetages que vous avez installés antérieurement
avec PPM, utilisez la commande query *.
Ceux qui utilisent PPM2 doivent taper 'search' pour obtenir une liste de tous
les paquetages disponibles, puis taper install <nom de paquetage>
où <nom de paquetage> est le nom d'un paquetage affiché par la commande
'search'. Pour obtenir la liste des paquetages que vous avez installés
antérieurement avec PPM2, utilisez la commande 'query'.
Note aux utilisateurs de PPM : Si vous trouvez que la liste des paquetages
se déroule trop rapidement, vous pouvez utiliser la commande
set more <nombre> pour faire une pause chaque fois que <nombre>
de paquets auront été affichés. Utilisez la commande 'set save' pour
sauvegarder cette configuration pour de futures sessions PPM.
La première fois que vous lancez PPM ou PPM2, le dépôt de paquetages par défaut est
le dépôt d'ActiveState. Si vous changez votre dépôt par défaut, ce changement
devra être sauvegardé. Les utilisateurs de PPM peuvent sélectionner un dépôt
différent avec la commande repository. Les utilisateurs de PPM2
doivent utiliser la commande 'set'.
Voir Où sont les dépôts de paquetages ? ci-dessous.
Les items entre <crochets angulaires> sont des arguments qui peuvent être utilisés avec les commandes, alors que les items entre [crochets] sont des éléments facultatifs. PPM reconnaîtra et acceptera des versions abrégées des commandes, sitôt qu'assez de lettres auront été tapées pour que la commande soit reconnue par PPM. Par exemple, «des» peut être tapé à la place de «describe».
describe Décrit le paquetage courant ou par défaut
describe <numéro> Décrit le paquetage <numéro> de la recherche
courante
describe <tranche> Décrit les paquetages de la tranche de la
recherche courante
describe <nom> Décrit le paquetage nommé
describe <motif glob> Exécute une nouvelle recherche qui utilise
le <motif glob>
Quand on l'utilise, describe retourne des informations sur un paquetage,
y compris le nom du paquetage, le nom de l'auteur et une brève description
(appelé «Abstract») au sujet du paquetage. Par exemple, si vous entrez:
describe libnet
PPM retournera :
===============================
Package 1
Name: libnet
Version: 1.07.03
Author: Graham Barr
Abstract: Collection of Network protocol modules
Implementations:
1.sun4-solaris-thread-multi
2.i686-linux-thread-multi
3.MSWIn32-x86-multi-thread
===============================
Quand la commande describe est appelée sans argument, elle retourne des
informations sur le premier paquetage de la recherche courante. S'il n'y a pas
de recherche par défaut, vous serez invité à utiliser search
pour trouver un paquetage.
Si describe est appelé avec un argument numérique, le numéro désigne le
paquetage par défaut et les informations à propos de ce paquetage sont
retournées. Si le numéro n'existe pas, vous serez invité à utiliser
search pour trouver un paquetage. Vous pouvez aussi utiliser
describe pour obtenir les descriptions de plusieurs paquetages. Par
exemple :
describe 4-7
vous donnera les descriptions des paquetages numéro 4 à 7 de la recherche courante. Vous pouvez aussi entrer :
describe 3-4,10
pour obtenir des informations sur les paquetages 3, 4 et 10.
Quand la commande describe reçoit un nom avec un joker (comme «*» or
«?») elle exécute la commande search avec l'argument donné. Ainsi, vous
pouvez taper quelque chose comme describe Tk* et la recherche vous
donnera le(s) nom(s) de tous les paquetages qui correspondent à vos
paramètres de recherche.
Voir aussi : Properties
exit Quitte le programme
Quand vous quittez l'environnement PPM, les réglages courants sont sauvegardés.
Voir aussi : Quit
help Liste toutes les commandes disponibles help <commande> Affiche une aide détaillée à propos de la <commande>
La commande help fournit une brève description des commandes disponibles
dans PPM. Pour une aide spécifique sur une commande, entrez help suivi du
nom de la commande. Par exemple, entrez help settings ou help set
pour obtenir une description détaillée de la commande settings.
Il y a quelques sujets d'aide supplémentaires construits dans PPM. On peut y accéder dans l'environnement PPM comme suit :
COMMANDE HELP DESCRIPTION
-------------------------------------------------------------------------
help ppm_migration donne plus de détails au sujet des changements
des versions antérieures de PPM
-------------------------------------------------------------------------
help quickstart un guide facile à suivre pour débuter avec PPM3
-------------------------------------------------------------------------
help prompt donne une explication détaillée à propos du
prompt de PPM3
-------------------------------------------------------------------------
help queryformat donne des trucs et astuces supplémentaires pour
faire des recherches efficaces avec PPM3
-------------------------------------------------------------------------
install Installe le paquetage par défaut. install <numéro> Installe le paquetage donné par son <numéro>. install <tranche> Installe les paquetages de la <tranche> numérique. install <name> Installe le paquetage nommé.
La commande install est utilisée pour installer des paquetages depuis le
dépôt. Vous pouvez installer des paquetages par nom ou par numéro (le
numéro est donné par le dépôt ou par une requête de recherche), ou un
paquetage par défaut peut être établi par l'intermédiaire de la commande
describe. Il existe aussi un ensemble de modificateurs qui peuvent être
utilisés avec la commande install :
-force -noforce -follow -nofollow
Les commandes force et follow déterminent comment les paquetages sont
installés :
FORCE FOLLOW RÉSULTAT
-------------------------------------------------------------------------
false false Vérifie si le paquetage est installé et s'il
l'est, PPM3 s'arrête. Si certains prérequis
manquent, l'installation échouera.
-------------------------------------------------------------------------
false true Vérifie si le paquetage est installé et s'il
l'est, PPM3 s'arrête. Si certains prérequis
manquent, ils sont automatiquement installés.
-------------------------------------------------------------------------
true false Si le paquetage est installé, PPM3 le réinstallera.
Si certains prérequis manquent, l'installation
échouera. NOTE : c'est le réglage par défaut quand
PPM3 est installé la première fois.
-------------------------------------------------------------------------
true true Si le paquetage est installé, PPM3 le réinstallera.
Si certains prérequis manquent, ils sont
automatiquement installés.
-------------------------------------------------------------------------
Si vous ne spécifiez aucune option, install utilise le réglage par
défaut. On peut fixer et voir ces valeurs par défaut en utilisant
la commande settings.
Par exemple :
install foo
installera le paquetage nommé «foo», en utilisant les réglages par défaut.
Vous pouvez les surpasser avec les modificateurs de install.
Par exemple :
install foo -force
installera le paquetage «foo», même si il a déjà été installé. Si à la fois
-force et -follow sont activés, tous les prérequis seront installés
pour tous les paquetages que vous installerez. Par exemple, l'installation
d'un paquetage lié à Tk, comme «tk-ach» qui fait 8,4 ko sera précédée de
l'installation de Tk, qui fait 1,7Mo
Vous pouvez aussi installer un paquetage par son numéro. La numérotation des paquetages est basée sur le dépôt courant ou sur la requête de recherche courante. Par exemple :
install 6
installe le paquetage numéro 6. Vous pouvez installer plusieurs paquetages en une seule fois :
install 3-5
installe les paquetages 3, 4 et 5. Vous pouvez aussi taper install 3-6,8
pour recevoir les paquetages 3, 4, 5, 6 et 8.
profile liste les profiles disponibles dans le dépôt profile <numéro> commute vers le profile donné profile add <nom> crée un nouveau profile dans le dépôt profile del <numéro> efface le profile donné profile save sauvegarde l'état du client dans le profile courant profile restore rétablit le profile courant
L'installation et la gestion des paquetages sont faciles à surveiller avec les profils. En utilisant des profils, vous pouvez sauver vos paquetages perl favoris dans un seul profil ou regrouper des paquetages par fonction dans différents profils. Cela rend aussi plus facile l'installation de paquetages, puisque vous n'avez besoin que d'accéder à un ou deux profils, au lieu de beaucoup de paquetages individuels.
Gérer vos profils peut se faire avec PPM3 ou via le site web Interactif d'ActiveState.
Note: Les commandes de profile sont disponibles seulement si le dépôt
courant est un dépôt PPM3.
properties Décrit le paquetage installé par défaut properties <numéro> Décrit le paquetage installé <numéro> properties <nom> Décrit le paquetage installé nommé <nom> properties <motif glob> Exécute une nouvelle recherche avec le <motif glob>
Similaire à la commande describe, la commande properties
fournit des informations sur un paquetage installé, mais avec plus de
détails que ceux obtenus avec describe. En plus du résumé,
elle affiche la date d'installation et une URL pointant vers l'emplacement
du paquetage dans le dépôt.
Note : Quand la commande properties est appelée avec des arguments
contenant un joker, elle affiche un message disant qu'elle est sur le point
d'envoyer la ligne de commande complète à query; puis elle le
fait. Vous pouvez taper «properties Tk*» ou «prop Tk*».
Par exemple, en tapant properties libnet vous obtenez :
Name: libnet
Version: 1.07.03
Author: Graham Barr
Abstract: Collection of Network protocol modules
InstDate: Fri Oct 2 16:15:15 1998
Location: http://ppm.ActiveState.com/cgibin/PPM/ppmserver.pl?urn:/PPMServer
Voir aussi : Describe
Quit termine le programme.
Quit est une autre commande pour fermer l'application PPM. Identique à
la commande exit ; quand vous fermez PPM3, les réglages courants
sont sauvegardés.
Voir aussi : Exit
query Affiche la liste des requêtes précédentes query <numéro> Affiche les résultats d'une requête précédente query <motif glob> Exécute une nouvelle requête en utilisant <motif glob> query * Affiche une liste de tous les paquetages installés
La commande query affiche ou bien une liste de tous les paquetages
installés ou bien une liste raccourcie, basée sur le <motif glob> donné. Vous
pouvez retrouver aussi la liste de requêtes précédentes ou les résultats
d'une requête précédente.
Note : Selon la valeur de l'option «case-sensitivity», la requête peut être ou non sensible à la casse (distinction majuscules/minuscules). Voir «help settings» pour la manière de changer la sensibilité à la casse.
Voir aussi : Settings
remove Supprime le paquetage installé par défaut remove <numéro> Supprime le paquetage donné par son numéro remove <tranche> Supprime les paquetages de la <tranche> numérique. remove <nom> Supprime le paquetage installé nommé <nom>
La commande remove supprime les paquetages de votre cible
(target) courante Les paquetages peuvent être supprimés par leur
nom de paquetage ou par leur numéro de liste. Par exemple :
remove XML-DOM
supprimera le paquetage XML-DOM de votre cible. Vous pouvez aussi supprimer un paquetage par son numéro :
remove 6
et le sixième paquetage de votre requête courante sera supprimé. Si vous n'avez pas de requête établie, il vous sera demandé d'utiliser query pour trouver un paquetage avant de le supprimer. Il est important de se souvenir que supprimer un paquetage efface aussi toutes les requêtes antérieures puisque la numérotation stockée dans toute requête n'est plus correcte dès que des paquetages ont été supprimés.
Les paquetages peuvent aussi être supprimés par groupe; par exemple :
remove 4-7
supprimera les paquetages 4, 5, 6 et 7 de votre cible. Vous pouvez aussi sauter des paquetages dans le processus de suppression :
remove 3-5, 7
supprimera les paquetages 3, 4, 5 et 7... mais laissera intact le 6. Souvenez-vous de lancer une nouvelle requête toutes les fois que vous supprimez un paquetage de votre cible.
Notez s'il vous plaît que les jokers comme «*» ou «?» ne peuvent pas être
utilisés avec la commande remove.
Voir aussi : Uninstall
repository affiche tous les dépôts
repository [set] <numéro> rend actif le dépôt spécifié
repository add [name] <emplacement du dépôt>
ajoute un nouveau dépôt
repository del <numéro> efface le dépôt spécifié
repository describe [numéro] affiche le nom, l'emplacement et le type
du dépôt spécifié (ou courant).
Quand utilisé sans argument, repository (ou «rep») liste les dépôts
correspondants aux réglages actuels de PPM3. Le dépôt par défaut est
indiqué par un «*» en tête.
Par exemple, quand vous entrez :
rep
PPM3 retourne quelque chose comme ça :
Repositories: * 1. ActiveCD. 2. ActiveState Package Repository
Dans l'exemple ci-dessus , entrer rep set 2 fera du second dépôt
(ActiveState Package Repository) le dépôt actif.
Ajouter un autre dépôt ce fait ainsi :
rep add <NAME> <LOCATION>
par exemple :
rep add TheoryX5
http://theoryx5.uwinnipeg.ca/cgi-bin/ppmserver?urn:/PPMServer
avec «TheoryX5» comme nom du dépôt (pour référence facile) et l'emplacement
indiqué par son adresse http. Si vous entrez rep à nouveau, vous pourrez
voir :
ppm>rep Repositories: 1. ActiveCD * 2. ActiveState Package Repository 3. TheoryX5
Si vous voulez enlever le dépôt ActiveCD, vous tapez rep del 1, pour
enlever le 1er dépôt. Pour obtenir plus d'information sur un dépôt
particulier, tapez rep describe pour obtenir de l'information sur le
dépôt courant ou rep describe <numéro> pour obtenir de l'information sur
un dépôt spécifique.
Par exemple :
rep describe 2
retournera :
Describing Repository 2:
Name: ActiveState Package Repository
Location: http://ppm.ActiveState.com/cgibin/PPM/ppmserver.pl?urn:/PPMServer
Type: PPMServer 2.00
search Affiche la liste des recherches précédentes
search <numéro> Affiche les résultats de la recherche <numéro>
search <motif glob> Effectue une nouvelle recherche
search <champ>=<motif glob> Recherche tous les paquetages dont le champ
correspond au motif - les champs disponibles
sont ABSTRACT, NAME ou TITLE, AUTHOR et VERSION
- NAME est le champ par défaut pour la recherche.
search * Recherche tous les paquetages du dépôt courant.
La commande Search est utilisée pour faire des recherches dans un dépôt
de paquetages. Avec PPM, vous pouvez faire des recherches puissantes et
détaillées. Voici quelques exemples:
COMMANDE SIGNIFICATION EXEMPLES
-------------------------------------------------------------------------
search CGI Recherche 'CGI' n'importe Apache-CGI
où dans le nom CGI-Application
CGI-ArgChecker
-------------------------------------------------------------------------
search CGI* Recherche 'CGI' au début CGI-Application
du nom CGI-ArgChecker
-------------------------------------------------------------------------
search AUTHOR=smith Recherche de tous les modules Apache-ProxyPass
dont l'auteur à 'smith' dans Business-ISBN
son nom ou son email
-------------------------------------------------------------------------
search ABSTRACT=compress
Recherche 'compress' n'importe Apache-GzipChain
où dans le résumé (abstract) IO-Zlib
-------------------------------------------------------------------------
search CGI or ABSTRACT=web
Recherche 'CGI' dans le nom ou CGI-XMLForm
'web' dans le résumé HTML-Clean
-------------------------------------------------------------------------
search XML and (parser or ABSTRACT=pars) and not XPath
Recherche 'XML' dans le nom et XML-Node
ou 'parser' dans le nom ou XML-Parser-EasyTree
'pars' dans le résumé, mais sans
'XPath' dans le nom
-------------------------------------------------------------------------
search Data::Grove dépôt PPM Server 3.0 seulement : C<libxml-perl>
Recherche par nom de module, même
si sans rapport avec le contenu
du paquetage
-------------------------------------------------------------------------
search * Examine tous les paquetages dans Affix-Infix2Postfix
le dépôt AI-Fuzzy
AI-NeuralNet-BackProp
[... 1700 en plus]
-------------------------------------------------------------------------
Vous pouvez rappeler des recherches antérieures avec la commande
search <numéro> puisque PPM conserve les recherches effectuées.
settings Affiche les options courantes settings <nom> Affiche le réglage courant du <nom> donné settings <nom> <valeur> Donne à <nom> la <valeur>
La commande settings vous donne accès aux différentes options de PPM qui
sont disponibles. Elles peuvent être modifiées pour mieux convenir à vos
besoins quand vous utilisez PPM.
Réglages disponibles :
NAME VALUE DESCRIPTION
-------------------------------------------------------------------------
case-sensitivity "0" ou "1" Si fixé à "1", les recherches et
requêtes sont sensibles à la casse.
-------------------------------------------------------------------------
download-chunksize nombre Si fixé à un entier strictement
positif PPM met à jour l'état
d'avancement chaque fois que <nombre>
d'octets ont été transférés pendant
une installation ou une mise à jour.
-------------------------------------------------------------------------
follow-install "0" ou "1" Voir "install" pour les détails.
-------------------------------------------------------------------------
force-install "0" or "1" Voir "install" pour les détails.
-------------------------------------------------------------------------
page-lines integer Le nombre de lignes à afficher par
page. Si un résultat a moins de
lignes que "page-lines", il sera
affiché directement à l'écran sans se
soucier des réglages du "pager".
-------------------------------------------------------------------------
pager chemin Le chemin vers un programme "pager"
externe utilisé pour afficher les
longues pages. Si laissé blanc, le
pager interne est utilisé.
-------------------------------------------------------------------------
prompt-context "0" ou "1" Si "1" autorise le changement du
prompt en fonction de l'état courant
de PPM, c'est-à-dire montrer la cible
courante, requête,...etc.
-------------------------------------------------------------------------
prompt-slotsize integer Si prompt-verbose est à "1", cela
définit la largeur de chaque plage
dans le prompt. Par exemple, "4"
définit des plages de 4 caractères
de large.
-------------------------------------------------------------------------
prompt-verbose "0" ou "1" Si à "0", utilise des nombres pour
représenter le contexte dans le
prompt; beaucoup plus court.
Si prompt-context est mis à "0", les
réglages de prompt-verbose
n'entraîneront aucune différence
visible.
-------------------------------------------------------------------------
sort-field champ Le champ sur lequel doit porter le
tri des résultats des recherches et
requêtes. Les champs valides sont
ABSTRACT, NAME ou TITLE, AUTHOR et
VERSION. Note : ces champs sont
sensibles à la casse.
-------------------------------------------------------------------------
tempdir chemin un répertoire temporaire dans lequel
les paquetages sont téléchargés et
décomprimés pendant "install" et
"upgrade".
-------------------------------------------------------------------------
trace-file chemin un fichier dans lequel PPM écrira les
informations de dépistage.
-------------------------------------------------------------------------
trace-level entier Si 0 ou négatif, le dépistage
[tracing] est désactivé. Tout nombre
entier positif entraîne des
information de dépistage. Plus le
nombre est grand, plus il y aura
d'informations de dépistage.
-------------------------------------------------------------------------
Options PPM: Si vous cherchez les anciennes options comprises par la version antérieure de PPM, voyez l'aide en tapant «help ppm_migration».
Note: Quand vous assignez une valeur, PPM sauve sa configuration. Cela signifie que toutes les valeurs persistent automatiquement d'une session à la suivante. Notez aussi que les noms d'options peuvent être abrégés sous réserve de non ambiguïté. Au lieu de taper «case-sensitivity», vous pouvez taper «case».
target Affiche une liste de cibles target <numéro> Fixe <numéro> comme cible par défaut target describe [numéro] Décrit la cible donnée (ou la cible par défaut) target set <clef> <val> Fixe la cible <clef> à <val>
Une cible est un emplacement où les paquetages sont installés, un répertoire où les paquetages que vous voulez installer sont placés quand ils sont téléchargés du dépôt. Par exemple, entrer:
target
retournera :
Targets: 1. ActivePerl 618 * 2. ActivePerl 630
Cela nous montre que nous avons 2 cibles disponibles et que la deuxième cible (ActivePerl 630) est la cible par défaut, comme indiqué par l'astérisque. La capacité de choisir des cibles différentes permet à PPM de gérer plusieurs installations de Perl avec une seule ligne de commandes.
Note: Actuellement, PPM supporte seulement Perl, mais sera étendu aux autres langages dans un futur proche. Vous pouvez avoir plusieurs versions de Perl sur votre système et chaque version sera reconnue comme une cible unique par PPM.
tree affiche l'arbre des dépendances du paquetage par défaut tree <numéro> affiche l'arbre des dépendances du paquetage <numéro> tree <tranche> affiche les arbres des dépendances d'une tranche tree <nom> affiche l'arbre des dépendances du paquetage <nom>
La commande tree est utilisée pour afficher ce qu'on appelle «l'arbre des dépendances» d'un paquetage donné. C'est une liste de paquetages supplémentaires qui sont requis pour que le paquetage donné fonctionne comme prévu. Par exemple, entrer:
tree SOAP-lite
devrait retourner quelque chose comme ceci:
====================
SOAP-Lite 0.46
|__MIME-tools 5.316
| |__MailTools 1.15
| \__IO-stringy 1.216
|
\__MIME-Lite 2.105
====================
Comme vous pouvez le constater, SOAP-Lite requiert l'installation de quatre autres paquetages avec lui.
Quand tree est appelé sans <nom> ou <numéro>, tree retourne l'arbre
des dépendances du premier paquetage du résultat de la recherche par défaut.
S'il n'y a pas de recherche par défaut, il vous sera demandé d'utiliser
search pour rechercher un paquetage.
uninst Supprime le paquetage installé par défaut uninst <numéro> Supprime le paquetage installé <numéro> uninst <tranche> Supprime les paquetages installés de la <tranche> uninst <nom> Supprime le paquetage installé <nom>
Comme la commande remove, uninstall vous permet de supprimer
des paquetages installés. Cela peut être fait par nom ou par liste
des numéros des paquetages. Aussi, comme la commande remove, désinstaller
n'importe quel paquetage efface les requêtes antérieures.
Voir aussi : Remove
upgrade [*] Liste les mises à jour disponibles pour tous les
paquetages installés
upgrade <numéro> Met à jour le paquetage installé <numéro>
upgrade <tranche> Met à jour les paquetages installés de la <tranche>
upgrade <nom> Met à jour le paquetage <nom>
Il y a plusieurs modificateurs à la commande upgrade, ainsi :
OPTION DESCRIPTION Install Installe les mises à jour plutôt que les lister Precious Autorise la mise à jour des paquetages "précieux" Force Voir "install" Follow Voir "install"
Par défaut, la commande upgrade seule ne fait que lister les mises à jour disponibles.
Pour installer réellement toutes les mises à jour disponibles, entrez :
upgrade -install
Pour autoriser la mise à jour des paquetages «précieux», tapez :
upgrade -install -precious
Version Affiche le numéro de la version du PPM installé.
Un résumé des commandes de PPM version 2 est donné ci-dessous. Tapez
help <commande> au prompt de PPM pour obtenir des détails. Les items
entre [crochets] sont optionnels.
COMMANDE FONCTION
-------------------------------------------------------------------------
genconfig écrit dans STDOUT un fichier de configuration
minimal [Note: genconfig ne marche que depuis la
ligne de commande]
-------------------------------------------------------------------------
help [commande] liste les commandes disponibles ou une aide
sur [commande]
-------------------------------------------------------------------------
install package1 [package2...]
installe les paquetages spécifiés.
-------------------------------------------------------------------------
quit termine le programme.
-------------------------------------------------------------------------
query [motif] liste les paquetages installés, ou les paquetages
correspondant au [motif].
-------------------------------------------------------------------------
query /abstract [motif]
liste les descriptions des paquetages installés ou
les descriptions qui contiennent le motif.
-------------------------------------------------------------------------
remove package1 [package2...]
supprime du système les paquetages spécifiés.
-------------------------------------------------------------------------
search [motif] liste les paquetages disponibles, ou ceux
contenant [motif]
-------------------------------------------------------------------------
search /abstract [motif]
liste les descriptions des paquetages disponibles
ou ceux dont la description contient [motif]
-------------------------------------------------------------------------
set fixe/affiche les options courantes.
-------------------------------------------------------------------------
set save sauvegarde les options courantes.
-------------------------------------------------------------------------
verify [package1...] vérifie que les fichiers couramment installés
sont à jour.
-------------------------------------------------------------------------
verify /upgrade [package1...]
installe les mises à jour disponibles des paquetages.
-------------------------------------------------------------------------
version affiche le numéro de version de PPM.
-------------------------------------------------------------------------
Un motif est une chaîne de recherche exactement comme une expression rationnelle - par exemple, si vous cherchez avec cette commande :
search ODBC|DBI
(qui signifie 'recherche les paquetages dans lesquels les caractères ODBC et/ou les caractères DBI sont présents dans cet ordre' vous obtenez un résultat comme celui-ci :
Apache-DBI DBD-ODBC DBI FindBin Win32-ODBC
Notez que si vous utilisez 'search /abstract [motif]' , la recherche se
fera non seulement sur les noms, mais aussi sur la section ABSTRACT des
fichiers de paquetage.
Par défaut, PPM utilisera le dépôt ActiveState, mais il existe d'autres dépôts sur Internet. Pour l'instant les dépôts suivants sont en ligne :
Note: la plupart de ces dépôts sont pour ActivePerl 5xx seulement; ils peuvent ne pas être compatibles avec ActivePerl 6xx. Regardez dans ces dépôts pour avoir les mises à jour les plus récentes :
[ Le module PPM-Repositories contient une liste mise à jour de tous les dépôts connus; voir sur le CPAN :
http://theoryx5.uwinnipeg.ca/CPAN/data/PPM-Repositories/Repositories.html
On peut naturellement l'installer avec PPM depuis le dépôt d'ActiveState.
NdT]
Pour utiliser ces dépôts de paquetages, lancez PPM (version 3) et, au prompt, tapez :
repository add NOM URL
où NOM est le nom sous lequel vous voulez référencer le dépôt dans PPM et où URL est l'URL du dépôt. Notez que NOM est optionnel, car PPM assignera un nom au dépôt pour vous. Par exemple, entrer :
repository add JENDA http://Jenda.Krynicky.cz/perl
créera un dépôt pour vous, de nom JENDA, et vous donnera accès aux modules disponibles là-bas.
Pour utiliser ces dépôts de paquetages, lancez PPM2 et, au prompt, tapez
set repository NOM URL
où NOM est le nom sous lequel vous voulez référencer le dépôt dans PPM et où URL est l'URL du dépôt. Par exemple, vous pouvez taper :
set repository JENDA http://Jenda.Krynicky.cz/perl
La prochaine fois que vous utiliserez search, vous effectuerez non
seulement une recherche dans le dépôt d'ActiveState mais aussi dans tous
les dépôts que vous aurez ajoutés. Avant de quitter PPM, vous devrez
sauvegarder les changements dans la configuration avec la commande set
save.
Si vous voulez créer un paquetage PPM pour l'utiliser sur une autre machine vous devez faire comme ceci :
Spécifiez les paramètres AUTHOR et ABSTRACT dans le fichier Makefile.PL. Cependant vous ne devez les passer à WriteMakefile que si la version de Perl est supérieure à 5.005 - les Perl plus anciens n'ont pas ces paramètres, et ne les attendent pas. Voici un exemple de Makefile.PL:
use ExtUtils::MakeMaker;
# See lib/ExtUtils/MakeMaker.pm for details of how to influence
# the contents of the Makefile that is written.
WriteMakefile(
'NAME' => 'Term::Control',
'VERSION_FROM' => 'Control.pm', # finds $VERSION
($] ge '5.005') ? (
'AUTHOR' => 'Johnny Doel (johnny@doel.org)',
'ABSTRACT' => 'Control the IO for terminals',
) : (),
);
Ensuite vous faites l'archive avec la commande :
perl Makefile.PL
nmake
Les fichiers résultants sont placés dans le répertoire blib qui est créé quand
vous lancez nmake. Ces fichiers doivent être compactés dans une archive ainsi :
tar cvf I<package>.tar blib
gzip --best I<package>.tar
Vous avez maintenant une archive appelé package.tar.gz. Ensuite vous engendrez le fichier ppd avec :
nmake ppd
Vous devez éditer le fichier PPD et ajouter l'emplacement de l'archive dans <CODEBASE HREF=«» />. Ce chemin est relatif par rapport au fichier PPD.
Vous pouvez obtenir nmake depuis
ftp://ftp.microsoft.com/Softlib/MSLFILES/nmake15.exe
Vous pouvez obtenir tar et gzip depuis
http://unxutils.sourceforge.net/
Si vous utilisez un serveur proxy ou un firewall, vous pouvez avoir des problèmes avec PPM.
NOTE : Si aucune des modifications décrites dans ce document ne marche pour vous, vous pouvez télécharger des paquetages individuels ici [ActivePerl 801 et plus]
http://www.activestate.com/PPMpackages/5.8/zips
ou ici [ActivePerl 613 et plus]
http://www.activestate.com/PPMpackages/5.6/zips
ou encore ici [ActivePerl 522 et moins]
http://www.activestate.com/PPMpackages/5.005/zips)
et les installer en suivant les indications du fichier README contenu dans
l'archive ZIP. Si vous le voulez, vous pouvez aussi créer un dépôt local, avec
plusieurs fichiers .ppd dans un répertoire dépôt permanent, et leurs fichiers
.tar.gz associés dans un sous-répertoire nommé x86.
Sous Windows 2000
Faites un clic droit sur «Poste de travail», cliquez sur «Propriétés» et sélectionnez le panneau «Avancé». Cliquez sur le bouton «Variables d'environnement» et effectuez les changements suivants dans la fenêtre «Variables système» :
http://»), suivi
par deux points et le port du proxy, si nécessaire; par exemple :
«http://proxy:8080/»
Si un nom d'utilisateur et/ou un mot de passe est requis pour accéder à
votre proxy, utilisez le bouton «Nouveau» pour ajouter les variables
HTTP_proxy_user et HTTP_proxy_pass, avec respectivement votre nom
d'utilisateur et votre mot de passe comme valeur.
Sous Windows NT
Cliquez droit sur «Poste de Travail», cliquez sur «Propriétés», sélectionnez l'onglet «Environnement». C'est votre configuration d'environnement. Faites les changements suivants :
http://proxy:8080».
Ajouter HTTP_proxy_user, avec votre nom d'utilisateur comme valeur
Ajouter HTTP_proxy_pass, avec votre mot de passe comme valeur
Sous Windows 9x
Dans votre fichier AUTOEXEC.BAT, rajouter les lignes suivantes et redémarrer pour que les changements prennent effet :
SET HTTP_proxy=<votre proxy> (vous devez inclure «http://» >, suivi par deux
point et le port du proxy, si nécessaire; par exemple «SET HTTP_proxy=http://proxy:8080».
SET HTTP_proxy_user=<votre nom d'utilisateur>
SET HTTP_proxy_pass=<votre mot de passe>
Cette FAQ a été à l'origine assemblée et maintenue par Evangelo Prodromou. Elle a été révisée et mise à jour par Brian Jepson de O'Reilly and Associates, David Grove, David Dmytryshynet et Murray Nesbitt d'ActiveState, Henning Michael Møller-Nielsen de RTO, Kevin Meltzer, et David Sparks d'ActiveState.
Cette FAQ est dans le domaine public. Si vous l'utilisez, cependant, vérifiez, s'il vous plaît, que vous donniez le crédit aux auteurs originaux.
Cette traduction française correspond à la version anglaise distribuée avec perl 5.8.0. Pour en savoir plus concernant ces traductions, consultez http://www.enstimac.fr/Perl/ .
Fabien Martinet <ho.fmartinet@cma-cgm.com>
Jean-Louis Morel <jl_morel@bribes.org> (mise à jour perl 5.8.0)
| perlwin32faq11 - Utiliser PPM pour installer des modules |