Difference between revisions of "cmd/gio"

from HTYP, the free directory anyone can edit if they can prove to me that they're not a spambot
< cmd
Jump to navigation Jump to search
(Created page with "==About== '''gio''' is a command line interface to the GIO subsystem. Commands (incomplete listing): {| class="wikitable sortable" |- ! subcommand || argument(s) || pu...")
 
Line 8: Line 8:
 
| '''{{l/sub|open}}''' || [{{arg|file}} or {{arg|URL}}] || opens files and URLs using the default applications as specified by the user's desktop environment
 
| '''{{l/sub|open}}''' || [{{arg|file}} or {{arg|URL}}] || opens files and URLs using the default applications as specified by the user's desktop environment
 
|-
 
|-
−
| '''{{l/sub|help}}''' || [COMMAND]
+
| '''{{l/sub|help}}''' || [COMMAND] || Displays a short synopsis of the available commands or provides detailed help on a specific command.
 
|-
 
|-
−
| '''{{l/sub|version}}''' ||  
+
| '''{{l/sub|version}}''' || || Prints the GLib version to which gio belongs.
 
|-
 
|-
−
| '''{{l/sub|cat}}''' || LOCATION...
+
| '''{{l/sub|cat}}''' || LOCATION...  
 +
| <poem>
 +
Concatenates the given files and prints them to the standard output.
 +
The cat command works just like the traditional cat utility.
 +
Note: just pipe through cat if you need its formatting options like -n, -T or other.
 +
</poem>
 
|-
 
|-
−
| '''{{l/sub|copy}}''' || [OPTION...] SOURCE... DESTINATION
+
| '''{{l/sub|copy}}''' || [OPTION...] SOURCE... DESTINATION || Copies one or more files from SOURCE to DESTINATION; similar to {{l/cmd|cp}}.
 
|-
 
|-
−
| '''{{l/sub|info}}''' || [OPTION...] LOCATION...
+
| '''{{l/sub|info}}''' || [OPTION...] LOCATION... || Shows information about the given locations; similar to {{l/cmd|ls}}.
 
|-
 
|-
 
| '''{{l/sub|launch}}''' || DESKTOP-FILE [FILE-ARG...]
 
| '''{{l/sub|launch}}''' || DESKTOP-FILE [FILE-ARG...]
 +
| Launch a desktop file from any location given.
 +
* The launch command extends the behavior of the open command by allowing any desktop file to be launched, not only those registered as file handlers.
 
|-
 
|-
−
| '''{{l/sub|list}}''' || [OPTION...] [LOCATION...]
+
| '''{{l/sub|list}}''' || [OPTION...] [LOCATION...] || Lists the contents of the given locations; similar to {{l/cmd|ls}}.
 
|-
 
|-
−
| '''{{l/sub|mime}}''' || MIMETYPE [HANDLER]
+
| '''{{l/sub|mime}}''' || [OPTION...] LOCATION...
 +
|
 +
* 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.
 +
* Handlers must be specified by their desktop file name, including the extension. Example: <code>org.gnome.gedit.desktop</code>.
 
|-
 
|-
−
| '''{{l/sub|mkdir}}''' || [OPTION...] LOCATION...
+
| '''{{l/sub|mkdir}}''' || MIMETYPE [HANDLER] || Creates directories; similar to {{l/cmd|mkdir}}.
 +
* Options:
 +
** -p, --parent
 +
**: Create parent directories when necessary.
 +
|-
 +
| '''{{l/sub|monitor}}''' || [OPTION...] [LOCATION...] || Monitors files or directories for changes
 +
|-
 +
| '''{{l/sub|mount}}''' || [OPTION...] [LOCATION...] || Provides commandline access to various aspects of GIO’s mounting functionality.
 +
|-
 +
| '''{{l/sub|move}}''' || [OPTION...] SOURCE... DESTINATION || Moves one or more files from SOURCE to DESTINATION; similar to {{l/cmd|mv}}.
 +
|-
 +
| '''{{l/sub|open}}''' || {{arg|LOCATION}}... || Opens files with the default application that is registered to handle files of this type; related to [[xdg-open]].
 +
|
 +
* GIO obtains this information from the shared-mime-info database, with per-user overrides stored in <code>$XDG_DATA_HOME/applications/mimeapps.list</code>.
 +
* The mime command can be used to change the default handler for a mimetype.
 +
* Environment variables will not be set on the application, as it may be an existing process which is activated to handle the new file.
 +
|-
 +
| '''{{l/sub|rename}}''' || {{arg|LOCATION}} {{arg|NAME}} || Renames a file; similar to {{l/cmd|rename}}.
 +
|-
 +
