.\" -*- coding: UTF-8 -*- '\" t .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH SYSTEMD\-ESCAPE 1 "" "systemd 255" systemd\-escape .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH BEZEICHNUNG systemd\-escape \- Zeichenketten für die Verwendung in Systemd\-Unit\-Namen maskieren .SH ÜBERSICHT .HP \w'\fBsystemd\-escape\fR\ 'u \fBsystemd\-escape\fP [OPTIONEN…] [ZEICHENKETTE…] .SH BESCHREIBUNG .PP \fBsystemd\-escape\fP kann dazu verwandt werden, Zeichenketten für die Aufnahme in Systemd\-Unit\-Namen zu maskieren\&. Der Befehl kann zum Maskieren und zur Entfernung der Maskierung von Zeichenketten verwandt werden\&. .PP Der Befehl akzeptiert auf der Befehlszeile eine beliebige Anzahl von Zeichenketten und verarbeitet diese individuell, eine nach der anderen\&. Es wird sie durch Leerzeichen getrennt auf der Standardausgabe ausgeben\&. .PP Standardmäßig wird dieser Befehl übergebene Zeichenketten maskieren. Falls \fB\-\-unescape\fP übergeben wird, dann wird die umgedrehte Aktion angewandt\&. Falls \fB\-\-mangle\fP angegeben ist, wird stattdessen ein spezieller Maskiermodus angewandt, der annimmt, dass eine Zeichenkette bereits maskiert ist, aber alles maskiert, was offensichtlich noch nicht maskiert aussieht\&. .PP Für Details zu den Maskier\- und Demaskier\-Algorithmen siehe den relevanten Abschnitt in \fBsystemd.unit\fP(5)\&. .SH OPTIONEN .PP Die folgenden Optionen werden verstanden: .PP \fB\-\-suffix=\fP .RS 4 Hängt die angegebene Unit\-Typ\-Endung an die maskierte Zeichenkette an\&. Akzeptiert eine der von Systemd unterstützen Unit\-Typen, wie »service« oder »mount«\&. Darf nicht zusammen mit \fB\-\-template=\fP, \fB\-\-unescape\fP oder \fB\-\-mangle\fP verwandt werden\&. .sp Hinzugefügt in Version 216\&. .RE .PP \fB\-\-template=\fP .RS 4 Fügt die geschützte Zeichenkette in eine Unit\-Namensvorlage ein\&. Akzeptiert eine Unit\-Namensvorlage wie foobar@\&.service\&. Erwartet bei \fB\-\-unescape\fP einen instanziierten Unit\-Namen für die Vorlage und löst nur den Instanzenanteil aus und demaskiert ihn\&. Darf nicht mit \fB\-\-suffix=\fP, \fB\-\-instance\fP oder \fB\-\-mangle\fP zusammen verwandt werden\&. .sp Hinzugefügt in Version 216\&. .RE .PP \fB\-\-path\fP, \fB\-p\fP .RS 4 Beim Maskieren und Demaskieren einer Zeichenkette wird angenommen, dass sie sich auf einen Dateisystempfad bezieht\&. Dies vereinfacht den Pfad (führende, anhängende und doppelte »/«\-Zeichen werden entfernt, nicht Pfad\-relevante »\&.«\-Komponenten werden entfernt und für absolute Pfade werden führende »\&.\&.«\-Komponenten entfernt)\&. Nach der Vereinfachung darf der Pfad keine »\&.\&.« enthalten\&. .sp Dies ist insbesondere für die Generierung von Zeichenketten geeignet, die für das Demaskieren mit dem »%f«\-Kennzeichner in Unit\-Dateien geeignet sind, siehe \fBsystemd.unit\fP(5)\&. .sp Hinzugefügt in Version 216\&. .RE .PP \fB\-\-unescape\fP, \fB\-u\fP .RS 4 Nimmt die Maskierung zurück, anstatt die angegebenen Zeichenketten zu maskieren und invertiert daher die Aktion\&. Darf nicht zusammen mit \fB\-\-suffix=\fP oder \fB\-\-mangle\fP verwandt werden\&. .sp Hinzugefügt in Version 216\&. .RE .PP \fB\-\-mangle\fP, \fB\-m\fP .RS 4 Ähnlich \fB\-\-escape\fP, maskiert aber nur Zeichen, die offensichtlich noch nicht maskiert sind und hängt möglicherweise automatisch eine geeignete Unit\-Typ\-Endung an die Zeichenkette an\&. Darf nicht zusammen mit \fB\-\-suffix=\fP, \fB\-\-template=\fP oder \fB\-\-unescape\fP verwandt werden\&. .sp Hinzugefügt in Version 216\&. .RE .PP \fB\-\-instance\fP .RS 4 Demaskiert und gibt bei \fB\-\-unescape\fP nur den Instanzenanteil der instanziierten Unit\-Namensvorlage aus\&. Im Falle von nicht instanziierten Vorlagen wie ssh@\&.service oder Nichtvorlagennamen wie ssh\&.service führt dies zu einem Fehler\&. Muss zusammen mit \fB\-\-unescape\fP und darf nicht mit \fB\-\-template\fP zusammen verwandt werden\&. .sp Hinzugefügt in Version 240\&. .RE .PP \fB\-h\fP, \fB\-\-help\fP .RS 4 Zeigt einen kurzen Hilfetext an und beendet das Programm\&. .RE .PP \fB\-\-version\fP .RS 4 Zeigt eine kurze Versionszeichenkette an und beendet das Programm\&. .RE .SH BEISPIELE .PP Um eine einzelne Zeichenkette zu maskieren: .sp .if n \{\ .RS 4 .\} .nf $ systemd\-escape \*(AqHallöchen, Meister\*(Aq Hall\exc3\exb6chen\ex2c\ex20Meister .fi .if n \{\ .RE .\} .PP Um die Maskierung einer einzelnen Zeichenktte zurückzunehmen: .sp .if n \{\ .RS 4 .\} .nf $ systemd\-escape \-u \*(AqHall\exc3\exb6chen\ex2c\ex20Meister\*(Aq Hallöchen, Meister .fi .if n \{\ .RE .\} .PP Um eine Einhänge\-Unit für einen Pfad zu generieren: .sp .if n \{\ .RS 4 .\} .nf $ systemd\-escape \-p \-\-suffix=mount "/tmp//waldi/foobar/" tmp\-waldi\-foobar\&.mount .fi .if n \{\ .RE .\} .PP Um Namensintanzen von drei Zeichenketten zu erzeugen: .sp .if n \{\ .RS 4 .\} .nf $ systemd\-escape \-\-template=systemd\-nspawn@\&.service \*(AqMein Container 1\*(Aq \*(Aqcontainerb\*(Aq \*(Aqcontainer/III\*(Aq systemd\-nspawn@Mein\ex20Container\ex201\&.service systemd\-nspawn@containerb\&.service systemd\-nspawn@container\-III\&.service .fi .if n \{\ .RE .\} .PP Um den Instanzenanteil einer instanziierten Unit herauszulösen: .sp .if n \{\ .RS 4 .\} .nf $ systemd\-escape \-u \-\-instance \*(Aqsystemd\-nspawn@Mein\ex20Container\ex201\&.service\*(Aq Mein Container 1 .fi .if n \{\ .RE .\} .PP Um den Instanzenanteil einer bestimmten Vorlage herauszulösen: .sp .if n \{\ .RS 4 .\} .nf $ systemd\-escape \-u \-\-template=systemd\-nspawn@\&.service \*(Aqsystemd\-nspawn@Mein\ex20Container\ex201\&.service\*(Aq Mein Container 1 .fi .if n \{\ .RE .\} .SH EXIT\-STATUS .PP Bei Erfolg wird 0 zurückgegeben, anderenfalls ein Fehlercode ungleich Null\&. .SH "SIEHE AUCH" .PP \fBsystemd\fP(1), \fBsystemd.unit\fP(5), \fBsystemctl\fP(1) .PP .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann erstellt. .PP Diese Übersetzung ist Freie Dokumentation; lesen Sie die .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. .PP Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die .MT debian-l10n-german@lists.debian.org Mailingliste der Übersetzer .ME .