1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356 | snap(1) General Commands Manual snap(1)
NAME
snap - Tool to interact with snaps
SYNOPSIS
snap [OPTIONS]
DESCRIPTION
The snap tool interacts with the snapd daemon to control the
snappy software platform.
OPTIONS
--version
print the version and exit
-h, --help
Show this help message
COMMANDS
abort
Abort a pending change
The abort command attempts to abort a change that still has pend‐
ing tasks.
-h, --help
Show this help message
ack
Adds an assertion to the system
The ack command tries to add an assertion to the system assertion
database.
The assertion may also be a newer revision of a preexisting asser‐
tion that it will replace.
To succeed the assertion must be valid, its signature verified
with a known public key and the assertion consistent with and its
prerequisite in the database.
-h, --help
Show this help message
buy
Buys a snap
The buy command buys a snap from the store.
Usage: snap [OPTIONS] buy [buy-OPTIONS]
--currency
ISO 4217 code for currency
(https://en.wikipedia.org/wiki/ISO_4217)
-h, --help
Show this help message
change
List a change's tasks
The change command displays a summary of tasks associated to an
individual change.
-h, --help
Show this help message
changes
List system changes
The changes command displays a summary of the recent system
changes performed.
-h, --help
Show this help message
connect
Connects a plug to a slot
The connect command connects a plug to a slot. It may be called
in the following ways:
$ snap connect <snap>:<plug> <snap>:<slot>
Connects the specific plug to the specific slot.
$ snap connect <snap>:<plug> <snap>
Connects the specific plug to the only slot in the provided snap
that matches the connected interface. If more than one potential
slot exists, the command fails.
$ snap connect <plug> <snap>[:<slot>]
Without a name for the snap offering the plug, the plug name is
looked at in the gadget snap, the kernel snap, and then the os
snap, in that order. The first of these snaps that has a matching
plug name is used and the command proceeds as above.
-h, --help
Show this help message
create-user
Creates a local system user
The create-user command creates a local system user with the user‐
name and SSH keys registered on the store account identified by
the provided email address.
An account can be setup at https://login.ubuntu.com.
-h, --help
Show this help message
disable
Disables a snap in the system
The disable command disables a snap. The binaries and services of
the snap will no longer be available. But all the data is still
available and the snap can easily be enabled again.
-h, --help
Show this help message
disconnect
Disconnects a plug from a slot
The disconnect command disconnects a plug from a slot. It may be
called in the following ways:
$ snap disconnect <snap>:<plug> <snap>:<slot>
Disconnects the specific plug from the specific slot.
$ snap disconnect <snap>:<slot>
Disconnects any previously connected plugs from the provided slot.
$ snap disconnect <snap>
Disconnects all plugs from the provided snap.
-h, --help
Show this help message
enable
Enables a snap in the system
The enable command enables a snap that was previously disabled.
-h, --help
Show this help message
find
Finds packages to install
The find command queries the store for available packages.
Usage: snap [OPTIONS] find [find-OPTIONS]
--private
search private snaps
-h, --help
Show this help message
help
Help
How help for the snap command.
Usage: snap [OPTIONS] help [help-OPTIONS]
--man Generate the manpage
-h, --help
Show this help message
install
Installs a snap to the system
The install command installs the named snap in the system.
Usage: snap [OPTIONS] install [install-OPTIONS]
--channel
Use this channel instead of stable
--edge Install from the edge channel
--beta Install from the beta channel
--candidate
Install from the candidate channel
--stable
Install from the stable channel
--devmode
Request non-enforcing security
--jailmode
Override a snap's request for non-enforcing security
-h, --help
Show this help message
interfaces
Lists interfaces in the system
The interfaces command lists interfaces available in the system.
By default all slots and plugs, used and offered by all snaps, are
displayed.
$ snap interfaces <snap>:<slot or plug>
Lists only the specified slot or plug.
$ snap interfaces <snap>
Lists the slots offered and plugs used by the specified snap.
$ snap interfaces -i=<interface> [<snap>]
Filters the complete output so only plugs and/or slots matching
the provided details are listed.
Usage: snap [OPTIONS] interfaces [interfaces-OPTIONS]
-i constrain listing to specific interfaces
-h, --help
Show this help message
known
Shows known assertions of the provided type
The known command shows known assertions of the provided type. If
header=value pairs are provided after the assertion type, the
assertions shown must also have the specified headers matching the
provided values.
-h, --help
Show this help message
list
List installed snaps
The list command displays a summary of snaps installed in the cur‐
rent system.
-h, --help
Show this help message
login
Authenticates on snapd and the store
The login command authenticates on snapd and the snap store and
saves credentials into the ~/.snap/auth.json file. Further commu‐
nication with snapd will then be made using those credentials.
Login only works for local users in the sudo, admin or wheel
groups.
An account can be setup at https://login.ubuntu.com
-h, --help
Show this help message
logout
Log out of the store
This command logs the current user out of the store
-h, --help
Show this help message
refresh
Refreshes a snap in the system
The refresh command refreshes (updates) the named snap.
Usage: snap [OPTIONS] refresh [refresh-OPTIONS]
--channel
Use this channel instead of stable
--edge Install from the edge channel
--beta Install from the beta channel
--candidate
Install from the candidate channel
--stable
Install from the stable channel
--devmode
Request non-enforcing security
--jailmode
Override a snap's request for non-enforcing security
--list show available snaps for refresh
-h, --help
Show this help message
remove
Removes a snap from the system
The remove command removes the named snap from the system.
The snap's data is currently not removed; use purge for that. This
behaviour will change before 16.04 is final.
-h, --help
Show this help message
run
Run the given snap command
Run the given snap command with the right confinement and environ‐
ment
Usage: snap [OPTIONS] run [run-OPTIONS]
--shell
run a shell instead of the command (useful for debugging)
-h, --help
Show this help message
try
Tests a snap in the system
The try command installs an unpacked snap into the system for
testing purposes. The unpacked snap content continues to be used
even after installation, so non-metadata changes there go live
instantly. Metadata changes such as those performed in snap.yaml
will require reinstallation to go live.
Usage: snap [OPTIONS] try [try-OPTIONS]
--devmode
Request non-enforcing security
--jailmode
Override a snap's request for non-enforcing security
-h, --help
Show this help message
1 August 2016 snap(1)
|