dpatch - En ligne dans le Cloud

PROGRAMME:

Nom

dpatch - système de maintenance des correctifs pour Debian

SYNOPSIS

dépêcher [Options] commander [arguments-commande]

DESCRIPTION

dépêcher est un système de correctifs facile à utiliser pour les paquets Debian, quelque peu similaire au dbs
package, mais beaucoup plus simple à utiliser.

Il vous permet de stocker des correctifs et d'autres modèles de personnalisation simples dans debian/correctifs et
Sinon, cela ne nécessite pas de réorganisation importante de votre arborescence source. Pour obtenir les correctifs
appliqué au moment de la construction, il vous suffit d'inclure un extrait de fichier Makefile, puis de dépendre du
patcher/dépatcher cible dans le construire or espace extérieur plus propre, étape de debian/règles. Pour plus de flexibilité,
tu peux appeler /usr/bin/dpatch directement aussi.

ATTENTION

dépêcher est obsolète, veuillez passer au format de paquet source Debian `3.0 (quilt)'
plutôt. Voir http://wiki.debian.org/Projects/DebSrc3.0#FAQ pour un petit guide sur la façon de faire
le

GLOBAL OPTIONS

Il existe quelques options qui modifient le comportement général de dpatch et ont un effet
non seulement sur une, mais sur la plupart des commandes disponibles.

Ces options globales sont :

--répertoire de travail (-ré) ANNUAIRE
Par défaut, dpatch applique les correctifs à l'arborescence source depuis laquelle il a été exécuté. Avec cela,
option, on peut changer cela et dire à dpatch de travailler sur un arbre différent, bien que
en prenant les patchs de l'actuel.

Notez que cela ne transmettra qu'un deuxième argument aux scriptlets dpatch et ne
accéder au répertoire spécifié. Pour ce faire, utilisez le --chdir option expliquée
ci-dessous.

--chdir (-c)
Lorsque vous utilisez un répertoire de travail différent du répertoire actuel, modifiez-le avant
j'essaie d'appliquer des correctifs.

Ceci doit être utilisé avec le --répertoire de travail option.

--stricte (-S)
Activez le mode strict, ce qui signifie que dpatch se retirera plus tôt que prévu, même en cas d'avertissement.
(comme lorsque vous essayez d'appliquer un patch qui est déjà appliqué - normalement, il le fera
(sautez-le simplement).

--Obliger (-F)
Forcer l'application ou la désapplication des correctifs, même si dpatch le ferait normalement
sautez-les car l'opération a déjà été effectuée plus tôt.

--avec-cpp
Forcer l'utilisation de cpp. Remplace l'utilisation de DPATCH_OPTION_CPP=1 option
debian/patches/00options fichier.

COMMANDES

Pièce manipulation commandes
Il existe une syntaxe générique pour toutes les commandes de gestion des correctifs, à savoir que la commande
lui-même prend une liste de noms de dpatch avec lesquels travailler, puis fait ce qu'il est censé faire sur tous
d'entre eux, dans le même ordre exact dans lequel ils ont été spécifiés sur la ligne de commande.

Ensuite, il existe une version de chaque commande de gestion des correctifs avec un -tout suffixe, qui fait
ne prend aucun argument et exécute l'action nécessaire pour chacun des arguments disponibles
dépêche.

La dernière variante est une commande avec un -jusqu'à or -jusqu'à suffixe, qui n'en prend qu'un
Argument : le nom d'un dpatch. L'action correspondante sera appliquée à tous les dpatchs.
jusqu'à et y compris celui spécifié.

vous inscrire [Options]
pièce [Options]
Applique un ou plusieurs dpatches à l'arborescence de travail (le répertoire courant, sinon
(sauf indication contraire). Par défaut, les correctifs spécifiés seront appliqués exactement de la même manière.
l'ordre dans lequel ils ont été spécifiés.

Options
--stampdir=annuaire, -s=annuaire
Mettre les fichiers de timbres dans annuaire au lieu de la valeur par défaut debian/correctif.
--Aidez-moi (-h)
Imprimez un court message d'aide sur la commande.
--silencieux (-q)
Force la commande à ne rien imprimer.
--verbeux (-v)
Désactive le masquage de la sortie du scriptlet.

retirer [Options]
annuler le patch [Options]
Désapplique un ou plusieurs dpatches à l'arborescence de travail (le répertoire courant, sinon
(sauf indication contraire). Par défaut, les correctifs spécifiés seront désactivés dans l'ordre inverse.
l'ordre dans lequel ils ont été spécifiés, car on devrait généralement les supprimer dans l'ordre inverse
(par rapport à l'ordre d'application, bien sûr).

Options
--stampdir=annuaire, -s=annuaire
Utiliser des fichiers de tampons dans annuaire au lieu de la valeur par défaut debian/correctif.
--Aidez-moi (-h)
Imprimez un court message d'aide sur la commande.
--silencieux (-q)
Force la commande à ne rien imprimer.
--verbeux (-v)
Désactive le masquage de la sortie du scriptlet.

cat [Options]
Imprimer les méta-informations sur un dpatch, telles que son nom, son auteur et sa description
(dont chacun peut être désactivé avec l'option appropriée).

Options
--pas de méta, --desc-uniquement (-nm, -ré)
Imprimez uniquement la description du patch.
--auteur-uniquement (-à)
Imprimez uniquement l'auteur du patch.
--no-desc, (-nd)
N'imprimez pas la description du patch.
--Aidez-moi (-h)
Imprimez un court message d'aide sur la commande.
--silencieux (-q)
Force la commande à ne rien imprimer.

liste [Options]
Liste le nom des correctifs donnés. Cette commande n'est pas vraiment utile, sauf
tout lister variante, qui répertorie tous les correctifs disponibles.

Options
--Aidez-moi (-h)
Imprimez un court message d'aide sur la commande.

statuts [Options]
Imprime l'état des correctifs donnés - s'ils sont appliqués au travail
arbre ou pas.

Options
--stampdir=annuaire, -s=annuaire
Utiliser des fichiers de tampons dans annuaire au lieu de la valeur par défaut debian/correctif.
--Aidez-moi (-h)
Imprimez un court message d'aide sur la commande.
--silencieux (-q)
Force la commande à ne rien imprimer.

enregistrer [Options]
Affiche le journal des tentatives de correctifs données.

Options
--stampdir=annuaire, -s=annuaire
Utiliser des fichiers de tampons dans annuaire au lieu de la valeur par défaut debian/correctif.
--Aidez-moi (-h)
Imprimez un court message d'aide sur la commande.
--silencieux (-q)
Force la commande à ne rien imprimer, mais les journaux sans supplément
sucre sur le dessus.

Appelez-nous [Options]
Appeler un dpatch avec un argument spécifié par l'utilisateur. Tous les arguments avec un paquet- le préfixe est
garantis comme n'étant pas utilisés par dpatch lui-même, et sont réservés à une utilisation avec ce même
commander.

Cette commande est particulièrement utile pour extraire des méta-informations personnalisées de dpatch
scriptlets.

Options
--argument=arg (-a=arg)
Appelez les patchs avec arg comme argument.
--Aidez-moi (-h)
Imprimez un court message d'aide sur la commande.
--silencieux (-q)
Force la commande à ne rien imprimer.

Divers commandes
modèle de patch [Options] [nom de patch] [la description]
Imprimez un modèle de script dpatch quasi-standard, basé sur les informations fournies sur le
ligne de commande. Si un la description étant donné, il sera plié à environ 72 caractères en
plusieurs lignes de manière appropriée.

Lors de l'ajout du modèle à STDIN, le contenu de l'entrée standard sera
imprimé juste après le modèle.

Options
--préfixer (-p)
Ajoutez le modèle à STDIN.
--Aidez-moi (-h)
Imprimez un court message d'aide sur la commande.

vous aider (--aide, -h) [commander]
Tenter de donner une aide un peu plus détaillée sur dpatch lui-même, ou sur un
commande dpatch.

version
Imprime le numéro de version de dpatch et quitte.

DPATCH IN DEBIAN FORFAITS

Il existe deux manières différentes d'utiliser dpatch dans debian/règles: en l'appelant directement, ou
comme dpatch.make(7). Seule la première méthode sera décrite ici ; la seconde a
sa propre page de manuel.

REMARQUE:Les exemples suivants nécessitent également l'ajout du .PAS PARALLÈLE drapeau à la tête de
debian/règles puisque les listes de dépendances dépendent de l'ordre d'exécution. Sans
.PAS PARALLÈLE, l'ordre d'exécution peut être erroné avec plusieurs threads make (le -j
option).

Dans la plupart des situations, il sera préférable d'exécuter dpatch dès que possible pendant le processus de construction.
possible. La manière dont cela peut être accompli dépend fortement des debian/règles.
Cependant, dans la pratique courante, la plupart des packages ont un construire (ou tampon de construction), config.statut, ou
configurer (ou configurer-timbre) cible. Le moyen le plus simple de faire de l'envoi de messages la toute première
chose, il suffit d'écrire une règle qui appelle dpatch, et de l'ajouter à la liste des
conditions préalables à la cible appropriée (voir ci-dessus).

Retirer des patchs peut être facile ou un peu plus délicat. Si rien ne se trouve dans le espace extérieur plus propre, règle touche
fichiers modifiés par dpatches (créant des modifications incompatibles), vous pouvez les ajouter en toute sécurité annuler le patch à
la liste des espace extérieur plus propre, dépendances des règles.

Si les correctifs peuvent affecter le système de construction, ils doivent être désappliqués après la source
L'arbre a été nettoyé. Pour cela, renommez l' espace extérieur plus propre, cibler, par exemple, propre et rapiécé, écrire un
règle qui appelle dpatch pour désappliquer les dpatches et en créer un nouveau espace extérieur plus propre, règle qui a
propre et rapiécé et annuler le patch comme conditions préalables.

Prenons un exemple ! Commençons par examiner les passages pertinents de l'original.
debian/règles de notre paquet imaginaire :

config.status : configurer
./configure --prefix=/ usr --mandir=/ Usr / share
construction : config.status
${MAKE}
nettoyer:
$(testdir)
$(racine de test)
${MAKE} distclean
rm -rf debian/paquet-imaginaire debian/fichiers debian/substvars

Après la mise à jour, cela ressemblerait à ceci :

config.status : configuration du correctif
./configure --prefix=/ usr --mandir=/ Usr / share
construction : config.status
${MAKE}
nettoyer : nettoyer-corrigé dépatcher
nettoyé et corrigé :
$(testdir)
$(racine de test)
${MAKE} distclean
rm -rf debian/paquet-imaginaire debian/fichiers debian/substvars

patch : patch-tampon
timbre-patch :
dpatch s'applique à tous
dpatch cat-all >patch-stamp

annuler le correctif :
dpatch désappliquer-tout
rm -rf patch-stamp debian/patché

L'ajout de dépêcher scriptlets à a paquet
Lors de l'utilisation de dpatch, on souhaite sûrement indiquer au système quels dpatchs appliquer et lesquels
à jeter. Dans la situation la plus courante, il suffit de lister les noms des
dpatches (les noms de fichiers relatifs à debian/correctifs) dans debian/patches/00list. Ces palmes
ont généralement l'extension .dpatch et l'extension peut être omise, donc un fichier
debian/patches/01_one_patch.dpatch s'écrit 01_one_patch à l'intérieur debian/patches/00list

Cependant, il peut y avoir des situations où quelque chose de plus flexible est nécessaire, comme l’application
le même patch sur seulement deux architectures, par exemple, M68K et powerpc. On peut résoudre ce problème en
au moins deux manières très différentes : l'une consiste à répertorier le même patch dans les deux
debian/patches/00list.m68k et debian/patches/00list.powerpc, l'autre est d'utiliser
DPATCH_OPTION_CPP=1 in debian/patches/00optionsLe fichier .00list est transmis cpp
commande avec DEB_BUILD_ARCH ensemble de variables sur l'architecture, et
DEB_BUILD_ARCH_architecture étant réglé sur 1. Avec cpp, notre échantillon debian/patches/00list
pourrait ressembler à ceci:

01_manpage_typo
#si défini(DEB_BUILD_ARCH_m68k) || défini(DEB_BUILD_ARCH_powerpc)
/* Ce patch corrige une panne aléatoire au moment de la construction sur les machines Macintosh. */
02_macintosh_foo
#endif

La création dépêcher scriptlets
Il existe de nombreuses façons de créer des scriptlets dpatch. Ce sont des fichiers exécutables simples,
suivre une convention d'appel standardisée (documentée dans dépêcher(7)).

Vous pouvez lancer votre $EDITOR, ou utiliser dpatch-edit-patch, et vous devriez être prêt.

Dans la plupart des cas, lorsque le fichier dpatch sert uniquement à appliquer un simple patch, il existe une
moyen le plus simple :

dpatch patch-template -p "01_some_patch" "Un patch aléatoire" \
debian/patches/01_some_patch.dpatch

Utiliser dpatch en ligne avec les services onworks.net