SYSTEMD-ESCAPE(1) systemd-escape SYSTEMD-ESCAPE(1) NOM systemd-escape - Protection de chaines pour une utilisation dans les noms d'unite de systemd SYNOPSIS systemd-escape [OPTIONS...] [CHAINE...] DESCRIPTION systemd-escape peut etre utilise pour proteger des chaines contre l'interpretation pour une inclusion dans les noms d'unite de systemd. Cette commande peut etre utilisee pour proteger des chaines ou supprimer cette protection. Cette commande accepte n'importe quel nombre de chaines sur la ligne de commande et les traite individuellement, l'une apres l'autre. Elles seront affichees sur la sortie standard separees par des espaces. Par defaut, cette commande protege les chaines indiquees a moins que l'option --unescape soit passee, aboutissant a l'operation inverse. Si l'option --mangle est indiquee, un mode special de protection est applique a la place qui suppose que la chaine est deja protegee, mais qui protegera toute chose apparaissant manifestement non protegee. Pour des renseignements sur les algorithmes de protection et de leur suppression, consulter la section concernee dans systemd.unit(5). OPTIONS Les options suivantes sont comprises : --suffix= Ajouter le suffixe de type d'unite indique a la chaine protegee. Cette option prend comme argument un des types d'unite geres par systemd tel que << service >> ou << mount >>. Elle ne peut etre utilisee conjointement avec les options --template=, --unescape ou --mangle. Ajoute dans la version 216. --template= Inserer des chaines protegees dans un modele de nom d'unite. Cet argument prend un modele de nom d'unite tel que tototiti@.service. Avec l'option --unescape, sont attendus des noms d'unite instanciee de ce modele ; leur partie d'instance est extraite et leur protection est supprimee. Cette option ne peut etre utilisee conjointement avec les options --suffix=, --instance ou --mangle. Ajoute dans la version 216. --path, -p Lors de la protection ou de la suppression d'une chaine, cette option suppose que c'est une reference a un chemin de systeme de fichiers. Cela simplifie le chemin (les barres obliques de debut, de fin ou en double sont supprimees, les composants << . >> non operationnels sont supprimes, et pour les chemins absolus les composants << .. >> sont supprimes). Apres la simplification, le chemin ne doit pas contenir de << .. >>. Cela est particulierement utile pour generer des chaines adaptees a la suppression de la protection pour des fichiers d'unite ayant le composant << %f >>. Consulter systemd.unit(5). Ajoute dans la version 216. --unescape, -u Au lieu de proteger les chaines indiquees, supprimer leur protection, ce qui inverse l'operation. Cette option ne peut etre utilisee conjointement avec les options --suffix= ou --mangle. Ajoute dans la version 216. --mangle, -m Cette option se comporte comme l'option --escape, mais protege seulement les caracteres qui ne sont manifestement pas deja proteges, et eventuellement ajoute automatiquement un suffixe de type d'unite approprie a la chaine. Cette option ne peut etre utilisee conjointement avec les options --suffix=, --template= ou --unescape. Ajoute dans la version 216. --instance Avec l'option --unescape, cette option supprime la protection et affiche la partie instance du modele de nom d'unite instanciee. Cela aboutit a une erreur pour un modele non instancie tel que ssh@.service ou un nom qui n'est pas un modele comme ssh.service. Cette option doit etre utilisee conjointement avec l'option --unescape et ne peut etre utilisee conjointement avec l'option --template. Ajoute dans la version 240. -h, --help Afficher un aide-memoire succinct et quitter. --version Afficher une information de version courte et quitter. EXEMPLES Protection d'une seule chaine : $ systemd-escape 'Hallochen, Meister' Hall\xc3\xb6chen\x2c\x20Meister Suppression de la protection d'une seule chaine : $ systemd-escape -u 'Hall\xc3\xb6chen\x2c\x20Meister' Hallochen, Meister Generation d'une unite mount pour un chemin : $ systemd-escape -p --suffix=mount "/tmp//waldi/tototiti/" tmp-waldi-tototiti.mount Generation de noms d'instance de trois chaines ; $ systemd-escape --template=systemd-nspawn@.service 'Mon Conteneur 1' 'conteneurb' 'conteneur/III' systemd-nspawn@Mon\x20Conteneur\x201.service systemd-nspawn@conteneurb.service systemd-nspawn@conteneur-III.service Extraction de la partie instance d'une unite instanciee : $ systemd-escape -u --instance 'systemd-nspawn@Mon\x20Conteneur\x201.service' Mon Conteneur 1 Extraction de la partie instance d'une instance d'un modele particulier : $ systemd-escape -u --template=systemd-nspawn@.service 'systemd-nspawn@Mon\x20Conteneur\x201.service' Mon Conteneur 1 CODE DE RETOUR En cas de succes, 0 est renvoye, autrement, un code d'echec different de zero est renvoye. VOIR AUSSI systemd(1), systemd.unit(5), systemctl(1) TRADUCTION La traduction francaise de cette page de manuel a ete creee par Jean- Paul Guillonneau Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . systemd 259.1 SYSTEMD-ESCAPE(1)