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 controlle 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 rename LOCATION NAME
276 Renames a file.
277 The rename command is similar to the traditional rename utility.
279 remove [OPTION...] LOCATION...
281 Deletes each given file.
282 This command removes files irreversibly. If you want a reversible
284 way to remove files, see the trash command.
285 Note that not all URI schemes that are supported by GIO may allow
287 deletion of files.
288 The remove command is similar to the traditional rm utility.
290 Options
292 -f, --force
293 Ignore non-existent and non-deletable files.
294 save [OPTION...] DESTINATION
296 Reads from standard input and saves the data to the given location.
297 This is similar to just redirecting output to a file using
299 traditional shell syntax, but the save command allows saving to
300 location that GIO can write to.
301 Options
303 -b, --backup
304 Back up existing destination files.
305 -c, --create
307 Only create the destination if it doesn’t exist yet.
308 -a, --append
310 Append to the end of the file.
311 -p, --private
313 When creating, restrict access to the current user.
314 -u, --unlink
316 When replacing, replace as if the destination did not
317 exist.
318 -v, --print-etag
320 Print the new ETag in the end.
321 -e, --etag=ETAG
323 The ETag of the file that is overwritten.
324 set LOCATION ATTRIBUTE VALUE...
326 Sets a file attribute on a file.
327 File attributes can be specified with their GIO name, e.g
329 standard::icon. Note that not all GIO file attributes are writable.
330 Use the --query-writable option of the info command to list
331 writable file attributes.
332 If the TYPE is unset, VALUE does not have to be specified. If the
334 TYPE is stringv, multiple values can be given.
335 Options
337 -t, --type=TYPE
338 Specifies the type of the attribute. Supported types are
339 string, stringv, bytestring, boolean, uint32, int32,
340 uint64, int64 and unset.
341 If the type is not specified, string is assumed.
343 -n, --nofollow-symlinks
345 Don’t follow symbolic links.
346 trash [OPTION...] [LOCATION...]
348 Sends files or directories to the ‘Trashcan’. This can be a
349 different folder depending on where the file is located, and not
350 all file systems support this concept. In the common case that the
351 file lives inside a user’s home directory, the trash folder is
352 $XDG_DATA_HOME/Trash.
353 Note that moving files to the trash does not free up space on the
355 file system until the ‘Trashcan’ is emptied. If you are interested
356 in deleting a file irreversibly, see the remove command.
357 Inspecting and emptying the ‘Trashcan’ is normally supported by
359 graphical file managers such as Nautilus, but you can also see the
360 trash with the command: gio list trash://.
361 Options
363 -f, --force
364 Ignore non-existent and non-deletable files.
365 --empty
367 Empty the trash.
368 tree [OPTION...] [LOCATION...]
370 Lists the contents of the given locations recursively, in a
371 tree-like format. If no location is given, it defaults to the
372 current directory.
373 The tree command is similar to the traditional tree utility.
375 Options
377 -h, --hidden
378 Show hidden files.
379 -l, --follow-symlinks
381 Follow symbolic links.
382
384 On success 0 is returned, a non-zero failure code otherwise.
385
387 cat(1), cp(1), ls(1), mkdir(1), mv(1), rm(1), tree(1).
388GIO GIO(1)