1GIO(1)                           User Commands                          GIO(1)
2
3
4

NAME

6       gio - GIO commandline tool
7

SYNOPSIS

9       gio help [COMMAND]
10
11       gio version
12
13       gio cat LOCATION...
14
15       gio copy [OPTION...] SOURCE... DESTINATION
16
17       gio info [OPTION...] LOCATION...
18
19       gio list [OPTION...] [LOCATION...]
20
21       gio mime MIMETYPE [HANDLER]
22
23       gio mkdir [OPTION...] LOCATION...
24
25       gio monitor [OPTION...] [LOCATION...]
26
27       gio mount [OPTION...] [LOCATION...]
28
29       gio move [OPTION...] SOURCE... DESTINATION
30
31       gio open LOCATION...
32
33       gio rename LOCATION NAME
34
35       gio remove [OPTION...] LOCATION...
36
37       gio save [OPTION...] DESTINATION
38
39       gio set [OPTION...] LOCATION ATTRIBUTE VALUE...
40
41       gio trash [OPTION...] [LOCATION...]
42
43       gio tree [OPTION...] [LOCATION...]
44

DESCRIPTION

46       gio is a utility that makes many of the GIO features available from the
47       commandline. In doing so, it provides commands that are similar to
48       traditional utilities, but let you use GIO locations instead of local
49       files: for example you can use something like
50       smb://server/resource/file.txt as location.
51

COMMANDS

