1snap(8) System Manager's Manual snap(8)
2
6 snap - Tool to interact with snaps
7
9 snap [OPTIONS]
10
12 The snap command lets you install, configure, refresh and remove snaps.
13 Snaps are packages that work across many different Linux distributions,
14 enabling secure delivery and operation of the latest apps and utili‐
15 ties.
16
19 abort
20 Abort a pending change
21 The abort command attempts to abort a change that still has pending
23 tasks.
24 Usage: snap abort [abort-OPTIONS]
26 --last Select last change of given type (install, refresh, remove, try,
28 auto-refresh, etc.). A question mark at the end of the type
29 means to do nothing (instead of returning an error) if no change
30 of the given type is found. Note the question mark could need
31 protecting from the shell.
32 ack
34 Add an assertion to the system
35 The ack command tries to add an assertion to the system assertion data‐
37 base.
38 The assertion may also be a newer revision of a pre-existing assertion
40 that it will replace.
41 To succeed the assertion must be valid, its signature verified with a
43 known public key and the assertion consistent with and its prerequisite
44 in the database.
45 alias
47 Set up a manual alias
48 The alias command aliases the given snap application to the given
50 alias.
51 Once this manual alias is setup the respective application command can
53 be invoked just using the alias.
54 Usage: snap alias [alias-OPTIONS]
56 --no-wait
58 Do not wait for the operation to finish but just print the
59 change id.
60 aliases
62 List aliases in the system
63 The aliases command lists all aliases available in the system and their
65 status.
66 $ snap aliases <snap>
68 Lists only the aliases defined by the specified snap.
70 An alias noted as undefined means it was explicitly enabled or disabled
72 but is not defined in the current revision of the snap, possibly tempo‐
73 rarily (e.g. because of a revert). This can cleared with 'snap alias
74 --reset'.
75 changes
77 List system changes
78 The changes command displays a summary of system changes performed
80 recently.
81 Usage: snap changes [changes-OPTIONS]
83 --abs-time
85 Display absolute times (in RFC 3339 format). Otherwise, display
86 relative times up to 60 days, then YYYY-MM-DD.
87 check-snapshot
89 Check a snapshot
90 The check-snapshot command verifies the user, system and configuration
92 data of the snaps included in the specified snapshot.
93 The check operation runs the same data integrity verification that is
95 performed when a snapshot is restored.
96 By default, this command checks all the data in a snapshot. Alterna‐
98 tively, you can specify the data of which snaps to check, or for which
99 users, or a combination of these.
100 If a snap is included in a check-snapshot operation, excluding its sys‐
102 tem and configuration data from the check is not currently possible.
103 This restriction may be lifted in the future.
104 Usage: snap check-snapshot [check-snapshot-OPTIONS]
106 --no-wait
108 Do not wait for the operation to finish but just print the
109 change id.
110 --users
112 Check data of only specific users (comma-separated) (default:
113 all users)
114 connect
116 Connect a plug to a slot
117 The connect command connects a plug to a slot. It may be called in the
119 following ways:
120 $ snap connect <snap>:<plug> <snap>:<slot>
122 Connects the provided plug to the given slot.
124 $ snap connect <snap>:<plug> <snap>
126 Connects the specific plug to the only slot in the provided snap that
128 matches the connected interface. If more than one potential slot
129 exists, the command fails.
130 $ snap connect <snap>:<plug>
132 Connects the provided plug to the slot in the core snap with a name
134 matching the plug name.
135 Usage: snap connect [connect-OPTIONS]
137 --no-wait
139 Do not wait for the operation to finish but just print the
140 change id.
141 connections
143 List interface connections
144 The connections command lists connections between plugs and slots in
146 the system.
147 Unless <snap> is provided, the listing is for connected plugs and slots
149 for all snaps in the system. In this mode, pass --all to also list
150 unconnected plugs and slots.
151 $ snap connections <snap>
153 Lists connected and unconnected plugs and slots for the specified snap.
155 Usage: snap connections [connections-OPTIONS]
157 --all Show connected and unconnected plugs and slots
159 create-cohort
161 Create cohort keys for a series of snaps
162 The create-cohort command creates a set of cohort keys for a given set
164 of snaps.
165 A cohort is a view or snapshot of a snap's "channel map" at a given
167 point in time that fixes the set of revisions for the snap given other
168 constraints (e.g. channel or architecture). The cohort is then identi‐
169 fied by an opaque per-snap key that works across systems. Installations
170 or refreshes of the snap using a given cohort key would use a fixed
171 revision for up to 90 days, after which a new set of revisions would be
172 fixed under that same cohort key and a new 90 days window started.
173 disable
175 Disable a snap in the system
176 The disable command disables a snap. The binaries and services of the
178 snap will no longer be available, but all the data is still available
179 and the snap can easily be enabled again.
180 Usage: snap disable [disable-OPTIONS]
182 --no-wait
184 Do not wait for the operation to finish but just print the
185 change id.
186 disconnect
188 Disconnect a plug from a slot
189 The disconnect command disconnects a plug from a slot. It may be
191 called in the following ways:
192 $ snap disconnect <snap>:<plug> <snap>:<slot>
194 Disconnects the specific plug from the specific slot.
196 $ snap disconnect <snap>:<slot or plug>
198 Disconnects everything from the provided plug or slot. The snap name
200 may be omitted for the core snap.
201 Usage: snap disconnect [disconnect-OPTIONS]
203 --no-wait
205 Do not wait for the operation to finish but just print the
206 change id.
207 download
209 Download the given snap
210 The download command downloads the given snap and its supporting asser‐
212 tions to the current directory with .snap and .assert file extensions,
213 respectively.
214 Usage: snap download [download-OPTIONS]
216 --channel
218 Use this channel instead of stable
219 --edge Install from the edge channel
221 --beta Install from the beta channel
223 --candidate
225 Install from the candidate channel
226 --stable
228 Install from the stable channel
229 --revision
231 Download the given revision of a snap, to which you must have
232 developer access
233 --basename
235 Use this basename for the snap and assertion files (defaults to
236 <snap>_<revision>)
237 --target-directory
239 Download to this directory (defaults to the current directory)
240 --cohort
242 Download from the given cohort
243 enable
245 Enable a snap in the system
246 The enable command enables a snap that was previously disabled.
248 Usage: snap enable [enable-OPTIONS]
250 --no-wait
252 Do not wait for the operation to finish but just print the
253 change id.
254 find
256 Find packages to install
257 The find command queries the store for available packages.
259 With the --private flag, which requires the user to be logged-in to the
261 store (see 'snap help login'), it instead searches for private snaps
262 that the user has developer access to, either directly or through the
263 store's collaboration feature.
264 A green check mark (given color and unicode support) after a publisher
266 name indicates that the publisher has been verified.
267 Usage: snap find [find-OPTIONS]
269 Aliases: search
272 --private
275 Search private snaps.
276 --narrow
278 Only search for snaps in “stable”.
279 --section [="show-all-sections-please"] <default: "no-section-speci‐
281 fied">
282 Restrict the search to a given section.
283 --color <default: "auto">
285 Use a little bit of color to highlight some things.
286 --unicode <default: "auto">
288 Use a little bit of Unicode to improve legibility.
289 forget
291 Delete a snapshot
292 The forget command deletes a snapshot. This operation can not be
294 undone.
295 A snapshot contains archives for the user, system and configuration
297 data of each snap included in the snapshot.
298 By default, this command forgets all the data in a snapshot. Alterna‐
300 tively, you can specify the data of which snaps to forget.
301 Usage: snap forget [forget-OPTIONS]
303 --no-wait
305 Do not wait for the operation to finish but just print the
306 change id.
307 get
309 Print configuration options
310 The get command prints configuration options for the provided snap.
312 $ snap get snap-name username
314 frank
315 If multiple option names are provided, the corresponding values are
317 returned:
318 $ snap get snap-name username password
320 Key Value
321 username frank
322 password ...
323 Nested values may be retrieved via a dotted path:
325 $ snap get snap-name author.name
327 frank
328 Usage: snap get [get-OPTIONS]
330 -t Strict typing with nulls and quoted strings
332 -d Always return document, even with single key
334 -l Always return list, even with single key
336 help
338 Show help about a command
339 The help command displays information about snap commands.
341 Usage: snap help [help-OPTIONS]
343 --all Show a short summary of all commands
345 info
347 Show detailed information about snaps
348 The info command shows detailed information about snaps.
350 The snaps can be specified by name or by path; names are looked for
352 both in the store and in the installed snaps; paths can refer to a
353 .snap file, or to a directory that contains an unpacked snap suitable
354 for 'snap try' (an example of this would be the 'prime' directory
355 snapcraft produces).
356 Usage: snap info [info-OPTIONS]
358 --color <default: "auto">
360 Use a little bit of color to highlight some things.
361 --unicode <default: "auto">
363 Use a little bit of Unicode to improve legibility.
364 --abs-time
366 Display absolute times (in RFC 3339 format). Otherwise, display
367 relative times up to 60 days, then YYYY-MM-DD.
368 --verbose
370 Include more details on the snap (expanded notes, base, etc.)
371 install
373 Install snaps on the system
374 The install command installs the named snaps on the system.
376 To install multiple instances of the same snap, append an underscore
378 and a unique identifier (for each instance) to a snap's name.
379 With no further options, the snaps are installed tracking the stable
381 channel, with strict security confinement.
382 Revision choice via the --revision override requires the the user to
384 have developer access to the snap, either directly or through the
385 store's collaboration feature, and to be logged in (see 'snap help
386 login').
387 Note a later refresh will typically undo a revision override, taking
389 the snap back to the current revision of the channel it's tracking.
390 Use --name to set the instance name when installing from snap file.
392 Usage: snap install [install-OPTIONS]
394 --color <default: "auto">
396 Use a little bit of color to highlight some things.
397 --unicode <default: "auto">
399 Use a little bit of Unicode to improve legibility.
400 --no-wait
402 Do not wait for the operation to finish but just print the
403 change id.
404 --channel
406 Use this channel instead of stable
407 --edge Install from the edge channel
409 --beta Install from the beta channel
411 --candidate
413 Install from the candidate channel
414 --stable
416 Install from the stable channel
417 --devmode
419 Put snap in development mode and disable security confinement
420 --jailmode
422 Put snap in enforced confinement mode
423 --classic
425 Put snap in classic mode and disable security confinement
426 --revision
428 Install the given revision of a snap, to which you must have
429 developer access
430 --dangerous
432 Install the given snap file even if there are no pre-acknowl‐
433 edged signatures for it, meaning it was not verified and could
434 be dangerous (--devmode implies this)
435 --unaliased
437 Install the given snap without enabling its automatic aliases
438 --name Install the snap file under the given instance name
440 --cohort
442 Install the snap in the given cohort
443 interface
445 Show details of snap interfaces
446 The interface command shows details of snap interfaces.
448 If no interface name is provided, a list of interface names with at
450 least one connection is shown, or a list of all interfaces if --all is
451 provided.
452 Usage: snap interface [interface-OPTIONS]
454 --attrs
456 Show interface attributes
457 --all Include unused interfaces
459 known
461 Show known assertions of the provided type
462 The known command shows known assertions of the provided type. If
464 header=value pairs are provided after the assertion type, the asser‐
465 tions shown must also have the specified headers matching the provided
466 values.
467 Usage: snap known [known-OPTIONS]
469 --remote
471 Query the store for the assertion, via snapd if possible
472 list
474 List installed snaps
475 The list command displays a summary of snaps installed in the current
477 system.
478 A green check mark (given color and unicode support) after a publisher
480 name indicates that the publisher has been verified.
481 Usage: snap list [list-OPTIONS]
483 --all Show all revisions
485 --color <default: "auto">
487 Use a little bit of color to highlight some things.
488 --unicode <default: "auto">
490 Use a little bit of Unicode to improve legibility.
491 login
493 Authenticate to snapd and the store
494 The login command authenticates the user to snapd and the snap store,
496 and saves credentials into the ~/.snap/auth.json file. Further communi‐
497 cation with snapd will then be made using those credentials.
498 It's not necessary to log in to interact with snapd. Doing so, however,
500 enables purchasing of snaps using 'snap buy', as well as some some
501 developer-oriented features as detailed in the help for the find,
502 install and refresh commands.
503 An account can be set up at https://login.ubuntu.com
505 logout
507 Log out of snapd and the store
508 The logout command logs the current user out of snapd and the store.
510 logs
512 Retrieve logs for services
513 The logs command fetches logs of the given services and displays them
515 in chronological order.
516 Usage: snap logs [logs-OPTIONS]
518 -n <default: "10">
520 Show only the given number of lines, or 'all'.
521 -f Wait for new lines and print them as they come in.
523 model
525 Get the active model for this device
526 The model command returns the active model assertion information for
528 this device.
529 By default, only the essential model identification information is
531 included in the output, but this can be expanded to include all of an
532 assertion's non-meta headers.
533 The verbose output is presented in a structured, yaml-like format.
535 Similarly, the active serial assertion can be used for the output
537 instead of the model assertion.
538 Usage: snap model [model-OPTIONS]
540 --no-wait
542 Do not wait for the operation to finish but just print the
543 change id.
544 --abs-time
546 Display absolute times (in RFC 3339 format). Otherwise, display
547 relative times up to 60 days, then YYYY-MM-DD.
548 --color <default: "auto">
550 Use a little bit of color to highlight some things.
551 --unicode <default: "auto">
553 Use a little bit of Unicode to improve legibility.
554 --serial
556 Print the serial assertion instead of the model assertion.
557 --verbose
559 Print all specific assertion fields.
560 --assertion
562 Print the raw assertion.
563 okay
565 Acknowledge warnings
566 The okay command acknowledges the warnings listed with 'snap warnings'.
568 Once acknowledged a warning won't appear again unless it re-occurrs and
570 sufficient time has passed.
571 pack
573 Pack the given directory as a snap
574 The pack command packs the given snap-dir as a snap and writes the
576 result to target-dir. If target-dir is omitted, the result is written
577 to current directory. If both source-dir and target-dir are omitted,
578 the pack command packs the current directory.
579 The default file name for a snap can be derived entirely from its
581 snap.yaml, but in some situations it's simpler for a script to feed the
582 filename in. In those cases, --filename can be given to override the
583 default. If this filename is not absolute it will be taken as relative
584 to target-dir.
585 When used with --check-skeleton, pack only checks whether snap-dir con‐
587 tains valid snap metadata and raises an error otherwise. Application
588 commands listed in snap metadata file, but appearing with incorrect
589 permission bits result in an error. Commands that are missing from
590 snap-dir are listed in diagnostic messages.
591 Usage: snap pack [pack-OPTIONS]
593 --check-skeleton
595 Validate snap-dir metadata only
596 --filename
598 Output to this filename
599 prefer
601 Enable aliases from a snap, disabling any conflicting aliases
602 The prefer command enables all aliases of the given snap in preference
604 to conflicting aliases of other snaps whose aliases will be disabled
605 (or removed, for manual ones).
606 Usage: snap prefer [prefer-OPTIONS]
608 --no-wait
610 Do not wait for the operation to finish but just print the
611 change id.
612 prepare-image
614 Prepare a device image
615 The prepare-image command performs some of the steps necessary for cre‐
617 ating device images.
618 For core images it is not invoked directly but usually via ubuntu-
620 image.
621 For preparing classic images it supports a --classic mode
623 Usage: snap prepare-image [prepare-image-OPTIONS]
625 --classic
627 Enable classic mode to prepare a classic model image
628 --arch Specify an architecture for snaps for --classic when the model
630 does not
631 --channel
633 The channel to use
634 --snap <snap>[=<channel>]
636 Include the given snap from the store or a local file and/or
637 specify the channel to track for the given snap
638 refresh
640 Refresh snaps in the system
641 The refresh command updates the specified snaps, or all snaps in the
643 system if none are specified.
644 With no further options, the snaps are refreshed to the current revi‐
646 sion of the channel they're tracking, preserving their confinement
647 options.
648 Revision choice via the --revision override requires the the user to
650 have developer access to the snap, either directly or through the
651 store's collaboration feature, and to be logged in (see 'snap help
652 login').
653 Note a later refresh will typically undo a revision override.
655 Usage: snap refresh [refresh-OPTIONS]
657 --color <default: "auto">
659 Use a little bit of color to highlight some things.
660 --unicode <default: "auto">
662 Use a little bit of Unicode to improve legibility.
663 --abs-time
665 Display absolute times (in RFC 3339 format). Otherwise, display
666 relative times up to 60 days, then YYYY-MM-DD.
667 --no-wait
669 Do not wait for the operation to finish but just print the
670 change id.
671 --channel
673 Use this channel instead of stable
674 --edge Install from the edge channel
676 --beta Install from the beta channel
678 --candidate
680 Install from the candidate channel
681 --stable
683 Install from the stable channel
684 --devmode
686 Put snap in development mode and disable security confinement
687 --jailmode
689 Put snap in enforced confinement mode
690 --classic
692 Put snap in classic mode and disable security confinement
693 --amend
695 Allow refresh attempt on snap unknown to the store
696 --revision
698 Refresh to the given revision, to which you must have developer
699 access
700 --cohort
702 Refresh the snap into the given cohort
703 --leave-cohort
705 Refresh the snap out of its cohort
706 --list Show the new versions of snaps that would be updated with the
708 next refresh
709 --time Show auto refresh information but do not perform a refresh
711 --ignore-validation
713 Ignore validation by other snaps blocking the refresh
714 remove
716 Remove snaps from the system
717 The remove command removes the named snap instance from the system.
719 By default all the snap revisions are removed, including their data and
721 the common data directory. When a --revision option is passed only the
722 specified revision is removed.
723 Usage: snap remove [remove-OPTIONS]
725 --no-wait
727 Do not wait for the operation to finish but just print the
728 change id.
729 --revision
731 Remove only the given revision
732 --purge
734 Remove the snap without saving a snapshot of its data
735 restart
737 Restart services
738 The restart command restarts the given services.
740 If the --reload option is given, for each service whose app has a
742 reload command, a reload is performed instead of a restart.
743 Usage: snap restart [restart-OPTIONS]
745 --no-wait
747 Do not wait for the operation to finish but just print the
748 change id.
749 --reload
751 If the service has a reload command, use it instead of restart‐
752 ing.
753 restore
755 Restore a snapshot
756 The restore command replaces the current user, system and configuration
758 data of included snaps, with the corresponding data from the specified
759 snapshot.
760 By default, this command restores all the data in a snapshot. Alterna‐
762 tively, you can specify the data of which snaps to restore, or for
763 which users, or a combination of these.
764 If a snap is included in a restore operation, excluding its system and
766 configuration data from the restore is not currently possible. This
767 restriction may be lifted in the future.
768 Usage: snap restore [restore-OPTIONS]
770 --no-wait
772 Do not wait for the operation to finish but just print the
773 change id.
774 --users
776 Restore data of only specific users (comma-separated) (default:
777 all users)
778 revert
780 Reverts the given snap to the previous state
781 The revert command reverts the given snap to its state before the lat‐
783 est refresh. This will reactivate the previous snap revision, and will
784 use the original data that was associated with that revision, discard‐
785 ing any data changes that were done by the latest revision. As an
786 exception, data which the snap explicitly chooses to share across revi‐
787 sions is not touched by the revert process.
788 Usage: snap revert [revert-OPTIONS]
790 --no-wait
792 Do not wait for the operation to finish but just print the
793 change id.
794 --devmode
796 Put snap in development mode and disable security confinement
797 --jailmode
799 Put snap in enforced confinement mode
800 --classic
802 Put snap in classic mode and disable security confinement
803 --revision
805 Revert to the given revision
806 run
808 Run the given snap command
809 The run command executes the given snap command with the right confine‐
811 ment and environment.
812 Usage: snap run [run-OPTIONS]
814 --shell
816 Run a shell instead of the command (useful for debugging)
817 --strace [="with-strace"] <default: "no-strace">
819 Run the command under strace (useful for debugging). Extra
820 strace options can be specified as well here. Pass --raw to
821 strace early snap helpers.
822 --gdb Run the command with gdb
824 --trace-exec
826 Display exec calls timing data
827 save
829 Save a snapshot of the current data
830 The save command creates a snapshot of the current user, system and
832 configuration data for the given snaps.
833 By default, this command saves the data of all snaps for all users.
835 Alternatively, you can specify the data of which snaps to save, or for
836 which users, or a combination of these.
837 If a snap is included in a save operation, excluding its system and
839 configuration data from the snapshot is not currently possible. This
840 restriction may be lifted in the future.
841 Usage: snap save [save-OPTIONS]
843 --no-wait
845 Do not wait for the operation to finish but just print the
846 change id.
847 --abs-time
849 Display absolute times (in RFC 3339 format). Otherwise, display
850 short relative times.
851 --users
853 Snapshot data of only specific users (comma-separated) (default:
854 all users)
855 saved
857 List currently stored snapshots
858 The saved command displays a list of snapshots that have been created
860 previously with the 'save' command.
861 Usage: snap saved [saved-OPTIONS]
863 --abs-time
865 Display absolute times (in RFC 3339 format). Otherwise, display
866 short relative times.
867 --id Show only a specific snapshot.
869 services
871 Query the status of services
872 The services command lists information about the services specified, or
874 about the services in all currently installed snaps.
875 set
877 Change configuration options
878 The set command changes the provided configuration options as
880 requested.
881 $ snap set snap-name username=frank password=$PASSWORD
883 All configuration changes are persisted at once, and only after the
885 snap's configuration hook returns successfully.
886 Nested values may be modified via a dotted path:
888 $ snap set snap-name author.name=frank
890 Configuration option may be unset with exclamation mark:
892 $ snap set snap-name author!
893 Usage: snap set [set-OPTIONS]
895 --no-wait
897 Do not wait for the operation to finish but just print the
898 change id.
899 start
901 Start services
902 The start command starts, and optionally enables, the given services.
904 Usage: snap start [start-OPTIONS]
906 --no-wait
908 Do not wait for the operation to finish but just print the
909 change id.
910 --enable
912 As well as starting the service now, arrange for it to be
913 started on boot.
914 stop
916 Stop services
917 The stop command stops, and optionally disables, the given services.
919 Usage: snap stop [stop-OPTIONS]
921 --no-wait
923 Do not wait for the operation to finish but just print the
924 change id.
925 --disable
927 As well as stopping the service now, arrange for it to no longer
928 be started on boot.
929 switch
931 Switches snap to a different channel
932 The switch command switches the given snap to a different channel with‐
934 out doing a refresh.
935 Usage: snap switch [switch-OPTIONS]
937 --no-wait
939 Do not wait for the operation to finish but just print the
940 change id.
941 --channel
943 Use this channel instead of stable
944 --edge Install from the edge channel
946 --beta Install from the beta channel
948 --candidate
950 Install from the candidate channel
951 --stable
953 Install from the stable channel
954 --cohort
956 Switch the snap into the given cohort
957 --leave-cohort
959 Switch the snap out of its cohort
960 tasks
962 List a change's tasks
963 The tasks command displays a summary of tasks associated with an indi‐
965 vidual change.
966 Usage: snap tasks [tasks-OPTIONS]
968 Aliases: change
971 --abs-time
974 Display absolute times (in RFC 3339 format). Otherwise, display
975 relative times up to 60 days, then YYYY-MM-DD.
976 --last Select last change of given type (install, refresh, remove, try,
978 auto-refresh, etc.). A question mark at the end of the type
979 means to do nothing (instead of returning an error) if no change
980 of the given type is found. Note the question mark could need
981 protecting from the shell.
982 try
984 Test an unpacked snap in the system
985 The try command installs an unpacked snap into the system for testing
987 purposes. The unpacked snap content continues to be used even after
988 installation, so non-metadata changes there go live instantly. Metadata
989 changes such as those performed in snap.yaml will require reinstalla‐
990 tion to go live.
991 If snap-dir argument is omitted, the try command will attempt to infer
993 it if either snapcraft.yaml file and prime directory or meta/snap.yaml
994 file can be found relative to current working directory.
995 Usage: snap try [try-OPTIONS]
997 --no-wait
999 Do not wait for the operation to finish but just print the
1000 change id.
1001 --devmode
1003 Put snap in development mode and disable security confinement
1004 --jailmode
1006 Put snap in enforced confinement mode
1007 --classic
1009 Put snap in classic mode and disable security confinement
1010 unalias
1012 Remove a manual alias, or the aliases for an entire snap
1013 The unalias command removes a single alias if the provided argument is
1015 a manual alias, or disables all aliases of a snap, including manual
1016 ones, if the argument is a snap name.
1017 Usage: snap unalias [unalias-OPTIONS]
1019 --no-wait
1021 Do not wait for the operation to finish but just print the
1022 change id.
1023 unset
1025 Remove configuration options
1026 The unset command removes the provided configuration options as
1028 requested.
1029 $ snap unset snap-name name address
1031 All configuration changes are persisted at once, and only after the
1033 snap's configuration hook returns successfully.
1034 Nested values may be removed via a dotted path:
1036 $ snap unset snap-name user.name
1038 Usage: snap unset [unset-OPTIONS]
1040 --no-wait
1042 Do not wait for the operation to finish but just print the
1043 change id.
1044 version
1046 Show version details
1047 The version command displays the versions of the running client,
1049 server, and operating system.
1050 wait
1052 Wait for configuration
1053 The wait command waits until a configuration becomes true.
1055 warnings
1057 List warnings
1058 The warnings command lists the warnings that have been reported to the
1060 system.
1061 Once warnings have been listed with 'snap warnings', 'snap okay' may be
1063 used to silence them. A warning that's been silenced in this way will
1064 not be listed again unless it happens again, _and_ a cooldown time has
1065 passed.
1066 Warnings expire automatically, and once expired they are forgotten.
1068 Usage: snap warnings [warnings-OPTIONS]
1070 --abs-time
1072 Display absolute times (in RFC 3339 format). Otherwise, display
1073 relative times up to 60 days, then YYYY-MM-DD.
1074 --unicode <default: "auto">
1076 Use a little bit of Unicode to improve legibility.
1077 --all Show all warnings
1079 --verbose
1081 Show more information
1082 watch
1084 Watch a change in progress
1085 The watch command waits for the given change-id to finish and shows
1087 progress (if available).
1088 Usage: snap watch [watch-OPTIONS]
1090 --last Select last change of given type (install, refresh, remove, try,
1092 auto-refresh, etc.). A question mark at the end of the type
1093 means to do nothing (instead of returning an error) if no change
1094 of the given type is found. Note the question mark could need
1095 protecting from the shell.
1096 whoami
1098 Show the email the user is logged in with
1099 The whoami command shows the email the user is logged in with.
1101 13 February 2020 snap(8)