| <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> | |
| <html> | |
| <head> | |
| <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> | |
| <title>gio: GIO Reference Manual</title> | |
| <meta name="generator" content="DocBook XSL Stylesheets V1.79.1"> | |
| <link rel="home" href="index.html" title="GIO Reference Manual"> | |
| <link rel="up" href="tools.html" title="GIO Tools"> | |
| <link rel="prev" href="gapplication-tool.html" title="gapplication"> | |
| <link rel="next" href="testing.html" title="GIO Testing"> | |
| <meta name="generator" content="GTK-Doc V1.25.1 (XML mode)"> | |
| <link rel="stylesheet" href="style.css" type="text/css"> | |
| </head> | |
| <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> | |
| <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle"> | |
| <td width="100%" align="left" class="shortcuts"></td> | |
| <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td> | |
| <td><a accesskey="u" href="tools.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td> | |
| <td><a accesskey="p" href="gapplication-tool.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td> | |
| <td><a accesskey="n" href="testing.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td> | |
| </tr></table> | |
| <div class="refentry"> | |
| <a name="gio"></a><div class="titlepage"></div> | |
| <div class="refnamediv"><table width="100%"><tr> | |
| <td valign="top"> | |
| <h2><span class="refentrytitle">gio</span></h2> | |
| <p>gio — GIO commandline tool</p> | |
| </td> | |
| <td class="gallery_image" valign="top" align="right"></td> | |
| </tr></table></div> | |
| <div class="refsynopsisdiv"> | |
| <h2>Synopsis</h2> | |
| <div class="cmdsynopsis"><p><code class="command">gio</code> help [<em class="replaceable"><code>COMMAND</code></em>]</p></div> | |
| <div class="cmdsynopsis"><p><code class="command">gio</code> version </p></div> | |
| <div class="cmdsynopsis"><p><code class="command">gio</code> cat <em class="replaceable"><code>LOCATION</code></em>... </p></div> | |
| <div class="cmdsynopsis"><p><code class="command">gio</code> copy [<em class="replaceable"><code>OPTION</code></em>...] <em class="replaceable"><code>SOURCE</code></em>... <em class="replaceable"><code>DESTINATION</code></em> </p></div> | |
| <div class="cmdsynopsis"><p><code class="command">gio</code> info [<em class="replaceable"><code>OPTION</code></em>...] <em class="replaceable"><code>LOCATION</code></em>... </p></div> | |
| <div class="cmdsynopsis"><p><code class="command">gio</code> list [<em class="replaceable"><code>OPTION</code></em>...] [<em class="replaceable"><code>LOCATION</code></em>...]</p></div> | |
| <div class="cmdsynopsis"><p><code class="command">gio</code> mime <em class="replaceable"><code>MIMETYPE</code></em> [<em class="replaceable"><code>HANDLER</code></em>]</p></div> | |
| <div class="cmdsynopsis"><p><code class="command">gio</code> mkdir [<em class="replaceable"><code>OPTION</code></em>...] <em class="replaceable"><code>LOCATION</code></em>... </p></div> | |
| <div class="cmdsynopsis"><p><code class="command">gio</code> monitor [<em class="replaceable"><code>OPTION</code></em>...] [<em class="replaceable"><code>LOCATION</code></em>...]</p></div> | |
| <div class="cmdsynopsis"><p><code class="command">gio</code> mount [<em class="replaceable"><code>OPTION</code></em>...] [<em class="replaceable"><code>LOCATION</code></em>...]</p></div> | |
| <div class="cmdsynopsis"><p><code class="command">gio</code> move [<em class="replaceable"><code>OPTION</code></em>...] <em class="replaceable"><code>SOURCE</code></em>... <em class="replaceable"><code>DESTINATION</code></em> </p></div> | |
| <div class="cmdsynopsis"><p><code class="command">gio</code> open <em class="replaceable"><code>LOCATION</code></em>... </p></div> | |
| <div class="cmdsynopsis"><p><code class="command">gio</code> rename <em class="replaceable"><code>LOCATION</code></em> <em class="replaceable"><code>NAME</code></em> </p></div> | |
| <div class="cmdsynopsis"><p><code class="command">gio</code> remove [<em class="replaceable"><code>OPTION</code></em>...] <em class="replaceable"><code>LOCATION</code></em>... </p></div> | |
| <div class="cmdsynopsis"><p><code class="command">gio</code> save [<em class="replaceable"><code>OPTION</code></em>...] <em class="replaceable"><code>DESTINATION</code></em> </p></div> | |
| <div class="cmdsynopsis"><p><code class="command">gio</code> set [<em class="replaceable"><code>OPTION</code></em>...] <em class="replaceable"><code>LOCATION</code></em> <em class="replaceable"><code>ATTRIBUTE</code></em> <em class="replaceable"><code>VALUE</code></em>... </p></div> | |
| <div class="cmdsynopsis"><p><code class="command">gio</code> trash [<em class="replaceable"><code>OPTION</code></em>...] [<em class="replaceable"><code>LOCATION</code></em>...]</p></div> | |
| <div class="cmdsynopsis"><p><code class="command">gio</code> tree [<em class="replaceable"><code>OPTION</code></em>...] [<em class="replaceable"><code>LOCATION</code></em>...]</p></div> | |
| </div> | |
| <div class="refsect1"> | |
| <a name="id-1.4.26.10.5"></a><h2>Description</h2> | |
| <p><span class="command"><strong>gio</strong></span> is a utility that makes many of the GIO | |
| features available from the commandline. In doing so, it provides | |
| commands that are similar to traditional utilities, but let you | |
| use GIO locations instead of local files: for example you can use | |
| something like <code class="filename">smb://server/resource/file.txt</code> | |
| as location.</p> | |
| </div> | |
| <div class="refsect1"> | |
| <a name="id-1.4.26.10.6"></a><h2>Commands</h2> | |
| <div class="variablelist"><table border="0" class="variablelist"> | |
| <colgroup> | |
| <col align="left" valign="top"> | |
| <col> | |
| </colgroup> | |
| <tbody> | |
| <tr> | |
| <td><p><span class="term"> | |
| <span class="command"><strong>help</strong></span> | |
| [<em class="replaceable"><code>COMMAND</code></em>] | |
| </span></p></td> | |
| <td><p>Displays a short synopsis of the available commands or provides | |
| detailed help on a specific command.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"> | |
| <span class="command"><strong>version</strong></span> | |
| </span></p></td> | |
| <td><p>Prints the GLib version to which <span class="command"><strong>gio</strong></span> | |
| belongs.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"> | |
| <span class="command"><strong>cat</strong></span> | |
| <em class="replaceable"><code>LOCATION</code></em>... | |
| </span></p></td> | |
| <td> | |
| <p>Concatenates the given files and prints them to the standard | |
| output.</p> | |
| <p>The cat command works just like the traditional cat utility.</p> | |
| <p>Note: just pipe through cat if you need its formatting options | |
| like -n, -T or other.</p> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"> | |
| <span class="command"><strong>copy</strong></span> | |
| [<em class="replaceable"><code>OPTION</code></em>...] | |
| <em class="replaceable"><code>SOURCE</code></em>... | |
| <em class="replaceable"><code>DESTINATION</code></em> | |
| </span></p></td> | |
| <td> | |
| <p>Copies one or more files from <em class="replaceable"><code>SOURCE</code></em> | |
| to <em class="replaceable"><code>DESTINATION</code></em>. If more than one source | |
| is specified, the destination must be a directory.</p> | |
| <p>The copy command is similar to the traditional cp utility.</p> | |
| <div class="refsect3"> | |
| <a name="id-1.4.26.10.6.2.4.2.3"></a><h4>Options</h4> | |
| <div class="variablelist"><table border="0" class="variablelist"> | |
| <colgroup> | |
| <col align="left" valign="top"> | |
| <col> | |
| </colgroup> | |
| <tbody> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-T</code>, <code class="option">--no-target-directory</code></span></p></td> | |
| <td><p>Don't copy into <em class="replaceable"><code>DESTINATION</code></em> even if it is a directory.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-p</code>, <code class="option">--progress</code></span></p></td> | |
| <td><p>Show progress.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-i</code>, <code class="option">--interactive</code></span></p></td> | |
| <td><p>Prompt for confirmation before overwriting files.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">--preserve</code></span></p></td> | |
| <td><p>Preserve all attributes of copied files.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-b</code>, <code class="option">--backup</code></span></p></td> | |
| <td><p>Create backups of existing destination files.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-P</code>, <code class="option">--no-dereference</code></span></p></td> | |
| <td><p>Never follow symbolic links.</p></td> | |
| </tr> | |
| </tbody> | |
| </table></div> | |
| </div> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"> | |
| <span class="command"><strong>info</strong></span> | |
| [<em class="replaceable"><code>OPTION</code></em>...] | |
| <em class="replaceable"><code>LOCATION</code></em>... | |
| </span></p></td> | |
| <td> | |
| <p>Shows information about the given locations.</p> | |
| <p>The info command is similar to the traditional ls utility.</p> | |
| <div class="refsect3"> | |
| <a name="id-1.4.26.10.6.2.5.2.3"></a><h4>Options</h4> | |
| <div class="variablelist"><table border="0" class="variablelist"> | |
| <colgroup> | |
| <col align="left" valign="top"> | |
| <col> | |
| </colgroup> | |
| <tbody> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-w</code>, <code class="option">--query-writable</code></span></p></td> | |
| <td><p>List writable attributes.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-f</code>, <code class="option">--filesystem</code></span></p></td> | |
| <td><p>Show information about the filesystem that the given | |
| locations reside on.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-a</code> <code class="option">--attributes=<em class="replaceable"><code>ATTRIBUTES</code></em></code></span></p></td> | |
| <td> | |
| <p>The attributes to get.</p> | |
| <p>Attributes can be specified with their GIO name, e.g. | |
| standard::icon, or just by namespace, e.g. unix, or by '*', | |
| which matches all attributes. Several attributes or groups | |
| of attributes can be specified, separated by comma.</p> | |
| <p>By default, all attributes are listed.</p> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-n</code>, <code class="option">--nofollow-symlinks</code></span></p></td> | |
| <td><p>Don't follow symbolic links.</p></td> | |
| </tr> | |
| </tbody> | |
| </table></div> | |
| </div> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"> | |
| <span class="command"><strong>list</strong></span> | |
| [<em class="replaceable"><code>OPTION</code></em>...] | |
| [<em class="replaceable"><code>LOCATION</code></em>...] | |
| </span></p></td> | |
| <td> | |
| <p>Lists the contents of the given locations. If no location is | |
| given, the contents of the current directory are shown.</p> | |
| <p>The list command is similar to the traditional ls utility.</p> | |
| <div class="refsect3"> | |
| <a name="id-1.4.26.10.6.2.6.2.3"></a><h4>Options</h4> | |
| <div class="variablelist"><table border="0" class="variablelist"> | |
| <colgroup> | |
| <col align="left" valign="top"> | |
| <col> | |
| </colgroup> | |
| <tbody> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-a</code> <code class="option">--attributes=<em class="replaceable"><code>ATTRIBUTES</code></em></code></span></p></td> | |
| <td> | |
| <p>The attributes to get.</p> | |
| <p>Attributes can be specified with their GIO name, e.g. | |
| standard::icon, or just by namespace, e.g. unix, or by '*', | |
| which matches all attributes. Several attributes or groups | |
| of attributes can be specified, separated by comma.</p> | |
| <p>By default, all attributes are listed.</p> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-h</code>, <code class="option">--hidden</code></span></p></td> | |
| <td><p>Show hidden files.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-l</code>, <code class="option">--long</code></span></p></td> | |
| <td><p>Use a long listing format.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-n</code>, <code class="option">--nofollow-symlinks</code></span></p></td> | |
| <td><p>Don't follow symbolic links.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-u</code>, <code class="option">--print-uris</code></span></p></td> | |
| <td><p>Print full URIs.</p></td> | |
| </tr> | |
| </tbody> | |
| </table></div> | |
| </div> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"> | |
| <span class="command"><strong>mime</strong></span> | |
| <em class="replaceable"><code>MIMETYPE</code></em> | |
| [<em class="replaceable"><code>HANDLER</code></em>] | |
| </span></p></td> | |
| <td> | |
| <p>If no handler is given, the mime command lists the | |
| registered and recommended applications for the mimetype. | |
| If a handler is given, it is set as the default handler for | |
| the mimetype.</p> | |
| <p>Handlers must be specified by their desktop file name, | |
| including the extension. Example: org.gnome.gedit.desktop.</p> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"> | |
| <span class="command"><strong>mkdir</strong></span> | |
| [<em class="replaceable"><code>OPTION</code></em>...] | |
| <em class="replaceable"><code>LOCATION</code></em>... | |
| </span></p></td> | |
| <td> | |
| <p>Creates directories.</p> | |
| <p>The mkdir command is similar to the traditional mkdir utility.</p> | |
| <div class="refsect3"> | |
| <a name="id-1.4.26.10.6.2.8.2.3"></a><h4>Options</h4> | |
| <div class="variablelist"><table border="0" class="variablelist"> | |
| <colgroup> | |
| <col align="left" valign="top"> | |
| <col> | |
| </colgroup> | |
| <tbody><tr> | |
| <td><p><span class="term"><code class="option">-p</code>, <code class="option">--parent</code></span></p></td> | |
| <td><p>Create parent directories when necessary.</p></td> | |
| </tr></tbody> | |
| </table></div> | |
| </div> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"> | |
| <span class="command"><strong>monitor</strong></span> | |
| [<em class="replaceable"><code>OPTION</code></em>...] | |
| [<em class="replaceable"><code>LOCATION</code></em>...] | |
| </span></p></td> | |
| <td> | |
| <p>Monitors files or directories for changes, such as creation | |
| deletion, content and attribute changes, and mount and unmount | |
| operations affecting the monitored locations.</p> | |
| <p>The monitor command uses the GIO file monitoring APIs to do | |
| its job. GIO has different implementations for different platforms. | |
| The most common implementation on Linux uses inotify.</p> | |
| <div class="refsect3"> | |
| <a name="id-1.4.26.10.6.2.9.2.3"></a><h4>Options</h4> | |
| <div class="variablelist"><table border="0" class="variablelist"> | |
| <colgroup> | |
| <col align="left" valign="top"> | |
| <col> | |
| </colgroup> | |
| <tbody> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-d</code>, <code class="option">--dir=<em class="replaceable"><code>LOCATION</code></em></code></span></p></td> | |
| <td><p>Monitor the given location as a directory. Normally, | |
| the file type is used to determine whether to monitor a file or directory.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-f</code>, <code class="option">--file=<em class="replaceable"><code>LOCATION</code></em></code></span></p></td> | |
| <td><p>Monitor the given location as a file. Normally, | |
| the file type is used to determine whether to monitor a file or directory.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-D</code>, <code class="option">--direct=<em class="replaceable"><code>LOCATION</code></em></code></span></p></td> | |
| <td><p>Monitor the file directly. This allows to capture changes made via hardlinks.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-s</code>, <code class="option">--silent=<em class="replaceable"><code>LOCATION</code></em></code></span></p></td> | |
| <td><p>Monitor the file directly, but don't report changes.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-n</code>, <code class="option">--no-moves</code></span></p></td> | |
| <td><p>Report moves and renames as simple deleted/created events.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-m</code>, <code class="option">--mounts</code></span></p></td> | |
| <td><p>Watch for mount events.</p></td> | |
| </tr> | |
| </tbody> | |
| </table></div> | |
| </div> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"> | |
| <span class="command"><strong>mount</strong></span> | |
| [<em class="replaceable"><code>OPTION</code></em>...] | |
| [<em class="replaceable"><code>LOCATION</code></em>...] | |
| </span></p></td> | |
| <td> | |
| <p>Provides commandline access to various aspects of GIOs mounting | |
| functionality.</p> | |
| <p>Mounting refers to the traditional concept of arranging multiple | |
| file systems and devices in a single tree, rooted at /. Classical | |
| mounting happens in the kernel and is controlle by the mount utility. | |
| GIO expands this concept by introducing mount daemons that can make | |
| file systems available to GIO applications without kernel | |
| involvement.</p> | |
| <p>GIO mounts can require authentication, and the mount command | |
| may ask for user IDs, passwords, and so on, when required.</p> | |
| <div class="refsect3"> | |
| <a name="id-1.4.26.10.6.2.10.2.4"></a><h4>Options</h4> | |
| <div class="variablelist"><table border="0" class="variablelist"> | |
| <colgroup> | |
| <col align="left" valign="top"> | |
| <col> | |
| </colgroup> | |
| <tbody> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-m</code>, <code class="option">--mountable</code></span></p></td> | |
| <td><p>Mount as mountable.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-d</code>, <code class="option">--device=<em class="replaceable"><code>DEVICE</code></em></code></span></p></td> | |
| <td><p>Mount volume with device file.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-u</code>, <code class="option">--unmount</code></span></p></td> | |
| <td><p>Unmount the location.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-e</code>, <code class="option">--eject</code></span></p></td> | |
| <td><p>Eject the location.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-s</code>, <code class="option">--unmount-scheme=<em class="replaceable"><code>SCHEME</code></em></code></span></p></td> | |
| <td><p>Unmount all mounts with the given scheme.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-f</code>, <code class="option">--force</code></span></p></td> | |
| <td><p>Ignore outstanding file operations when unmounting or ejecting.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-a</code>, <code class="option">--anonymous</code></span></p></td> | |
| <td><p>Use an anonymous user when authenticating.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-l</code>, <code class="option">--list</code></span></p></td> | |
| <td><p>List all GIO mounts.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-o</code>, <code class="option">--monitor</code></span></p></td> | |
| <td><p>Monitor mount-related events.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-i</code>, <code class="option">--detail</code></span></p></td> | |
| <td><p>Show extra information.</p></td> | |
| </tr> | |
| </tbody> | |
| </table></div> | |
| </div> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"> | |
| <span class="command"><strong>move</strong></span> | |
| [<em class="replaceable"><code>OPTION</code></em>...] | |
| <em class="replaceable"><code>SOURCE</code></em>... | |
| <em class="replaceable"><code>DESTINATION</code></em> | |
| </span></p></td> | |
| <td> | |
| <p>Moves one or more files from <em class="replaceable"><code>SOURCE</code></em> | |
| to <em class="replaceable"><code>DESTINATION</code></em>. If more than one source | |
| is specified, the destination must be a directory.</p> | |
| <p>The move command is similar to the traditional mv utility.</p> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"> | |
| <span class="command"><strong>open</strong></span> | |
| <em class="replaceable"><code>LOCATION</code></em>... | |
| </span></p></td> | |
| <td> | |
| <p>Opens files with the default application that is registered | |
| to handle files of this type.</p> | |
| <p>GIO obtains this information from the shared-mime-info | |
| database, with per-user overrides stored in | |
| <code class="filename"><code class="envar">$XDG_DATA_HOME</code>/applications/mimeapps.list</code>.</p> | |
| <p>The mime command can be used to change the default handler for | |
| a mimetype.</p> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"> | |
| <span class="command"><strong>rename</strong></span> | |
| <em class="replaceable"><code>LOCATION</code></em> | |
| <em class="replaceable"><code>NAME</code></em> | |
| </span></p></td> | |
| <td> | |
| <p>Renames a file.</p> | |
| <p>The rename command is similar to the traditional rename utility.</p> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"> | |
| <span class="command"><strong>remove</strong></span> | |
| [<em class="replaceable"><code>OPTION</code></em>...] | |
| <em class="replaceable"><code>LOCATION</code></em>... | |
| </span></p></td> | |
| <td> | |
| <p>Deletes each given file.</p> | |
| <p>This command removes files irreversibly. If you want a reversible | |
| way to remove files, see the trash command.</p> | |
| <p>Note that not all URI schemes that are supported by GIO may | |
| allow deletion of files.</p> | |
| <p> The remove command is similar to the traditional rm utility.</p> | |
| <div class="refsect3"> | |
| <a name="id-1.4.26.10.6.2.14.2.5"></a><h4>Options</h4> | |
| <div class="variablelist"><table border="0" class="variablelist"> | |
| <colgroup> | |
| <col align="left" valign="top"> | |
| <col> | |
| </colgroup> | |
| <tbody><tr> | |
| <td><p><span class="term"><code class="option">-f</code>, <code class="option">--force</code></span></p></td> | |
| <td><p>Ignore non-existent and non-deletable files.</p></td> | |
| </tr></tbody> | |
| </table></div> | |
| </div> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"> | |
| <span class="command"><strong>save</strong></span> | |
| [<em class="replaceable"><code>OPTION</code></em>...] | |
| <em class="replaceable"><code>DESTINATION</code></em> | |
| </span></p></td> | |
| <td> | |
| <p>Reads from standard input and saves the data to the given | |
| location.</p> | |
| <p>This is similar to just redirecting output to a file using | |
| traditional shell syntax, but the save command allows saving to | |
| location that GIO can write to.</p> | |
| <div class="refsect3"> | |
| <a name="id-1.4.26.10.6.2.15.2.3"></a><h4>Options</h4> | |
| <div class="variablelist"><table border="0" class="variablelist"> | |
| <colgroup> | |
| <col align="left" valign="top"> | |
| <col> | |
| </colgroup> | |
| <tbody> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-b</code>, <code class="option">--backup</code></span></p></td> | |
| <td><p>Backup existing destination files.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-c</code>, <code class="option">--create</code></span></p></td> | |
| <td><p>Only create the destination if it doesn't exist yet.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-a</code>, <code class="option">--append</code></span></p></td> | |
| <td><p>Append to the end of the file.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-p</code>, <code class="option">--private</code></span></p></td> | |
| <td><p>When creating, restrict access to the current user.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-u</code>, <code class="option">--unlink</code></span></p></td> | |
| <td><p>When replacing, replace as if the destination did not exist.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-v</code>, <code class="option">--print-etag</code></span></p></td> | |
| <td><p>Print the new etag in the end.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-e</code>, <code class="option">--etag=<em class="replaceable"><code>ETAG</code></em></code></span></p></td> | |
| <td><p>The etag of the file that is overwritten.</p></td> | |
| </tr> | |
| </tbody> | |
| </table></div> | |
| </div> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"> | |
| <span class="command"><strong>set</strong></span> | |
| <em class="replaceable"><code>LOCATION</code></em> | |
| <em class="replaceable"><code>ATTRIBUTE</code></em> | |
| <em class="replaceable"><code>VALUE</code></em>... | |
| </span></p></td> | |
| <td> | |
| <p>Allows to set a file attribute on a file.</p> | |
| <p>File attributes can be specified with their GIO name, e.g | |
| standard::icon. Note that not all GIO file attributes are writable. | |
| Use the --query-writable option of the info command to list | |
| writable file attributes.</p> | |
| <p>If the <em class="replaceable"><code>TYPE</code></em> is unset, | |
| <em class="replaceable"><code>VALUE</code></em> does not have to be specified. | |
| If the type is stringv, multiple values can be given.</p> | |
| <div class="refsect3"> | |
| <a name="id-1.4.26.10.6.2.16.2.4"></a><h4>Options</h4> | |
| <div class="variablelist"><table border="0" class="variablelist"> | |
| <colgroup> | |
| <col align="left" valign="top"> | |
| <col> | |
| </colgroup> | |
| <tbody> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-t</code>, <code class="option">--type=<em class="replaceable"><code>TYPE</code></em></code></span></p></td> | |
| <td> | |
| <p>Specifies the type of the attribute. Supported | |
| types are string, stringv, bytestring, boolean, uint32, int32, | |
| uint64, int64 and unset.</p> | |
| <p>If the type is not specified, string is assumed.</p> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-n</code>, <code class="option">--nofollow-symlinks</code></span></p></td> | |
| <td><p>Don't follow symbolic links.</p></td> | |
| </tr> | |
| </tbody> | |
| </table></div> | |
| </div> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"> | |
| <span class="command"><strong>trash</strong></span> | |
| [<em class="replaceable"><code>OPTION</code></em>...] | |
| [<em class="replaceable"><code>LOCATION</code></em>...] | |
| </span></p></td> | |
| <td> | |
| <p>Sends files or directories to the "Trashcan". This can be a | |
| different folder depending on where the file is located, and not | |
| all file systems support this concept. In the common case that the | |
| file lives inside a users home directory, the trash folder is | |
| <code class="filename"><code class="envar">$XDG_DATA_HOME</code>/Trash</code>.</p> | |
| <p>Note that moving files to the trash does not free up space on | |
| the file system until the "Trashcan" is emptied. If you are interested | |
| in deleting a file irreversibly, see the remove command.</p> | |
| <p>Inspecting and emptying the "Trashcan" is normally supported by | |
| graphical file managers such as nautilus, but you can also see the | |
| trash with the command: gio list trash://.</p> | |
| <div class="refsect3"> | |
| <a name="id-1.4.26.10.6.2.17.2.4"></a><h4>Options</h4> | |
| <div class="variablelist"><table border="0" class="variablelist"> | |
| <colgroup> | |
| <col align="left" valign="top"> | |
| <col> | |
| </colgroup> | |
| <tbody> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-f</code>, <code class="option">--force</code></span></p></td> | |
| <td><p>Ignore non-existent and non-deletable files.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">--empty</code></span></p></td> | |
| <td><p>Empty the trash.</p></td> | |
| </tr> | |
| </tbody> | |
| </table></div> | |
| </div> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"> | |
| <span class="command"><strong>tree</strong></span> | |
| [<em class="replaceable"><code>OPTION</code></em>...] | |
| [<em class="replaceable"><code>LOCATION</code></em>...] | |
| </span></p></td> | |
| <td> | |
| <p>Lists the contents of the given locations recursively, in a | |
| tree-like format. If no location is given, it defaults to the current | |
| directory.</p> | |
| <p>The tree command is similar to the traditional tree utility.</p> | |
| <div class="refsect3"> | |
| <a name="id-1.4.26.10.6.2.18.2.3"></a><h4>Options</h4> | |
| <div class="variablelist"><table border="0" class="variablelist"> | |
| <colgroup> | |
| <col align="left" valign="top"> | |
| <col> | |
| </colgroup> | |
| <tbody> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-h</code>, <code class="option">--hidden</code></span></p></td> | |
| <td><p>Show hidden files.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-h</code>, <code class="option">--hidden</code></span></p></td> | |
| <td><p>Show hidden files.</p></td> | |
| </tr> | |
| <tr> | |
| <td><p><span class="term"><code class="option">-l</code>, <code class="option">--follow-symlinks</code></span></p></td> | |
| <td><p>Follow symbolic links.</p></td> | |
| </tr> | |
| </tbody> | |
| </table></div> | |
| </div> | |
| </td> | |
| </tr> | |
| </tbody> | |
| </table></div> | |
| </div> | |
| <div class="refsect1"> | |
| <a name="id-1.4.26.10.7"></a><h2>Exit status</h2> | |
| <p>On success 0 is returned, a non-zero failure code otherwise.</p> | |
| </div> | |
| <div class="refsect1"> | |
| <a name="id-1.4.26.10.8"></a><h2>See Also</h2> | |
| <p> | |
| <span class="citerefentry"><span class="refentrytitle">cat</span>(1)</span>, | |
| <span class="citerefentry"><span class="refentrytitle">cp</span>(1)</span>, | |
| <span class="citerefentry"><span class="refentrytitle">ls</span>(1)</span>, | |
| <span class="citerefentry"><span class="refentrytitle">mkdir</span>(1)</span>, | |
| <span class="citerefentry"><span class="refentrytitle">mv</span>(1)</span>, | |
| <span class="citerefentry"><span class="refentrytitle">rm</span>(1)</span>, | |
| <span class="citerefentry"><span class="refentrytitle">tree</span>(1)</span>. | |
| </p> | |
| </div> | |
| </div> | |
| <div class="footer"> | |
| <hr>Generated by GTK-Doc V1.25.1</div> | |
| </body> | |
| </html> |