Scroll to navigation

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]

Listet Speicherdatenträger auf, die durch alle auf dem System laufenden Speicheranbieter (oder mit --user im Benutzerbereich) bereitgestellt werden. Das optionale Argument GLOB ist ein Shell-artiges Muster (siehe fnmatch(3)), das das Ergebnis nach Datenträgernamen filtert. Die Ausgabe ist eine Tabelle, die die bereitgestellten Dienste enthält, den Datenträgernamen, seinen Typ (»blk«, »reg« oder »dir«), ob er schreibgeschützt ist und – falls bekannt – seine Größe und die Anzahl der von ihm verwandten Bytes.

Dies ist der Vorgabebefehl, falls keiner angegeben ist.

Hinzugefügt in Version 261.

templates [GLOB]

Listet die Datenträgervorlagen auf, die von den laufenden Speicheranbietern unterstützt werden. Vorlagen kapseln eine Konfiguration, die bei der schnellen Erstellung von Datenträgern verwandt wird, wenn sie erlangt werden. Die Unterstützung für Vorlagen ist für Anbieter optional und ist nur für Anbieter relevant, die die schnelle Erstellung von Vorlagen anbieten. Lesen Sie die entsprechende Dokumentation der Anbieter zu Details, beispielsweise systemd-storage-fs@.service(8). Das optionale Argument GLOB filtert nach Vorlagennamen. Speicheranbieter, die die Vorlagen-basierte Erstellung von Datenträgern nicht implementieren (wie Blockgeräte-Anbieter), tragen zu dieser Ausgabe nichts bei.

Hinzugefügt in Version 261.

providers

Listet die dem System bekannten Speicheranbieter auf. Dies wird durch Absuchen des gut bekannten Socket-Verzeichnisses für AF_UNIX-Sockets erreicht, die wie io.systemd.StorageProvider-Endpunkte ausschauen. Für jeden Anbieter wird auch berichtet, ob sich derzeit mit dem Socket verbunden werden kann.

Hinzugefügt in Version 261.

OPTIONEN

Die folgenden Optionen werden verstanden:

--system

Agiert auf systemweiten Speicheranbietern. Es wird in /run/systemd/io.systemd.StorageProvider/ nach Sockets geschaut. Dies ist die Vorgabe.

Hinzugefügt in Version 261.

--user

Agiert auf benutzerbezogenen Speicheranbietern. Es wird in $XDG_RUNTIME_DIR/systemd/io.systemd.StorageProvider/ nach Sockets geschaut.

Hinzugefügt in Version 261.

--json=MODUS

Zeigt die Ausgabe als JSON formatiert. Erwartet entweder »short« (für die kürzest mögliche Ausgabe ohne unnötigen Leerraum oder Zeilenumbrüche), »pretty« (für eine schönere Version der gleichen Ausgabe, mit Einzügen und Zeilenumbrüchen) oder »off« (um die JSON-Ausgabe auszuschalten, was die Vorgabe ist).

--no-pager

Leitet die Ausgabe nicht an ein Seitenanzeigeprogramm weiter.

--no-legend

Gibt die Legende nicht aus, d.h. die Spaltenköpfe und die Fußzeile mit Hinweisen.

--no-ask-password

Befragt den Benutzer nicht für Authentifizierung für privilegierte Aktionen.

-h, --help

Zeigt einen kurzen Hilfetext an und beendet das Programm.

--version

Zeigt eine kurze Versionszeichenkette an und beendet das Programm.

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"

Erlangt einen Verzeichnisdatenträger und hängt dessen Verzeichnisbaum mit bind auf das Ziel ein.

Hinzugefügt in Version 261.

"storage.DSTYP"

Erlangt einen regulären Datei- oder Blockgerätedatenträger und hängt ihn als Dateisystem vom Typ DSTYP ein (beispielsweise »storage.ext4«, »storage.btrfs«, …).

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

Akzeptiert entweder »any« (öffnen, falls es existiert, andernfalls erstellen – die Vorgabe), »open« (fehlschlagen, falls der Datenträger nicht existiert) oder »new« (fehlschlagen, falls der Datenträger bereits existiert).

