1<?xml version="1.0"?> 2<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> 3<refentry id="gio"> 4 <refentryinfo> 5 <title>gio</title> 6 <productname>GIO</productname> 7 <authorgroup> 8 <author> 9 <contrib>Developer</contrib> 10 <firstname>Matthias</firstname> 11 <surname>Clasen</surname> 12 <email>mclasen@redhat.com</email> 13 </author> 14 </authorgroup> 15 </refentryinfo> 16 17 <refmeta> 18 <refentrytitle>gio</refentrytitle> 19 <manvolnum>1</manvolnum> 20 <refmiscinfo class="manual">User Commands</refmiscinfo> 21 </refmeta> 22 23 <refnamediv> 24 <refname>gio</refname> 25 <refpurpose>GIO commandline tool</refpurpose> 26 </refnamediv> 27 28 <refsynopsisdiv> 29 <cmdsynopsis> 30 <command>gio</command> 31 <arg choice="plain">help</arg> 32 <arg choice="opt"><replaceable>COMMAND</replaceable></arg> 33 </cmdsynopsis> 34 <cmdsynopsis> 35 <command>gio</command> 36 <arg choice="plain">version</arg> 37 </cmdsynopsis> 38 <cmdsynopsis> 39 <command>gio</command> 40 <arg choice="plain">cat</arg> 41 <arg choice="plain" rep="repeat"><replaceable>LOCATION</replaceable></arg> 42 </cmdsynopsis> 43 <cmdsynopsis> 44 <command>gio</command> 45 <arg choice="plain">copy</arg> 46 <arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg> 47 <arg choice="plain" rep="repeat"><replaceable>SOURCE</replaceable></arg> 48 <arg choice="plain"><replaceable>DESTINATION</replaceable></arg> 49 </cmdsynopsis> 50 <cmdsynopsis> 51 <command>gio</command> 52 <arg choice="plain">info</arg> 53 <arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg> 54 <arg choice="plain" rep="repeat"><replaceable>LOCATION</replaceable></arg> 55 </cmdsynopsis> 56 <cmdsynopsis> 57 <command>gio</command> 58 <arg choice="plain">list</arg> 59 <arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg> 60 <arg choice="opt" rep="repeat"><replaceable>LOCATION</replaceable></arg> 61 </cmdsynopsis> 62 <cmdsynopsis> 63 <command>gio</command> 64 <arg choice="plain">mime</arg> 65 <arg choice="plain"><replaceable>MIMETYPE</replaceable></arg> 66 <arg choice="opt"><replaceable>HANDLER</replaceable></arg> 67 </cmdsynopsis> 68 <cmdsynopsis> 69 <command>gio</command> 70 <arg choice="plain">mkdir</arg> 71 <arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg> 72 <arg choice="plain" rep="repeat"><replaceable>LOCATION</replaceable></arg> 73 </cmdsynopsis> 74 <cmdsynopsis> 75 <command>gio</command> 76 <arg choice="plain">monitor</arg> 77 <arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg> 78 <arg choice="opt" rep="repeat"><replaceable>LOCATION</replaceable></arg> 79 </cmdsynopsis> 80 <cmdsynopsis> 81 <command>gio</command> 82 <arg choice="plain">mount</arg> 83 <arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg> 84 <arg choice="opt" rep="repeat"><replaceable>LOCATION</replaceable></arg> 85 </cmdsynopsis> 86 <cmdsynopsis> 87 <command>gio</command> 88 <arg choice="plain">move</arg> 89 <arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg> 90 <arg choice="plain" rep="repeat"><replaceable>SOURCE</replaceable></arg> 91 <arg choice="plain"><replaceable>DESTINATION</replaceable></arg> 92 </cmdsynopsis> 93 <cmdsynopsis> 94 <command>gio</command> 95 <arg choice="plain">open</arg> 96 <arg choice="plain" rep="repeat"><replaceable>LOCATION</replaceable></arg> 97 </cmdsynopsis> 98 <cmdsynopsis> 99 <command>gio</command> 100 <arg choice="plain">rename</arg> 101 <arg choice="plain"><replaceable>LOCATION</replaceable></arg> 102 <arg choice="plain"><replaceable>NAME</replaceable></arg> 103 </cmdsynopsis> 104 <cmdsynopsis> 105 <command>gio</command> 106 <arg choice="plain">remove</arg> 107 <arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg> 108 <arg choice="plain" rep="repeat"><replaceable>LOCATION</replaceable></arg> 109 </cmdsynopsis> 110 <cmdsynopsis> 111 <command>gio</command> 112 <arg choice="plain">save</arg> 113 <arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg> 114 <arg choice="plain"><replaceable>DESTINATION</replaceable></arg> 115 </cmdsynopsis> 116 <cmdsynopsis> 117 <command>gio</command> 118 <arg choice="plain">set</arg> 119 <arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg> 120 <arg choice="plain"><replaceable>LOCATION</replaceable></arg> 121 <arg choice="plain"><replaceable>ATTRIBUTE</replaceable></arg> 122 <arg choice="plain" rep="repeat"><replaceable>VALUE</replaceable></arg> 123 </cmdsynopsis> 124 <cmdsynopsis> 125 <command>gio</command> 126 <arg choice="plain">trash</arg> 127 <arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg> 128 <arg choice="opt" rep="repeat"><replaceable>LOCATION</replaceable></arg> 129 </cmdsynopsis> 130 <cmdsynopsis> 131 <command>gio</command> 132 <arg choice="plain">tree</arg> 133 <arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg> 134 <arg choice="opt" rep="repeat"><replaceable>LOCATION</replaceable></arg> 135 </cmdsynopsis> 136 </refsynopsisdiv> 137 138 <refsect1> 139 <title>Description</title> 140 <para><command>gio</command> is a utility that makes many of the GIO 141 features available from the commandline. In doing so, it provides 142 commands that are similar to traditional utilities, but let you 143 use GIO locations instead of local files: for example you can use 144 something like <filename>smb://server/resource/file.txt</filename> 145 as a location.</para> 146 <para>Plain filenames which contain a colon will be interpreted as URIs 147 with an unknown protocol. To avoid this, prefix them with a path such as 148 <filename>./</filename>, or with the <literal>file:</literal> protocol.</para> 149 </refsect1> 150 151 <refsect1> 152 <title>Commands</title> 153 154 <variablelist> 155 <varlistentry> 156 <term> 157 <command>help</command> 158 <arg choice="opt"><replaceable>COMMAND</replaceable></arg> 159 </term> 160 <listitem> 161 <para>Displays a short synopsis of the available commands or provides 162 detailed help on a specific command.</para> 163 </listitem> 164 </varlistentry> 165 166 <varlistentry> 167 <term> 168 <command>version</command> 169 </term> 170 <listitem> 171 <para>Prints the GLib version to which <command>gio</command> 172 belongs.</para> 173 </listitem> 174 </varlistentry> 175 176 <varlistentry> 177 <term> 178 <command>cat</command> 179 <arg choice="plain" rep="repeat"><replaceable>LOCATION</replaceable></arg> 180 </term> 181 <listitem> 182 <para>Concatenates the given files and prints them to the standard 183 output.</para> 184 <para>The <command>cat</command> command works just like the traditional <command>cat</command> utility.</para> 185 <para>Note: just pipe through <command>cat</command> if you need its formatting options 186 like <option>-n</option>, <option>-T</option> or other.</para> 187 </listitem> 188 </varlistentry> 189 190 <varlistentry> 191 <term> 192 <command>copy</command> 193 <arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg> 194 <arg choice="plain" rep="repeat"><replaceable>SOURCE</replaceable></arg> 195 <arg choice="plain"><replaceable>DESTINATION</replaceable></arg> 196 </term> 197 <listitem> 198 <para>Copies one or more files from <replaceable>SOURCE</replaceable> 199 to <replaceable>DESTINATION</replaceable>. If more than one source 200 is specified, the destination must be a directory.</para> 201 <para>The <command>copy</command> command is similar to the traditional <command>cp</command> utility.</para> 202 <refsect3> 203 <title>Options</title> 204 <variablelist> 205 <varlistentry> 206 <term><option>-T</option>, <option>--no-target-directory</option></term> 207 <listitem><para>Don’t copy into <replaceable>DESTINATION</replaceable> even if it is a directory.</para></listitem> 208 </varlistentry> 209 <varlistentry> 210 <term><option>-p</option>, <option>--progress</option></term> 211 <listitem><para>Show progress.</para></listitem> 212 </varlistentry> 213 <varlistentry> 214 <term><option>-i</option>, <option>--interactive</option></term> 215 <listitem><para>Prompt for confirmation before overwriting files.</para></listitem> 216 </varlistentry> 217 <varlistentry> 218 <term><option>--preserve</option></term> 219 <listitem><para>Preserve all attributes of copied files.</para></listitem> 220 </varlistentry> 221 <varlistentry> 222 <term><option>-b</option>, <option>--backup</option></term> 223 <listitem><para>Create backups of existing destination files.</para></listitem> 224 </varlistentry> 225 <varlistentry> 226 <term><option>-P</option>, <option>--no-dereference</option></term> 227 <listitem><para>Never follow symbolic links.</para></listitem> 228 </varlistentry> 229 </variablelist> 230 </refsect3> 231 </listitem> 232 </varlistentry> 233 <varlistentry> 234 <term> 235 <command>info</command> 236 <arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg> 237 <arg choice="plain" rep="repeat"><replaceable>LOCATION</replaceable></arg> 238 </term> 239 <listitem> 240 <para>Shows information about the given locations.</para> 241 <para>The <command>info</command> command is similar to the traditional <command>ls</command> utility.</para> 242 <refsect3> 243 <title>Options</title> 244 <variablelist> 245 <varlistentry> 246 <term><option>-w</option>, <option>--query-writable</option></term> 247 <listitem><para>List writable attributes.</para></listitem> 248 </varlistentry> 249 <varlistentry> 250 <term><option>-f</option>, <option>--filesystem</option></term> 251 <listitem><para>Show information about the filesystem that the given 252 locations reside on.</para></listitem> 253 </varlistentry> 254 <varlistentry> 255 <term><option>-a</option> <option>--attributes=<replaceable>ATTRIBUTES</replaceable></option></term> 256 <listitem><para>The attributes to get.</para> 257 <para>Attributes can be specified with their GIO name, e.g. 258 <literal>standard::icon</literal>, or just by namespace, e.g. <literal>unix</literal>, or by <literal>*</literal>, 259 which matches all attributes. Several attributes or groups 260 of attributes can be specified, separated by comma.</para> 261 <para>By default, all attributes are listed.</para></listitem> 262 </varlistentry> 263 <varlistentry> 264 <term><option>-n</option>, <option>--nofollow-symlinks</option></term> 265 <listitem><para>Don’t follow symbolic links.</para></listitem> 266 </varlistentry> 267 </variablelist> 268 </refsect3> 269 </listitem> 270 </varlistentry> 271 272 <varlistentry> 273 <term> 274 <command>list</command> 275 <arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg> 276 <arg choice="opt" rep="repeat"><replaceable>LOCATION</replaceable></arg> 277 </term> 278 <listitem> 279 <para>Lists the contents of the given locations. If no location is 280 given, the contents of the current directory are shown.</para> 281 <para>The <command>list</command> command is similar to the traditional <command>ls</command> utility.</para> 282 <refsect3> 283 <title>Options</title> 284 <variablelist> 285 <varlistentry> 286 <term><option>-a</option> <option>--attributes=<replaceable>ATTRIBUTES</replaceable></option></term> 287 <listitem><para>The attributes to get.</para> 288 <para>Attributes can be specified with their GIO name, e.g. 289 <literal>standard::icon</literal>, or just by namespace, e.g. <literal>unix</literal>, or by <literal>*</literal>, 290 which matches all attributes. Several attributes or groups 291 of attributes can be specified, separated by comma.</para> 292 <para>By default, all attributes are listed.</para></listitem> 293 </varlistentry> 294 <varlistentry> 295 <term><option>-h</option>, <option>--hidden</option></term> 296 <listitem><para>Show hidden files.</para></listitem> 297 </varlistentry> 298 <varlistentry> 299 <term><option>-l</option>, <option>--long</option></term> 300 <listitem><para>Use a long listing format.</para></listitem> 301 </varlistentry> 302 <varlistentry> 303 <term><option>-n</option>, <option>--nofollow-symlinks</option></term> 304 <listitem><para>Don’t follow symbolic links.</para></listitem> 305 </varlistentry> 306 <varlistentry> 307 <term><option>-u</option>, <option>--print-uris</option></term> 308 <listitem><para>Print full URIs.</para></listitem> 309 </varlistentry> 310 </variablelist> 311 </refsect3> 312 </listitem> 313 </varlistentry> 314 315 <varlistentry> 316 <term> 317 <command>mime</command> 318 <arg choice="plain"><replaceable>MIMETYPE</replaceable></arg> 319 <arg choice="opt"><replaceable>HANDLER</replaceable></arg> 320 </term> 321 <listitem> 322 <para>If no handler is given, the <command>mime</command> command lists the 323 registered and recommended applications for the mimetype. 324 If a handler is given, it is set as the default handler for 325 the mimetype.</para> 326 <para>Handlers must be specified by their desktop file name, 327 including the extension. Example: <literal>org.gnome.gedit.desktop</literal>.</para> 328 </listitem> 329 </varlistentry> 330 331 <varlistentry> 332 <term> 333 <command>mkdir</command> 334 <arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg> 335 <arg choice="plain" rep="repeat"><replaceable>LOCATION</replaceable></arg> 336 </term> 337 <listitem> 338 <para>Creates directories.</para> 339 <para>The <command>mkdir</command> command is similar to the traditional <command>mkdir</command> utility.</para> 340 <refsect3> 341 <title>Options</title> 342 <variablelist> 343 <varlistentry> 344 <term><option>-p</option>, <option>--parent</option></term> 345 <listitem><para>Create parent directories when necessary.</para></listitem> 346 </varlistentry> 347 </variablelist> 348 </refsect3> 349 </listitem> 350 </varlistentry> 351 352 <varlistentry> 353 <term> 354 <command>monitor</command> 355 <arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg> 356 <arg choice="opt" rep="repeat"><replaceable>LOCATION</replaceable></arg> 357 </term> 358 <listitem> 359 <para>Monitors files or directories for changes, such as creation 360 deletion, content and attribute changes, and mount and unmount 361 operations affecting the monitored locations.</para> 362 <para>The <command>monitor</command> command uses the GIO file monitoring APIs to do 363 its job. GIO has different implementations for different platforms. 364 The most common implementation on Linux uses inotify.</para> 365 <refsect3> 366 <title>Options</title> 367 <variablelist> 368 <varlistentry> 369 <term><option>-d</option>, <option>--dir=<replaceable>LOCATION</replaceable></option></term> 370 <listitem><para>Monitor the given location as a directory. Normally, 371 the file type is used to determine whether to monitor a file or directory.</para></listitem> 372 </varlistentry> 373 <varlistentry> 374 <term><option>-f</option>, <option>--file=<replaceable>LOCATION</replaceable></option></term> 375 <listitem><para>Monitor the given location as a file. Normally, 376 the file type is used to determine whether to monitor a file or directory.</para></listitem> 377 </varlistentry> 378 <varlistentry> 379 <term><option>-D</option>, <option>--direct=<replaceable>LOCATION</replaceable></option></term> 380 <listitem><para>Monitor the file directly. This allows changes made via hardlinks to be captured.</para></listitem> 381 </varlistentry> 382 <varlistentry> 383 <term><option>-s</option>, <option>--silent=<replaceable>LOCATION</replaceable></option></term> 384 <listitem><para>Monitor the file directly, but don’t report changes.</para></listitem> 385 </varlistentry> 386 <varlistentry> 387 <term><option>-n</option>, <option>--no-moves</option></term> 388 <listitem><para>Report moves and renames as simple deleted/created events.</para></listitem> 389 </varlistentry> 390 <varlistentry> 391 <term><option>-m</option>, <option>--mounts</option></term> 392 <listitem><para>Watch for mount events.</para></listitem> 393 </varlistentry> 394 </variablelist> 395 </refsect3> 396 </listitem> 397 </varlistentry> 398 399 <varlistentry> 400 <term> 401 <command>mount</command> 402 <arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg> 403 <arg choice="opt" rep="repeat"><replaceable>LOCATION</replaceable></arg> 404 </term> 405 <listitem> 406 <para>Provides commandline access to various aspects of GIO’s mounting 407 functionality.</para> 408 <para>Mounting refers to the traditional concept of arranging multiple 409 file systems and devices in a single tree, rooted at <filename>/</filename>. Classical 410 mounting happens in the kernel and is controlled by the mount utility. 411 GIO expands this concept by introducing mount daemons that can make 412 file systems available to GIO applications without kernel 413 involvement.</para> 414 <para>GIO mounts can require authentication, and the <command>mount</command> command 415 may ask for user IDs, passwords, and so on, when required.</para> 416 <refsect3> 417 <title>Options</title> 418 <variablelist> 419 <varlistentry> 420 <term><option>-m</option>, <option>--mountable</option></term> 421 <listitem><para>Mount as mountable.</para></listitem> 422 </varlistentry> 423 <varlistentry> 424 <term><option>-d</option>, <option>--device=<replaceable>DEVICE</replaceable></option></term> 425 <listitem><para>Mount volume with device file.</para></listitem> 426 </varlistentry> 427 <varlistentry> 428 <term><option>-u</option>, <option>--unmount</option></term> 429 <listitem><para>Unmount the location.</para></listitem> 430 </varlistentry> 431 <varlistentry> 432 <term><option>-e</option>, <option>--eject</option></term> 433 <listitem><para>Eject the location.</para></listitem> 434 </varlistentry> 435 <varlistentry> 436 <term><option>-s</option>, <option>--unmount-scheme=<replaceable>SCHEME</replaceable></option></term> 437 <listitem><para>Unmount all mounts with the given scheme.</para></listitem> 438 </varlistentry> 439 <varlistentry> 440 <term><option>-f</option>, <option>--force</option></term> 441 <listitem><para>Ignore outstanding file operations when unmounting or ejecting.</para></listitem> 442 </varlistentry> 443 <varlistentry> 444 <term><option>-a</option>, <option>--anonymous</option></term> 445 <listitem><para>Use an anonymous user when authenticating.</para></listitem> 446 </varlistentry> 447 <varlistentry> 448 <term><option>-l</option>, <option>--list</option></term> 449 <listitem><para>List all GIO mounts.</para></listitem> 450 </varlistentry> 451 <varlistentry> 452 <term><option>-o</option>, <option>--monitor</option></term> 453 <listitem><para>Monitor mount-related events.</para> 454 </listitem> 455 </varlistentry> 456 <varlistentry> 457 <term><option>-i</option>, <option>--detail</option></term> 458 <listitem><para>Show extra information.</para> 459 </listitem> 460 </varlistentry> 461 <varlistentry> 462 <term><option>--tcrypt-pim</option></term> 463 <listitem><para>The numeric PIM when unlocking a VeraCrypt volume.</para> 464 </listitem> 465 </varlistentry> 466 <varlistentry> 467 <term><option>--tcrypt-hidden</option></term> 468 <listitem><para>Mount a TCRYPT hidden volume.</para> 469 </listitem> 470 </varlistentry> 471 <varlistentry> 472 <term><option>--tcrypt-system</option></term> 473 <listitem><para>Mount a TCRYPT system volume.</para> 474 </listitem> 475 </varlistentry> 476 </variablelist> 477 </refsect3> 478 </listitem> 479 </varlistentry> 480 481 <varlistentry> 482 <term> 483 <command>move</command> 484 <arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg> 485 <arg choice="plain" rep="repeat"><replaceable>SOURCE</replaceable></arg> 486 <arg choice="plain"><replaceable>DESTINATION</replaceable></arg> 487 </term> 488 <listitem> 489 <para>Moves one or more files from <replaceable>SOURCE</replaceable> 490 to <replaceable>DESTINATION</replaceable>. If more than one source 491 is specified, the destination must be a directory.</para> 492 <para>The <command>move</command> command is similar to the traditional <command>mv</command> utility.</para> 493 </listitem> 494 </varlistentry> 495 496 <varlistentry> 497 <term> 498 <command>open</command> 499 <arg choice="plain" rep="repeat"><replaceable>LOCATION</replaceable></arg> 500 </term> 501 <listitem> 502 <para>Opens files with the default application that is registered 503 to handle files of this type.</para> 504 <para>GIO obtains this information from the shared-mime-info 505 database, with per-user overrides stored in 506 <filename><envar>$XDG_DATA_HOME</envar>/applications/mimeapps.list</filename>.</para> 507 <para>The <command>mime</command> command can be used to change the default handler for 508 a mimetype.</para> 509 <para>Environment variables will not be set on the application, as it 510 may be an existing process which is activated to handle the new file.</para> 511 </listitem> 512 </varlistentry> 513 514 <varlistentry> 515 <term> 516 <command>rename</command> 517 <arg choice="plain"><replaceable>LOCATION</replaceable></arg> 518 <arg choice="plain"><replaceable>NAME</replaceable></arg> 519 </term> 520 <listitem> 521 <para>Renames a file.</para> 522 <para>The <command>rename</command> command is similar to the traditional <command>rename</command> utility.</para> 523 </listitem> 524 </varlistentry> 525 526 <varlistentry> 527 <term> 528 <command>remove</command> 529 <arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg> 530 <arg choice="plain" rep="repeat"><replaceable>LOCATION</replaceable></arg> 531 </term> 532 <listitem> 533 <para>Deletes each given file.</para> 534 <para>This command removes files irreversibly. If you want a reversible 535 way to remove files, see the <command>trash</command> command.</para> 536 <para>Note that not all URI schemes that are supported by GIO may 537 allow deletion of files.</para> 538 <para>The <command>remove</command> command is similar to the traditional <command>rm</command> utility.</para> 539 <refsect3> 540 <title>Options</title> 541 <variablelist> 542 <varlistentry> 543 <term><option>-f</option>, <option>--force</option></term> 544 <listitem><para>Ignore non-existent and non-deletable files.</para></listitem> 545 </varlistentry> 546 </variablelist> 547 </refsect3> 548 </listitem> 549 </varlistentry> 550 551 <varlistentry> 552 <term> 553 <command>save</command> 554 <arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg> 555 <arg choice="plain"><replaceable>DESTINATION</replaceable></arg> 556 </term> 557 <listitem> 558 <para>Reads from standard input and saves the data to the given 559 location.</para> 560 <para>This is similar to just redirecting output to a file using 561 traditional shell syntax, but the <command>save</command> command allows saving to 562 location that GIO can write to.</para> 563 <refsect3> 564 <title>Options</title> 565 <variablelist> 566 <varlistentry> 567 <term><option>-b</option>, <option>--backup</option></term> 568 <listitem><para>Back up existing destination files.</para></listitem> 569 </varlistentry> 570 <varlistentry> 571 <term><option>-c</option>, <option>--create</option></term> 572 <listitem><para>Only create the destination if it doesn’t exist yet.</para></listitem> 573 </varlistentry> 574 <varlistentry> 575 <term><option>-a</option>, <option>--append</option></term> 576 <listitem><para>Append to the end of the file.</para></listitem> 577 </varlistentry> 578 <varlistentry> 579 <term><option>-p</option>, <option>--private</option></term> 580 <listitem><para>When creating, restrict access to the current user.</para></listitem> 581 </varlistentry> 582 <varlistentry> 583 <term><option>-u</option>, <option>--unlink</option></term> 584 <listitem><para>When replacing, replace as if the destination did not exist.</para></listitem> 585 </varlistentry> 586 <varlistentry> 587 <term><option>-v</option>, <option>--print-etag</option></term> 588 <listitem><para>Print the new ETag in the end.</para></listitem> 589 </varlistentry> 590 <varlistentry> 591 <term><option>-e</option>, <option>--etag=<replaceable>ETAG</replaceable></option></term> 592 <listitem><para>The ETag of the file that is overwritten.</para></listitem> 593 </varlistentry> 594 </variablelist> 595 </refsect3> 596 </listitem> 597 </varlistentry> 598 599 <varlistentry> 600 <term> 601 <command>set</command> 602 <arg choice="plain"><replaceable>LOCATION</replaceable></arg> 603 <arg choice="plain"><replaceable>ATTRIBUTE</replaceable></arg> 604 <arg choice="plain" rep="repeat"><replaceable>VALUE</replaceable></arg> 605 </term> 606 <listitem> 607 <para>Sets a file attribute on a file.</para> 608 <para>File attributes can be specified with their GIO name, e.g 609 <literal>standard::icon</literal>. Note that not all GIO file attributes are writable. 610 Use the <option>--query-writable</option> option of the <command>info</command> command to list 611 writable file attributes.</para> 612 <para>If the <replaceable>TYPE</replaceable> is unset, 613 <replaceable>VALUE</replaceable> does not have to be specified. 614 If the <replaceable>TYPE</replaceable> is <literal>stringv</literal>, multiple values can be given.</para> 615 <refsect3> 616 <title>Options</title> 617 <variablelist> 618 <varlistentry> 619 <term><option>-t</option>, <option>--type=<replaceable>TYPE</replaceable></option></term> 620 <listitem><para>Specifies the type of the attribute. Supported 621 types are <literal>string</literal>, <literal>stringv</literal>, 622 <literal>bytestring</literal>, <literal>boolean</literal>, 623 <literal>uint32</literal>, <literal>int32</literal>, 624 <literal>uint64</literal>, <literal>int64</literal> and <literal>unset</literal>.</para> 625 <para>If the type is not specified, <literal>string</literal> is assumed.</para> 626 </listitem> 627 </varlistentry> 628 <varlistentry> 629 <term><option>-n</option>, <option>--nofollow-symlinks</option></term> 630 <listitem><para>Don’t follow symbolic links.</para></listitem> 631 </varlistentry> 632 </variablelist> 633 </refsect3> 634 </listitem> 635 </varlistentry> 636 637 <varlistentry> 638 <term> 639 <command>trash</command> 640 <arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg> 641 <arg choice="opt" rep="repeat"><replaceable>LOCATION</replaceable></arg> 642 </term> 643 <listitem> 644 <para>Sends files or directories to the ‘Trashcan’. This can be a 645 different folder depending on where the file is located, and not 646 all file systems support this concept. In the common case that the 647 file lives inside a user’s home directory, the trash folder is 648 <filename><envar>$XDG_DATA_HOME</envar>/Trash</filename>.</para> 649 <para>Note that moving files to the trash does not free up space on 650 the file system until the ‘Trashcan’ is emptied. If you are interested 651 in deleting a file irreversibly, see the <command>remove</command> command.</para> 652 <para>Inspecting and emptying the ‘Trashcan’ is normally supported by 653 graphical file managers such as Nautilus, but you can also see the 654 trash with the command: <command>gio list trash://</command>.</para> 655 <refsect3> 656 <title>Options</title> 657 <variablelist> 658 <varlistentry> 659 <term><option>-f</option>, <option>--force</option></term> 660 <listitem><para>Ignore non-existent and non-deletable files.</para></listitem> 661 </varlistentry> 662 <varlistentry> 663 <term><option>--empty</option></term> 664 <listitem><para>Empty the trash.</para></listitem> 665 </varlistentry> 666 </variablelist> 667 </refsect3> 668 </listitem> 669 </varlistentry> 670 671 <varlistentry> 672 <term> 673 <command>tree</command> 674 <arg choice="opt" rep="repeat"><replaceable>OPTION</replaceable></arg> 675 <arg choice="opt" rep="repeat"><replaceable>LOCATION</replaceable></arg> 676 </term> 677 <listitem> 678 <para>Lists the contents of the given locations recursively, in a 679 tree-like format. If no location is given, it defaults to the current 680 directory.</para> 681 <para>The <command>tree</command> command is similar to the traditional <command>tree</command> utility.</para> 682 <refsect3> 683 <title>Options</title> 684 <variablelist> 685 <varlistentry> 686 <term><option>-h</option>, <option>--hidden</option></term> 687 <listitem><para>Show hidden files.</para></listitem> 688 </varlistentry> 689 <varlistentry> 690 <term><option>-l</option>, <option>--follow-symlinks</option></term> 691 <listitem><para>Follow symbolic links.</para></listitem> 692 </varlistentry> 693 </variablelist> 694 </refsect3> 695 </listitem> 696 </varlistentry> 697 </variablelist> 698 </refsect1> 699 700 <refsect1> 701 <title>Exit status</title> 702 <para>On success 0 is returned, a non-zero failure code otherwise.</para> 703 </refsect1> 704 705 <refsect1> 706 <title>See Also</title> 707 <para> 708 <citerefentry> 709 <refentrytitle>cat</refentrytitle> 710 <manvolnum>1</manvolnum> 711 </citerefentry>, 712 <citerefentry> 713 <refentrytitle>cp</refentrytitle> 714 <manvolnum>1</manvolnum> 715 </citerefentry>, 716 <citerefentry> 717 <refentrytitle>ls</refentrytitle> 718 <manvolnum>1</manvolnum> 719 </citerefentry>, 720 <citerefentry> 721 <refentrytitle>mkdir</refentrytitle> 722 <manvolnum>1</manvolnum> 723 </citerefentry>, 724 <citerefentry> 725 <refentrytitle>mv</refentrytitle> 726 <manvolnum>1</manvolnum> 727 </citerefentry>, 728 <citerefentry> 729 <refentrytitle>rm</refentrytitle> 730 <manvolnum>1</manvolnum> 731 </citerefentry>, 732 <citerefentry> 733 <refentrytitle>tree</refentrytitle> 734 <manvolnum>1</manvolnum> 735 </citerefentry>. 736 </para> 737 </refsect1> 738</refentry> 739