File: gresource.rst

package info (click to toggle)
glib2.0 2.84.1-2
  • links: PTS, VCS
  • area: main
  • in suites: trixie
  • size: 66,144 kB
  • sloc: ansic: 538,877; python: 9,624; sh: 1,572; xml: 1,482; perl: 1,222; cpp: 535; makefile: 316; javascript: 11
file content (66 lines) | stat: -rw-r--r-- 1,779 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
.. _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.