| STORAGECTL(1) | storagectl | STORAGECTL(1) |
BEZEICHNUNG¶
storagectl, mount.storage - Durch Speicheranbieter bereitgestellte Speicherdatenträger aufzählen und einhängen
ÜBERSICHT¶
storagectl [OPTIONEN…] {BEFEHL} [NAME…]
mount -t storage ANBIETER:DATENTRÄGER VERZEICHNIS
mount -t storage.DSTYP ANBIETER:DATENTRÄGER VERZEICHNIS
BESCHREIBUNG¶
storagectl kann zur Untersuchung von Speicheranbietern und der von ihnen offengelegten Speicherdatenträgern verwandt werden. Ein Speicheranbieter ist ein Dienst, der die Varlink[1]-Schnittstelle io.systemd.StorageProvider implementiert, die als AF_UNIX-Socket unterhalb des gut bekannten Socket-Verzeichnisses /run/systemd/io.systemd.StorageProvider/ (im Systemmodus) oder $XDG_RUNTIME_DIR/systemd/io.systemd.StorageProvider/ (im Benutzermodus) registriert ist. Die zwei mit Systemd ausgelieferten Speicheranbieter sind systemd-storage-block@.service(8), das die Blockgeräte des Systems offenlegt und systemd-storage-fs@.service(8), das die regulären Dateien und Verzeichnisse des zugrundeliegenden Dateisystems offenlegt.
Das Werkzeug stellt auch ein Hilfsprogramm für mount(8) für den Dateisystemtyp »storage« bereit, der das Einhängen von Speicherdatenträgern an beliebigen Orten ermöglicht. Lesen Sie den nachfolgenden Abschnitt »Verwendung als Einhänge-Hilfsprogramm« weiter unten zu Details.
BEFEHLE¶
Die folgenden Befehle werden verstanden:
volumes [GLOB]
Dies ist der Vorgabebefehl, falls keiner angegeben ist.
Hinzugefügt in Version 261.
templates [GLOB]
Hinzugefügt in Version 261.
providers
Hinzugefügt in Version 261.
OPTIONEN¶
Die folgenden Optionen werden verstanden:
--system
Hinzugefügt in Version 261.
--user
Hinzugefügt in Version 261.
--json=MODUS
--no-pager
--no-legend
--no-ask-password
-h, --help
--version
VERWENDUNG ALS EINHÄNGE-HILFSPROGRAMM¶
Dieses Werkzeug stellt den Alias /sbin/mount.storage bereit, der die Schnittstelle »externes Hilfsprogramm« von mount(8) implementiert. Damit können Speicherdatenträger mit dem regulären Befehl mount(8) eingehängt werden. Der einzuhängende Datenträger wird als Quelle der Einhängung in der Form »ANBIETER:DATENTRÄGER« kodiert, wobei ANBIETER der Name eines Speicheranbieters (wie von storagectl providers aufgelistet) und DATENTRÄGER der Datenträgername ist. Zwei Schreibweisen für den Dateisystemtyp werden erkannt:
"storage"
Hinzugefügt in Version 261.
"storage.DSTYP"
Hinzugefügt in Version 261.
Die normalen Einhängeoptionen -o werden an mount(8) weitergeleitet. Zusätzlich werden die folgenden Optionen, denen »storage.« vorangestellt wird, durch mount.storage selbst interpretiert und von der weitergeleiteten Liste entfernt:
storage.create=MODUS
Hinzugefügt in Version 261.
storage.template=NAME
Hinzugefügt in Version 261.
storage.create-size=BYTE
Hinzugefügt in Version 261.
BEISPIELE¶
Beispiel 1. Benennung verfügbarer Speicheranbieter, Datenträger und Vorlagen
$ storagectl providers $ storagectl volumes $ storagectl volumes '*foo*' $ storagectl templates
Beispiel 2. Einhängen eines Verzeichnisses von dem Dateisystemanbieter
# mount -t storage fs:meindat /mnt/meindat
Falls der Datenträger »meindat« noch nicht existiert, wird er mit der Standardvorlage »subvolume« erstellt.
Beispiel 3. Erstellen und Einhängen eines Ext4-Dateisystems aus einer normalen Datei
# mount -t storage.ext4 fs:scratch /mnt/scratch -o loop
Beispiel 4. Einhängen eines schreibgeschützten Blockgerätes
# mount -t storage.ext4 -o ro block:/dev/disk/by-id/usb-foo /mnt/foo
EXIT-STATUS¶
Bei Erfolg wird 0 zurückgegeben, anderenfalls ein Fehlercode ungleich Null.
UMGEBUNGSVARIABLEN¶
$SYSTEMD_LOG_LEVEL
$SYSTEMD_LOG_COLOR
Diese Einstellung ist nur nützlich, falls die Nachrichten direkt auf das Terminal geschrieben werden, da journalctl(1) und andere Werkzeuge, die Protokolle anzeigen, selbständig Nachrichten gemäß ihrer Protokollierungsstufe einfärben.
$SYSTEMD_LOG_TIME
Diese Einstellung ist nur nützlich, falls die Nachrichten direkt auf das Terminal oder in eine Datei geschrieben werden, da journalctl(1) und andere Werkzeuge, die Protokolle anzeigen, selbständig Zeitstempel basierend auf ihren Metadaten den Nachrichten anhängen.
$SYSTEMD_LOG_LOCATION
Beachten Sie, dass der Protokollierort sowieso oft als Metadaten zu den Journal-Einträgen angehängt ist. Die Aufnahme in den Nachrichtentext kann bei der Fehlersuche in Programmen dennoch praktisch sein.
$SYSTEMD_LOG_TID
Beachten Sie, dass diese Informationen sowieso als Metadaten an Journal-Einträge angehängt werden. Die Aufnahme direkt im Nachrichtentext kann aber trotzdem bei der Fehlersuche in Programmen praktisch sein.
$SYSTEMD_LOG_TARGET
$SYSTEMD_LOG_RATELIMIT_KMSG
$SYSTEMD_PAGER, $PAGER
Beachten Sie: Falls $SYSTEMD_PAGERSECURE nicht gesetzt ist, können $SYSTEMD_PAGER und $PAGER nur zum Deaktivieren des Seitenanzeigeprogramms (mit »cat« oder »«) verwandt werden und werden ansonsten ignoriert.
$SYSTEMD_LESS
Benutzer könnten insbesondere zwei Optionen ändern wollen:
K
Falls der Wert von $SYSTEMD_LESS kein »K« enthält und less das aufgerufene Seitenanzeigeprogramm ist, wird Strg+C durch das Programm ignoriert und muss durch das Seitenanzeigeprogramm selbst gehandhabt werden.
X
Beachten Sie, dass das Setzen der regulären Umgebungsvariablen $LESS keine Auswirkungen auf die Ausführung von less(1) durch systemd(1)-Werkzeuge hat.
Siehe less(1) für weitere Ausführungen.
$SYSTEMD_LESSCHARSET
Beachten Sie, dass das Setzen der regulären Umgebungsvariablen $LESSCHARSET keine Auswirkungen auf die Ausführungen von less(1) durch systemd(1)-Werkzeuge hat.
$SYSTEMD_PAGERSECURE
Diese Option akzeptiert ein logisches Argument. Ist es auf »true« gesetzt, wird der »Sichere Modus« des Seitenanzeigeprogramms aktiviert. Im »Sicheren Modus« wird LESSSECURE=1 beim Aufruf des Seitenanzeigeprogramms gesetzt. Dies weist das Seitenanzeigeprogramm an, Befehle zum Öffnen oder Erstellen von neuen Dateien sowie das Starten von Subprozessen zu deaktivieren. Derzeit ist nur von less(1) bekannt, dass es diese Variable versteht und den »Sicheren Modus« implementiert.
Ist diese Variable auf »false« gesetzt, unterliegt das Seitenanzeigeprogramm keinen Beschränkungen. Setzen auf SYSTEMD_PAGERSECURE=0 oder das Beibehalten der Variable von der geerbten Umgebung könnte den Benutzern die Ausführung beliebiger Befehle erlauben.
Ist $SYSTEMD_PAGERSECURE nicht gesetzt, versuchen die Systemd-Werkzeuge automatisch herauszufinden, ob der »Sichere Modus« aktiviert werden soll und ob das Seitenanzeigeprogramm dies unterstützt. Der »Sichere Modus« wird aktiviert, falls die effektive UID nicht mit der UID des Eigentümers der Anmeldesitzung übereinstimmt, siehe geteuid(2) und sd_pid_get_owner_uid(3), oder wenn die Ausführung unter Werkzeugen wie sudo(8) oder ähnlichem erfolgt ($SUDO_UID ist gesetzt [2]). In diesen Fällen wird SYSTEMD_PAGERSECURE=1 gesetzt und Seitenanzeigeprogramme, von denen nicht bekannt ist, dass sie den »Sicheren Modus« unterstützen, werden überhaupt nicht verwandt. Beachten Sie, dass diese automatische Erkennung nur die typischsten Mechanismen zur Erlangung von Privilegien abdeckt und dem Komfort dient. Es wird empfohlen, explizit $SYSTEMD_PAGERSECURE zu setzen oder das Seitenanzeigeprogramm zu deaktivieren.
Beachten Sie, dass auch $SYSTEMD_PAGERSECURE gesetzt sein muss, damit die Variablen $SYSTEMD_PAGER oder $PAGER (außer zum Deaktivieren des Seitenanzeigeprogramms) berücksichtigt werden.
$SYSTEMD_COLORS
true
false
»16«, »256«, »24bit«
»auto-16«, »auto-256«, »auto-24bit«
$SYSTEMD_URLIFY
SIEHE AUCH¶
systemd(1), systemd-storage-block@.service(8), systemd-storage-fs@.service(8), varlinkctl(1), mount(8)
ANMERKUNGEN¶
- 1.
- Varlink
- 2.
- Es wird für andere Werkzeuge empfohlen, $SUDO_UID geeignet zu setzen und zu überprüfen und es als allgemeine Schnittstelle zu behandeln.
ÜBERSETZUNG¶
Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> erstellt.
Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer.
| systemd 262.1 |