Debian Codegraph @

docs/debspawn-maintain.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-maintain">
8 <!ENTITY command "debspawn maintain">
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>Run various maintenance actions</refpurpose>
29 </refnamediv>
30
31 <refsynopsisdiv>
32 <cmdsynopsis>
33 <command>&command;</command>
34 @MAINTAIN_FLAGS_SYNOPSIS@
35 </cmdsynopsis>
36 </refsynopsisdiv>
37
38 <refsect1>
39 <title>Description</title>
40 <para>
41 Perform various maintenance actions on <command>debspawn</command>. Actions this subcommand allows
42 will affect generic settings of <command>debspawn</command> or all of its container images at once.
43 It can also be used to display general, useful information about the system and
44 <command>debspawn</command> installation to help with finding setup issues.
45 </para>
46 </refsect1>
47
48 <refsect1>
49 <title>Examples</title>
50 <para>
51 You can update all container images that <command>debspawn</command> knows of in one go:
52 </para>
53 <para>
54 <prompt>$</prompt> <command>&command;</command> --update-all
55 </para>
56 <para>
57 If you want to get information about the current <command>debspawn</command> installation
58 (useful when reporting an issue against it), the <option>--status</option> option will print a
59 status summary and highlight issues:
60 </para>
61 <para>
62 <prompt>$</prompt> <command>&command;</command> --status
63 </para>
64 <para>
65 You can clear all caches for all images to free up disk space (missing data will be downloaded
66 or regenerated again when it is needed):
67 </para>
68 <para>
69 <prompt>$</prompt> <command>&command;</command> --clear-caches
70 </para>
71 </refsect1>
72
73 <refsect1>
74 <title>Options</title>
75
76 <variablelist>
77 @MAINTAIN_FLAGS_ENTRIES@
78 </variablelist>
79 </refsect1>
80
81 <refsect1>
82 <title>See Also</title>
83 <para>debspawn-build(1), debootstrap(1), systemd-nspawn(1).</para>
84 </refsect1>
85 <refsect1>
86 <title>AUTHOR</title>
87 <para>
88 This manual page was written by Matthias Klumpp <email>[email protected]</email>.
89 </para>
90 </refsect1>
91 </refentry>