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 a location.
51 Plain filenames which contain a colon will be interpreted as URIs with
53 an unknown protocol. To avoid this, prefix them with a path such as ./,
54 or with the file: protocol.
55
57 help [COMMAND]
58 Displays a short synopsis of the available commands or provides
59 detailed help on a specific command.
60 version
62 Prints the GLib version to which gio belongs.
63 cat LOCATION...
65 Concatenates the given files and prints them to the standard
66 output.
67 The cat command works just like the traditional cat utility.
69 Note: just pipe through cat if you need its formatting options like
71 -n, -T or other.
72 copy [OPTION...] SOURCE... DESTINATION
74 Copies one or more files from SOURCE to DESTINATION. If more than
75 one source is specified, the destination must be a directory.
76 The copy command is similar to the traditional cp utility.
78 Options
80 -T, --no-target-directory
81 Don’t copy into DESTINATION even if it is a directory.
82 -p, --progress
84 Show progress.
85 -i, --interactive
87 Prompt for confirmation before overwriting files.
88 --preserve
90 Preserve all attributes of copied files.
91 -b, --backup
93 Create backups of existing destination files.
94 -P, --no-dereference
96 Never follow symbolic links.
97 info [OPTION...] LOCATION...
99 Shows information about the given locations.
100 The info command is similar to the traditional ls utility.
102 Options
104 -w, --query-writable
105 List writable attributes.
106 -f, --filesystem
108 Show information about the filesystem that the given
109 locations reside on.
110 -a --attributes=ATTRIBUTES
112 The attributes to get.
113 Attributes can be specified with their GIO name, e.g.
115 standard::icon, or just by namespace, e.g. unix, or by *,
116 which matches all attributes. Several attributes or groups
117 of attributes can be specified, separated by comma.
118 By default, all attributes are listed.
120 -n, --nofollow-symlinks
122 Don’t follow symbolic links.
123 list [OPTION...] [LOCATION...]
125 Lists the contents of the given locations. If no location is given,
126 the contents of the current directory are shown.
127 The list command is similar to the traditional ls utility.
129 Options
131 -a --attributes=ATTRIBUTES
132 The attributes to get.
133 Attributes can be specified with their GIO name, e.g.
135 standard::icon, or just by namespace, e.g. unix, or by *,
136 which matches all attributes. Several attributes or groups
137 of attributes can be specified, separated by comma.
138 By default, all attributes are listed.
140 -h, --hidden
142 Show hidden files.
143 -l, --long
145 Use a long listing format.
146 -n, --nofollow-symlinks
148 Don’t follow symbolic links.
149 -u, --print-uris
151 Print full URIs.
152 mime MIMETYPE [HANDLER]
154 If no handler is given, the mime command lists the registered and
155 recommended applications for the mimetype. If a handler is given,
156 it is set as the default handler for the mimetype.
157 Handlers must be specified by their desktop file name, including
159 the extension. Example: org.gnome.gedit.desktop.
160 mkdir [OPTION...] LOCATION...
162 Creates directories.
163 The mkdir command is similar to the traditional mkdir utility.
165 Options
167 -p, --parent
168 Create parent directories when necessary.
169 monitor [OPTION...] [LOCATION...]
171 Monitors files or directories for changes, such as creation
172 deletion, content and attribute changes, and mount and unmount
173 operations affecting the monitored locations.
174 The monitor command uses the GIO file monitoring APIs to do its
176 job. GIO has different implementations for different platforms. The
177 most common implementation on Linux uses inotify.
178 Options
180 -d, --dir=LOCATION
181 Monitor the given location as a directory. Normally, the
182 file type is used to determine whether to monitor a file or
183 directory.
184 -f, --file=LOCATION
186 Monitor the given location as a file. Normally, the file
187 type is used to determine whether to monitor a file or
188 directory.
189 -D, --direct=LOCATION
191 Monitor the file directly. This allows changes made via
192 hardlinks to be captured.
193 -s, --silent=LOCATION
195 Monitor the file directly, but don’t report changes.
196 -n, --no-moves
198 Report moves and renames as simple deleted/created events.
199 -m, --mounts
201 Watch for mount events.
202 mount [OPTION...] [LOCATION...]
204 Provides commandline access to various aspects of GIO’s mounting
205 functionality.
206 Mounting refers to the traditional concept of arranging multiple
208 file systems and devices in a single tree, rooted at /. Classical
209 mounting happens in the kernel and is controlled by the mount
210 utility. GIO expands this concept by introducing mount daemons that
211 can make file systems available to GIO applications without kernel
212 involvement.
213 GIO mounts can require authentication, and the mount command may
215 ask for user IDs, passwords, and so on, when required.
216 Options
218 -m, --mountable
219 Mount as mountable.
220 -d, --device=DEVICE
222 Mount volume with device file.
223 -u, --unmount
225 Unmount the location.
226 -e, --eject
228 Eject the location.
229 -s, --unmount-scheme=SCHEME
231 Unmount all mounts with the given scheme.
232 -f, --force
234 Ignore outstanding file operations when unmounting or
235 ejecting.
236 -a, --anonymous
238 Use an anonymous user when authenticating.
239 -l, --list
241 List all GIO mounts.
242 -o, --monitor
244 Monitor mount-related events.
245 -i, --detail
247 Show extra information.
248 --tcrypt-pim
250 The numeric PIM when unlocking a VeraCrypt volume.
251 --tcrypt-hidden
253 Mount a TCRYPT hidden volume.
254 --tcrypt-system
256 Mount a TCRYPT system volume.
257 move [OPTION...] SOURCE... DESTINATION
259 Moves one or more files from SOURCE to DESTINATION. If more than
260 one source is specified, the destination must be a directory.
261 The move command is similar to the traditional mv utility.
263 open LOCATION...
265 Opens files with the default application that is registered to
266 handle files of this type.
267 GIO obtains this information from the shared-mime-info database,
269 with per-user overrides stored in
270 $XDG_DATA_HOME/applications/mimeapps.list.
271 The mime command can be used to change the default handler for a
273 mimetype.
274 Environment variables will not be set on the application, as it may
276 be an existing process which is activated to handle the new file.
277 rename LOCATION NAME
279 Renames a file.
280 The rename command is similar to the traditional rename utility.
282 remove [OPTION...] LOCATION...
284 Deletes each given file.
285 This command removes files irreversibly. If you want a reversible
287 way to remove files, see the trash command.
288 Note that not all URI schemes that are supported by GIO may allow
290 deletion of files.
291 The remove command is similar to the traditional rm utility.
293 Options
295 -f, --force
296 Ignore non-existent and non-deletable files.
297 save [OPTION...] DESTINATION
299 Reads from standard input and saves the data to the given location.
300 This is similar to just redirecting output to a file using
302 traditional shell syntax, but the save command allows saving to
303 location that GIO can write to.
304 Options
306 -b, --backup
307 Back up existing destination files.
308 -c, --create
310 Only create the destination if it doesn’t exist yet.
311 -a, --append
313 Append to the end of the file.
314 -p, --private
316 When creating, restrict access to the current user.
317 -u, --unlink
319 When replacing, replace as if the destination did not
320 exist.
321 -v, --print-etag
323 Print the new ETag in the end.
324 -e, --etag=ETAG
326 The ETag of the file that is overwritten.
327 set LOCATION ATTRIBUTE VALUE...
329 Sets a file attribute on a file.
330 File attributes can be specified with their GIO name, e.g
332 standard::icon. Note that not all GIO file attributes are writable.
333 Use the --query-writable option of the info command to list
334 writable file attributes.
335 If the TYPE is unset, VALUE does not have to be specified. If the
337 TYPE is stringv, multiple values can be given.
338 Options
340 -t, --type=TYPE
341 Specifies the type of the attribute. Supported types are
342 string, stringv, bytestring, boolean, uint32, int32,
343 uint64, int64 and unset.
344 If the type is not specified, string is assumed.
346 -n, --nofollow-symlinks
348 Don’t follow symbolic links.
349 trash [OPTION...] [LOCATION...]
351 Sends files or directories to the ‘Trashcan’. This can be a
352 different folder depending on where the file is located, and not
353 all file systems support this concept. In the common case that the
354 file lives inside a user’s home directory, the trash folder is
355 $XDG_DATA_HOME/Trash.
356 Note that moving files to the trash does not free up space on the
358 file system until the ‘Trashcan’ is emptied. If you are interested
359 in deleting a file irreversibly, see the remove command.
360 Inspecting and emptying the ‘Trashcan’ is normally supported by
362 graphical file managers such as Nautilus, but you can also see the
363 trash with the command: gio list trash://.
364 Options
366 -f, --force
367 Ignore non-existent and non-deletable files.
368 --empty
370 Empty the trash.
371 tree [OPTION...] [LOCATION...]
373 Lists the contents of the given locations recursively, in a
374 tree-like format. If no location is given, it defaults to the
375 current directory.
376 The tree command is similar to the traditional tree utility.
378 Options
380 -h, --hidden
381 Show hidden files.
382 -l, --follow-symlinks
384 Follow symbolic links.
385
387 On success 0 is returned, a non-zero failure code otherwise.
388
390 cat(1), cp(1), ls(1), mkdir(1), mv(1), rm(1), tree(1).
391GIO GIO(1)