diff options
Diffstat (limited to 'manpages/pot/live-persistence.conf.5.pot')
| -rw-r--r-- | manpages/pot/live-persistence.conf.5.pot | 516 |
1 files changed, 516 insertions, 0 deletions
diff --git a/manpages/pot/live-persistence.conf.5.pot b/manpages/pot/live-persistence.conf.5.pot new file mode 100644 index 0000000..cf912ea --- /dev/null +++ b/manpages/pot/live-persistence.conf.5.pot @@ -0,0 +1,516 @@ +# 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 VERSION\n" +"POT-Creation-Date: 2012-04-08 22:48+0300\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/live-persistence.conf.5:1 en/live-snapshot.1:1 +#, no-wrap +msgid "LIVE-BOOT" +msgstr "" + +#. type: TH +#: en/live-boot.7:1 en/live-persistence.conf.5:1 en/live-snapshot.1:1 +#, no-wrap +msgid "2012-04-08" +msgstr "" + +#. type: TH +#: en/live-boot.7:1 en/live-persistence.conf.5:1 en/live-snapshot.1:1 +#, no-wrap +msgid "3.0~a26-1" +msgstr "" + +#. type: TH +#: en/live-boot.7:1 en/live-persistence.conf.5:1 en/live-snapshot.1:1 +#, no-wrap +msgid "Debian Live Project" +msgstr "" + +#. type: SH +#: en/live-boot.7:3 en/live-persistence.conf.5:3 en/live-snapshot.1:3 +#, no-wrap +msgid "NAME" +msgstr "" + +#. type: SH +#: en/live-boot.7:6 en/live-persistence.conf.5:7 en/live-snapshot.1:17 +#, no-wrap +msgid "DESCRIPTION" +msgstr "" + +#. type: SH +#: en/live-boot.7:28 en/live-persistence.conf.5:57 en/live-snapshot.1:20 +#, no-wrap +msgid "OPTIONS" +msgstr "" + +#. type: SH +#: en/live-boot.7:160 en/live-persistence.conf.5:191 en/live-snapshot.1:54 +#, no-wrap +msgid "SEE ALSO" +msgstr "" + +#. type: Plain text +#: en/live-boot.7:166 en/live-persistence.conf.5:195 en/live-snapshot.1:58 +msgid "I<live-build>(7)" +msgstr "" + +#. type: Plain text +#: en/live-boot.7:168 en/live-persistence.conf.5:197 en/live-snapshot.1:60 +msgid "I<live-config>(7)" +msgstr "" + +#. type: Plain text +#: en/live-boot.7:170 en/live-persistence.conf.5:199 en/live-snapshot.1:62 +msgid "I<live-tools>(7)" +msgstr "" + +#. type: SH +#: en/live-boot.7:171 en/live-persistence.conf.5:200 en/live-snapshot.1:63 +#, no-wrap +msgid "HOMEPAGE" +msgstr "" + +#. type: Plain text +#: en/live-boot.7:173 en/live-persistence.conf.5:204 en/live-snapshot.1:65 +msgid "" +"More information about live-boot and the Debian Live project can be found on " +"the homepage at E<lt>I<http://live.debian.net/>E<gt> and in the manual at " +"E<lt>I<http://live.debian.net/manual/>E<gt>." +msgstr "" + +#. type: SH +#: en/live-boot.7:174 en/live-persistence.conf.5:205 en/live-snapshot.1:66 +#, no-wrap +msgid "BUGS" +msgstr "" + +#. type: Plain text +#: en/live-boot.7:176 en/live-persistence.conf.5:210 en/live-snapshot.1:68 +msgid "" +"Bugs can be reported by submitting a bugreport for the live-boot package in " +"the Debian Bug Tracking System at E<lt>I<http://bugs.debian.org/>E<gt> or by " +"writing a mail to the Debian Live mailing list at E<lt>I<debian-live@lists." +"debian.org>E<gt>." +msgstr "" + +#. type: SH +#: en/live-boot.7:177 en/live-persistence.conf.5:211 en/live-snapshot.1:69 +#, no-wrap +msgid "AUTHOR" +msgstr "" + +#. type: Plain text +#: en/live-persistence.conf.5:6 +msgid "" +"B<live-persistence.conf> - Configuration file for persistence media in live-" +"boot" +msgstr "" + +#. type: Plain text +#: en/live-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\") \"custom-ov\", that " +"volume's persistence is fully customizable through the B<live-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/live-persistence.conf.5:17 +msgid "" +"The format of B<live-persistence.conf> allow 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/live-persistence.conf.5:20 +msgid "I<DIR> [I<OPTION>]..." +msgstr "" + +#. type: Plain text +#: en/live-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/live-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), or / (for the latter, use \"full-ov\" " +"persistence instead). 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/live-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<live-persistence.conf> are " +"ordered, or if several B<live-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/live-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<linkfiles> or B<union> options are used (see below)." +msgstr "" + +#. type: Plain text +#: en/live-persistence.conf.5:60 +msgid "" +"Custom mounts defined in B<live-persistence.conf> accept the following " +"options in a coma-separated list:" +msgstr "" + +#. type: IP +#: en/live-persistence.conf.5:60 +#, no-wrap +msgid "B<source>=I<PATH>" +msgstr "" + +#. type: Plain text +#: en/live-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 (w.r.t. 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/live-persistence.conf.5:72 +msgid "" +"The following options are mutually exclusive (only the last given one will " +"be in effect):" +msgstr "" + +#. type: IP +#: en/live-persistence.conf.5:72 +#, no-wrap +msgid "B<bind>" +msgstr "" + +#. type: Plain text +#: en/live-persistence.conf.5:74 +msgid "Bind-mount the source directory to I<DIR>. This is the default." +msgstr "" + +#. type: IP +#: en/live-persistence.conf.5:74 +#, no-wrap +msgid "B<linkfiles>" +msgstr "" + +#. type: Plain text +#: en/live-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/live-persistence.conf.5:91 +msgid "" +"Effectively B<linkfiles> 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/live-persistence.conf.5:91 +#, no-wrap +msgid "B<union>" +msgstr "" + +#. type: Plain text +#: en/live-persistence.conf.5:101 +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, but is not " +"supported with B<union=unionmount>." +msgstr "" + +#. type: SH +#: en/live-persistence.conf.5:102 +#, no-wrap +msgid "DIRECTORIES" +msgstr "" + +#. type: IP +#: en/live-persistence.conf.5:103 +#, no-wrap +msgid "B</live/persistence>" +msgstr "" + +#. type: Plain text +#: en/live-persistence.conf.5:109 +msgid "" +"All persistence volumes will be mounted here (in a directory corresponding " +"to the device name). The B<live-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<linkfiles> option)." +msgstr "" + +#. type: SH +#: en/live-persistence.conf.5:110 +#, no-wrap +msgid "EXAMPLES" +msgstr "" + +#. type: Plain text +#: en/live-persistence.conf.5:115 +msgid "" +"Let's say we have a persistence volume I<VOL> with the a B<live-persistence." +"conf> file containing the following four lines (numbered for ease of " +"reference):" +msgstr "" + +#. type: TP +#: en/live-persistence.conf.5:115 en/live-persistence.conf.5:129 +#, no-wrap +msgid "1." +msgstr "" + +#. type: Plain text +#: en/live-persistence.conf.5:118 +msgid "/home/user1 linkfiles,source=config-files/user1" +msgstr "" + +#. type: TP +#: en/live-persistence.conf.5:118 en/live-persistence.conf.5:133 +#, no-wrap +msgid "2." +msgstr "" + +#. type: Plain text +#: en/live-persistence.conf.5:121 +msgid "/home/user2 linkfiles,source=config-files/user2" +msgstr "" + +#. type: TP +#: en/live-persistence.conf.5:121 en/live-persistence.conf.5:137 +#, no-wrap +msgid "3." +msgstr "" + +#. type: Plain text +#: en/live-persistence.conf.5:124 +msgid "/home" +msgstr "" + +#. type: TP +#: en/live-persistence.conf.5:124 en/live-persistence.conf.5:140 +#, no-wrap +msgid "4." +msgstr "" + +#. type: Plain text +#: en/live-persistence.conf.5:127 +msgid "/usr union" +msgstr "" + +#. type: Plain text +#: en/live-persistence.conf.5:129 +msgid "The corresponding source directories are:" +msgstr "" + +#. type: Plain text +#: en/live-persistence.conf.5:133 +msgid "" +"I<VOL>/config-files/user1 (but it would be I<VOL>/home/user1 without the " +"B<source> option)" +msgstr "" + +#. type: Plain text +#: en/live-persistence.conf.5:137 +msgid "" +"I<VOL>/config-files/user2 (but it would be I<VOL>/home/user2 without the " +"B<source> option)" +msgstr "" + +#. type: Plain text +#: en/live-persistence.conf.5:140 +msgid "I<VOL>/home" +msgstr "" + +#. type: Plain text +#: en/live-persistence.conf.5:143 +msgid "I<VOL>/usr" +msgstr "" + +#. type: Plain text +#: en/live-persistence.conf.5:146 +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/live-persistence.conf.5:151 +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/live-persistence.conf.5:151 +#, no-wrap +msgid "a." +msgstr "" + +#. type: Plain text +#: en/live-persistence.conf.5:154 +msgid "I<VOL>/config-files/user1/.emacs" +msgstr "" + +#. type: TP +#: en/live-persistence.conf.5:154 +#, no-wrap +msgid "b." +msgstr "" + +#. type: Plain text +#: en/live-persistence.conf.5:157 +msgid "I<VOL>/config-files/user2/.bashrc" +msgstr "" + +#. type: TP +#: en/live-persistence.conf.5:157 +#, no-wrap +msgid "c." +msgstr "" + +#. type: Plain text +#: en/live-persistence.conf.5:160 +msgid "I<VOL>/config-files/user2/.ssh/config" +msgstr "" + +#. type: Plain text +#: en/live-persistence.conf.5:162 +msgid "Then the following links and directories will be created:" +msgstr "" + +#. type: TP +#: en/live-persistence.conf.5:162 en/live-persistence.conf.5:165 +#: en/live-persistence.conf.5:171 +#, no-wrap +msgid "Link:" +msgstr "" + +#. type: Plain text +#: en/live-persistence.conf.5:165 +msgid "/home/user1/.emacs -E<gt> I<VOL>/config-files/user1/.emacs (from a)" +msgstr "" + +#. type: Plain text +#: en/live-persistence.conf.5:168 +msgid "/home/user2/.bashrc -E<gt> I<VOL>/config-files/user2/.bashrc (from b)" +msgstr "" + +#. type: TP +#: en/live-persistence.conf.5:168 +#, no-wrap +msgid "Dir:" +msgstr "" + +#. type: Plain text +#: en/live-persistence.conf.5:171 +msgid "/homea/user2/.ssh (from c)" +msgstr "" + +#. type: Plain text +#: en/live-persistence.conf.5:175 +msgid "" +"/home/user2/.ssh/config -E<gt> I<VOL>/config-files/user2/.ssh/config (from c)" +msgstr "" + +#. type: Plain text +#: en/live-persistence.conf.5:181 +msgid "" +"One could argue, though, that lines 1 and 2 in the example B<live-" +"persistence.conf> file above are unnecessary since line 3 already would make " +"all of /home persistent. The B<linkfiles> 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/live-persistence.conf.5:190 +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/live-persistence.conf.5:193 +msgid "I<live-boot>(7)" +msgstr "" + +#. type: Plain text +#: en/live-persistence.conf.5:213 +msgid "" +"live.persist was written by anonym E<lt>I<anonym@lavabit.com>E<gt> for the " +"Debian project." +msgstr "" |