Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

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

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 specifing 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.


       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.24/file-roller-3.24.0.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)