Imported Upstream version 2.50.2
[platform/upstream/glib.git] / docs / reference / gio / html / gresource-tool.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html>
3 <head>
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>gresource: GIO Reference Manual</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
7 <link rel="home" href="index.html" title="GIO Reference Manual">
8 <link rel="up" href="tools.html" title="GIO Tools">
9 <link rel="prev" href="gdbus-codegen.html" title="gdbus-codegen">
10 <link rel="next" href="gapplication-tool.html" title="gapplication">
11 <meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
13 </head>
14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
16 <td width="100%" align="left" class="shortcuts"></td>
17 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
18 <td><a accesskey="u" href="tools.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
19 <td><a accesskey="p" href="gdbus-codegen.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
20 <td><a accesskey="n" href="gapplication-tool.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
21 </tr></table>
22 <div lang="en" class="refentry">
23 <a name="gresource-tool"></a><div class="titlepage"></div>
24 <div class="refnamediv"><table width="100%"><tr>
25 <td valign="top">
26 <h2><span class="refentrytitle">gresource</span></h2>
27 <p>gresource — GResource tool</p>
28 </td>
29 <td class="gallery_image" valign="top" align="right"></td>
30 </tr></table></div>
31 <div class="refsynopsisdiv">
32 <h2>Synopsis</h2>
33 <div class="cmdsynopsis"><p><code class="command">gresource</code>  [--section <em class="replaceable"><code>SECTION</code></em>]  list   <em class="replaceable"><code>FILE</code></em>  [<em class="replaceable"><code>PATH</code></em>]</p></div>
34 <div class="cmdsynopsis"><p><code class="command">gresource</code>  [--section <em class="replaceable"><code>SECTION</code></em>]  details   <em class="replaceable"><code>FILE</code></em>  [<em class="replaceable"><code>PATH</code></em>]</p></div>
35 <div class="cmdsynopsis"><p><code class="command">gresource</code>  [--section <em class="replaceable"><code>SECTION</code></em>]  extract   <em class="replaceable"><code>FILE</code></em>   <em class="replaceable"><code>PATH</code></em> </p></div>
36 <div class="cmdsynopsis"><p><code class="command">gresource</code>   sections   <em class="replaceable"><code>FILE</code></em> </p></div>
37 <div class="cmdsynopsis"><p><code class="command">gresource</code>   help  [<em class="replaceable"><code>COMMAND</code></em>]</p></div>
38 </div>
39 <div class="refsect1">
40 <a name="id-1.4.26.8.5"></a><h2>Description</h2>
41 <p><span class="command"><strong>gresource</strong></span> offers a simple commandline
42 interface to <a class="link" href="GResource.html" title="GResource"><span class="type">GResource</span></a>.
43 It lets you list and extract resources that have been compiled
44 into a resource file or included in an elf file (a binary or a
45 shared library).
46 </p>
47 <p>
48 The file to operate on is specified by the <em class="replaceable"><code>FILE</code></em>
49 argument.
50 </p>
51 <p>
52 If an elf file includes multiple sections with resources, it is
53 possible to select which one to operate on with the
54  --section  option. Use the
55   sections  command to find available sections.
56 </p>
57 </div>
58 <div class="refsect1">
59 <a name="id-1.4.26.8.6"></a><h2>Commands</h2>
60 <div class="variablelist"><table border="0" class="variablelist">
61 <colgroup>
62 <col align="left" valign="top">
63 <col>
64 </colgroup>
65 <tbody>
66 <tr>
67 <td><p><span class="term"><code class="option">list</code></span></p></td>
68 <td><p>
69 Lists resources. If <em class="replaceable"><code>SECTION</code></em> is given, only
70 list resourcs in this section. If <em class="replaceable"><code>PATH</code></em> is
71 given, only list matching resources.
72 </p></td>
73 </tr>
74 <tr>
75 <td><p><span class="term"><code class="option">details</code></span></p></td>
76 <td><p>
77 Lists resources with details. If <em class="replaceable"><code>SECTION</code></em>
78 is given, only list resources in this section. If
79 <em class="replaceable"><code>PATH</code></em> is given, only list matching resources.
80 Details include the section, size and compression of each resource.
81 </p></td>
82 </tr>
83 <tr>
84 <td><p><span class="term"><code class="option">extract</code></span></p></td>
85 <td><p>
86 Extracts the resource named by <em class="replaceable"><code>PATH</code></em> to stdout.
87 Note that resources may contain binary data.
88 </p></td>
89 </tr>
90 <tr>
91 <td><p><span class="term"><code class="option">sections</code></span></p></td>
92 <td><p>
93 Lists sections containing resources. This is only interesting if
94 <em class="replaceable"><code>FILE</code></em> is an elf file.
95 </p></td>
96 </tr>
97 <tr>
98 <td><p><span class="term"><code class="option">help</code></span></p></td>
99 <td><p>
100 Prints help and exits.
101 </p></td>
102 </tr>
103 </tbody>
104 </table></div>
105 </div>
106 </div>
107 <div class="footer">
108 <hr>Generated by GTK-Doc V1.25.1</div>
109 </body>
110 </html>