1GIO(1) User Commands GIO(1)
2
6 gio - GIO commandline tool
7
9 gio help [COMMAND]
10 gio version
12 gio cat LOCATION...
14 gio copy [OPTION...] SOURCE... DESTINATION
16 gio info [OPTION...] LOCATION...
18 gio list [OPTION...] [LOCATION...]
20 gio mime MIMETYPE [HANDLER]
22 gio mkdir [OPTION...] LOCATION...
24 gio monitor [OPTION...] [LOCATION...]
26 gio mount [OPTION...] [LOCATION...]
28 gio move [OPTION...] SOURCE... DESTINATION
30 gio open LOCATION...
32 gio rename LOCATION NAME
34 gio remove [OPTION...] LOCATION...
36 gio save [OPTION...] DESTINATION
38 gio set [OPTION...] LOCATION ATTRIBUTE VALUE...
40 gio trash [OPTION...] [LOCATION...]
42 gio tree [OPTION...] [LOCATION...]
44
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
53 help [COMMAND]
54 Displays a short synopsis of the available commands or provides
55 detailed help on a specific command.
56 version
58 Prints the GLib version to which gio belongs.
59 cat LOCATION...
61 Concatenates the given files and prints them to the standard
62 output.
63 The cat command works just like the traditional cat utility.
65 Note: just pipe through cat if you need its formatting options like
67 -n, -T or other.
68 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 The copy command is similar to the traditional cp utility.
74 Options
76 -T, --no-target-directory
77 Don't copy into DESTINATION even if it is a directory.
78 -p, --progress
80 Show progress.
81 -i, --interactive
83 Prompt for confirmation before overwriting files.
84 --preserve
86 Preserve all attributes of copied files.
87 -b, --backup
89 Create backups of existing destination files.
90 -P, --no-dereference
92 Never follow symbolic links.
93 info [OPTION...] LOCATION...
95 Shows information about the given locations.
96 The info command is similar to the traditional ls utility.
98 Options
100 -w, --query-writable
101 List writable attributes.
102 -f, --filesystem
104 Show information about the filesystem that the given
105 locations reside on.
106 -a --attributes=ATTRIBUTES
108 The attributes to get.
109 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 By default, all attributes are listed.
116 -n, --nofollow-symlinks
118 Don't follow symbolic links.
119 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 The list command is similar to the traditional ls utility.
125 Options
127 -a --attributes=ATTRIBUTES
128 The attributes to get.
129 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 By default, all attributes are listed.
136 -h, --hidden
138 Show hidden files.
139 -l, --long
141 Use a long listing format.
142 -n, --nofollow-symlinks
144 Don't follow symbolic links.
145 -u, --print-uris
147 Print full URIs.
148 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 Handlers must be specified by their desktop file name, including
155 the extension. Example: org.gnome.gedit.desktop.
156 mkdir [OPTION...] LOCATION...
158 Creates directories.
159 The mkdir command is similar to the traditional mkdir utility.
161 Options
163 -p, --parent
164 Create parent directories when necessary.
165 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 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 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 -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 -D, --direct=LOCATION
187 Monitor the file directly. This allows changes made via
188 hardlinks to be captured.
189 -s, --silent=LOCATION
191 Monitor the file directly, but don't report changes.
192 -n, --no-moves
194 Report moves and renames as simple deleted/created events.
195 -m, --mounts
197 Watch for mount events.
198 mount [OPTION...] [LOCATION...]
200 Provides commandline access to various aspects of GIOs mounting
201 functionality.
202 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 GIO mounts can require authentication, and the mount command may
211 ask for user IDs, passwords, and so on, when required.
212 Options
214 -m, --mountable
215 Mount as mountable.
216 -d, --device=DEVICE
218 Mount volume with device file.
219 -u, --unmount
221 Unmount the location.
222 -e, --eject
224 Eject the location.
225 -s, --unmount-scheme=SCHEME
227 Unmount all mounts with the given scheme.
228 -f, --force
230 Ignore outstanding file operations when unmounting or
231 ejecting.
232 -a, --anonymous
234 Use an anonymous user when authenticating.
235 -l, --list
237 List all GIO mounts.
238 -o, --monitor
240 Monitor mount-related events.
241 -i, --detail
243 Show extra information.
244 --tcrypt-pim
246 The numeric PIM when unlocking a VeraCrypt volume.
247 --tcrypt-hidden
249 Mount a TCRYPT hidden volume.
250 --tcrypt-system
252 Mount a TCRYPT system volume.
253 move [OPTION...] SOURCE... DESTINATION
255 Moves one or more files from SOURCE to DESTINATION. If more than
256 one source is specified, the destination must be a directory.
257 The move command is similar to the traditional mv utility.
259 open LOCATION...
261 Opens files with the default application that is registered to
262 handle files of this type.
263 GIO obtains this information from the shared-mime-info database,
265 with per-user overrides stored in
266 $XDG_DATA_HOME/applications/mimeapps.list.
267 The mime command can be used to change the default handler for a
269 mimetype.
270 rename LOCATION NAME
272 Renames a file.
273 The rename command is similar to the traditional rename utility.
275 remove [OPTION...] LOCATION...
277 Deletes each given file.
278 This command removes files irreversibly. If you want a reversible
280 way to remove files, see the trash command.
281 Note that not all URI schemes that are supported by GIO may allow
283 deletion of files.
284 The remove command is similar to the traditional rm utility.
286 Options
288 -f, --force
289 Ignore non-existent and non-deletable files.
290 save [OPTION...] DESTINATION
292 Reads from standard input and saves the data to the given location.
293 This is similar to just redirecting output to a file using
295 traditional shell syntax, but the save command allows saving to
296 location that GIO can write to.
297 Options
299 -b, --backup
300 Backup existing destination files.
301 -c, --create
303 Only create the destination if it doesn't exist yet.
304 -a, --append
306 Append to the end of the file.
307 -p, --private
309 When creating, restrict access to the current user.
310 -u, --unlink
312 When replacing, replace as if the destination did not
313 exist.
314 -v, --print-etag
316 Print the new etag in the end.
317 -e, --etag=ETAG
319 The etag of the file that is overwritten.
320 set LOCATION ATTRIBUTE VALUE...
322 Sets a file attribute on a file.
323 File attributes can be specified with their GIO name, e.g
325 standard::icon. Note that not all GIO file attributes are writable.
326 Use the --query-writable option of the info command to list
327 writable file attributes.
328 If the TYPE is unset, VALUE does not have to be specified. If the
330 type is stringv, multiple values can be given.
331 Options
333 -t, --type=TYPE
334 Specifies the type of the attribute. Supported types are
335 string, stringv, bytestring, boolean, uint32, int32,
336 uint64, int64 and unset.
337 If the type is not specified, string is assumed.
339 -n, --nofollow-symlinks
341 Don't follow symbolic links.
342 trash [OPTION...] [LOCATION...]
344 Sends files or directories to the "Trashcan". This can be a
345 different folder depending on where the file is located, and not
346 all file systems support this concept. In the common case that the
347 file lives inside a users home directory, the trash folder is
348 $XDG_DATA_HOME/Trash.
349 Note that moving files to the trash does not free up space on the
351 file system until the "Trashcan" is emptied. If you are interested
352 in deleting a file irreversibly, see the remove command.
353 Inspecting and emptying the "Trashcan" is normally supported by
355 graphical file managers such as nautilus, but you can also see the
356 trash with the command: gio list trash://.
357 Options
359 -f, --force
360 Ignore non-existent and non-deletable files.
361 --empty
363 Empty the trash.
364 tree [OPTION...] [LOCATION...]
366 Lists the contents of the given locations recursively, in a
367 tree-like format. If no location is given, it defaults to the
368 current directory.
369 The tree command is similar to the traditional tree utility.
371 Options
373 -h, --hidden
374 Show hidden files.
375 -l, --follow-symlinks
377 Follow symbolic links.
378
380 On success 0 is returned, a non-zero failure code otherwise.
381
383 cat(1), cp(1), ls(1), mkdir(1), mv(1), rm(1), tree(1).
384GIO GIO(1)