53       help [COMMAND]
54           Displays a short synopsis of the available commands or provides
55           detailed help on a specific command.
56
57       version
58           Prints the GLib version to which gio belongs.
59
60       cat LOCATION...
61           Concatenates the given files and prints them to the standard
62           output.
63
64           The cat command works just like the traditional cat utility.
65
66           Note: just pipe through cat if you need its formatting options like
67           -n, -T or other.
68
69       copy [OPTION...] SOURCE... DESTINATION
70           Copies one or more files from SOURCE to DESTINATION. If more than
71           one source is specified, the destination must be a directory.
72
73           The copy command is similar to the traditional cp utility.
74
75           Options
76               -T, --no-target-directory
77                   Don't copy into DESTINATION even if it is a directory.
78
79               -p, --progress
80                   Show progress.
81
82               -i, --interactive
83                   Prompt for confirmation before overwriting files.
84
85               --preserve
86                   Preserve all attributes of copied files.
87
88               -b, --backup
89                   Create backups of existing destination files.
90
91               -P, --no-dereference
92                   Never follow symbolic links.
93
94       info [OPTION...] LOCATION...
95           Shows information about the given locations.
96
97           The info command is similar to the traditional ls utility.
98
99           Options
100               -w, --query-writable
101                   List writable attributes.
102
103               -f, --filesystem
104                   Show information about the filesystem that the given
105                   locations reside on.
106
107               -a --attributes=ATTRIBUTES
108                   The attributes to get.
109
110                   Attributes can be specified with their GIO name, e.g.
111                   standard::icon, or just by namespace, e.g. unix, or by '*',
112                   which matches all attributes. Several attributes or groups
113                   of attributes can be specified, separated by comma.
114
115                   By default, all attributes are listed.
116
117               -n, --nofollow-symlinks
118                   Don't follow symbolic links.
119
120       list [OPTION...] [LOCATION...]
121           Lists the contents of the given locations. If no location is given,
122           the contents of the current directory are shown.
123
124           The list command is similar to the traditional ls utility.
125
126           Options
127               -a --attributes=ATTRIBUTES
128                   The attributes to get.
129
130                   Attributes can be specified with their GIO name, e.g.
131                   standard::icon, or just by namespace, e.g. unix, or by '*',
132                   which matches all attributes. Several attributes or groups
133                   of attributes can be specified, separated by comma.
134
135                   By default, all attributes are listed.
136
137               -h, --hidden
138                   Show hidden files.
139
140               -l, --long
141                   Use a long listing format.
142
143               -n, --nofollow-symlinks
144                   Don't follow symbolic links.
145
146               -u, --print-uris
147                   Print full URIs.
148
149       mime MIMETYPE [HANDLER]
150           If no handler is given, the mime command lists the registered and
151           recommended applications for the mimetype. If a handler is given,
152           it is set as the default handler for the mimetype.
153
154           Handlers must be specified by their desktop file name, including
155           the extension. Example: org.gnome.gedit.desktop.
156
157       mkdir [OPTION...] LOCATION...
158           Creates directories.
159
160           The mkdir command is similar to the traditional mkdir utility.
161
162           Options
163               -p, --parent
164                   Create parent directories when necessary.
165
166       monitor [OPTION...] [LOCATION...]
167           Monitors files or directories for changes, such as creation
168           deletion, content and attribute changes, and mount and unmount
169           operations affecting the monitored locations.
170
171           The monitor command uses the GIO file monitoring APIs to do its
172           job. GIO has different implementations for different platforms. The
173           most common implementation on Linux uses inotify.
174
175           Options
176               -d, --dir=LOCATION
177                   Monitor the given location as a directory. Normally, the
178                   file type is used to determine whether to monitor a file or
179                   directory.
180
181               -f, --file=LOCATION
182                   Monitor the given location as a file. Normally, the file
183                   type is used to determine whether to monitor a file or
184                   directory.
185
186               -D, --direct=LOCATION
187                   Monitor the file directly. This allows to capture changes
188                   made via hardlinks.
189
190               -s, --silent=LOCATION
191                   Monitor the file directly, but don't report changes.
192
193               -n, --no-moves
194                   Report moves and renames as simple deleted/created events.
195
196               -m, --mounts
197                   Watch for mount events.
198
199       mount [OPTION...] [LOCATION...]
200           Provides commandline access to various aspects of GIOs mounting
201           functionality.
202
203           Mounting refers to the traditional concept of arranging multiple
204           file systems and devices in a single tree, rooted at /. Classical
205           mounting happens in the kernel and is controlle by the mount
206           utility. GIO expands this concept by introducing mount daemons that
207           can make file systems available to GIO applications without kernel
208           involvement.
209
210           GIO mounts can require authentication, and the mount command may
211           ask for user IDs, passwords, and so on, when required.
212
213           Options
214               -m, --mountable
215                   Mount as mountable.
216
217               -d, --device=DEVICE
218                   Mount volume with device file.
219
220               -u, --unmount
221                   Unmount the location.
222
223               -e, --eject
224                   Eject the location.
225
226               -s, --unmount-scheme=SCHEME
227                   Unmount all mounts with the given scheme.
228
229               -f, --force
230                   Ignore outstanding file operations when unmounting or
231                   ejecting.
232
233               -a, --anonymous
234                   Use an anonymous user when authenticating.
235
236               -l, --list
237                   List all GIO mounts.
238
239               -o, --monitor
240                   Monitor mount-related events.
241
242               -i, --detail
243                   Show extra information.
244
245       move [OPTION...] SOURCE... DESTINATION
246           Moves one or more files from SOURCE to DESTINATION. If more than
247           one source is specified, the destination must be a directory.
248
249           The move command is similar to the traditional mv utility.
250
251       open LOCATION...
252           Opens files with the default application that is registered to
253           handle files of this type.
254
255           GIO obtains this information from the shared-mime-info database,
256           with per-user overrides stored in
257           $XDG_DATA_HOME/applications/mimeapps.list.
258
259           The mime command can be used to change the default handler for a
260           mimetype.
261
262       rename LOCATION NAME
263           Renames a file.
264
265           The rename command is similar to the traditional rename utility.
266
267       remove [OPTION...] LOCATION...
268           Deletes each given file.
269
270           This command removes files irreversibly. If you want a reversible
271           way to remove files, see the trash command.
272
273           Note that not all URI schemes that are supported by GIO may allow
274           deletion of files.
275
276           The remove command is similar to the traditional rm utility.
277
278           Options
279               -f, --force
280                   Ignore non-existent and non-deletable files.
281
282       save [OPTION...] DESTINATION
283           Reads from standard input and saves the data to the given location.
284
285           This is similar to just redirecting output to a file using
286           traditional shell syntax, but the save command allows saving to
287           location that GIO can write to.
288
289           Options
290               -b, --backup
291                   Backup existing destination files.
292
293               -c, --create
294                   Only create the destination if it doesn't exist yet.
295
296               -a, --append
297                   Append to the end of the file.
298
299               -p, --private
300                   When creating, restrict access to the current user.
301
302               -u, --unlink
303                   When replacing, replace as if the destination did not
304                   exist.
305
306               -v, --print-etag
307                   Print the new etag in the end.
308
309               -e, --etag=ETAG
310                   The etag of the file that is overwritten.
311
312       set LOCATION ATTRIBUTE VALUE...
313           Allows to set a file attribute on a file.
314
315           File attributes can be specified with their GIO name, e.g
316           standard::icon. Note that not all GIO file attributes are writable.
317           Use the --query-writable option of the info command to list
318           writable file attributes.
319
320           If the TYPE is unset, VALUE does not have to be specified. If the
321           type is stringv, multiple values can be given.
322
323           Options
324               -t, --type=TYPE
325                   Specifies the type of the attribute. Supported types are
326                   string, stringv, bytestring, boolean, uint32, int32,
327                   uint64, int64 and unset.
328
329                   If the type is not specified, string is assumed.
330
331               -n, --nofollow-symlinks
332                   Don't follow symbolic links.
333
334       trash [OPTION...] [LOCATION...]
335           Sends files or directories to the "Trashcan". This can be a
336           different folder depending on where the file is located, and not
337           all file systems support this concept. In the common case that the
338           file lives inside a users home directory, the trash folder is
339           $XDG_DATA_HOME/Trash.
340
341           Note that moving files to the trash does not free up space on the
342           file system until the "Trashcan" is emptied. If you are interested
343           in deleting a file irreversibly, see the remove command.
344
345           Inspecting and emptying the "Trashcan" is normally supported by
346           graphical file managers such as nautilus, but you can also see the
347           trash with the command: gio list trash://.
348
349           Options
350               -f, --force
351                   Ignore non-existent and non-deletable files.
352
353               --empty
354                   Empty the trash.
355
356       tree [OPTION...] [LOCATION...]
357           Lists the contents of the given locations recursively, in a
358           tree-like format. If no location is given, it defaults to the
359           current directory.
360
361           The tree command is similar to the traditional tree utility.
362
363           Options
364               -h, --hidden
365                   Show hidden files.
366
367               -l, --follow-symlinks
368                   Follow symbolic links.
369

EXIT STATUS

371       On success 0 is returned, a non-zero failure code otherwise.
372

SEE ALSO

374       cat(1), cp(1), ls(1), mkdir(1), mv(1), rm(1), tree(1).
375
376
377
378GIO                                                                     GIO(1)
Impressum