Google Git
Sign in
nest-open-source / nest-cam / 4320010 / glib / refs/heads/master / . / glib / docs / reference / gio / html / gio.html
blob: 9e1641e65785c389d74a81013f76997eedf573b4 [file] [log] [blame]
<!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>