Adding upstream version 20190202.upstream/20190202

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 510 insertions, 0 deletions

diff --git a/system-boot/manpages/pot/persistence.conf.5.pot b/system-boot/manpages/pot/persistence.conf.5.pot
new file mode 100644
index 0000000..821fca3
--- /dev/null
+++ b/system-boot/manpages/pot/persistence.conf.5.pot
@@ -0,0 +1,510 @@
+# SOME DESCRIPTIVE TITLE
+# Copyright (C) YEAR Free Software Foundation, Inc.
+# This file is distributed under the same license as the live-boot package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: live-boot 5.0~a5-1\n"
+"POT-Creation-Date: 2015-09-22 10:09+0200\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"Language: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=CHARSET\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. type: TH
+#: en/live-boot.7:1 en/persistence.conf.5:1
+#, no-wrap
+msgid "LIVE-BOOT"
+msgstr ""
+
+#. type: TH
+#: en/live-boot.7:1 en/persistence.conf.5:1
+#, no-wrap
+msgid "2015-09-22"
+msgstr ""
+
+#. type: TH
+#: en/live-boot.7:1 en/persistence.conf.5:1
+#, no-wrap
+msgid "5.0~a5-1"
+msgstr ""
+
+#. type: TH
+#: en/live-boot.7:1 en/persistence.conf.5:1
+#, no-wrap
+msgid "Live Systems Project"
+msgstr ""
+
+#. type: SH
+#: en/live-boot.7:3 en/persistence.conf.5:3
+#, no-wrap
+msgid "NAME"
+msgstr ""
+
+#. type: SH
+#: en/live-boot.7:6 en/persistence.conf.5:7
+#, no-wrap
+msgid "DESCRIPTION"
+msgstr ""
+
+#. type: SH
+#: en/live-boot.7:28 en/persistence.conf.5:57
+#, no-wrap
+msgid "OPTIONS"
+msgstr ""
+
+#. type: SH
+#: en/live-boot.7:154 en/persistence.conf.5:190
+#, no-wrap
+msgid "SEE ALSO"
+msgstr ""
+
+#. type: Plain text
+#: en/live-boot.7:158 en/persistence.conf.5:194
+msgid "I<live-build>(7)"
+msgstr ""
+
+#. type: Plain text
+#: en/live-boot.7:160 en/persistence.conf.5:196
+msgid "I<live-config>(7)"
+msgstr ""
+
+#. type: Plain text
+#: en/live-boot.7:162 en/persistence.conf.5:198
+msgid "I<live-tools>(7)"
+msgstr ""
+
+#. type: SH
+#: en/live-boot.7:163 en/persistence.conf.5:199
+#, no-wrap
+msgid "HOMEPAGE"
+msgstr ""
+
+#. type: Plain text
+#: en/live-boot.7:165 en/persistence.conf.5:201
+msgid ""
+"More information about live-boot and the Live Systems project can be found "
+"on the homepage at E<lt>I<http://live-systems.org/>E<gt> and in the manual "
+"at E<lt>I<http://live-systems.org/manual/>E<gt>."
+msgstr ""
+
+#. type: SH
+#: en/live-boot.7:166 en/persistence.conf.5:202
+#, no-wrap
+msgid "BUGS"
+msgstr ""
+
+#. type: Plain text
+#: en/live-boot.7:168 en/persistence.conf.5:204
+msgid ""
+"Bugs can be reported by submitting a bugreport for the live-boot package in "
+"the Bug Tracking System at E<lt>I<http://bugs.debian.org/>E<gt> or by "
+"writing a mail to the Live Systems mailing list at E<lt>I<debian-live@lists."
+"debian.org>E<gt>."
+msgstr ""
+
+#. type: SH
+#: en/live-boot.7:169 en/persistence.conf.5:205
+#, no-wrap
+msgid "AUTHOR"
+msgstr ""
+
+#. type: Plain text
+#: en/live-boot.7:170 en/persistence.conf.5:206
+msgid ""
+"live-boot was written by Daniel Baumann E<lt>I<mail@daniel-baumann.ch>E<gt>."
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:6
+msgid ""
+"B<persistence.conf> - Configuration file for persistence media in live-boot"
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:13
+msgid ""
+"If live-boot probes a persistence volume with the label (or GPT name, or "
+"file name, but from now on we will just say \"label\") \"persistence\", that "
+"volume's persistence is fully customizable through the B<persistence.conf> "
+"file stored on the root of its file system. Any such labeled volume must "
+"have such a file, or it will be ignored."
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:17
+msgid ""
+"The format of B<persistence.conf> allows empty lines and lines starting with "
+"a \"#\" (used for comments), both which will be ignored. A so called "
+"\"custom mount\" has the format:"
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:20
+msgid "I<DIR> [I<OPTION>]..."
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:24
+msgid ""
+"which roughly translates to \"make I<DIR> persistence in the way described "
+"by the list of I<OPTION>s\"."
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:35
+msgid ""
+"For each custom mount I<DIR> must be an absolute path that cannot contain "
+"white spaces or the special . and .. path components, and cannot be /live "
+"(or any of its sub-directories).  Once activated all changes (file deletion, "
+"creation and modification) to I<DIR> on the live file system are stored "
+"persistently into a path equivalent to I<DIR> on the persistence media, "
+"called the source directory. The default way to achieve persistence is to "
+"simply bind-mount the corresponding source directory to I<DIR>, but this can "
+"be changed through the use of I<OPTION>s."
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:48
+msgid ""
+"All custom mounts will be done in an order so that no two custom mounts can "
+"\"hide\" each other. For instance, if we have the two I<DIR>:s /a and /a/b "
+"it would always be the case that /a is mounted first, then /a/b. This "
+"remains true no matter how the lines in B<persistence.conf> are ordered, or "
+"if several B<persistence.conf> files on different persistence media are used "
+"at the same time. However, it is forbidden for custom mounts to have their "
+"source directory inside the source directory of another custom mount, so the "
+"source directories that are auto-created by live-boot does not support "
+"\"nested\" mounts like /a and /a/b on the same media. In this case you must "
+"use the B<source> option (see below) to make sure that they are stored in "
+"different source directories."
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:56
+msgid ""
+"When a source directory doesn't exist on the persistence media for a certain "
+"custom mount, it will be created automatically, and permissions and "
+"ownership will be optimistically set according to I<DIR>. It will also be "
+"bootstrapped by copying the contents of the I<DIR> into its source directory "
+"on the persistence media. The bootstrapping will not happen when the B<link> "
+"or B<union> options are used (see below)."
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:60
+msgid ""
+"Custom mounts defined in B<persistence.conf> accept the following options in "
+"a comma-separated list:"
+msgstr ""
+
+#. type: IP
+#: en/persistence.conf.5:60
+#, no-wrap
+msgid "B<source>=I<PATH>"
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:69
+msgid ""
+"When given, store the persistence changes into I<PATH> on the persistence "
+"media. I<PATH> must be a relative path (with respect to the persistence "
+"media root) that cannot contain white spaces or the special . or .. path "
+"components, with the exception that it can be just . which means the "
+"persistence media root. This option is mostly relevant if you want to nest "
+"custom mounts, which otherwise would cause errors, or if you want to make "
+"the whole media root available (similar to the now deprecated B<home-rw> "
+"type of persistence)."
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:72
+msgid ""
+"The following options are mutually exclusive (only the last given one will "
+"be in effect):"
+msgstr ""
+
+#. type: IP
+#: en/persistence.conf.5:72
+#, no-wrap
+msgid "B<bind>"
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:74
+msgid "Bind-mount the source directory to I<DIR>. This is the default."
+msgstr ""
+
+#. type: IP
+#: en/persistence.conf.5:74
+#, no-wrap
+msgid "B<link>"
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:83
+msgid ""
+"Create the directory structure of the source directory on the persistence "
+"media in I<DIR> and create symbolic links from the corresponding place in "
+"I<DIR> to each file in the source directory.  Existing files or directories "
+"with the same name as any link will be overwritten. Note that deleting the "
+"links in I<DIR> will only remove the link, not the corresponding file in the "
+"source; removed links will reappear after a reboot. To permanently add or "
+"delete a file one must do so directly in the source directory."
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:91
+msgid ""
+"Effectively B<link> will make only files already in the source directory "
+"persistent, not any other files in I<DIR>. These files must be manually "
+"added to the source directory to make use of this option, and they will "
+"appear in I<DIR> in addition to files already there. This option is useful "
+"when only certain files need to be persistent, not the whole directory "
+"they're in, e.g. some configuration files in a user's home directory."
+msgstr ""
+
+#. type: IP
+#: en/persistence.conf.5:91
+#, no-wrap
+msgid "B<union>"
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:100
+msgid ""
+"Save the rw branch of a union on the persistence media, so only the changes "
+"are stored persistently. This can potentially reduce disk usage compared to "
+"bind-mounts, and will not hide files added to the read-only media. One "
+"caveat is that the union will use I<DIR> from the image's read-only file "
+"system, not the real file system root, so files created after boot (e.g. by "
+"live-config) will not appear in the union. This option will use the union "
+"file system specified by live-boot's B<union> boot parameter."
+msgstr ""
+
+#. type: SH
+#: en/persistence.conf.5:101
+#, no-wrap
+msgid "DIRECTORIES"
+msgstr ""
+
+#. type: IP
+#: en/persistence.conf.5:102
+#, no-wrap
+msgid "B</live/persistence>"
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:108
+msgid ""
+"All persistence volumes will be mounted here (in a directory corresponding "
+"to the device name). The B<persistence.conf> file can easily be edited "
+"through this mount, as well as any source directories (which is especially "
+"practical for custom mounts using the B<link> option)."
+msgstr ""
+
+#. type: SH
+#: en/persistence.conf.5:109
+#, no-wrap
+msgid "EXAMPLES"
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:114
+msgid ""
+"Let's say we have a persistence volume I<VOL> with the a B<persistence.conf> "
+"file containing the following four lines (numbered for ease of reference):"
+msgstr ""
+
+#. type: TP
+#: en/persistence.conf.5:114 en/persistence.conf.5:128
+#, no-wrap
+msgid "1."
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:117
+msgid "/home/user1 link,source=config-files/user1"
+msgstr ""
+
+#. type: TP
+#: en/persistence.conf.5:117 en/persistence.conf.5:132
+#, no-wrap
+msgid "2."
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:120
+msgid "/home/user2 link,source=config-files/user2"
+msgstr ""
+
+#. type: TP
+#: en/persistence.conf.5:120 en/persistence.conf.5:136
+#, no-wrap
+msgid "3."
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:123
+msgid "/home"
+msgstr ""
+
+#. type: TP
+#: en/persistence.conf.5:123 en/persistence.conf.5:139
+#, no-wrap
+msgid "4."
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:126
+msgid "/usr union"
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:128
+msgid "The corresponding source directories are:"
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:132
+msgid ""
+"I<VOL>/config-files/user1 (but it would be I<VOL>/home/user1 without the "
+"B<source> option)"
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:136
+msgid ""
+"I<VOL>/config-files/user2 (but it would be I<VOL>/home/user2 without the "
+"B<source> option)"
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:139
+msgid "I<VOL>/home"
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:142
+msgid "I<VOL>/usr"
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:145
+msgid ""
+"It was necessary to set the B<source> options for 1 and 2, since they "
+"otherwise would become nested with 3's source, which is invalid."
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:150
+msgid ""
+"Line 3 will be taken care of before line 1 and 2 in order to prevent custom "
+"mounts 1 and 2 from being hidden by 3. When line 3 is handled, I<VOL>/home "
+"is simply bind-mounted on /home. To illustrate what happens for lines 1 and "
+"2, let's say that the following files exist:"
+msgstr ""
+
+#. type: TP
+#: en/persistence.conf.5:150
+#, no-wrap
+msgid "a."
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:153
+msgid "I<VOL>/config-files/user1/.emacs"
+msgstr ""
+
+#. type: TP
+#: en/persistence.conf.5:153
+#, no-wrap
+msgid "b."
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:156
+msgid "I<VOL>/config-files/user2/.bashrc"
+msgstr ""
+
+#. type: TP
+#: en/persistence.conf.5:156
+#, no-wrap
+msgid "c."
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:159
+msgid "I<VOL>/config-files/user2/.ssh/config"
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:161
+msgid "Then the following links and directories will be created:"
+msgstr ""
+
+#. type: TP
+#: en/persistence.conf.5:161 en/persistence.conf.5:164
+#: en/persistence.conf.5:170
+#, no-wrap
+msgid "Link:"
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:164
+msgid "/home/user1/.emacs -E<gt> I<VOL>/config-files/user1/.emacs (from a)"
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:167
+msgid "/home/user2/.bashrc -E<gt> I<VOL>/config-files/user2/.bashrc (from b)"
+msgstr ""
+
+#. type: TP
+#: en/persistence.conf.5:167
+#, no-wrap
+msgid "Dir:"
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:170
+msgid "/homea/user2/.ssh (from c)"
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:174
+msgid ""
+"/home/user2/.ssh/config -E<gt> I<VOL>/config-files/user2/.ssh/config (from c)"
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:180
+msgid ""
+"One could argue, though, that lines 1 and 2 in the example B<persistence."
+"conf> file above are unnecessary since line 3 already would make all of /"
+"home persistent. The B<link> option is intended for situations where you "
+"don't want a complete directory to be persistent, only certain files in it "
+"or its sub-directories."
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:189
+msgid ""
+"Line 4 can be mounted at any time since its I<DIR> (and source directory) is "
+"completely disjoint from all the other custom mounts. When mounted, I<VOL>/"
+"usr will be the rw branch due to the B<union> option, and will only contain "
+"the difference compared to the underlying read-only file system. Hence "
+"packages could be installed into /usr with great space-wise efficiency "
+"compared to bind-mounts, since in the latter case all of /usr would have to "
+"be copied into I<VOL>/usr during the initial bootstrap."
+msgstr ""
+
+#. type: Plain text
+#: en/persistence.conf.5:192
+msgid "I<live-boot>(7)"
+msgstr ""