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 to capture changes
188 made via hardlinks.
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 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 The move command is similar to the traditional mv utility.
250 open LOCATION...
252 Opens files with the default application that is registered to
253 handle files of this type.
254 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 The mime command can be used to change the default handler for a
260 mimetype.
261 rename LOCATION NAME
263 Renames a file.
264 The rename command is similar to the traditional rename utility.
266 remove [OPTION...] LOCATION...
268 Deletes each given file.
269 This command removes files irreversibly. If you want a reversible
271 way to remove files, see the trash command.
272 Note that not all URI schemes that are supported by GIO may allow
274 deletion of files.
275 The remove command is similar to the traditional rm utility.
277 Options
279 -f, --force
280 Ignore non-existent and non-deletable files.
281 save [OPTION...] DESTINATION
283 Reads from standard input and saves the data to the given location.
284 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 Options
290 -b, --backup
291 Backup existing destination files.
292 -c, --create
294 Only create the destination if it doesn't exist yet.
295 -a, --append
297 Append to the end of the file.
298 -p, --private
300 When creating, restrict access to the current user.
301 -u, --unlink
303 When replacing, replace as if the destination did not
304 exist.
305 -v, --print-etag
307 Print the new etag in the end.
308 -e, --etag=ETAG
310 The etag of the file that is overwritten.
311 set LOCATION ATTRIBUTE VALUE...
313 Allows to set a file attribute on a file.
314 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 If the TYPE is unset, VALUE does not have to be specified. If the
321 type is stringv, multiple values can be given.
322 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 If the type is not specified, string is assumed.
330 -n, --nofollow-symlinks
332 Don't follow symbolic links.
333 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 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 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 Options
350 -f, --force
351 Ignore non-existent and non-deletable files.
352 --empty
354 Empty the trash.
355 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 The tree command is similar to the traditional tree utility.
362 Options
364 -h, --hidden
365 Show hidden files.
366 -l, --follow-symlinks
368 Follow symbolic links.
369
371 On success 0 is returned, a non-zero failure code otherwise.
372
374 cat(1), cp(1), ls(1), mkdir(1), mv(1), rm(1), tree(1).
375GIO GIO(1)