Hinzugefügt in Version 261.

storage.template=NAME

Die bei der Erstellung eines neuen Datenträgers zu verwendende Vorlage, falls diese fehlt und der Anbieter die schnelle Erstellung von Datenträgern unterstützt.

Hinzugefügt in Version 261.

storage.create-size=BYTE

Die zu reservierende Größe in Byte bei der dynamischen Erstellung eines neuen Datenträgers. Akzeptiert die normalen Endungen »K«/»M«/»G«/»T« (zur Basis 1024). Benötigt, wenn ein normaler Dateidatenträger erstellt wird.

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

Die maximale Protokollierstufe für ausgegebene Meldungen (Meldungen mit einer höheren Protokollierstufe, d.h. weniger wichtige, werden unterdrückt). Akzeptiert eine Kommata-getrennte Liste von Werten. Ein Wert kann einer der folgenden sein (in Reihenfolge absteigender Bedeutung): emerg, alert, crit, err, warning, notice, info, debug oder eine Ganzzahl im Bereich 0…7. Siehe syslog(3) für weitere Informationen. Jedem Wert kann optional eine Zeichenkette aus console, syslog, kmsg oder journal gefolgt von einem Doppelpunkt vorangestellt werden, um die maximale Protokollierstufe für dieses spezielle Protokollierziel zu setzen (d.h. SYSTEMD_LOG_LEVEL=debug,console:info legt fest, dass auf der Stufe »debug« protokolliert werden soll, außer beim Protokollieren auf die Konsole, die auf Stufe »info« erfolgen soll). Beachten Sie, dass die globale maximale Protokollierstufe Priorität gegenüber jeder zielbezogenen maximalen Protokollierstufe hat.

$SYSTEMD_LOG_COLOR

Ein logischer Wert. Falls »true«, werden auf das TTY geschriebene Nachrichten gemäß ihrer Priorität eingefärbt.

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

Ein logischer Wert. Falls »true«, wird den Protokollnachrichten der Konsole ein Zeitstempel vorangestellt.

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

Ein logischer Wert. Falls »true«, wird den Protokollnachrichten ein Dateiname und eine Zeilennummer in dem Quellcode, aus dem die Nachrichten stammen, vorangestellt.

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

Ein logischer Wert. Falls »true«, wird den Nachrichten die aktuelle numerische Thread-Kennung (TID) vorangestellt.

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

Das Ziel für Protokolliernachrichten. Entweder console (auf das angehängte TTY protokollieren), console-prefixed (auf das angehängte TTY protokollieren, aber die Protokollierstufe und »Einrichtung« voranstellen, siehe syslog(3)), kmsg (in den zirkulären Kernel-Protokollpuffer protokollieren), journal (in das Journal protokollieren), journal-or-kmsg (in das Journal protokollieren, falls verfügbar, und andernfalls nach Kmsg), auto (das geeignete Protokollierziel automatisch ermitteln, die Vorgabe) oder null (die Protokollierung deaktivieren).

$SYSTEMD_LOG_RATELIMIT_KMSG

Ob Kmsg ratenbegrenzt werden soll oder nicht. Akzeptiert einen logischen Wert. Standardmäßig »true«. Falls deaktiviert, wird Systemd die nach Kmsg geschriebenen Meldungen nicht ratenbegrenzt.

$SYSTEMD_PAGER, $PAGER

Zu verwendendes Seitenanzeigeprogramm, wenn --no-pager nicht angegeben ist. Falls gesetzt, wird $SYSTEMD_PAGER verwandt, andernfalls $PAGER. Falls weder $SYSTEMD_PAGER noch $PAGER gesetzt sind, wird eine Reihe wohlbekannter Implementierungen von Seitenanzeigeprogrammen der Reihe nach ausprobiert, einschließlich less(1) und more(1), bis eines gefunden wird. Falls keine Implementierung eines Seitenanzeigeprogramms gefunden wird, wird keines aufgerufen. Setzen dieser Umgebungsvariablen auf die leere Zeichenkette oder den Wert »cat« ist äquivalent zur Übergabe von --no-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

