New upstream version 2019.3

2019-08-23 08:37:51 +01:00
commit 1b51e1d9d0
@@ -770,6 +770,14 @@
 <span class="returnvalue">gboolean</span>
 </td>
 <td class="function_name">
+<a class="link" href="ostree-OstreeRepo.html#ostree-repo-write-archive-to-mtree-from-fd" title="ostree_repo_write_archive_to_mtree_from_fd ()">ostree_repo_write_archive_to_mtree_from_fd</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">gboolean</span>
+</td>
+<td class="function_name">
 <a class="link" href="ostree-OstreeRepo.html#ostree-repo-write-mtree" title="ostree_repo_write_mtree ()">ostree_repo_write_mtree</a> <span class="c_punctuation">()</span>
 </td>
 </tr>
@@ -1279,6 +1287,33 @@ collection IDs, see <code class="function">ostree_validate_collection_id()</code
 ostree_repo_mode_from_string (<em class="parameter"><code>const <span class="type">char</span> *mode</code></em>,
                              <em class="parameter"><code><a class="link" href="ostree-OstreeRepo.html#OstreeRepoMode" title="enum OstreeRepoMode"><span class="type">OstreeRepoMode</span></a> *out_mode</code></em>,
                              <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
+<div class="refsect3">
+<a name="ostree-repo-mode-from-string.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>mode</p></td>
+<td class="parameter_description"><p>a repo mode as a string</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>out_mode</p></td>
+<td class="parameter_description"><p>the corresponding <a class="link" href="ostree-OstreeRepo.html#OstreeRepoMode" title="enum OstreeRepoMode"><span class="type">OstreeRepoMode</span></a>. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>error</p></td>
+<td class="parameter_description"><p>a <span class="type">GError</span> if the string is not a valid mode</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
 </div>
 <hr>
 <div class="refsect2">
@@ -1320,6 +1355,7 @@ already extant repository.  If you want to create one, use <a class="link" href=
 . </p>
 <p><span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span></p>
 </div>
+<p class="since">Since: 2017.10</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1598,6 +1634,7 @@ the mode or configuration (<code class="literal">repo/config</code>) of an exist
 <p>A new OSTree repository reference. </p>
 <p><span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span></p>
 </div>
+<p class="since">Since: 2017.10</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1721,6 +1758,43 @@ ostree_repo_get_mode (<em class="parameter"><code><a class="link" href="ostree-O
 ostree_repo_get_min_free_space_bytes (<em class="parameter"><code><a class="link" href="ostree-OstreeRepo.html#OstreeRepo" title="OstreeRepo"><span class="type">OstreeRepo</span></a> *self</code></em>,
                                      <em class="parameter"><code><span class="type">guint64</span> *out_reserved_bytes</code></em>,
                                      <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
+<p>Determine the number of bytes of free disk space that are reserved according
+to the repo config and return that number in <em class="parameter"><code>out_reserved_bytes</code></em>
+. See the
+documentation for the core.min-free-space-size and
+core.min-free-space-percent repo config options.</p>
+<div class="refsect3">
+<a name="ostree-repo-get-min-free-space-bytes.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>self</p></td>
+<td class="parameter_description"><p>Repo</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>out_reserved_bytes</p></td>
+<td class="parameter_description"><p>Location to store the result. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>error</p></td>
+<td class="parameter_description"><p>Return location for a <span class="type">GError</span></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="ostree-repo-get-min-free-space-bytes.returns"></a><h4>Returns</h4>
+<p> <code class="literal">TRUE</code> on success, <code class="literal">FALSE</code> otherwise.</p>
+</div>
+<p class="since">Since: 2018.9</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1762,6 +1836,7 @@ repository (to see whether a ref was written).</p>
 <p> File descriptor for repository root - owned by <em class="parameter"><code>self</code></em>
 </p>
 </div>
+<p class="since">Since: 2016.4</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2283,18 +2358,18 @@ from the remote named <em class="parameter"><code>name</code></em>
 <tr>
 <td class="parameter_name"><p>source_stream</p></td>
 <td class="parameter_description"><p>a <span class="type">GInputStream</span>, or <code class="literal">NULL</code>. </p></td>
-<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span></td>
+<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/nullable"><span class="acronym">nullable</span></a>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>key_ids</p></td>
 <td class="parameter_description"><p>a <code class="literal">NULL</code>-terminated array of GPG key IDs, or <code class="literal">NULL</code>. </p></td>
-<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/array"><span class="acronym">array</span></a> zero-terminated=1][<a href="http://foldoc.org/element-type"><span class="acronym">element-type</span></a> utf8][<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span></td>
+<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/array"><span class="acronym">array</span></a> zero-terminated=1][<a href="http://foldoc.org/element-type"><span class="acronym">element-type</span></a> utf8][<a href="http://foldoc.org/nullable"><span class="acronym">nullable</span></a>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>out_imported</p></td>
 <td class="parameter_description"><p>return location for the number of imported
 keys, or <code class="literal">NULL</code>. </p></td>
-<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span></td>
+<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>][<a href="http://foldoc.org/optional"><span class="acronym">optional</span></a>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>cancellable</p></td>
@@ -2464,6 +2539,7 @@ signature data, or <code class="literal">NULL</code>. </p></td>
 <a name="ostree-repo-remote-fetch-summary-with-options.returns"></a><h4>Returns</h4>
 <p> <code class="literal">TRUE</code> on success, <code class="literal">FALSE</code> on failure</p>
 </div>
+<p class="since">Since: 2016.6</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2501,6 +2577,7 @@ own repo/config data.  This API can be used to reload it.</p>
 </tbody>
 </table></div>
 </div>
+<p class="since">Since: 2017.2</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2569,6 +2646,7 @@ is not present</p></td>
 <p> <code class="literal">TRUE</code> on success, otherwise <code class="literal">FALSE</code> with <em class="parameter"><code>error</code></em>
 set</p>
 </div>
+<p class="since">Since: 2016.5</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2630,6 +2708,7 @@ of strings. The list should be freed with
 <p> <code class="literal">TRUE</code> on success, otherwise <code class="literal">FALSE</code> with <em class="parameter"><code>error</code></em>
 set</p>
 </div>
+<p class="since">Since: 2016.5</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -2696,6 +2775,7 @@ is not present. </p></td>
 <p> <code class="literal">TRUE</code> on success, otherwise <code class="literal">FALSE</code> with <em class="parameter"><code>error</code></em>
 set</p>
 </div>
+<p class="since">Since: 2016.5</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -3170,6 +3250,7 @@ ostree_repo_set_alias_ref_immediate (<em class="parameter"><code><a class="link"
 </tbody>
 </table></div>
 </div>
+<p class="since">Since: 2017.10</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -3222,6 +3303,7 @@ write permissions in the repo, where the cache is normally stored.</p>
 </tbody>
 </table></div>
 </div>
+<p class="since">Since: 2016.5</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -4032,6 +4114,7 @@ is true and it does not exist. </p></td>
 </tbody>
 </table></div>
 </div>
+<p class="since">Since: 2016.7</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -4154,6 +4237,7 @@ remote name) to checksums. Differently from <a class="link" href="ostree-OstreeR
 </tbody>
 </table></div>
 </div>
+<p class="since">Since: 2016.4</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -4668,6 +4752,7 @@ this will simply be a fast Unix hard link operation.</p>
 </tbody>
 </table></div>
 </div>
+<p class="since">Since: 2016.5</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -5357,6 +5442,70 @@ file structure to <em class="parameter"><code>mtree</code></em>
 </div>
 <hr>
 <div class="refsect2">
+<a name="ostree-repo-write-archive-to-mtree-from-fd"></a><h3>ostree_repo_write_archive_to_mtree_from_fd ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
+ostree_repo_write_archive_to_mtree_from_fd
+                               (<em class="parameter"><code><a class="link" href="ostree-OstreeRepo.html#OstreeRepo" title="OstreeRepo"><span class="type">OstreeRepo</span></a> *self</code></em>,
+                                <em class="parameter"><code><span class="type">int</span> fd</code></em>,
+                                <em class="parameter"><code><a class="link" href="ostree-In-memory-modifiable-filesystem-tree.html#OstreeMutableTree" title="OstreeMutableTree"><span class="type">OstreeMutableTree</span></a> *mtree</code></em>,
+                                <em class="parameter"><code><a class="link" href="ostree-OstreeRepo.html#OstreeRepoCommitModifier" title="OstreeRepoCommitModifier"><span class="type">OstreeRepoCommitModifier</span></a> *modifier</code></em>,
+                                <em class="parameter"><code><span class="type">gboolean</span> autocreate_parents</code></em>,
+                                <em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
+                                <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
+<p>Read an archive from <em class="parameter"><code>fd</code></em>
+ and import it into the repository, writing
+its file structure to <em class="parameter"><code>mtree</code></em>
+.</p>
+<div class="refsect3">
+<a name="ostree-repo-write-archive-to-mtree-from-fd.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>self</p></td>
+<td class="parameter_description"><p>An <a class="link" href="ostree-OstreeRepo.html#OstreeRepo" title="OstreeRepo"><span class="type">OstreeRepo</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>fd</p></td>
+<td class="parameter_description"><p>A file descriptor to read the archive from</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>mtree</p></td>
+<td class="parameter_description"><p>The <a class="link" href="ostree-In-memory-modifiable-filesystem-tree.html#OstreeMutableTree" title="OstreeMutableTree"><span class="type">OstreeMutableTree</span></a> to write to</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>modifier</p></td>
+<td class="parameter_description"><p>Optional commit modifier. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span></td>
+</tr>
+<tr>
+<td class="parameter_name"><p>autocreate_parents</p></td>
+<td class="parameter_description"><p>Autocreate parent directories</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>cancellable</p></td>
+<td class="parameter_description"><p>Cancellable</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>error</p></td>
+<td class="parameter_description"><p>Error</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+</div>
+<hr>
+<div class="refsect2">
 <a name="ostree-repo-write-mtree"></a><h3>ostree_repo_write_mtree ()</h3>
 <pre class="programlisting"><span class="returnvalue">gboolean</span>
 ostree_repo_write_mtree (<em class="parameter"><code><a class="link" href="ostree-OstreeRepo.html#OstreeRepo" title="OstreeRepo"><span class="type">OstreeRepo</span></a> *self</code></em>,
@@ -5708,6 +5857,7 @@ ostree_repo_checkout_at_options_set_devino
 </tbody>
 </table></div>
 </div>
+<p class="since">Since: 2017.13</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -5919,6 +6069,7 @@ cache.</p>
 </tbody>
 </table></div>
 </div>
+<p class="since">Since: 2016.8</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -7029,6 +7180,7 @@ statistics on objects that would be deleted, without actually deleting them.</p>
 </tbody>
 </table></div>
 </div>
+<p class="since">Since: 2017.1</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -7535,6 +7687,7 @@ the verifications using GPG keys in the keyrings of all remotes.</p>
 <p>an <a class="link" href="ostree-GPG-signature-verification-results.html#OstreeGpgVerifyResult" title="OstreeGpgVerifyResult"><span class="type">OstreeGpgVerifyResult</span></a>, or <code class="literal">NULL</code> on error. </p>
 <p><span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span></p>
 </div>
+<p class="since">Since: 2016.6</p>
 </div>
 <hr>
 <div class="refsect2">
@@ -7713,6 +7866,7 @@ configured for <em class="parameter"><code>remote</code></em>
 <p>an <a class="link" href="ostree-GPG-signature-verification-results.html#OstreeGpgVerifyResult" title="OstreeGpgVerifyResult"><span class="type">OstreeGpgVerifyResult</span></a>, or <code class="literal">NULL</code> on error. </p>
 <p><span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span></p>
 </div>
+<p class="since">Since: 2016.14</p>
 </div>
 <hr>
 <div class="refsect2">