Ubuntu Manpage: bilibop.conf - fichier de configuration des paquets bilibop

NOM

       bilibop.conf - fichier de configuration des paquets bilibop

SYNOPSIS

       /etc/bilibop/bilibop.conf

DESCRIPTION

       bilibop.conf est le fichier de configuration des paquets bilibop-* qui sont prévus pour être utilisés sur
       des  systèmes  tournant  depuis un périphérique externe et modifiable (USB, FireWire, MMC, eSATA). Il est
       composé de paires VARIABLE=VALEUR où VARIABLE est une chaîne commençant par 'BILIBOP_',  et  VALEUR  doit
       être  entourée  de  guillemets si elle contient des caractères d'espacement (espaces ou tabulations). Les
       espaces autour du signe égal (=) ne sont pas permis. Les lignes vides ou celles commençant par  un  signe
       dièse (#) sont ignorées.

       Les  options de configuration valides peuvent être divisées en sections 'commune' et 'spécifiques', comme
       suit:

VARIABLES COMMUNES

   BILIBOP_COMMON_BASENAME
       Cette variable définit le nom des sous-répertoires (ou d'un lien symbolique) propres à bilibop qui seront
       créés dans /dev et /run au  moment  du  démarrage,  depuis  l'environnement  du  disque  mémoire  initial
       (initramdisk)  ou depuis le système en cours d'éxécution. Si elle est vide ou non définie, sa valeur sera
       'bilibop'. Si vous la modifiez, vous devez prendre garde  que  certains  liens  symboliques  ou  réglages
       personnels  de  votre  système reflètent correctement cette nouvelle valeur. Au minimum, si bilibop-rules
       est installé, vous devriez exécuter les scripts d'aide fournis par ce paquet, soit à la main,  soit  avec
       'dpkg-reconfigure bilibop-rules'. Donc ce n'est peut-être pas une bonne idée de la modifier.

       Par défaut, la valeur de cette variable n'est pas fixée.

VARIABLES SPÉCIFIQUES À BILIBOP-LOCKFS

BILIBOP_LOCKFS
Cette variable définit le comportement principal du script initramfs bilibop-lockfs. Sa valeur est de
type booléen:

Si elle est fixée à false, le système démarrera normalement, et les autres variables BILIBOP_LOCKFS_*
seront ignorées, à l'exception de BILIBOP_LOCKFS_NOTIFY_POLICY. Si elle est fixée à true, le script
initramfs déplacera le système de fichiers racine du système vers un point de montage utilisé comme
branche inférieure et accessible en lecture seule d'un point de montage aufs(5) ou overlay utilisé
lui-même comme racine du système. Après quoi le fichier temporaire et accessible en écriture /etc/fstab
sera modifié pour préparer les autres systèmes de fichiers à être montés comme branches non modifiables
d'autres systèmes de fichiers aufs ou overlay.

Si cette variable ne vaut rien ou vaut n'importe quoi d'autre, une heuristique sera utilisée pour la
fixer à true ou false, ceci dépendant de l'attribut 'removable' (amovible) du disque dans sysfs, sachant
que généralement les clés USB sont vues comme media amovibles (true), et les disques durs externes sont
vus comme media non amovibles (false).

Dans tous les cas, la valeur de cette variable peut être écrasée depuis la ligne de commande de démarrage
en ajoutant 'lockfs' ou 'nolockfs' aux paramètres du noyau. Cependant, si le périphérique est verrouillé
physiquement par un commutateur, cela sera detecté et les paramétrages précédents seront écrasés pour
fixer BILIBOP_LOCKFS à true.

Par défaut, la valeur de cette variable n'est pas fixée.

BILIBOP_LOCKFS_POLICY
Cette variable definit un niveau additionnel de verrouillage ('lock') à activer ou non. Sa valeur peut
être écrasée depuis la ligne de commande de démarrage avec 'lockfs=hard' ou 'lockfs=soft'.

• soft
Les branches inférieures des systèmes de fichiers aufs(5) ou overlay utiliseront l'option 'ro'
(readonly). Ensuite, ces systèmes de fichiers accessibles en lecture seule peuvent être remontés
manuellement comme accessibles en lecture-écriture pour permettre à l'administratrice d'y sauvegarder
certains changements. Ce genre d'action est fortement découragé ici, mais reste possible si vous savez
VRAIMENT ce que vous faites; autrement, cela peut mener à des résultats inattendus, dont évidemment la
perte de données.

• hard
Les branches inférieures des points de montage aufs utiliseront l'option 'rr' (real readonly); aufs
utilise cette option pour optimiser certaines opérations internes. De plus, les périphériques bloc
correspondants seront eux aussi paramètrés comme accessibles en lecture seule en utilisant
read_only_volume_list dans lvm.conf(5) pour les Volumes Logiques, ou blockdev(8) pour les autres
périphériques bloc, évitant ainsi l'accès en écriture bas niveau (même par l'administratrice) sur ces
périphériques, et évitant aussi un remontage ultérieur en lecture-écriture.

Si cette variable ne vaut rien ou vaut n'importe quoi d'autre, sa valeur retombera à hard. Cependant, si
le périphérique est verrouillé physiquement, les paramétrages précédents seront écrasés et la politique
hard sera automatiquement appliquée.

Par défaut, la valeur de cette variable n'est pas fixée.

BILIBOP_LOCKFS_UNION_METHOD
Cette variable definit quel module unionfs utiliser de préférence. Comme ce module peut ne pas être
supporté par le noyau en cours d'usage, l'autre module supporté par 'bilibop-lockfs' est appelé en
secours. La valeur de cette variable peut être surchargée depuis la ligne de commande de démarrage avec
'lockfs=aufs' ou 'lockfs=overlay'.

• aufs
Essaie d'utiliser d'abord 'aufs', sinon 'overlay'.

• overlay
Essaie d'utiliser d'abord 'overlay', sinon 'aufs'.

Si cette variable est vide ou non définie, ou vaut n'importe quoi d'autre, sa valeur retombera à aufs.
Ainsi l'installation du paquet aufs-dkms le rend immédiatement utilisable.

Par défaut, la valeur de cette variable n'est pas fixée.

BILIBOP_LOCKFS_PATH_PREFIX
Cette variable définit le répertoire principal sous lequel toutes les branches accessibles en lecture ou
en écriture sont montées. Ce peut être n'importe quelle chaîne de caractères, pour autant que le nom soit
valide et que le répertoire n'éxiste pas encore. Sa valeur peut être surchargée depuis la ligne de
commande de démarrage avec 'lockfs=:prefix' (notez le caractère deux-points, qui sert de marqueur).

Si cette variable est vide ou non définie, sa valeur prendra le nom du module en cours d'utilisation
(c'est à dire aufs ou overlay).

Par défaut, la valeur de cette variable n'est pas fixée.

BILIBOP_LOCKFS_PATH_SCHEME
Cette variable définit la structure de chaque ensemble de branches, au regard des autres. Elle existe
parce que contrairement à aufs, overlay ne permet pas facilement d'imbriquer les points de montage en une
sous-arborscence unique (particulièrement les répertoires accessibles en écriture, ou upperdirs). La
valeur de cette variable peut être surchargée depuis la ligne de commande de démarrage avec
'lockfs=isolated' ou 'lockfs=hybrid' ou 'lockfs=nested'.

• isolated
Chanque ensemble de branches relatif à un montage aufs ou overlay est créé dans un répertoire dédié.
Par exemple, pour une union sur /usr/local, /$union/usr/local/ro et /$union/usr/local/rw sont utilisés.
Avec ce schéma, les branches relatives à un montage $union spécifique sont clairement identifiées, mais
les liens symboliques entre systèmes de fichiers différents sont cassés (sur les branches, pas sur leur
union).

• nested
Toutes les branches en lecture seule sont placées dans une sous-arborescence unique, et toutes les
branches modifiables sont placées dans une autre sous-arborescence. Chacune de ces sous-arborescences
est facile à parcourir, et les liens symboliques sont préservés. Par exemple, pour un montage aufs sur
/usr/local, /aufs/ro/usr/local et /aufs/rw/usr/local sont utilisés. Ce schéma n'est pas disponible avec
overlay, et reste le schéma par défaut avec aufs, par compatibilité avec les versions 0.4.23 et
antérieures de bilibop.

• hybrid
Les branches en lecture seule sont imbriquées (nested), et les branches accessibles en écriture sont
isolées (isolated).

Si cette variable est vide ou non définie, ou vaut n'importe quoi d'autre, sa valeur retombera à nested
avec aufs, et isolated avec overlay.

Par défaut, la valeur de cette variable n'est pas fixée.

BILIBOP_LOCKFS_WHITELIST
Une fois que le système de fichiers racine est verrouillé comme branche inférieure accessible en lecture
seule d'un point de montage pour aufs ou overlay, le fichier /etc/fstab est modifié sur la branche
supérieure et accessible en lecture-écriture, pour verrouiller de la même façon tous les autres systèmes
de fichiers locaux. Cette variable offre la possibilité d'éviter ce mécanisme pour certains points de
montage: il s'agit d'une liste de points de montage ou de noms de périphériques (tels que connus dans
fstab(5)) ou encore de lexèmes ('tokens') de la forme UUID=fsuuid, LABEL=fslabel ou TYPE=fstype séparés
par des espaces. Si l'étiquette (LABEL) d'un système de fichiers contient elle-même des espaces,
remplacez-les par des tirets bas (_), comme donnés par la sortie des commandes 'udevadm info --query
property --name PÉRIPHÉRIQUE' ou 'blkid -o udev -p PÉRIPHÉRIQUE' pour les variables ID_FS_UUID,
ID_FS_LABEL et ID_FS_TYPE. Notez que lister ici un point de montage, un nom de périphérique ou n'importe
quel lexème qui correspond littéralement à une entrée du fichier fstab fait que le périphérique est
filtré au niveau du script initramfs, ce qui est plus rapide. Autrement, mount.lockfs(8) cherchera à
partir des métadonnées du périphérique s'il doit le sauter ou pas.

Notez que le montage sur /usr étant maintenant effectué dans l'initramfs, son verrouillage doit être fait
aussi dans l'initramfs. Cela signifie que seul l'analyseur simpliste de cette phase du démarrage est
disponible à ce moment, et que le moyen le plus simple de lister /usr est de l'appeler /usr, et rien
d'autre, pour éviter des erreurs de démarrage et des résultats inattendus.

Notez aussi qu'il est possible d'écraser (et de vider) la valeur de cette variable en ajoutant
'lockfs=all' sur la ligne de commmande de démarrage. Cela est fait automatiquement quand le périphérique
est verrouillé physiquement. Au contraire, pour ajouter des points de montage à cette liste blanche
depuis la ligne de commande du démarrage, il est aussi possible d'utiliser une option de la forme
'lockfs=-/foobar', où /foobar est le point de montage à ne pas verrouiller; notez qu'il est précédé d'un
signe moins (-).

Par défaut, la valeur de cette variable n'est pas fixée.

BILIBOP_LOCKFS_FALLBACK_POLICY
Si une option de montage ou un type de système de fichiers n'est pas supporté par aufs(5) ou overlay,
mount.lockfs échouera à le verrouiller comme attendu. Cette variable definit la stratégie à appliquer en
cas d'erreur de montage. Sa valeur peut être surchargée depuis la ligne de commande de démarrage avec
'lockfs=ro' ou 'lockfs=asis'.

• ro
Le script d'aide au montage essaiera de monter le système de fichiers de manière standard, mais en
lecture seule pour empêcher des modifications par erreur.

• asis
Le script d'aide au montage essaiera de monter le système de fichiers de manière standard.

Si cette variable est vide ou non définie, ou vaut n'importe quoi d'autre, sa valeur retombera à ro.

Cependant, si le périphérique est verrouillé physiquement, les paramétrages précédents seront écrasés et
la politique ro sera automatiquement appliquée.

Par défaut, la valeur de cette variable n'est pas fixée.

BILIBOP_LOCKFS_SIZE
Par défaut, bilibop-lockfs alloue la moitié de la taille de la mémoire vive (ou TPMFS_SIZE si cette
variable est initialisée dans /etc/default/tmpfs) pour chaque branche supérieure d'un système de fichiers
verrouillé. Il est possible d'écraser cette valeur pour certains points de montage dans une liste de
paires /point/de/montage=taille séparées par des espaces. Les tailles peuvent être absolues (suffixées
par k, K, m, M, g ou G), ou relatives à la quantité totale de mémoire RAM (et suffixées par %). La taille
allouée à la racine du système peut être fixée ici aussi, mais peut être écrasée depuis la ligne de
commade de démarrage avec le paramètre 'lockfs=taille'.

Par défaut, la valeur de cette variable n'est pas fixée.

BILIBOP_LOCKFS_SWAP_POLICY
Cette variable définit la politique d'utilisation des périphériques d'échange (swap) listés dans
/etc/fstab (et optionnellement dans /etc/crypttab). Generalement, il n'y a pas de sens a paramètrer un
espace d'échange sur de la mémoire flash, mais cela peut se faire sur des disques durs externes USB,
FireWire ou eSATA. Cinq politiques sont disponibles:

• soft
Rien n'est modifié: les lignes dans fstab(5) et crypttab(5) sont conservées telles quelles.

• hard
Les entrées relatives aux périphériques 'swap' sont désactivées (commentées) dans fstab et crypttab.

• noauto
Le mot-clé 'noauto' est ajouté à la liste des options relatives aux périphériques 'swap' dans fstab et
crypttab. Cela signifie que ces périphériques peuvent être activés manuellement avec swapon(8).

• crypt
Les entrées relatives aux périphériques 'swap' chiffrés sont conservées, les autres sont désactivées.
ATTENTION: cette option ne fait pas de distinction entre les périphériques swap chiffrés avec une clef
aléatoire (et dont le contenu est irrécupérable après l'arrêt du système) et ceux dont le contenu est
écrit en clair sur un Volume Logique faisant lui-même partie d'un Groupe de Volumes chiffré.

• random
Les entrées relatives aux périphériques 'swap' chiffrés avec une clef aléatoire sont conservées, les
autres sont désactivées.

Si BILIBOP_LOCKFS_SWAP_POLICY n'est pas fixée à une valeur connue, elle retombera à crypt ou hard. Cela
dépend de l'attribut 'removable' (amovible) du disque dans sysfs: pour les media vus comme amovibles
(clés USB), la politique est de ne pas utiliser du tout de périphérique d'échange (hard policy). Notez
que dans tous les cas, l'utilisation de 'swap' peut être désactivée depuis la ligne de commande de
démarrage avec le paramètre noyau noswap, qui n'est pas une option de démarrage spécifique à bilibop(7),
mais fixe la valeur de BILIBOP_LOCKFS_SWAP_POLICY à hard. C'est aussi le cas si le script détecte que le
périphérique est verrouillé physiquement.

Par défaut, la valeur de cette variable n'est pas fixée.

BILIBOP_LOCKFS_NOTIFY_POLICY
Cette variable définit à quelles conditions une notification doit être envoyée à l'utilisatrice pour lui
signifier que des systèmes de fichiers sont ou non verrouillés. De telles notifications peuvent être
envoyées aussi bien au démarrage du système (nécessite que le paquet plymounth soit installé) qu'au
lancement d'une session de bureau (nécessite que le paquet libnotify-bin soit installé). Ce qui suit
décrit les notifications de bureau; les messages de plymouth(8) sont moins bavards. Quatre politiques
sont disponibles:

• always
C'est la valeur de secours quand la variable vaut autre chose que never, lockfs ou nolockfs. Si la
fonctionalité bilibop-lockfs est désactivée, alors une notification sera envoyée pour dire que toutes
les informations de la session peuvent être écrites sur le disque. Si la fonctionnalité est activée,
une notification sera envoyée pour dire que toutes les modifications faites sous les points de montage
aufs ou overlay (listés) seront perdues à l'arrêt du système. Si des systèmes de fichiers ne sont pas
verrouillés, une deuxième notification sera envoyée pour dire que leurs modifications seront conservées
à l'arrêt du système.

• never
Ne jamais envoyer de notification concernant le verrouillage ou non verrouillage des systèmes de
fichiers.

• lockfs
Si la fonctionnalité bilibop-lockfs est activée, alors une notification sera envoyée pour dire que
toutes les modifications faites sous les points de montage aufs ou overlay (listés) seront perdues à
l'arrêt du système.

• nolockfs
Si la fonctionnalité bilibop-lockfs est désactivée, fait la même chose que pour always. Si la
fonctionnalité est activée et que des systèmes de fichiers ne sont pas verrouillés, alors une
notification sera envoyée pour dire que leurs modifications seront conservées après l'arrêt du système.

Dans tous les cas, n'importe quelle utilisatrice peut (pour sa propre session de bureau) écraser le
règlage de l'administratrice en copiant lockfs-notify.desktop (normalement dans /etc/xdg/autostart) dans
son propre répertoire .config/autostart et en modifiant les lignes commençant par Exec= ou Hidden=. Voir
lockfs-notify(1) pour plus de détails.

Par défaut, la valeur de cette variable n'est pas fixée.

VARIABLES SPÉCIFIQUES À BILIBOP-RULES

Contrairement à la plupart des variables précédentes dont les modifications ne prennent effet qu'après le
redémarrage du système, la plupart des variables BILIBOP_RULES_* suivantes, à l'exception notable de la
première, peuvent être modifiées, et les changements immédiatement appliqués au cours de la même session
en éxécutant 'lsbilibop -c'. Voir lsbilibop(8).

BILIBOP_RULES_SYSTEM_INTERNAL
Par défaut, les règles bilibop utilisent les capacités de udisks (versions 1.x et 2.x) pour outrepasser
la détection usuelle du type de bus permettant de détecter si un périphérique est considéré comme 'system
internal', c'est à dire comme disque interne de l'ordinateur. Cela signifie que des privilèges
d'administratrice sont nécessaires pour gérer les périphériques faisant partie du même disque que celui
contenant la racine du système. Si vous n'avez pas besoin de ce comportement global, vous devez
explicitement fixer cette variable à false (les autres valeurs n'ont aucun effet, c'est à dire ont le
même effet que true).

Par défaut, la valeur de cette variable n'est pas fixée.

BILIBOP_RULES_SYSTEM_INTERNAL_WHITELIST
Si BILIBOP_RULES_SYSTEM_INTERNAL n'est pas 'false', toutes les partitions hébergées par le même disque
que la racine du système seront considérées comme 'system internal'. Pour désactiver ce comportement pour
certains périphériques — par exemple si vous voulez qu'une partition soit montable/démontable sans
privilèges — vous pouvez les lister ici, séparés par des espaces. Pour chaque périphérique ou groupe de
périphériques, vous devez spécifier au moins un lexème de la forme UUID=fsuuid, LABEL=fslabel,
TYPE=fstype ou USAGE=fsusage. Si l'étiquette (LABEL) d'un système de fichiers contient elle-même des
espaces, remplacez-les par des tirets bas (_), comme donnés par la sortie des commandes 'udevadm info
--query property --name PÉRIPHÉRIQUE' ou 'blkid -o udev -p PÉRIPHÉRIQUE' pour les variables ID_FS_UUID,
ID_FS_LABEL, ID_FS_TYPE et ID_FS_USAGE.

Par défaut, la valeur de cette variable n'est pas fixée.

BILIBOP_RULES_PRESENTATION_HIDE
Par défaut, les règles bilibop masquent (si possible) les systèmes de fichiers contenus sur le même
disque physique que la racine du système. Cela s'applique aux applications de bureau basées sur udisks
(versions 1.x et 2.x). Si vous ne voulez pas masquer les volumes bilibop, vous devez explicitement fixer
cette variable à false (les autres valeurs n'ont aucun effet, c'est à dire ont le même effet que true).

Par défaut, la valeur de cette variable n'est pas fixée.

BILIBOP_RULES_PRESENTATION_HIDE_WHITELIST
Si BILIBOP_RULES_PRESENTATION_HIDE n'est pas 'false', tous les volumes hébergés sur le même disque que la
racine du système seront cachés à l'utilisatrice. Pour désactiver ce comportement pour certains
périphériques, vous pouvez les lister ici, séparés par des espaces. Pour chaque périphérique ou groupe de
périphériques, vous devez spécifier au moins un lexème de la forme UUID=fsuuid, LABEL=fslabel,
TYPE=fstype ou USAGE=fsusage. Si l'étiquette (LABEL) d'un système de fichiers contient elle-même des
espaces, remplacez-les par des tirets bas (_), comme donnés par la sortie des commandes 'udevadm info
--query property --name PÉRIPHÉRIQUE' ou 'blkid -o udev -p PÉRIPHÉRIQUE' pour les variables ID_FS_UUID,
ID_FS_LABEL, ID_FS_TYPE et ID_FS_USAGE.

Par défaut, la valeur de cette variable n'est pas fixée.

BILIBOP_RULES_PRESENTATION_ICON
Si un périphérique n'est pas caché à l'utilisatrice, il peut être montré avec une autre icône que celle
par défaut. Pour chaque périphérique ou groupe de périphériques auquel vous voulez associer une autre
icône, vous devez spécifier au moins une valeur de la forme UUID=fsuuid:icon, LABEL=fslabel:icon,
TYPE=fstype:icon ou USAGE=fsusage:icon. Le nom de l'icône doit suivre la spécification des thèmes
d'icônes de freedesktop.org. Si l'étiquette (LABEL) d'un système de fichiers contient elle-même des
espaces, remplacez-les par des tirets bas (_), comme donnés par la sortie des commandes 'udevadm info
--query property --name PÉRIPHÉRIQUE' ou 'blkid -o udev -p PÉRIPHÉRIQUE' pour les variables ID_FS_UUID,
ID_FS_LABEL, ID_FS_TYPE et ID_FS_USAGE.

Par défaut, la valeur de cette variable n'est pas fixée.

BILIBOP_RULES_PRESENTATION_NAME
Si un périphérique n'est pas caché à l'utilisatrice, il peut être montré avec un autre nom que celui par
défaut (généralement l'étiquette du système de fichiers). Pour chaque périphérique ou groupe de
périphériques dont vous voulez modifier le nom par défaut, vous devez spécifier au moins une valeur de la
forme UUID=fsuuid:name, LABEL=fslabel:name, TYPE=fstype:name ou USAGE=fsusage:name. Si l'étiquette
(LABEL) d'un système de fichiers contient elle-même des espaces, remplacez-les par des tirets bas (_),
comme donnés par la sortie des commandes 'udevadm info --query property --name PÉRIPHÉRIQUE' ou 'blkid -o
udev -p PÉRIPHÉRIQUE' pour les variables ID_FS_UUID, ID_FS_LABEL, ID_FS_TYPE et ID_FS_USAGE.

Par défaut, la valeur de cette variable n'est pas fixée.

FICHIERS

       /etc/bilibop/bilibop.conf
       /usr/share/doc/bilibop-common/examples/bilibop.conf
       /usr/share/doc/bilibop-lockfs/examples/bilibop.conf
       /usr/share/doc/bilibop-rules/examples/bilibop.conf

VOIR AUSSI

       aufs(5),  bilibop(7),  blkid(8),  crypttab(5),  fstab(5),   lockfs-notify(1),   lsbilibop(8),   mount(8),
       mount.lockfs(8), notify-send(1), plymouth(8), proc(5), udev(7), udevadm(8), udisks(7), udisks(8)

AUTEUR

       Cette  page  de  manuel  a  été traduite de l'anglais par Alexandre Martin <alemar@Safe-mail.net> dans le
       cadre du projet bilibop.

bilibop                                            2020-02-08                                    BILIBOP.CONF(5)