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)