snap - Tool zum Interagieren mit Snaps
SYNOPSIS
snap [OPTIONEN]
BESCHREIBUNG
Der Befehl snap ermöglicht die Installation, Konfiguration, Aktualisierung und Entfernung von Snaps. Snaps sind Pakete, die auf vielen verschiedenen Linux-Distributionen funktionieren und die sichere Bereitstellung und Ausführung der neuesten Apps und Dienstprogramme ermöglichen.
OPTIONEN
Anwendungsoptionen
BEFEHLE
abort
Bricht eine ausstehende Änderung ab.
Der Befehl abort versucht, eine Änderung, bei der noch ausstehende Aufgaben vorhanden sind, abzubrechen.
Verwendung: snap [OPTIONEN] abort [abort-OPTIONEN]
--last Wählt die letzte Änderung des angegebenen Typs (Installieren, Aktualisieren, Entfernen, Testen, automatische Aktualisierung usw.) aus.
Ein Fragezeichen am Ende des Typs bedeutet, dass nichts unternommen wird (anstatt eines Fehlers zurückzugeben),
wenn keine Änderung des angegebenen Typs gefunden wird. Beachten Sie, dass das Fragezeichen möglicherweise vor der
Shell geschützt werden muss.
ack
Fügt eine Assertion zum System hinzu.
Der Befehl ack versucht, eine Assertion zur System-Assertionsdatenbank hinzuzufügen.
Die Assertion kann auch eine neuere Version einer bereits vorhandenen Assertion sein, die sie ersetzt.
Um erfolgreich zu sein, muss die Assertion gültig sein, ihre Signatur mit einem bekannten öffentlichen Schlüssel verifiziert werden und die Assertion muss mit ihrer Voraussetzung in der Datenbank übereinstimmen.
alias
Richtet einen manuellen Alias ein.
Der Befehl alias weist dem angegebenen Snap-Anwendung den angegebenen Alias zu.
Sobald dieser manuelle Alias eingerichtet ist, kann der jeweilige Anwendungsbefehl einfach unter Verwendung des Alias aufgerufen werden.
Verwendung: snap [OPTIONEN] alias [alias-OPTIONEN]
--no-wait
Nicht auf den Abschluss der Operation warten, sondern nur die Änderungs-ID ausgeben.
aliases
Listet die Aliase im System auf.
Der Befehl aliases listet alle im System verfügbaren Aliase und deren Status auf.
$ snap aliases <snap>
Listet nur die von dem angegebenen Snap definierten Aliase auf.
changes
Listet Systemänderungen auf.
Der Befehl changes zeigt eine Zusammenfassung der kürzlich durchgeführten Systemänderungen an.
Verwendung: snap [OPTIONEN] changes [changes-OPTIONEN]
--abs-time
Zeigt absolute Zeiten (im RFC 3339-Format) an. Andernfalls werden relative Zeiten bis zu 60 Tagen und dann JJJJ-MM-TT angezeigt.
check-snapshot
Überprüft ein Snapshot.
Der Befehl check-snapshot überprüft die Benutzer-, System- und Konfigurationsdaten der in dem angegebenen Snapshot enthaltenen Snaps.
Die Überprüfung führt die gleichen Datenintegritätsprüfungen aus, die bei der Wiederherstellung eines Snapshots durchgeführt werden.
Standardmäßig überprüft dieser Befehl alle Daten in einem Snapshot. Alternativ können Sie die Daten der Snaps, für die die Überprüfung durchgeführt werden soll, oder für die Benutzer angeben, oder eine Kombination aus beidem.
Wenn ein Snap in einer check-snapshot-Operation enthalten ist, ist es derzeit nicht möglich, seine System- und Konfigurationsdaten von der Überprüfung auszuschließen. Diese Einschränkung kann in Zukunft aufgehoben werden.
Verwendung: snap [OPTIONEN] check-snapshot [check-snapshot-OPTIONEN]
--no-wait
Nicht auf das Ende der Operation warten, sondern nur die Änderungs-ID ausgeben.
--users
Daten nur für bestimmte Benutzer überprüfen (durch Komma getrennt) (Standard: alle Benutzer)
components
Verfügbare und installierte Komponenten für installierte Snaps auflisten
Der Befehl components zeigt eine Zusammenfassung der Komponenten an, die für die aktuell installierten Snaps installiert und verfügbar sind.
Komponenten für bestimmte installierte Snaps können durch Angabe der Snap-Namen als Positionsargumente abgefragt werden.
connect
Einen Plug mit einem Slot verbinden
Der Befehl connect verbindet einen Plug mit einem Slot. Er kann auf folgende Weise aufgerufen werden:
$ snap connect <snap>:<plug> <snap>:<slot>
Verbindet den angegebenen Plug mit dem angegebenen Slot.
$ snap connect <snap>:<plug> <snap>
Verbindet den angegebenen Plug mit dem einzigen Slot im angegebenen Snap, der mit der verbundenen Schnittstelle übereinstimmt. Wenn mehr als ein möglicher Slot vorhanden ist, schlägt der Befehl fehl.
$ snap connect <snap>:<plug>
Verbindet den angegebenen Plug mit dem Slot im Core-Snap, dessen Name mit dem Plug-Namen übereinstimmt.
Verwendung: snap [OPTIONEN] connect [connect-OPTIONEN]
--no-wait
Nicht auf das Ende der Operation warten, sondern nur die Änderungs-ID ausgeben.
connections
Schnittstellenverbindungen auflisten
Der Befehl connections listet Verbindungen zwischen Plugs und Slots im System auf.
Wenn kein <snap> angegeben wird, wird die Liste für verbundene Plugs und Slots für alle Snaps im System angezeigt. In diesem Modus können Sie mit --all auch nicht verbundene Plugs und Slots auflisten.
$ snap connections <snap>
Listet verbundene und nicht verbundene Plugs und Slots für den angegebenen Snap auf.
Verwendung: snap [OPTIONEN] connections [connections-OPTIONEN]
--all Verbundene und nicht verbundene Plugs und Slots anzeigen
create-cohort
Cohort-Schlüssel für eine Reihe von Snaps erstellen
Der Befehl create-cohort erstellt einen Satz von Cohort-Schlüsseln für eine gegebene Reihe von Snaps.
Ein Cohort ist eine Ansicht oder Momentaufnahme der "Kanal-Map" eines Snaps zu einem bestimmten Zeitpunkt, die die Menge der Revisionen für den Snap unter Berücksichtigung anderer Einschränkungen (z. B. Kanal oder Architektur) festlegt. Der Cohort wird dann durch einen undurchsichtigen, snap-spezifischen Schlüssel identifiziert, der über Systeme hinweg funktioniert. Installationen oder Aktualisierungen des Snaps mit einem bestimmten Cohort-Schlüssel würden eine feste Revision für bis zu 90 Tage verwenden, wonach ein neuer Satz von Revisionen unter demselben Cohort-Schlüssel festgelegt würde und ein neues 90-Tage-Fenster beginnen würde.
debug
Debug-Befehle ausführen
Der Befehl debug enthält eine Auswahl zusätzlicher Unterbefehle.
Debug-Befehle können ohne Vorwarnung entfernt werden und funktionieren möglicherweise nicht auf Nicht-Entwicklungssystemen.
debug api
Rohe Abfrage an die Snapd-API ausführen
Führt eine rohe Abfrage an die Snapd-API aus. Komplexe Eingaben können von stdin gelesen werden, während die Ausgabe nach stdout geschrieben wird. Siehe Beispiele unten:
Alle Snaps auflisten: $ snap debug api /v2/snaps
Snaps mit dem Namen foo finden: $ snap debug api '/v2/find?name=foo'
Aktualisierung des Snaps 'some-snap' anfordern: $ echo '{"action": "refresh"}' | snap debug api -X POST \ -H 'Content-Type: application/json' /v2/snaps/some-snap
Verwendung: debug api [api-OPTIONEN]
--snap-socket
Verwenden Sie den Snap-Zugriffssocket
-H, --header
Setzen Sie den Header (kann mehrmals wiederholt werden), die Header-Art und der Wert werden durch ':' getrennt
-X, --request
HTTP-Methode, die verwendet werden soll (Standard ist GET)
--fail
Bei Anforderungsfehlern abbrechen
debug confinement
Geben Sie den Confinement-Modus aus, in dem das System arbeitet
Der Befehl confinement gibt den Confinement-Modus (strict, partial oder none) aus, in dem das System arbeitet.
debug connectivity
Überprüfen Sie den Netzwerkverbindungsstatus
Der Befehl connectivity überprüft die Netzwerkverbindung von snapd.
debug execution
Rufen Sie Informationen über Ausführungsaspekte der Snap-Toolchain-Befehle ab
Zeigen Sie Debugging-Informationen über Aspekte der Ausführung der Snap-Toolchain an, z. B. erneute Ausführung, Tools-Speicherort usw.
debug execution apparmor
AppArmor anzeigen
debug execution internal-tool
Zeigen Sie interne Tool-Ausführungsinformationen an
debug execution snap
Zeigen Sie Snap-Ausführungsinformationen an
debug features
Rufen Sie die vollständige Liste der Feature-Tags ab
Geben Sie eine JSON-Ausgabe aus, die die vollständige Liste der Feature-Tags enthält, die in snapd und snap vorhanden sind. Feature-Tags sind eine Sammlung von Daten, die wichtige Codepfade innerhalb von snapd beschreiben, einschließlich Aufgaben, Änderungen, Schnittstellen, Endpunkte, Snap-Befehle und Hilfsfunktionen zur Gewährleistung.
debug lsm
(intern) Statusinformationen zu LSMs abrufen
(intern) Statusinformationen zu LSMs abrufen
debug migrate-home
Verschieben Sie das Snap-Verzeichnis nach ~/Snap.
Verschieben Sie das Snap-Verzeichnis nach ~/Snap.
Verwendung: debug migrate-home [migrate-home-OPTIONEN]
--no-wait
debug paths
Systempfade ausgeben
Der Befehl paths gibt die Liste der von snapd erkannten und verwendeten Pfade aus.
debug refresh-app-awareness
(intern) Details zu refresh-app-awareness auflisten
(intern) Details zu refresh-app-awareness auflisten
Verwendung: debug refresh-app-awareness [refresh-app-awareness-OPTIONEN]
--unicode <Standard: "auto">
debug sandbox-features
Geben Sie Sandbox-Funktionen aus, die auf dem System verfügbar sind
Der Befehl sandbox gibt Tags aus, die die Funktionen einzelner Sandbox-Komponenten beschreiben, die von snapd auf einem bestimmten System verwendet werden.
Verwendung: debug sandbox-features [sandbox-features-OPTIONEN]
--required
Stellen Sie sicher, dass das angegebene Backend:Feature verfügbar ist
debug seeding
Rufen Sie Seeding- und Pre-Seeding-Details ab
Rufen Sie Seeding- und Pre-Seeding-Details ab
Verwendung: debug seeding [seeding-OPTIONEN]
--unicode <Standard: "auto">
debug stacktraces
Rufen Sie die Stacktraces aller snapd-Goranwendungen ab
Rufen Sie die Stacktraces aller snapd-Goranwendungen ab.
debug state
Untersuchen Sie eine snapd-Statusdatei.
Untersuchen Sie eine snapd-Statusdatei und umgehen Sie die snapd-API.
Verwendung: debug state [state-OPTIONEN]
--abs-time
Absolute Zeiten anzeigen (im RFC 3339-Format). Andernfalls werden relative Zeiten bis zu 60 Tagen und dann JJJJ-MM-TT angezeigt.
--changes
Alle Änderungen auflisten
--task
ID der zu untersuchenden Aufgabe
--change
ID der zu untersuchenden Änderung
--check
Überprüfen Sie die Konsistenz der Änderung
--connections
Listet alle Verbindungen auf
--connection
Zeigt Details der übereinstimmenden Verbindungen an (snap oder snap:plug, snap:slot oder snap:plug-oder-slot)
--is-seeded
Gibt den Seeding-Status aus (true oder false)
--dot Dot-Ausgabe (Graphviz)
--no-hold
Lässt Aufgaben im Status „Hold“ in der Änderungsausgabe aus
debug timings
Ruft die Zeitangaben der Aufgaben einer Änderung ab.
Der Befehl timings zeigt Details zur Ausführungszeit jeder Aufgabe an.
Verwendung: debug timings [timings-OPTIONEN]
--last Wählt die letzte Änderung des angegebenen Typs aus (install, refresh, remove, try, auto-refresh usw.). Ein Fragezeichen am Ende des Typs bedeutet, dass nichts unternommen wird (anstatt einen Fehler zurückzugeben), wenn keine Änderung des angegebenen Typs gefunden wird. Beachten Sie, dass das Fragezeichen möglicherweise vor der Shell geschützt werden muss.
--ensure
Zeigt Zeitangaben für eine Änderung im Zusammenhang mit der angegebenen Ensure-Aktivität an (eine von: auto-refresh, become-operational, refresh-catalogs, refresh-hints, seed).
--all Zeigt Zeitangaben für alle Ausführungen der angegebenen Ensure- oder Startaktivität an, nicht nur für die letzte.
--startup Zeigt Zeitangaben für den Start des angegebenen Subsystems an (eine von: load-state, ifacemgr).
--verbose
Zeigt weitere Informationen an.
debug validate-seed
Validiert das Snap-Seed.
Überprüft die Korrektheit des Snap-Seeds, das sich im Verzeichnis der Datei seed.yaml befindet.
disable
Deaktiviert ein Snap im System.
Der Befehl disable deaktiviert ein Snap. Die Binärdateien und Dienste des Snaps sind dann nicht mehr verfügbar, aber alle Daten bleiben erhalten und das Snap kann einfach wieder aktiviert werden.
Verwendung: snap [OPTIONEN] disable [disable-OPTIONEN]
--no-wait
Wartet nicht, bis die Operation abgeschlossen ist, sondern gibt nur die Änderungs-ID aus.
disconnect
Trennt einen Plug von einem Slot.
Der Befehl disconnect trennt einen Plug von einem Slot. Er kann auf folgende Weise aufgerufen werden:
$ snap disconnect <snap>:<plug> <snap>:<slot>
Trennt den angegebenen Plug vom angegebenen Slot.
$ snap disconnect <snap>:<slot oder plug>
Trennt alles vom angegebenen Plug oder Slot. Der Snap-Name kann für das Core-Snap weggelassen werden.
Wenn eine automatische Verbindung manuell getrennt wird, wird ihr getrennter Zustand nach einer Snap-Aktualisierung beibehalten. Mit der Option --forget kann der Befehl disconnect verwendet werden, um diesen Status zurückzusetzen und somit eine automatische Wiederverbindung nach einer Snap-Aktualisierung zu ermöglichen.
Verwendung: snap [OPTIONEN] disconnect [disconnect-OPTIONEN]
--no-wait
Wartet nicht, bis die Operation abgeschlossen ist, sondern gibt nur die Änderungs-ID aus.
--forget
Vergisst gespeicherte Informationen über die angegebene Verbindung.
download
Lädt das angegebene Snap herunter.
Der Befehl download lädt das angegebene Snap, die Komponenten und die zugehörigen Assertions in das aktuelle Verzeichnis mit den Dateierweiterungen .snap, .comp bzw. .assert herunter.
Verwendung: snap [OPTIONEN] download [download-OPTIONEN]
--channel
Verwendet diesen Kanal anstelle von stable.
--edge Installiert von dem Edge-Kanal.
--beta Installiert von dem Beta-Kanal.
--candidate Installiert von dem Candidate-Kanal.
--stable Installiert von dem Stable-Kanal.
--revision
Lädt die angegebene Revision eines Snaps herunter. Beim Herunterladen von Komponenten werden die Komponenten heruntergeladen, die der angegebenen Snap-Revision zugeordnet sind.
--basename
Verwenden Sie diesen Basisnamen für die Snap-, Komponenten- und Assertionsdateien (Standard ist
--target-directory
Laden Sie in dieses Verzeichnis herunter (Standard ist das aktuelle Verzeichnis)
--only-components
Laden Sie nur die angegebenen Komponenten und nicht das Snap herunter
--cohort
Laden Sie aus dem angegebenen Cohort herunter
enable
Aktivieren Sie ein Snap im System
Der Befehl enable aktiviert ein zuvor deaktiviertes Snap.
Verwendung: snap [OPTIONEN] enable [enable-OPTIONEN]
--no-wait
Warten Sie nicht, bis die Operation abgeschlossen ist, sondern geben Sie einfach die Änderungs-ID aus.
export-snapshot
Exportieren Sie ein Snapshot
Exportieren Sie ein Snapshot in die angegebene Datei.
find
Finden Sie Pakete zum Installieren
Der Befehl find fragt den Store nach verfügbaren Paketen ab.
Mit dem Flag --private, das erfordert, dass der Benutzer beim Store angemeldet ist (siehe snap help login), werden stattdessen private Snaps durchsucht, auf die der Benutzer direkt oder über die Kollaborationsfunktion des Stores Entwicklerzugriff hat.
Ein grünes Häkchen (wenn Farbe und Unicode unterstützt werden) nach einem Publisher-Namen zeigt an, dass der
Publisher verifiziert wurde.
Verwendung: snap [OPTIONEN] find [find-OPTIONEN]
Aliase: search
--private
Durchsuchen Sie private Snaps.
--narrow
Suchen Sie nur nach Snaps in „stable“.
--section [="show-all-sections-please"] <Standard: "no-section-specified">
Beschränken Sie die Suche auf einen bestimmten Abschnitt.
--color <Standard: "auto">
Verwenden Sie etwas Farbe, um einige Dinge hervorzuheben.
--unicode <Standard: "auto">
Verwenden Sie etwas Unicode, um die Lesbarkeit zu verbessern.
forget
Löschen Sie ein Snapshot
Der Befehl forget löscht ein Snapshot. Dieser Vorgang kann nicht rückgängig gemacht werden.
Ein Snapshot enthält Archive für die Benutzer-, System- und Konfigurationsdaten jedes in
dem Snapshot enthaltenen Snaps.
Standardmäßig löscht dieser Befehl alle Daten in einem Snapshot. Alternativ können Sie die Daten der Snaps angeben, die gelöscht werden sollen.
Verwendung: snap [OPTIONEN] forget [forget-OPTIONEN]
--no-wait
Warten Sie nicht, bis die Operation abgeschlossen ist, sondern geben Sie einfach die Änderungs-ID aus.
get
Drucken Sie Konfigurationsoptionen
Der Befehl get gibt Konfigurationsoptionen für das angegebene Snap aus.
$ snap get snap-name username
frank
Wenn mehrere Optionsnamen angegeben werden, werden die entsprechenden Werte zurückgegeben:
$ snap get snap-name username password
Key Value username frank password ...
Verschachtelte Werte können über einen Punkt-getrennten Pfad abgerufen werden:
$ snap get snap-name author.name
frank
Verwendung: snap [OPTIONEN] get [get-OPTIONEN]
-t Strenge Typisierung mit Nullwerten und Anführungszeichen
-d Geben Sie immer das Dokument zurück, auch bei einem einzelnen Schlüssel
-l Geben Sie immer die Liste zurück, auch bei einem einzelnen Schlüssel
help
Zeigen Sie die Hilfe für einen Befehl an
Der Befehl help zeigt Informationen über Snap-Befehle an.
Verwendung: snap [OPTIONEN] help [help-OPTIONEN]
--all Zeigen Sie eine kurze Zusammenfassung aller Befehle an
import-snapshot
Importieren Sie ein Snapshot
Importieren Sie ein exportiertes Snapshot-Set in das System. Das Snapshot wird mit einer neuen Snapshot-ID importiert
und kann mit dem Befehl restore wiederhergestellt werden.
Verwendung: snap [OPTIONEN] import-snapshot [import-snapshot-OPTIONEN]
--abs-time
info
Zeigt detaillierte Informationen über Snaps an.
Der Befehl info zeigt detaillierte Informationen über Snaps an.
Die Snaps können per Name oder Pfad angegeben werden; Namen werden sowohl im Store als auch in den
installierten Snaps nachgeschlagen; Pfade können sich auf eine .snap-Datei oder auf ein Verzeichnis beziehen, das einen entpackten
Snap enthält, der für snap try geeignet ist (ein Beispiel hierfür wäre das Verzeichnis prime, das snapcraft erstellt).
Verwendung: snap [OPTIONEN] info [info-OPTIONEN]
--color <Standard: "auto">
Verwendet etwas Farbe, um bestimmte Dinge hervorzuheben.
--unicode <Standard: "auto">
Verwendet etwas Unicode, um die Lesbarkeit zu verbessern.
--abs-time
Zeigt absolute Zeiten (im RFC 3339-Format) an. Andernfalls werden relative Zeiten bis zu 60 Tagen und danach im Format YYYY-MM-TT angezeigt.
--verbose
Enthält mehr Details zum Snap (erweiterte Notizen, Basis usw.).
install
Installiert Snaps auf dem System.
Mit dem Befehl install werden die angegebenen Snaps auf dem System installiert.
Um mehrere Instanzen desselben Snaps zu installieren, fügen Sie dem Namen eines Snaps einen Unterstrich und eine eindeutige Kennung (für jede Instanz) hinzu.
Parallele Instanzen werden mit --unaliased installiert, wodurch implizit verhindert wird, dass Konflikte mit bestehenden Installationen entstehen. Dieses Verhalten kann geändert werden, indem --prefer übergeben wird, wodurch alle Aliase
des angegebenen Snaps gegenüber widersprüchlichen Aliasen anderer Snaps bevorzugt werden, deren automatische Aliase deaktiviert und deren manuelle Aliase entfernt werden.
Ohne weitere Optionen werden die Snaps so installiert, dass sie den Stable-Kanal mit strikter Sicherheitsbeschränkung verfolgen. Alle verfügbaren Kanäle eines Snaps werden in der Ausgabe von snap info aufgeführt.
Wenn --revision verwendet wird, wird bei einer späteren Aktualisierung in der Regel die Revisionsüberschreibung rückgängig gemacht, wodurch der
Snap wieder zur aktuellen Revision des verfolgten Kanals zurückkehrt.
Verwenden Sie --name, um den Instanznamen bei der Installation aus einer Snap-Datei festzulegen.
Verwendung: snap [OPTIONEN] install [install-OPTIONEN]
--color <Standard: "auto">
Verwendet etwas Farbe, um bestimmte Dinge hervorzuheben.
--unicode <Standard: "auto">
Verwendet etwas Unicode, um die Lesbarkeit zu verbessern.
--no-wait
Wartet nicht, bis die Operation abgeschlossen ist, sondern gibt nur die Änderungs-ID aus.
--channel
Verwendet diesen Kanal anstelle von Stable.
--edge
Installiert aus dem Edge-Kanal.
--beta
Installiert aus dem Beta-Kanal.
--candidate
Installiert aus dem Candidate-Kanal.
--stable
Installiert aus dem Stable-Kanal.
--devmode
Setzt den Snap in den Entwicklermodus und deaktiviert die Sicherheitsbeschränkungen.
--jailmode
Setzt den Snap in den Modus der erzwungenen Beschränkungen.
--classic
Setzt den Snap in den klassischen Modus und deaktiviert die Sicherheitsbeschränkungen.
--revision
Installiert die angegebene Revision eines Snaps.
--dangerous
Installiert die angegebene Snap-Datei, auch wenn keine vordefinierten Signaturen dafür vorhanden sind, was bedeutet, dass sie nicht verifiziert wurde und gefährlich sein könnte (--devmode impliziert dies).
--unaliased
Installiert den angegebenen Snap, ohne seine automatischen Aliase zu aktivieren.
--prefer
Aktiviert alle Aliase des angegebenen Snaps, um Konflikte mit Aliasen anderer Snaps zu vermeiden.
--name
Installiert die Snap-Datei unter dem angegebenen Instanznamen.
--cohort
Installiert den Snap in der angegebenen Kohorte.
--ignore-validation
Ignoriert die Validierung durch andere Snaps, die die Installation blockieren.
--transaction <Standard: "per-snap">
Führt entweder eine Transaktion pro Snap oder eine für alle angegebenen Snaps aus.
--quota-group
Fügt den Snap bei der Installation zu einer Quoten-Gruppe hinzu.
interface
Zeigt Details der Snap-Schnittstellen an.
Der Befehl interface zeigt Details der Snap-Schnittstellen an.
Wenn kein Schnittstellenname angegeben ist, wird eine Liste der Schnittstellennamen mit mindestens einer Verbindung angezeigt, oder eine Liste aller Schnittstellen, wenn --all angegeben ist.
Verwendung: snap [OPTIONEN] interface [Schnittstellen-OPTIONEN]
--attrs
Zeigt Schnittstellenattribute an.
--all
Bezieht auch ungenutzte Schnittstellen ein.
known
Zeigt bekannte Assertions des angegebenen Typs an.
Der Befehl known zeigt bekannte Assertions des angegebenen Typs an. Wenn Header=Wert-Paare nach dem Assertionstyp angegeben werden, müssen die angezeigten Assertions auch die angegebenen Header mit den angegebenen Werten aufweisen.
Verwendung: snap [OPTIONEN] known [known-OPTIONEN]
--remote
Fragt den Store nach der Assertion ab, falls möglich über snapd.
--direct
Fragt den Store nach der Assertion ab, ohne zu versuchen, dies über snapd zu tun.
list
Listet installierte Snaps auf.
Der Befehl list zeigt eine Zusammenfassung der in dem aktuellen System installierten Snaps an.
Ein grünes Häkchen (vorausgesetzt, es gibt Farb- und Unicode-Unterstützung) nach einem Publisher-Namen zeigt an, dass der Publisher verifiziert wurde.
Verwendung: snap [OPTIONEN] list [List-OPTIONEN]
--all
Zeigt alle Revisionen an.
--color <Standard: "auto">
Verwendet etwas Farbe, um einige Dinge hervorzuheben.
--unicode <Standard: "auto">
Verwendet etwas Unicode, um die Lesbarkeit zu verbessern.
login
Authentifiziert sich bei snapd und dem Store.
Der Befehl login authentifiziert den Benutzer bei snapd und dem Snap Store und speichert die Anmeldeinformationen in der Datei ~/.snap/auth.json. Die weitere Kommunikation mit snapd erfolgt dann unter Verwendung dieser Anmeldeinformationen.
Es ist nicht erforderlich, sich bei snapd anzumelden. Durch die Anmeldung werden jedoch Interaktionen ohne sudo sowie einige für Entwickler relevante Funktionen ermöglicht, wie in der Hilfe für die Befehle find, install und refresh detailliert beschrieben.
Ein Konto kann unter https://login.ubuntu.com eingerichtet werden.
logout
Meldet sich von snapd und dem Store ab.
Der Befehl logout meldet den aktuellen Benutzer von snapd und dem Store ab.
logs
Ruft Protokolle für Dienste ab.
Der Befehl logs ruft die Protokolle der angegebenen Dienste ab und zeigt sie in chronologischer Reihenfolge an.
Verwendung: snap [OPTIONEN] logs [Logs-OPTIONEN]
--abs-time
Zeigt absolute Zeiten (im RFC 3339-Format) an. Andernfalls werden relative Zeiten bis zu 60 Tagen und dann JJJJ-MM-TT angezeigt.
-n <Standard: "10">
Zeigt nur die angegebene Anzahl von Zeilen oder "all" an.
-f
Wartet auf neue Zeilen und gibt sie so aus, wie sie eintreffen.
model
Ruft das aktive Modell für dieses Gerät ab.
Der Befehl model gibt die Informationen des aktiven Modell-Assertions für dieses Gerät zurück.
Standardmäßig werden nur die wesentlichen Informationen zur Modellidentifizierung in der Ausgabe enthalten, dies kann jedoch erweitert werden, um alle Nicht-Meta-Header einer Assertion einzuschließen.
Die ausführliche Ausgabe wird in einem strukturierten, YAML-ähnlichen Format dargestellt.
Ebenso kann anstelle der Modell-Assertion die aktive Serial-Assertion für die Ausgabe verwendet werden.
Verwendung: snap [OPTIONEN] modell [modell-OPTIONEN]
--abs-time
Zeigt absolute Zeiten (im RFC 3339-Format) an. Andernfalls werden relative Zeiten bis zu 60 Tagen und danach JJJJ-MM-TT angezeigt.
--color <Standard: "auto">
Verwendet etwas Farbe, um einige Dinge hervorzuheben.
--unicode <Standard: "auto">
Verwendet etwas Unicode, um die Lesbarkeit zu verbessern.
--serial
Gibt die Serial-Assertion anstelle der Modell-Assertion aus.
--verbose
Gibt alle spezifischen Assertionsfelder aus.
--assertion
Gibt die rohe Assertion aus.
okay
Bestätigt Warnungen.
Der Befehl `okay` bestätigt die mit `snap warnings` aufgeführten Warnungen.
Nach der Bestätigung werden die Warnungen nicht erneut angezeigt, es sei denn, sie treten erneut auf und genügend Zeit ist vergangen.
pack
Packt das angegebene Verzeichnis als Snap.
Der Befehl `pack` packt das angegebene Snap-Verzeichnis als Snap und schreibt das Ergebnis in das Zielverzeichnis. Wenn das Zielverzeichnis weggelassen wird, wird das Ergebnis in das aktuelle Verzeichnis geschrieben. Wenn sowohl das Quell- als auch das Zielverzeichnis weggelassen werden, packt der Befehl `pack` das aktuelle Verzeichnis.
Der Standarddateiname für einen Snap kann vollständig aus seiner `snap.yaml`-Datei abgeleitet werden, in einigen Situationen ist es jedoch einfacher für ein Skript, den Dateinamen anzugeben. In diesen Fällen kann `--filename` verwendet werden, um den Standardwert zu überschreiben. Wenn dieser Dateiname nicht absolut ist, wird er als relativ zum Zielverzeichnis betrachtet.
Bei Verwendung mit `--check-skeleton` überprüft `pack` nur, ob das Snap-Verzeichnis gültige Snap-Metadaten enthält, und gibt andernfalls einen Fehler aus. Anwendungsprogramme, die in der Snap-Metadatendatei aufgeführt sind, aber mit falschen Berechtigungsbits versehen sind, führen zu einem Fehler. Programme, die im Snap-Verzeichnis fehlen, werden in den Diagnosemeldungen aufgeführt.
Verwendung: snap [OPTIONEN] pack [pack-OPTIONEN]
--check-skeleton
Überprüft nur die Snap-Verzeichnis-Metadaten.
--filename
Ausgabe in diese Datei.
--compression
Zu verwendende Komprimierung (z. B. xz oder lzo).
prefer
Aktiviert Aliase von einem Snap und deaktiviert alle widersprüchlichen Aliase.
Der Befehl `prefer` aktiviert alle Aliase des angegebenen Snaps, wobei widersprüchliche Aliase anderer Snaps deaktiviert (oder für manuelle Aliase entfernt) werden.
Verwendung: snap [OPTIONEN] prefer [prefer-OPTIONEN]
--no-wait
Nicht auf das Ende des Vorgangs warten, sondern nur die Änderungs-ID ausgeben.
prepare-image
Bereitet ein Geräteabbild vor.
Der Befehl `prepare-image` führt einige der Schritte aus, die für die Erstellung von Geräteabbildern erforderlich sind.
Für Core-Images wird er nicht direkt aufgerufen, sondern normalerweise über `ubuntu-image`.
Für die Vorbereitung klassischer Images unterstützt er einen `--classic`-Modus.
Verwendung: snap [OPTIONEN] prepare-image [prepare-image-OPTIONEN]
--classic
Aktiviert den klassischen Modus, um ein klassisches Modellabbild vorzubereiten.
--preseed
Vorabversion (nur UC20+).
--preseed-sign-key
Name des Schlüssels, der zum Signieren der Preseed-Assertion verwendet werden soll, andernfalls wird der Standardschlüssel verwendet.
--apparmor-features-dir
Optionaler Pfad zum AppArmor-Kernel-Funktionenverzeichnis (nur UC20+).
--sysfs-overlay
Optionales Sysfs-Overlay, das während der Preseed-Schritte verwendet werden soll.
--arch
Gibt eine Architektur für Snaps für --classic an, wenn das Modell dies nicht tut.
--channel
Der zu verwendende Kanal.
--snap <snap>[=<channel>]
Fügt den angegebenen Snap aus dem Store oder einer lokalen Datei hinzu und/oder gibt den zu verfolgenden Kanal für den angegebenen Snap an.
--comp <snap>+<comp>
Fügt die angegebene Komponente aus dem Store oder einer lokalen Datei hinzu.
--revisions
Gibt eine Datei „seeds.manifest“ an, die die genauen Revisionen der angegebenen Snaps enthält, die installiert werden sollen.
--write-revisions [="./seed.manifest"]
Schreibt eine Manifestdatei, die Referenzen zu den genauen Snap-Revisionen enthält, die für das Image verwendet werden. Ein Pfad für das Manifest ist optional.
--validation
Steuert, ob Validierungen ignoriert oder erzwungen werden sollen (Standard: ignorieren).
--allow-snapd-kernel-mismatch
Gibt an, ob eine Abweichung zwischen den Versionen des Snapd-Snaps und Snapd im Kernel zulässig ist.
--assert <filename>
Fügt die Assertion aus der lokalen Datei ein.
quota
Zeigt die Quota-Gruppe für eine Reihe von Snaps an.
Der Befehl `quota` zeigt Informationen über eine Quota-Gruppe an, einschließlich der Menge der Snaps und aller Untergruppen, die sie enthält, sowie ihrer Ressourcenbeschränkungen und der aktuellen Nutzung dieser eingeschränkten Ressourcen.
quotas
Zeigt Quota-Gruppen an.
Der Befehl `quotas` zeigt alle Quota-Gruppen an.
reboot
Startet in das ausgewählte System und den ausgewählten Modus neu.
Der Befehl `reboot` startet das System in einen bestimmten Modus des ausgewählten Wiederherstellungssystems neu.
Wenn er ohne eine Systembezeichnung und ohne einen Modus aufgerufen wird, wird einfach ein normaler Neustart ausgelöst.
Wenn er ohne Bezeichnung aufgerufen wird, wird das aktuelle System für den Modus „run“ verwendet. Das Standard-Wiederherstellungssystem wird für die Modi „recover“, „factory-reset“ und „install“ verwendet.
Beachten Sie, dass der Modus „run“ nur für das aktuelle System verfügbar ist.
Verwendung: snap [OPTIONEN] reboot [reboot-OPTIONEN]
--run
Startet im Run-Modus.
--install
Startet im Installationsmodus.
--recover
Startet im Wiederherstellungsmodus.
--factory-reset
Startet im Factory-Reset-Modus.
recovery
Listet die verfügbaren Wiederherstellungssysteme auf.
Der Befehl `recovery` listet die verfügbaren Wiederherstellungssysteme auf.
Mit der Option `--show-keys` werden die Wiederherstellungsschlüssel angezeigt, mit denen die verschlüsselten Partitionen entsperrt werden können, falls die gerätespezifische automatische Entsperrung nicht funktioniert.
Verwendung: snap [OPTIONEN] recovery [recovery-OPTIONEN]
--color <Standard: "auto">
Verwendet etwas Farbe, um einige Dinge hervorzuheben.
--unicode <Standard: "auto">
Verwendet etwas Unicode, um die Lesbarkeit zu verbessern.
--show-keys
Zeigt Wiederherstellungsschlüssel an (falls verfügbar), um verschlüsselte Partitionen zu entsperren.
refresh
Aktualisiert Snaps im System.
Der Befehl `refresh` aktualisiert die angegebenen Snaps oder alle Snaps im System, wenn keine angegeben sind.
Ohne weitere Optionen werden die Snaps auf die aktuelle Revision des Kanals aktualisiert, den sie verfolgen, wobei ihre Konfinement-Optionen erhalten bleiben. Alle verfügbaren Kanäle eines Snaps sind in dessen Ausgabe von „snap info“ aufgeführt.
Wenn --revision verwendet wird, wird eine spätere Aktualisierung in der Regel die Revisionsüberschreibung rückgängig machen.
^ old (--hold) wird verwendet, um Snap-Aktualisierungen für alle Snaps zu verschieben, wenn keine Snaps angegeben sind, oder für die angegebenen Snaps.
Wenn keine Snaps angegeben sind, ist --hold nur für automatische Aktualisierungen wirksam und blockiert weder allgemeine Aktualisierungsanforderungen von snap refresh noch spezifische Snap-Anforderungen von snap refresh targetsnap.
Wenn Snaps angegeben sind, ist --hold sowohl für ihre automatischen Aktualisierungen als auch für allgemeine Aktualisierungsanforderungen von snap refresh wirksam. Spezifische Snap-Anforderungen von snap refresh target-snap bleiben jedoch unblockiert und werden fortgesetzt.
Verwendung: snap [OPTIONEN] refresh [refresh-OPTIONEN]
`--color` `<Standard: "auto">`
Verwenden Sie etwas Farbe, um bestimmte Elemente hervorzuheben.
`--unicode` `<Standard: "auto">`
Verwenden Sie etwas Unicode, um die Lesbarkeit zu verbessern.
`--abs-time`
Zeigen Sie absolute Zeiten (im RFC 3339-Format) an. Andernfalls werden relative Zeiten bis zu 60 Tagen und dann JJJJ-MM-TT angezeigt.
`--no-wait`
Warten Sie nicht, bis die Operation abgeschlossen ist, sondern geben Sie nur die Änderungs-ID aus.
`--channel`
Verwenden Sie diesen Kanal anstelle von "stable".
`--edge`
Installieren Sie von dem "edge"-Kanal.
`--beta`
Installieren Sie von dem "beta"-Kanal.
`--candidate`
Installieren Sie von dem "candidate"-Kanal.
`--stable`
Installieren Sie von dem "stable"-Kanal.
`--devmode`
Setzen Sie den Snap in den Entwicklermodus und deaktivieren Sie die Sicherheitsisolierung.
`--jailmode`
Setzen Sie den Snap in den Modus der verstärkten Isolierung.
`--classic`
Setzen Sie den Snap in den klassischen Modus und deaktivieren Sie die Sicherheitsisolierung.
`--amend`
Erlauben Sie einen Aktualisierungsversuch für einen Snap, der dem Store nicht bekannt ist.
`--revision`
Aktualisieren Sie auf die angegebene Revision.
`--cohort`
Aktualisieren Sie den Snap in die angegebene Kohorte.
`--leave-cohort`
Aktualisieren Sie den Snap, um ihn aus seiner Kohorte zu entfernen.
`--list`
Zeigen Sie die neuen Versionen der Snaps an, die bei der nächsten Aktualisierung aktualisiert würden.
`--time`
Zeigen Sie automatische Aktualisierungsinformationen an, führen Sie aber keine Aktualisierung durch.
`--ignore-validation`
Ignorieren Sie die Validierung durch andere Snaps, die die Aktualisierung blockieren.
`--transaction` `<Standard: "per-snap">`
Führen Sie eine Transaktion pro Snap oder eine für alle angegebenen Snaps durch.
`--hold` `[="forever"]`
Halten Sie Aktualisierungen für einen bestimmten Zeitraum an (oder für immer, wenn kein Wert angegeben ist).
`--unhold`
Entfernen Sie die Aktualisierungssperre.
^ emodel
Das remodel-Kommando ändert die Modelldeklaration des Geräts, entweder zu einer neuen Revision oder zu einem vollständig neuen Modell.
Dabei werden alle impliziten Änderungen am Gerät angewendet: neue erforderliche Snaps, neuer Kernel oder neues Gadget usw.
Snaps und Deklarationen werden aus dem Store heruntergeladen, es sei denn, sie werden als lokale Dateien über die Optionen --snap und --assertion bereitgestellt. Wenn diese Optionen verwendet werden, wird erwartet, dass alle erforderlichen Snaps und Deklarationen lokal bereitgestellt werden, andernfalls schlägt die Neuanordnung fehl.
Verwendung: snap [OPTIONEN] remodel [remodel-OPTIONEN]
`--no-wait`
Warten Sie nicht, bis die Operation abgeschlossen ist, sondern geben Sie nur die Änderungs-ID aus.
`--snap`
Verwenden Sie einen oder mehrere lokal verfügbare Snaps.
`--assertion`
Verwenden Sie eine oder mehrere lokal verfügbare Deklarationsdateien.
--offline
Verwende nur vorinstallierte und lokal bereitgestellte Snaps und Assertions. Das lokale Bereitstellen von Snaps oder Assertions impliziert --offline.
remove
Entferne Snaps vom System
Der Befehl remove entfernt die benannte Snap-Instanz vom System.
Standardmäßig werden alle Snap-Revisionen entfernt, einschließlich ihrer Daten und des gemeinsamen Datenverzeichnisses. Wenn die Option --revision verwendet wird, wird nur die angegebene Revision
entfernt.
Sofern automatische Snapshots nicht deaktiviert sind, wird beim Entfernen ein Snapshot aller Daten für den Snap gespeichert, der dann für die zukünftige Wiederherstellung mit snap restore verfügbar ist.
Die Option --purge deaktiviert das automatische Erstellen von Snapshots.
Verwendung: snap [OPTIONEN] remove [remove-OPTIONEN]
--no-wait
Warte nicht, bis die Operation abgeschlossen ist, sondern gib nur die Änderungs-ID aus.
--revision
Entferne nur die angegebene Revision
--purge
Entferne den Snap, ohne einen Snapshot seiner Daten zu speichern
--terminate
Beende laufende Prozesse, die mit einem Snap verbunden sind, bevor es entfernt wird
remove-quota
Entferne eine Quota-Gruppe
Der Befehl remove-quota entfernt die angegebene Quota-Gruppe.
Derzeit können nur Quota-Gruppen ohne Untergruppen entfernt werden. Um eine Quota-Gruppe mit Untergruppen zu entfernen, müssen zuerst die Untergruppen entfernt werden, bis keine Untergruppen mehr für die Gruppe vorhanden sind. Anschließend kann die Gruppe selbst entfernt werden.
Verwendung: snap [OPTIONEN] remove-quota [remove-quota-OPTIONEN]
--no-wait
restart
Starte Dienste neu
Der Befehl restart startet die angegebenen Dienste neu.
Wenn die Option --reload angegeben wird, wird für jeden Dienst, dessen App einen Reload-Befehl hat, anstelle eines Neustarts ein Reload durchgeführt.
Verwendung: snap [OPTIONEN] restart [restart-OPTIONEN]
--no-wait
Warte nicht, bis die Operation abgeschlossen ist, sondern gib nur die Änderungs-ID aus.
--system
Die Operation sollte nur Systemdienste betreffen.
--user Die Operation sollte nur Benutzerdienste für den aktuellen Benutzer betreffen.
--users
Wenn angegeben und auf 'all' gesetzt, sollte die Operation Dienste für alle Benutzer betreffen.
--reload
Wenn der Dienst einen Reload-Befehl hat, verwende diesen anstelle eines Neustarts.
restore
Stelle einen Snapshot wieder her
Der Befehl restore ersetzt die aktuellen Benutzer-, System- und Konfigurationsdaten der enthaltenen Snaps
durch die entsprechenden Daten aus dem angegebenen Snapshot.
Standardmäßig stellt dieser Befehl alle Daten in einem Snapshot wieder her. Alternativ können Sie angeben, welche Daten der Snaps, für welche Benutzer oder eine Kombination davon wiederhergestellt werden sollen.
Wenn ein Snap in einer Wiederherstellungsoperation enthalten ist, ist es derzeit nicht möglich, seine System- und Konfigurationsdaten von der Wiederherstellung auszuschließen. Diese Einschränkung kann in Zukunft aufgehoben werden.
Verwendung: snap [OPTIONEN] restore [restore-OPTIONEN]
--no-wait
Warte nicht, bis die Operation abgeschlossen ist, sondern gib nur die Änderungs-ID aus.
--users
Stelle nur die Daten bestimmter Benutzer wieder her (durch Komma getrennt) (Standard: alle Benutzer)
revert
Setzt den angegebenen Snap in den vorherigen Zustand zurück
Der Befehl revert setzt den angegebenen Snap in seinen Zustand vor der letzten Aktualisierung zurück. Dadurch wird die vorherige Snap-Revision reaktiviert, und es werden die ursprünglichen Daten
verwendet, die dieser
Revision zugeordnet waren, wobei alle Datenänderungen, die von der letzten Revision vorgenommen wurden, verworfen werden. Als Ausnahme werden
Daten, die der Snap explizit für die gemeinsame Nutzung zwischen Revisionen auswählt, vom Revert-Prozess nicht beeinflusst.
Verwendung: snap [OPTIONEN] revert [revert-OPTIONEN]
--no-wait
Warten Sie nicht, bis die Operation abgeschlossen ist, sondern geben Sie nur die Änderungs-ID aus.
--devmode
Setzen Sie Snap in den Entwicklungsmodus und deaktivieren Sie die Sicherheitsbeschränkung.
--jailmode
Setzen Sie Snap in den Modus mit erzwungener Beschränkung.
--classic
Setzen Sie Snap in den klassischen Modus und deaktivieren Sie die Sicherheitsbeschränkung.
--revision
Kehren Sie zu der angegebenen Revision zurück.
run
Führen Sie den angegebenen Snap-Befehl aus.
Der Befehl run führt den angegebenen Snap-Befehl mit der richtigen Beschränkung und Umgebung aus.
Verwendung: snap [OPTIONEN] run [run-OPTIONEN] <NAME-DES-SNAPS>.<NAME-DER-ANWENDUNG> [<SNAP-ANWENDUNGS-ARGUMENT>...]
--shell
Führen Sie eine Shell anstelle des Befehls aus (nützlich zum Debuggen).
--debug-log
Aktivieren Sie die Debug-Protokollierung während der frühen Snap-Startphasen.
--strace [="with-strace"] <Standard: "no-strace">
Führen Sie den Befehl unter strace aus (nützlich zum Debuggen). Zusätzliche Strace-Optionen können hier angegeben werden. Übergeben Sie --raw an strace, um die frühen Snap-Helfer zu verwenden.
--gdbserver [=":0"] <Standard: "no-gdbserver">
Führen Sie den Befehl mit gdbserver aus.
--trace-exec
Zeigen Sie die Zeitdaten der exec-Aufrufe an.
save
Speichern Sie eine Momentaufnahme der aktuellen Daten.
Der Befehl save erstellt eine Momentaufnahme der aktuellen Benutzer-, System- und Konfigurationsdaten für die angegebenen Snaps.
Standardmäßig speichert dieser Befehl die Daten aller Snaps für alle Benutzer. Alternativ können Sie angeben, deren Daten für welche Snaps gespeichert werden sollen oder für welche Benutzer, oder eine Kombination aus beidem.
Wenn ein Snap in eine Speicheroperation einbezogen wird, ist es derzeit nicht möglich, dessen System- und Konfigurationsdaten aus der Momentaufnahme auszuschließen. Diese Einschränkung kann in Zukunft aufgehoben werden.
Verwendung: snap [OPTIONEN] save [save-OPTIONEN]
--no-wait
Warten Sie nicht, bis die Operation abgeschlossen ist, sondern geben Sie nur die Änderungs-ID aus.
--abs-time
Zeigen Sie absolute Zeiten (im RFC 3339-Format) an. Andernfalls werden kurze relative Zeiten angezeigt.
--users
Speichern Sie Daten nur für bestimmte Benutzer (kommagetrennt) (Standard: alle Benutzer).
saved
Listen Sie die aktuell gespeicherten Momentaufnahmen auf.
Der Befehl saved zeigt eine Liste der zuvor mit dem Befehl save erstellten Momentaufnahmen an.
Verwendung: snap [OPTIONEN] saved [saved-OPTIONEN]
--abs-time
Zeigen Sie absolute Zeiten (im RFC 3339-Format) an. Andernfalls werden kurze relative Zeiten angezeigt.
--id Zeigen Sie nur eine bestimmte Momentaufnahme an.
services
Abfrage des Status der Dienste.
Der Befehl services listet Informationen über die angegebenen Dienste oder über die Dienste in allen derzeit installierten Snaps auf.
Wenn er als Root-Benutzer ausgeführt wird, zeigt die Spalte Startup für jeden Benutzerdienst an, ob er global aktiviert ist (d. h. systemctl is-enabled). Um den tatsächlichen Startup-/Current-Status der Benutzerdienste für den Root-Benutzer selbst anzuzeigen, kann --user angegeben werden.
Wenn es als Nicht-Root-Benutzer ausgeführt wird, ist der Status „Startup“|„Current“ der Benutzerdienste der aktuelle Status für den aufrufenden Benutzer. Um den globalen Aktivierungsstatus der Benutzerdienste anzuzeigen, kann --global angegeben werden.
Verwendung: snap [OPTIONEN] services [services-OPTIONEN]
-g, --global
Zeigt den globalen Aktivierungsstatus für Benutzerdienste an, anstatt den Status für den aktuellen Benutzer.
-u, --user
Zeigt den aktuellen Status der Benutzerdienste an, anstatt den globalen Aktivierungsstatus.
set
Ändert Konfigurationsoptionen.
Der Befehl set ändert die angegebenen Konfigurationsoptionen wie angefordert.
$ snap set snap-name username=frank password=$PASSWORD
Alle Konfigurationsänderungen werden gleichzeitig gespeichert und erst dann, wenn der Konfigurations-Hook des Snaps erfolgreich zurückgegeben wurde.
Verschachtelte Werte können über einen Punkt-Pfad geändert werden:
$ snap set snap-name author.name=frank
Konfigurationsoptionen können mit einem Ausrufezeichen aufgehoben werden: $ snap set snap-name author!
Verwendung: snap [OPTIONEN] set [set-OPTIONEN]
--no-wait
Nicht auf das Ende der Operation warten, sondern nur die Änderungs-ID ausgeben.
-t Wert strikt als JSON-Dokument parsen.
-s Wert als Zeichenfolge parsen.
set-quota
Erstellt oder aktualisiert eine Quota-Gruppe.
Der Befehl set-quota aktualisiert oder erstellt eine Quota-Gruppe mit der angegebenen Menge an Snaps.
Eine Quota-Gruppe legt Ressourcenbeschränkungen für die Menge an Snaps oder Snap-Diensten fest, die sie enthält. Snaps können höchstens in einer Quota-Gruppe enthalten sein, aber Quota-Gruppen können verschachtelt sein. Verschachtelte Quota-Gruppen unterliegen der Einschränkung, dass die Gesamtsumme jeder vorhandenen Quota in Untergruppen die des übergeordneten Gruppe, zu der die verschachtelten Gruppen gehören, nicht überschreiten darf.
Alle angegebenen Snaps werden der Gruppe hinzugefügt; um einen Snap aus einer Quota-Gruppe zu entfernen, muss die gesamte Gruppe mit remove-quota entfernt und ohne den Snap neu erstellt werden. Um eine Untergruppe aus der Quota-Gruppe zu entfernen, muss die Untergruppe direkt mit dem Befehl remove-quota entfernt werden.
Um Beschränkungen für einzelne Dienste festzulegen, können ein oder mehrere Dienste in einer Untergruppe platziert werden. Der jeweilige Snap für jeden Dienst muss zur übergeordneten Gruppe der Untergruppe gehören. Diese Untergruppen unterliegen den gleichen Einschränkungen wie verschachtelte Gruppen, was bedeutet, dass ihre kombinierte Ressourcennutzung die für die übergeordnete Gruppe festgelegten Ressourcenbeschränkungen nicht überschreiten darf. Untergruppen, die Dienste enthalten, können keine eigenen Journal-Quotas haben, sondern erben stattdessen automatisch alle Journal-Quotas, die ihre übergeordnete Quota-Gruppe haben kann.
Die Speicherbegrenzung für eine Quota-Gruppe kann erhöht, aber nicht verringert werden. Um die Speicherbegrenzung für eine Quota-Gruppe zu verringern, muss die gesamte Gruppe mit dem Befehl remove-quota entfernt und mit einer niedrigeren Begrenzung neu erstellt werden. Das Erhöhen der Speicherbegrenzung für eine Quota-Gruppe startet keine Dienste neu, die den in der Quota-Gruppe enthaltenen Snaps zugeordnet sind.
Die CPU-Begrenzung für eine Quota-Gruppe kann sowohl erhöht als auch verringert werden, nachdem sie für eine Quota-Gruppe festgelegt wurde. Die CPU-Begrenzung kann als einzelner Prozentsatz angegeben werden, was bedeutet, dass der Quota-Gruppe ein bestimmter Prozentsatz der CPU-Ressourcen zugewiesen wird. Das Einstellen auf 50 % bedeutet, dass die Quota-Gruppe bis zu 50 % aller CPU-Kerne im zulässigen CPU-Satz verwenden darf. Das Einstellen des Prozentsatzes auf 2100 % bedeutet, dass der Quota-Gruppe bis zu 100 % auf zwei CPU-Kernen zugewiesen werden.
Das CPU-Set-Limit für eine Quota-Gruppe kann geändert werden, um neue CPUs einzuschließen oder vorhandene CPUs aus dem bereits festgelegten Quota zu entfernen.
Das Threads-Limit für eine Quota-Gruppe kann erhöht, aber nicht verringert werden. Um das Threads-Limit für eine Quota-Gruppe zu verringern, muss die gesamte Gruppe mit dem Befehl remove-quota entfernt und mit einem niedrigeren Limit neu erstellt werden.
Die Journal-Limits können nach der Festlegung auf einer Gruppe erhöht und verringert werden. Das Festlegen eines Journal-Limits führt dazu, dass die Snaps in der Gruppe in denselben Journal-Namespace gestellt werden. Dies wirkt sich auf das Verhalten des Befehls log aus.
Neue Quotas können für vorhandene Quota-Gruppen festgelegt werden, aber vorhandene Quotas können nicht aus einer Quota-Gruppe entfernt werden, ohne die gesamte Gruppe zu entfernen und neu zu erstellen.
Das Hinzufügen neuer Snaps zu einer Quota-Gruppe führt dazu, dass alle nicht deaktivierten Dienste in diesem Snap neu gestartet werden.
Eine vorhandene Untergruppe kann nicht von einem übergeordneten Element zu einem anderen verschoben werden.
Verwendung: snap [OPTIONEN] set-quota [set-quota-OPTIONEN]
--no-wait
Nicht auf den Abschluss der Operation warten, sondern nur die Änderungs-ID ausgeben.
--memory [=]
Speicher-Quota
--cpu [=]
CPU-Quota
--cpu-set [=]
CPU-Set-Quota
--threads [=]
Threads-Quota
--journal-size [=]
Journal-Größen-Quota
--journal-rate-limit [=]
Journal-Ratenlimit als
--parent [=]
Übergeordnete Quota-Gruppe
start
Starten Sie Dienste
Der Befehl start startet die angegebenen Dienste und aktiviert sie optional.
Verwendung: snap [OPTIONEN] start [start-OPTIONEN]
--no-wait
Nicht auf den Abschluss der Operation warten, sondern nur die Änderungs-ID ausgeben.
--system
Die Operation sollte nur Systemdienste betreffen.
--user Die Operation sollte nur Benutzerdienste für den aktuellen Benutzer betreffen.
--users
Wenn angegeben und auf 'all' gesetzt, sollte die Operation Dienste für alle Benutzer betreffen.
--enable
Starten Sie den Dienst jetzt und ordnen Sie an, dass er beim Bootvorgang gestartet wird.
stop
Stoppen Sie Dienste
Der Befehl stop stoppt die angegebenen Dienste und deaktiviert sie optional.
Verwendung: snap [OPTIONEN] stop [stop-OPTIONEN]
--no-wait
Nicht auf den Abschluss der Operation warten, sondern nur die Änderungs-ID ausgeben.
--system
Die Operation sollte nur Systemdienste betreffen.
--user Die Operation sollte nur Benutzerdienste für den aktuellen Benutzer betreffen.
--users
Wenn angegeben und auf 'all' gesetzt, sollte die Operation Dienste für alle Benutzer betreffen.
--disable
Stoppen Sie den Dienst jetzt und ordnen Sie an, dass er nicht mehr beim Bootvorgang gestartet wird.
switch
Schaltet Snap auf einen anderen Kanal um
Der Befehl switch schaltet den angegebenen Snap auf einen anderen Kanal um, ohne eine Aktualisierung durchzuführen. Alle verfügbaren Kanäle eines Snaps werden in der Ausgabe von snap info aufgelistet.
Verwendung: snap [OPTIONEN] switch [switch-OPTIONEN]
--no-wait
Warten Sie nicht, bis die Operation abgeschlossen ist, sondern geben Sie nur die Änderungs-ID aus.
--channel
Verwenden Sie diesen Kanal anstelle von Stable.
--edge
Installieren Sie von dem Edge-Kanal.
--beta
Installieren Sie von dem Beta-Kanal.
--candidate
Installieren Sie von dem Kandidaten-Kanal.
--stable
Installieren Sie von dem Stable-Kanal.
--cohort
Schalten Sie den Snap auf die angegebene Kohorte um.
--leave-cohort
Schalten Sie den Snap aus seiner Kohorte heraus.
tasks
Listen Sie die Aufgaben einer Änderung auf.
Der Befehl tasks zeigt eine Zusammenfassung der Aufgaben an, die einer einzelnen Änderung zugeordnet sind.
Verwendung: snap [OPTIONEN] tasks [tasks-OPTIONEN]
Alias: change
--abs-time
Zeigen Sie absolute Zeiten (im RFC 3339-Format) an. Andernfalls werden relative Zeiten bis zu 60 Tage angezeigt, dann JJJJ-MM-TT.
--last
Wählen Sie die letzte Änderung des angegebenen Typs aus (installieren, aktualisieren, entfernen, testen, automatische Aktualisierung usw.). Ein Fragezeichen am Ende des Typs bedeutet, dass im Falle, dass keine Änderung des angegebenen Typs gefunden wird, nichts unternommen wird (anstatt einen Fehler zurückzugeben). Beachten Sie, dass das Fragezeichen möglicherweise vor der Shell geschützt werden muss.
try
Testen Sie einen entpackten Snap im System.
Der Befehl try installiert einen entpackten Snap zum Testen im System. Der Inhalt des entpackten Snaps wird auch nach der Installation weiterhin verwendet, sodass nicht-metadatenbezogene Änderungen sofort wirksam werden. Metadatenänderungen, wie z. B. in der Datei snap.yaml, erfordern eine Neuinstallation, um wirksam zu werden.
Wenn das Argument snap-dir weggelassen wird, versucht der Befehl try, es zu ermitteln, wenn entweder eine Datei snapcraft.yaml und ein Hauptverzeichnis oder eine Datei meta/snap.yaml relativ zum aktuellen Arbeitsverzeichnis gefunden werden können.
Verwendung: snap [OPTIONEN] try [try-OPTIONEN]
--no-wait
Warten Sie nicht, bis die Operation abgeschlossen ist, sondern geben Sie nur die Änderungs-ID aus.
--devmode
Setzen Sie den Snap in den Entwicklermodus und deaktivieren Sie die Sicherheitsbeschränkungen.
--jailmode
Setzen Sie den Snap in den eingeschränkten Modus.
--classic
Setzen Sie den Snap in den klassischen Modus und deaktivieren Sie die Sicherheitsbeschränkungen.
unalias
Entfernen Sie einen manuellen Alias oder die Aliase für einen gesamten Snap.
Der Befehl unalias entfernt einen einzelnen Alias, wenn das angegebene Argument ein manueller Alias ist, oder deaktiviert alle Aliase eines Snaps, einschließlich manueller Aliase, wenn das Argument ein Snap-Name ist.
Verwendung: snap [OPTIONEN] unalias [unalias-OPTIONEN]
--no-wait
Warten Sie nicht, bis die Operation abgeschlossen ist, sondern geben Sie nur die Änderungs-ID aus.
unset
Entfernen Sie Konfigurationsoptionen.
Der Befehl unset entfernt die angegebenen Konfigurationsoptionen.
$ snap unset snap-name name address
Alle Konfigurationsänderungen werden gleichzeitig gespeichert und erst dann angewendet, wenn der Konfigurations-Hook des Snaps erfolgreich ausgeführt wurde.
Verschachtelte Werte können über einen Punkt getrennten Pfad entfernt werden:
$ snap unset snap-name user.name
Verwendung: snap [OPTIONEN] unset [unset-OPTIONEN]
--no-wait
Warten Sie nicht, bis die Operation abgeschlossen ist, sondern geben Sie nur die Änderungs-ID aus.
validate
Listen oder wenden Sie Validierungssätze an.
Der Befehl validate listet oder wendet Validierungssätze an, die festlegen, welche Snaps zusammen installiert werden dürfen oder erforderlich sind, optional begrenzt auf feste Revisionen.
Ein Validierungssatz kann entweder im Überwachungsmodus sein, in dem seine Beschränkungen nicht erzwungen werden, oder im Erzwingungsmodus, in dem snapd Operationen nicht zulässt, die dazu führen würden, dass Snaps die Beschränkungen des Validierungssatzes verletzen.
Verwendung: snap [OPTIONEN] validate [validate-OPTIONEN]
--monitor
Überwache das angegebene Validierungsset
--enforce
Setze das angegebene Validierungsset durch
--forget
Vergiss das angegebene Validierungsset
--refresh
Aktualisiere oder installiere Snaps, um die durchgesetzten Validierungssets zu erfüllen
--color <Standard: "auto">
Verwende etwas Farbe, um bestimmte Dinge hervorzuheben.
--unicode <Standard: "auto">
Verwende etwas Unicode, um die Lesbarkeit zu verbessern.
--no-wait
Warte nicht auf den Abschluss der Operation, sondern gib nur die Änderungs-ID aus.
version
Zeige Versionsdetails an
Der Befehl `version` zeigt die Versionen des ausgeführten Clients, Servers und des Betriebssystems an.
wait
Warte auf eine Konfiguration
Der Befehl `wait` wartet, bis eine Konfiguration wahr ist.
warnings
Liste Warnungen auf
Der Befehl `warnings` listet die Warnungen auf, die dem System gemeldet wurden.
Nachdem Warnungen mit `snap warnings` aufgelistet wurden, kann `snap okay` verwendet werden, um sie zu unterdrücken. Eine
Warnung, die auf diese Weise unterdrückt wurde, wird nicht erneut aufgelistet, es sei denn, sie tritt erneut auf _und_
eine Abkühlzeit ist verstrichen.
Warnungen verfallen automatisch, und sobald sie verfallen sind, werden sie vergessen.
Verwendung: snap [OPTIONEN] warnings [warnings-OPTIONEN]
--abs-time
Zeige absolute Zeiten (im RFC 3339-Format) an. Andernfalls werden relative Zeiten bis zu 60
Tagen und dann JJJJ-MM-TT angezeigt.
--unicode <Standard: "auto">
Verwende etwas Unicode, um die Lesbarkeit zu verbessern.
--all
Zeige alle Warnungen an
--verbose
Zeige mehr Informationen an
watch
Beobachte einen laufenden Prozess
Der Befehl `watch` wartet, bis die angegebene Änderungs-ID abgeschlossen ist, und zeigt den Fortschritt an (falls verfügbar).
Verwendung: snap [OPTIONEN] watch [watch-OPTIONEN]
--last
Wähle die letzte Änderung des angegebenen Typs (Installation, Aktualisierung, Entfernung, Versuch, automatische Aktualisierung usw.) aus. Ein
Fragezeichen am Ende des Typs bedeutet, dass nichts unternommen werden soll (anstatt einen Fehler zurückzugeben),
wenn keine Änderung des angegebenen Typs gefunden wird. Beachten Sie, dass das Fragezeichen möglicherweise vor der
Shell geschützt werden muss.
whoami
Zeige die E-Mail-Adresse des angemeldeten Benutzers an
Der Befehl `whoami` zeigt die E-Mail-Adresse des angemeldeten Benutzers an.
HINWEISE
Online-Dokumentation
https://docs.snapcraft.io
FEHLER
Bitte melde alle Fehler unter https://bugs.launchpad.net/snapd/+filebug