SBOPKG.CONF(5)

NAME
sbopkg.conf - Fichier de Configuration de sbopkg

DESCRIPTION
Le fichier sbopkg.conf contient les paramètres de configuration pour sbopkg(8), un outil pour utiliser le dépôt de SlackBuilds.org ("SBo"), une collection de scripts Slackbuild tiers pour construire des packages Slackware. Le fichier de configuration par défaut est /etc/sbopkg/sbopkg.conf. L'utilisateur peut remplacer n'importe quel paramètre de ce fichier en créant un fichier ~/.sbopkg.conf.

Lisez aussi, s'il vous plait, la section NOTES pour plus d'information sur les variables, y compris $ARCH.

Les options booléennes nécessitent un YES ou un NO et sont insensibles à la casse. Tous les chemins utilisés doivent être absolus.

Voici les différentes options de configuration :

ALLOW_MULTI
    Booléen.

    Si sa valeur est YES, cette option permet à l'utilisateur de lancer plusieurs instances simultanées de sbopkg

    Comprenez bien que cette option est là pour votre commodité, mais étant donné le nombre d'erreurs potentielles qu'elle peut entraîner (et nous n'allons pas tenter de prévoir toutes les bêtises que peut faire un utilisateur), il faut considérer que c'est une fonctionnalité EXPÉRIMENTALE et NON PRISE EN CHARGE. Si vous rencontrez des problèmes, vérifiez bien qu'ils ne viennent pas d'actions inappropriées de votre part. Pour information, voici quelques unes des choses à ne pas faire lors de l'utilisation de cette option :

    •   Lancer plusieurs instances avec un mélange de paramètres YES et de paramètres NO

    •   Synchroniser un dépôt lorsqu'une autre instance l'utilise.

    •   Changer de branche sur un depôt git lorsqu'une autre instance l'utilise (cet avertissement ne concerne pas les dépôts rsync)

    •   Compiler ou installer simultanément le même logiciel à partir de différentes instances

    •   Sauvegarder une file d'attente en cours d'utilisation par une autre instance

    Il peut y avoir encore d'autres situations dangereuses auxquelles nous n'avons pas pensé. Soyez prudents.

    La valeur par défaut est :

    xxxALLOW_MULTIxxx

CLEANUP
    Booléen.

    Quand il vaut YES, les fichiers source décompressés et l'arborescence du paquet dans $TMP sont effacés immédiatement après la construction, alors que l'archive source et le paquet réalisé sont conservés dans $SRCDIR et $OUTPUT.

    Un effet secondaire de CLEANUP à YES est que TMP a pour valeur le répertoire temporaire de sbopkg ($TMPDIR/sbopkg.RANDOM_STRING) et toute autre configuration de TMP est ignorée.

    La valeur par défaut est :

    xxxCLEANUPxxx

DEBUG_UPDATES
    Énumeration.

    Cette option peut prendre les valeurs 0, 1, ou 2. DEBUG_UPDATES définit le niveau de débogage par défaut de la liste de mise à jour de sbopkg. Quand elle vaut 0, on affiche seulement les paquets pouvant être mis à jour (ou dégradés). Quand elle vaut 1, on affiche les paquets qui peuvent être mis à jour, les paquets qui ne sont pas dans le dépôt et les paquets qui sont plus neufs que ceux du dépôt. Quand elle vaut 2, on affiche aussi tous les paquets non à jour. Modifier DEBUG_UPDATES à 1 ou 2 peut être utile si la liste des mises à jour parait incompléte.

    La valeur par défaut est :

    xxxDEBUG_UPDATESxxx

DIFF
    Commande.

    Cette option permet à l'utilisateur de définir le programme de comparaison à utiliser quand sbopkg affiche les différences entre fichiers édités.

    La valeur par défaut est :

    xxxDIFFxxx

DIFFOPTS
    Options de commande.

    Cette option permet à l'utilisateur de définir les options utilisées par le programme $DIFF quand sbopkg affiche les différences entre fichiers édités.

    La valeur par défaut est :

    xxxDIFFOPTSxxx

KEEPLOG
    Booléen.

    Cette option permet à l'utilisateur de conserver un journal permanent des paquets qui sont construits avec sbopkg pour pouvoir revoir les compilations pour mémoire ou pour d'éventuelles erreurs. Voir LOGFILE pour l'emplacement de ce journal.

    La valeur par défaut est :

    xxxKEEPLOGxxx

LOGFILE
    Chemin.

    Cette option définit l'emplacement du journal de compilation si l'option KEEPLOG vaut YES.

    La valeur par défaut est :

    xxxLOGFILExxx

MKDIR_PROMPT
    Booléen.

    Quand il vaut YES, sbopkg demandera confirmation avant de modifier le système de fichiers en créant ses répertoires. Si vous ne souhaitez pas avoir à confirmer (par exemple, certains de ces répertoires sont dans un système de fichiers temporaires et vous ne voulez avoir à confirmer à chaque réinitialisation du système de fichiers), vous pouvez mettre cette valeur à NO.

    La valeur par défaut est :

    xxxMKDIR_PROMPTxxx

OUTPUT
    Chemin.

    Cette option définit le répertoire où seront sauvegardés les paquets compilés. OUTPUT doit être exporté car il est aussi utilisé par les SlackBuilds SBo. À noter que La valeur par défaut de OUTPUT est donc la même que celle des SlackBuildS SBO.

    La valeur par défaut est :

    xxxOUTPUTxxx

QUEUEDIR
    Chemin.

    Cette option définit le répertoire dans lequel seront enregistrées les files d'attente sauvegardées.

    La valeur par défaut est :

    xxxQUEUEDIRxxx

REPO_BRANCH
    Énumeration.

    Cette option permet à l'utilisateur de définir la branche active par défaut. Les valeurs actuellement possibles sont indiquées dans le fichier repos.d/* et peuvent aussi être affichées en tapant

        # sbopkg -V ?

    La valeur par défaut est :

    xxxREPO_BRANCHxxx

REPO_NAME
    Énumeration.

    Cette option permet à l'utilisateur de choisir le dépôt à utiliser. Voir REPO_BRANCH pour savoir comment obtenir une liste des valeurs admises. Le choix "local" correspond à un dépôt géré par l'utilisateur et dont la structure doit être identique à celle de SBo, c'est à dire avec une hiérarchie category/package/files Note : toutes les variables REPO_* sont concernées par les fichiers de dépôt gérés dans le répertoire /etc/sbopkg/repos.d. Lire le fichier README-repos dans le répertoire de documentation de sbopkg

    La valeur par défaut est :

    xxxREPO_NAMExxx

REPO_ROOT
    Chemin.

    Cette option permet à l'utilisateur de définir l'emplacement des miroirs locaux des dépôts externes. Actuellement la taille d'une copie locale du dépôt SBo est d'environ xxxSIZExxx.

    La valeur par défaut est :

    xxxREPO_ROOTxxx

RSYNCFLAGS
    Options de commande.

    Rsync est utilisé par sbopkg pour dupliquer le dépôt de SlackBuilds.org. Cette option permet à l'utilisateur d'ajuster les indicateurs (options) de rsync utilisés par sbopkg. Les utilisateurs sont mis en garde contre toute modification des valeurs par défaut de ces indicateurs, de nouvelles valeurs pouvant fonctionner ou non. Note : la commande rsync de sbopkg utilise déjà les indicateurs --archive, --delete, --no-owner, et --exclude il n'est donc pas nécessaire de les ajouter dans les options de RSYNCFLAGS Modifier ces options par défaut n'est pas conseillé. Cependant, --timeout est une option utile à tester en cas d'erreur de synchronisation.

    La valeur par défaut est :

    xxxRSYNCFLAGSxxx

SRCDIR
    Chemin.

    Cette option indique l'emplacement du répertoire cache qui contiendra la sauvegarde des sources téléchargés.

    La valeur par défaut est :

    xxxSRCDIRxxx

TMP Chemin.

    Cette option définit le répertoire dans lequel seront sauvegardés les paquets construits. TMP doit être exporté car il est aussi utilisé par les SlackBuilds SBo. À noter que la valeur par défaut de TMP est donc identique à celle des SlackBuildS SBo.

    À noter aussi que si la variable CLEANUP vaut YES, toute personnalisation de TMP est ignorée

    La valeur par défaut est :

    xxxTMPxxx

TMPDIR
    Path.

    Cette option indique le répertoire dans lequel certains fichiers de travail spécifiques à sbopkg seront sauvegardés temporairement. À noter que cette variable est actuellement utilisée par mktemp(1), et que le répertoire actuel est codé en dur, en interne, par sbopkg.XXXXXX où 'XXXXXX' est une chaîne aléatoire. Cette variable détermine le répertoire conteneur utilisé. Si /tmp n'est pas le répertoire conteneur approprié, la valeur de TMPDIR peut être modifiée dans la ligne de commande en appelant sbopkg ou dans le fichier sbopkg.conf.

    La valeur par défaut est :

    xxxTMPDIRxxx

WGETFLAGS
    Options de commande.

    Wget est utilisé par sbopkg pour télécharger les sources des paquets à compiler. Cette option permet à l'utilisateur d'ajuster les indicateurs (options) de wget utilisés par sbopkg. Les utilisateurs sont mis en garde contre toute modification des valeurs par défaut de ces indicateurs, de nouvelles valeurs pouvant fonctionner ou non. Cependant, --timeout est une option utile à tester en cas d'erreur de téléchargement.

    La valeur par défaut est :

    xxxWGETFLAGSxxx

NOTES

  Overriding Environmental Variables
Il est possible de définir ou de redéfinir des variables d'environnement et de les exporter vers les scripts SlackBuilds lorsqu'il sont construits avec sbopkg. Ceci est déjà demontré dans l'exemple suivant (et d'autres semblables) dans le fichier sbopkg.conf .

    export TMP=${TMP:-/tmp/SBo}

