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</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.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="migrating.html" title="Part III. Migrating to GIO">
  11 <meta name="generator" content="GTK-Doc V1.18 (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="2"><tr valign="middle">
  16 <td><a accesskey="p" href="gdbus-codegen.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  17 <td><a accesskey="u" href="tools.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  18 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  19 <th width="100%" align="center">GIO Reference Manual</th>
  20 <td><a accesskey="n" href="migrating.html"><img src="right.png" width="24" height="24" 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 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 SECTION]  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 SECTION]  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="id657122"></a><h2>Description</h2>
  41 <p><span class="command"><strong>gresource</strong></span> offers a simple commandline
  42 interface to <a class="link" href="gio-GResource.html#GResource" 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 class="refsect2">
  58 <a name="id996040"></a><h3>Commands</h3>
  59 <div class="variablelist"><table border="0">
  60 <col align="left" valign="top">
  61 <tbody>
  62 <tr>
  63 <td><p><span class="term"><code class="option">list</code></span></p></td>
  64 <td><p>
  65 Lists resources. If <em class="replaceable"><code>SECTION</code></em> is given, only
  66 list resourcs in this section. If <em class="replaceable"><code>PATH</code></em> is
  67 given, only list matching resources.
  68 </p></td>
  69 </tr>
  70 <tr>
  71 <td><p><span class="term"><code class="option">details</code></span></p></td>
  72 <td><p>
  73 Lists resources with details. If <em class="replaceable"><code>SECTION</code></em>
  74 is given, only list resources in this section. If
  75 <em class="replaceable"><code>PATH</code></em> is given, only list matching resources.
  76 Details include the section, size and compression of each resource.
  77 </p></td>
  78 </tr>
  79 <tr>
  80 <td><p><span class="term"><code class="option">extract</code></span></p></td>
  81 <td><p>
  82 Extracts the resource named by <em class="replaceable"><code>PATH</code></em> to stdout.
  83 Note that resources may contain binary data.
  84 </p></td>
  85 </tr>
  86 <tr>
  87 <td><p><span class="term"><code class="option">sections</code></span></p></td>
  88 <td><p>
  89 Lists sections containing resources. This is only interesting if
  90 <em class="replaceable"><code>FILE</code></em> is an elf file.
  91 </p></td>
  92 </tr>
  93 <tr>
  94 <td><p><span class="term"><code class="option">help</code></span></p></td>
  95 <td><p>
  96 Prints help and exits.
  97 </p></td>
  98 </tr>
  99 </tbody>
 100 </table></div>
 101 </div>
 102 </div>
 103 </div>
 104 <div class="footer">
 105 <hr>
 106           Generated by GTK-Doc V1.18</div>
 107 </body>
 108 </html>