Setzt die an less übergebenen Optionen (standardmäßig »FRSXMK«) außer Kraft.

Benutzer könnten insbesondere zwei Optionen ändern wollen:

K

Diese Option weist das Seitenanzeigeprogramm an, sich sofort beim Druck von Strg-C zu beenden. Um less die Handhabung von Strg-C selbst zum Umschalten auf die Eingabeaufforderung zu erlauben, setzen Sie diese Option zurück.

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

Diese Option weist das Seitenanzeigeprogramm an, keine Termcap-Initialisierungs- und -Deinitalisierungszeichenketten an das Terminal zu senden. Dies ist standardmäßig gesetzt, damit die Darstellung von Befehlen selbst nach dem Beenden des Seitenanzeigeprogramms sichtbar bleibt. Allerdings stehen dadurch einige Funktionen des Seitenanzeigeprogramms nicht zur Verfügung; insbesondere ist das Scrollen in der Ausgabe mit der Maus nicht möglich.

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

Setzt den an less zu übergebenden Zeichensatz (standardmäßig »utf-8«, falls das aufrufende Terminal als UTF-8-kompatibel erkannt wurde) außer Kraft.

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

Typische Seitenanzeigeprogramme wie less(1) unterstützen nebem dem seitenweisen Anzeigen (d.h. dem Durchlaufen der Ausgabe) das Öffnen von oder Schreiben in andere Dateien und die Ausführung von beliebigen Shell-Befehlen. Werden Befehle mit erhöhten Berechtigungen, beispielsweise unter sudo(8) oder pkexec(1), aufgerufen, wird das Seitenanzeigeprogramm zur Sicherheitsgrenze. Es muss darauf geachtet werden, dass nur Programme mit streng begrenzter Funktionalität als Seitenanzeigeprogramm verwandt werden und unerwünschte interaktive Funktionalitäten wie das Öffnen oder Erstellen von neuen Dateien oder das Starten von Subprozessen nicht erlaubt sind. Der »Sichere Modus« für das Seitenanzeigeprogramm kann wie nachfolgend beschrieben aktiviert werden, falls das Seitenanzeigeprogramm dies unterstützt (die meisten Seitenanzeigeprogramme sind nicht so geschrieben, dass sie dies berücksichtigen). Es wird empfohlen, den »Sicheren Modus« explizit zu aktivieren oder das Seitenanzeigeprogramm komplett mittels --no-pager oder PAGER=cat zu deaktivieren, wenn nicht vertrauenswürdigen Benutzern die Ausführung von Programmen mit erhöhten Privilegien erlaubt wird.

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

Akzeptiert ein logisches Argument oder einen besonderen Wert. Standardmäßig (nicht gesetzt) werden systemd und zugehörige Hilfswerkzeuge in ihrer Ausgabe Farben verwenden, falls dies möglich ist. Falls $COLORTERM auf »truecolor« oder »24bit« gesetzt ist, werden 24-bit-Farben aktiviert, ansonsten 256 Farben, außer wenn $NO_COLOR gesetzt ist oder $TERM anzeigt, dass Farben deaktiviert sind.

true

Identisch zu nicht gesetzt, außer dass $NO_COLOR ignoriert wird.

false

Die Ausgabe erfolgt monochrom.

»16«, »256«, »24bit«

Verwendet immer die 16-, 256- bzw. 24-bit-ANSI-Basisfarben.

»auto-16«, »auto-256«, »auto-24bit«

Verwendet die angegebene Menge an Farben, abhängig von $TERM und womit die Konsole verbunden ist.

$SYSTEMD_URLIFY

Dies muss ein logischer Wert sein. Er steuert, ob anklickbare Links für Terminal-Emulatoren, die dies unterstützen, erstellt werden sollen. Dies kann angegeben werden, um die Entscheidung, die systemd basierend auf $TERM und anderen Bedingungen trifft, außer Kraft zu setzen.

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