Ceci définit la valeur de TMP à /tmp/SBo for building SBo packages within pour la construction des paquets SBo dans sbopkg (c'est déjà la valeur par défaut dans les SlackBuilds SBo). Puisque cette variable est exportée, elle peut être modifiée à la fois pour sbopkg et pour la construction des paquets dans sbopkg. Par exemple, modifier cette ligne pour :

    export TMP=${TMP:-/home/sbo/tmp}

définit TMP comme /home/sbo/tmp pour la construction des paquets SBo, mais permet cependant de l'outrepasser au démarrage en lançant sbopkg ainsi

    # export TMP=foo; sbopkg

OUTPUT peut aussi être modifié pour sauvegarder les paquets compilés dans un autre emplacement que celui par défaut, /tmp.

On peut également exporter dans sbopkg.conf des variables qui ne sont aucunement utilisées par sbopkg .

  À propos de la variable ARCH
Vous pouvez vous demander pourquoi ARCH n'est pas configuré dans le fichier par défaut sbopkg.conf . La raison est qu'il n'a pas à y être. Si ARCH n'est pas défini, sbopkg fait certaines vérifications (utilisant la sortie de uname -m) pour déterminer l'architecture du système. Si cette architecture est x86, x86_64 ou arm*, alors sbopkg définit automatiquement ARCH à i486, x86_64, ou arm, respectivement. Si ARCH est défini, sbopkg récupère cette définition. Ce qui signifie que l'utilisateur peut, par exemple, ajouter export ARCH=i686 dans son .bashrc ou dans un fichier similaire, il peut aussi exécuter, dans un terminal root, quelque chose comme

    # export ARCH=i686; sbopkg

L'utilisateur peut aussi l'ajouter manuellement dans son fichier sbopkg.conf s'il le souhaite. En conclusion, si ARCH n'est pas défini par l'utilisateur et si sbopkg ne détecte pas l'une des architectures citées précédemment, alors ARCH prendra par défaut la valeur définie dans les SlackBuilds. À noter que le SlackBuild peut, dans certains cas, écarter ou outrepasser des paramètres précédents de ARCH si c'est nécessaire pour la compilation.

FILES

/etc/sbopkg/sbopkg.conf
    Fichier qui contient les options de configuration.

~/.sbopkg.conf
    Fichier pour remplacer les options de la configuration système.

/etc/sbopkg/renames.d/*.renames
    Fichiers contenant la liste des logiciels du dépôt SBo qui ont été renommés. Voir le fichier README-renames dans le répertoire de documentation de sbopkg pour plus d'information.

/etc/sbopkg/repos.d/*.repo
    Fichiers pour les différents types de dépôts de sbopkg . Voir le fichier README-repos dans le répertoire de documentation de sbopkg pour plus d'information.

AUTHORS
Willy Sudiarto Raharjo <willysr@sbopkg.org> Chess Griffin <chess@chessgriffin.com>

Mauro Giachero <mauro.giachero@gmail.com>

slakmagik <slakmagik@gmail.com>

VOIR AUSSI
diff(1), mktemp(1), rsync(1), sbopkg(8), uname(1), wget(1), /usr/doc/sbopkg-xxxVERSIONxxx/*

TRADUCTION
Ce document est une traduction réalisée par M.C Collilieux <mccnews@free.fr> le 18 mars 2011. N'hésitez pas à signaler au traducteur, toute erreur dans cette page de manuel. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=en man 5 sbopkg.conf ».