Debian Codegraph @

docs/debspawn-update.1.xml

raw
1 <?xml version='1.0' encoding='ISO-8859-1'?>
2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4
5 <!ENTITY date "<date>18 August, 2018</date>">
6
7 <!ENTITY pagename "debspawn-update">
8 <!ENTITY command "debspawn update">
9 ]>
10
11 <refentry>
12 <refentryinfo>
13 <title>&command;</title>
14 <copyright>
15 <year>2018-2022</year>
16 <holder>Matthias Klumpp</holder>
17 </copyright>
18 <productname>Debspawn</productname>
19 &date;
20 </refentryinfo>
21
22 <refmeta>
23 <refentrytitle>&pagename;</refentrytitle>
24 <manvolnum>1</manvolnum>
25 </refmeta>
26 <refnamediv>
27 <refname>&pagename;</refname>
28 <refpurpose>Update a container image</refpurpose>
29 </refnamediv>
30
31 <refsynopsisdiv>
32 <cmdsynopsis>
33 <command>&command;</command>
34 @UPDATE_FLAGS_SYNOPSIS@
35 <arg choice="req">NAME</arg>
36 </cmdsynopsis>
37 </refsynopsisdiv>
38
39 <refsect1>
40 <title>Description</title>
41 <para>
42 Update a container base image. This achieves the same thing as running <command>apt update &amp;&amp; apt full-upgrade</command> on the base
43 image and making the changes permanent. Additionally, <command>&command;</command> will prune all caches and ensure all required packages and
44 scripts are installed in the container image.
45 </para>
46 <para>
47 Running <command>&command;</command> on the images that are in use about once a week ensures builds will happen faster, due to less changes
48 that have to be done prior to each build.
49 </para>
50 </refsect1>
51
52 <refsect1>
53 <title>Examples</title>
54 <para>
55 Updating images is easy, you just pass the same arguments you used for creating them, but use the <command>update</command> subcommand instead:
56 </para>
57 <screen>
58 <prompt>$</prompt> <command>&command;</command> sid
59 <prompt>$</prompt> <command>&command;</command> --arch=i386 cosmic
60 </screen>
61 </refsect1>
62
63 <refsect1>
64 <title>Options</title>
65
66 <variablelist>
67 <varlistentry>
68 <term>NAME</term>
69 <listitem><para>The name of the container image (usually a distribution suite name).</para></listitem>
70 </varlistentry>
71
72 @UPDATE_FLAGS_ENTRIES@
73 </variablelist>
74 </refsect1>
75
76 <refsect1>
77 <title>See Also</title>
78 <para>debspawn-create(1), debspawn-build(1).</para>
79 </refsect1>
80 <refsect1>
81 <title>AUTHOR</title>
82 <para>
83 This manual page was written by Matthias Klumpp <email>[email protected]</email>.
84 </para>
85 </refsect1>
86 </refentry>