file-roller - create, view, modify, or unpack an archive
file-roller [--add] [--add-to=archive] [--default-dir=folder] [--extract] [--extract-here] [--extract-to=folder] [--force] [--notify] [--service] [gnome-std-options] [archive...]
file-roller(1) User Commands file-roller(1) NAME file-roller - create, view, modify, or unpack an archive SYNOPSIS file-roller [--add] [--add-to=archive] [--default-dir=folder] [--extract] [--extract-here] [--extract-to=folder] [--force] [--notify] [--service] [gnome-std-options] [archive...] DESCRIPTION The File Roller application enables you to create, view, modify, or unpack an archive. An archive is a file that acts as a container for other files. An archive can contain many files, folders, and subfold- ers, usually in compressed form. You can extract a series of archives with a single command. OPTIONS The following options are supported: -d, --add Ask for the name of the archive, then add the files, then quit the applica- tion. -a, --add-to=archive Add files to the specified archive, then quit the application. --default-dir=folder Specify the default folder for the --add and --extract options. -f, --extract Ask for the name of the destination folder, then extract the files, then quit the application. -h, --extract-here Extract archives using the archive name as destination folder and quit the pro- gram. -e, --extract-to=folder Extract archives to the specified folder, then quit the application. --force Create the destination folder without asking for confirmation. --notify Use the notification system to show a dialog that notifies the user that the operation has completed successfully and allows to open the destination folder. --service Start as a service. gnome-std-options Standard options available for use with most GNOME applications. See gnome- std-options(7) for more information. EXAMPLES Example 1: Unpacking an Archive example% file-roller --extract archive Example 1: Extract an archive to a specified directory example% file-roller --extract-to=/path/to/dir archive.tgz To create the destination folder without asking the user to confirm: example% file-roller --force --extract-to=/path/to/dir archive.tgz Example 2: Extract an archive letting the user choose the destination directory example% file-roller --extract archive.tgz To set the directory to show in the folder chooser dialog: example% file-roller --default-dir=/path/to/show --extract archive.tgz Example 3: Extract an archive in its parent folder To extract an archive in its parent folder creating a subfolder if the archive contains more than one top level object (that is avoiding the tar-bombing): example% file-roller --extract-here archive.tgz This is the same command used in the Nautilus context menu to extract archives. Example 4: Compress a series of files specifying the archive name example% file-roller --add-to=/path/to/archive.tgz file1 file2 .. The archive is created if it doesn't exist. Example 5: Compress a series of files letting the user choose the ar- chive name example% file-roller --add file1 file2 .. To set the directory to show in the folder chooser dialog: example% file-roller --default-dir=/path/to/show --add file1 file2 .. EXIT STATUS The following exit values are returned: 0 Application exited successfully >0 Application exited with failure FILES The following files are used by this application: /usr/bin/file-roller Executable for File Roller application. ATTRIBUTES See attributes(7) for descriptions of the following attributes: +---------------+-------------------------------------+ |ATTRIBUTE TYPE | ATTRIBUTE VALUE | +---------------+-------------------------------------+ |Availability | desktop/archive-manager/file-roller | +---------------+-------------------------------------+ |Stability | Pass-through volatile | +---------------+-------------------------------------+ SEE ALSO File Roller Manual ar(1), tar(1), unzip(1), zip(1), libarchive(3lib), attributes(7), gnome-std-options(7) NOTES Written by Laszlo Kovacs, Sun Microsystems Inc., 2003, 2004, 2007. Source code for open source software components in Oracle Solaris can be found at https://www.oracle.com/downloads/opensource/solaris-source- code-downloads.html. This software was built from source available at https://github.com/oracle/solaris-userland. The original community source was downloaded from https://download.gnome.org/sources/file- roller/3.38/file-roller-3.38.1.tar.xz. Further information about this software can be found on the open source community website at https://wiki.gnome.org/Apps/FileRoller. Solaris 11.4 7 Apr 2017 file-roller(1)