| '''{{l/sub|remove}}''' || [{{arg|OPTION}}...] {{arg|LOCATION}}... || Deletes each given file; similar to {{l/cmd|rm}}.
 +
* This command removes files irreversibly. If you want a reversible way to remove files, see the '''trash''' command.
 +
* Note that not all URI schemes that are supported by GIO may allow deletion of files.
 +
* Options:
 +
** -f, --force
 +
**: Ignore non-existent and non-deletable files.
 +
|-
 +
| '''{{l/sub|save}}''' || [{{arg|OPTION}}...] {{arg|DESTINATION}} || Reads from standard input and saves the data to the given location.
 +
|-
 +
| '''{{l/sub|set}}''' || [{{arg|OPTION}}...] {{arg|LOCATION}} {{arg|ATTRIBUTE}} {{arg|VALUE}}... || Sets a file attribute on a file.
 +
|-
 +
| '''{{l/sub|trash}}''' || [{{arg|OPTION}}...] [{{arg|LOCATION}}...] || Sends files or directories to the ‘Trashcan’ or restore them from ‘Trashcan’.
 +
|-
 +
| '''{{l/sub|tree}}''' || [{{arg|OPTION}}...] [{{arg|LOCATION}}...] || Lists the contents of the given locations recursively, in a tree-like format; similar to {{l/cmd|tree}}.
 +
* Options:
 +
** -h, --hidden
 +
**: Show hidden files.
 +
** -l, --follow-symlinks
 +
**: Follow symbolic links.
 
|}
 
|}

Revision as of 23:38, 2 January 2024

About

gio is a command line interface to the GIO subsystem. Commands (incomplete listing):

subcommand argument(s) purpose
open [<file> or <URL>] opens files and URLs using the default applications as specified by the user's desktop environment
help [COMMAND] Displays a short synopsis of the available commands or provides detailed help on a specific command.
version Prints the GLib version to which gio belongs.
cat LOCATION...

Concatenates the given files and prints them to the standard output.
The cat command works just like the traditional cat utility.
Note: just pipe through cat if you need its formatting options like -n, -T or other.

copy [OPTION...] SOURCE... DESTINATION Copies one or more files from SOURCE to DESTINATION; similar to cp.
info [OPTION...] LOCATION... Shows information about the given locations; similar to ls.
launch DESKTOP-FILE [FILE-ARG...] Launch a desktop file from any location given.
  • The launch command extends the behavior of the open command by allowing any desktop file to be launched, not only those registered as file handlers.
list [OPTION...] [LOCATION...] Lists the contents of the given locations; similar to ls.
mime [OPTION...] LOCATION...
  • 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.
  • Handlers must be specified by their desktop file name, including the extension. Example: org.gnome.gedit.desktop.
mkdir MIMETYPE [HANDLER] Creates directories; similar to mkdir.
  • Options:
    • -p, --parent
      Create parent directories when necessary.
monitor [OPTION...] [LOCATION...] Monitors files or directories for changes
mount [OPTION...] [LOCATION...] Provides commandline access to various aspects of GIO’s mounting functionality.
move [OPTION...] SOURCE... DESTINATION Moves one or more files from SOURCE to DESTINATION; similar to mv.
open <LOCATION>... Opens files with the default application that is registered to handle files of this type; related to xdg-open.
  • GIO obtains this information from the shared-mime-info database, with per-user overrides stored in $XDG_DATA_HOME/applications/mimeapps.list.
  • The mime command can be used to change the default handler for a mimetype.
  • Environment variables will not be set on the application, as it may be an existing process which is activated to handle the new file.
rename <LOCATION> <NAME> Renames a file; similar to rename.
remove [<OPTION>...] <LOCATION>... Deletes each given file; similar to rm.
  • This command removes files irreversibly. If you want a reversible way to remove files, see the trash command.
  • Note that not all URI schemes that are supported by GIO may allow deletion of files.
  • Options:
    • -f, --force
      Ignore non-existent and non-deletable files.
save [<OPTION>...] <DESTINATION> Reads from standard input and saves the data to the given location.
set [<OPTION>...] <LOCATION> <ATTRIBUTE> <VALUE>... Sets a file attribute on a file.
trash [<OPTION>...] [<LOCATION>...] Sends files or directories to the ‘Trashcan’ or restore them from ‘Trashcan’.
tree [<OPTION>...] [<LOCATION>...] Lists the contents of the given locations recursively, in a tree-like format; similar to tree.
  • Options:
    • -h, --hidden
      Show hidden files.
    • -l, --follow-symlinks
      Follow symbolic links.
Retrieved from "https://htyp.org/mw/index.php?title=cmd/gio&oldid=28880"