| .. _gresource(1): | |
| .. meta:: | |
| :copyright: Copyright 2012 Red Hat, Inc. | |
| :license: LGPL-2.1-or-later | |
| .. | |
| This has to be duplicated from above to make it machine-readable by `reuse`: | |
| SPDX-FileCopyrightText: 2012 Red Hat, Inc. | |
| SPDX-License-Identifier: LGPL-2.1-or-later | |
| ========= | |
| gresource | |
| ========= | |
| -------------- | |
| GResource tool | |
| -------------- | |
| SYNOPSIS | |
| -------- | |
| | **gresource** [--section *SECTION*] list *FILE* [*PATH*] | |
| | **gresource** [--section *SECTION*] details *FILE* [*PATH*] | |
| | **gresource** [--section *SECTION*] extract *FILE* *PATH* | |
| | **gresource** sections *FILE* | |
| | **gresource** help [*COMMAND*] | |
| DESCRIPTION | |
| ----------- | |
| ``gresource`` offers a simple commandline interface to ``GResource``. It lets | |
| you list and extract resources that have been compiled into a resource file or | |
| included in an ELF file (a binary or a shared library). | |
| The file to operate on is specified by the ``FILE`` argument. | |
| If an ELF file includes multiple sections with resources, it is possible to | |
| select which one to operate on with the ``--section`` option. Use the | |
| ``sections`` command to find available sections. | |
| COMMANDS | |
| -------- | |
| ``list`` | |
| Lists resources. If ``SECTION`` is given, only list resources in this section. | |
| If ``PATH`` is given, only list matching resources. | |
| ``details`` | |
| Lists resources with details. If ``SECTION`` is given, only list resources in | |
| this section. If ``PATH`` is given, only list matching resources. Details | |
| include the section, size and compression of each resource. | |
| ``extract`` | |
| Extracts the resource named by ``PATH`` to stdout. Note that resources may | |
| contain binary data. | |
| ``sections`` | |
| Lists sections containing resources. This is only interesting if ``FILE`` is | |
| an ELF file. | |
| ``help`` | |
| Prints help and exits. |