manpages/pot/persistence.conf.5.pot

   1 # SOME DESCRIPTIVE TITLE
   2 # Copyright (C) YEAR Free Software Foundation, Inc.
   3 # This file is distributed under the same license as the live-boot package.
   4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
   5 #
   6 #, fuzzy
   7 msgid ""
   8 msgstr ""
   9 "Project-Id-Version: live-boot VERSION\n"
  10 "POT-Creation-Date: 2014-03-31 21:39+0200\n"
  11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  13 "Language-Team: LANGUAGE <LL@li.org>\n"
  14 "Language: \n"
  15 "MIME-Version: 1.0\n"
  16 "Content-Type: text/plain; charset=CHARSET\n"
  17 "Content-Transfer-Encoding: 8bit\n"
  18
  19 #. type: TH
  20 #: en/live-boot.7:1 en/persistence.conf.5:1
  21 #, no-wrap
  22 msgid "LIVE-BOOT"
  23 msgstr ""
  24
  25 #. type: TH
  26 #: en/live-boot.7:1 en/persistence.conf.5:1
  27 #, no-wrap
  28 msgid "2014-03-31"
  29 msgstr ""
  30
  31 #. type: TH
  32 #: en/live-boot.7:1 en/persistence.conf.5:1
  33 #, no-wrap
  34 msgid "4.0~alpha20-1"
  35 msgstr ""
  36
  37 #. type: TH
  38 #: en/live-boot.7:1 en/persistence.conf.5:1
  39 #, no-wrap
  40 msgid "Live Systems Project"
  41 msgstr ""
  42
  43 #. type: SH
  44 #: en/live-boot.7:3 en/persistence.conf.5:3
  45 #, no-wrap
  46 msgid "NAME"
  47 msgstr ""
  48
  49 #. type: SH
  50 #: en/live-boot.7:6 en/persistence.conf.5:7
  51 #, no-wrap
  52 msgid "DESCRIPTION"
  53 msgstr ""
  54
  55 #. type: SH
  56 #: en/live-boot.7:28 en/persistence.conf.5:57
  57 #, no-wrap
  58 msgid "OPTIONS"
  59 msgstr ""
  60
  61 #. type: SH
  62 #: en/live-boot.7:154 en/persistence.conf.5:191
  63 #, no-wrap
  64 msgid "SEE ALSO"
  65 msgstr ""
  66
  67 #. type: Plain text
  68 #: en/live-boot.7:158 en/persistence.conf.5:195
  69 msgid "I<live-build>(7)"
  70 msgstr ""
  71
  72 #. type: Plain text
  73 #: en/live-boot.7:160 en/persistence.conf.5:197
  74 msgid "I<live-config>(7)"
  75 msgstr ""
  76
  77 #. type: Plain text
  78 #: en/live-boot.7:162 en/persistence.conf.5:199
  79 msgid "I<live-tools>(7)"
  80 msgstr ""
  81
  82 #. type: SH
  83 #: en/live-boot.7:163 en/persistence.conf.5:200
  84 #, no-wrap
  85 msgid "HOMEPAGE"
  86 msgstr ""
  87
  88 #. type: Plain text
  89 #: en/live-boot.7:165 en/persistence.conf.5:202
  90 msgid ""
  91 "More information about live-boot and the Live Systems project can be found "
  92 "on the homepage at E<lt>I<http://live-systems.org/>E<gt> and in the manual "
  93 "at E<lt>I<http://live-systems.org/manual/>E<gt>."
  94 msgstr ""
  95
  96 #. type: SH
  97 #: en/live-boot.7:166 en/persistence.conf.5:203
  98 #, no-wrap
  99 msgid "BUGS"
 100 msgstr ""
 101
 102 #. type: Plain text
 103 #: en/live-boot.7:168 en/persistence.conf.5:205
 104 msgid ""
 105 "Bugs can be reported by submitting a bugreport for the live-boot package in "
 106 "the Bug Tracking System at E<lt>I<http://bugs.debian.org/>E<gt> or by "
 107 "writing a mail to the Live Systems mailing list at E<lt>I<debian-live@lists."
 108 "debian.org>E<gt>."
 109 msgstr ""
 110
 111 #. type: SH
 112 #: en/live-boot.7:169 en/persistence.conf.5:206
 113 #, no-wrap
 114 msgid "AUTHOR"
 115 msgstr ""
 116
 117 #. type: Plain text
 118 #: en/live-boot.7:170 en/persistence.conf.5:207
 119 msgid ""
 120 "live-boot was written by Daniel Baumann E<lt>I<mail@daniel-baumann.ch>E<gt>."
 121 msgstr ""
 122
 123 #. type: Plain text
 124 #: en/persistence.conf.5:6
 125 msgid ""
 126 "B<persistence.conf> - Configuration file for persistence media in live-boot"
 127 msgstr ""
 128
 129 #. type: Plain text
 130 #: en/persistence.conf.5:13
 131 msgid ""
 132 "If live-boot probes a persistence volume with the label (or GPT name, or "
 133 "file name, but from now on we will just say \"label\") \"persistence\", that "
 134 "volume's persistence is fully customizable through the B<persistence.conf> "
 135 "file stored on the root of its file system. Any such labeled volume must "
 136 "have such a file, or it will be ignored."
 137 msgstr ""
 138
 139 #. type: Plain text
 140 #: en/persistence.conf.5:17
 141 msgid ""
 142 "The format of B<persistence.conf> allows empty lines and lines starting with "
 143 "a \"#\" (used for comments), both which will be ignored. A so called "
 144 "\"custom mount\" has the format:"
 145 msgstr ""
 146
 147 #. type: Plain text
 148 #: en/persistence.conf.5:20
 149 msgid "I<DIR> [I<OPTION>]..."
 150 msgstr ""
 151
 152 #. type: Plain text
 153 #: en/persistence.conf.5:24
 154 msgid ""
 155 "which roughly translates to \"make I<DIR> persistence in the way described "
 156 "by the list of I<OPTION>s\"."
 157 msgstr ""
 158
 159 #. type: Plain text
 160 #: en/persistence.conf.5:35
 161 msgid ""
 162 "For each custom mount I<DIR> must be an absolute path that cannot contain "
 163 "white spaces or the special . and .. path components, and cannot be /live "
 164 "(or any of its sub-directories).  Once activated all changes (file deletion, "
 165 "creation and modification) to I<DIR> on the live file system are stored "
 166 "persistently into a path equivalent to I<DIR> on the persistence media, "
 167 "called the source directory. The default way to achieve persistence is to "
 168 "simply bind-mount the corresponding source directory to I<DIR>, but this can "
 169 "be changed through the use of I<OPTION>s."
 170 msgstr ""
 171
 172 #. type: Plain text
 173 #: en/persistence.conf.5:48
 174 msgid ""
 175 "All custom mounts will be done in an order so that no two custom mounts can "
 176 "\"hide\" each other. For instance, if we have the two I<DIR>:s /a and /a/b "
 177 "it would always be the case that /a is mounted first, then /a/b. This "
 178 "remains true no matter how the lines in B<persistence.conf> are ordered, or "
 179 "if several B<persistence.conf> files on different persistence media are used "
 180 "at the same time. However, it is forbidden for custom mounts to have their "
 181 "source directory inside the source directory of another custom mount, so the "
 182 "source directories that are auto-created by live-boot does not support "
 183 "\"nested\" mounts like /a and /a/b on the same media. In this case you must "
 184 "use the B<source> option (see below) to make sure that they are stored in "
 185 "different source directories."
 186 msgstr ""
 187
 188 #. type: Plain text
 189 #: en/persistence.conf.5:56
 190 msgid ""
 191 "When a source directory doesn't exist on the persistence media for a certain "
 192 "custom mount, it will be created automatically, and permissions and "
 193 "ownership will be optimistically set according to I<DIR>. It will also be "
 194 "bootstrapped by copying the contents of the I<DIR> into its source directory "
 195 "on the persistence media. The bootstrapping will not happen when the B<link> "
 196 "or B<union> options are used (see below)."
 197 msgstr ""
 198
 199 #. type: Plain text
 200 #: en/persistence.conf.5:60
 201 msgid ""
 202 "Custom mounts defined in B<persistence.conf> accept the following options in "
 203 "a comma-separated list:"
 204 msgstr ""
 205
 206 #. type: IP
 207 #: en/persistence.conf.5:60
 208 #, no-wrap
 209 msgid "B<source>=I<PATH>"
 210 msgstr ""
 211
 212 #. type: Plain text
 213 #: en/persistence.conf.5:69
 214 msgid ""
 215 "When given, store the persistence changes into I<PATH> on the persistence "
 216 "media. I<PATH> must be a relative path (with respect to the persistence "
 217 "media root) that cannot contain white spaces or the special . or .. path "
 218 "components, with the exception that it can be just . which means the "
 219 "persistence media root. This option is mostly relevant if you want to nest "
 220 "custom mounts, which otherwise would cause errors, or if you want to make "
 221 "the whole media root available (similar to the now deprecated B<home-rw> "
 222 "type of persistence)."
 223 msgstr ""
 224
 225 #. type: Plain text
 226 #: en/persistence.conf.5:72
 227 msgid ""
 228 "The following options are mutually exclusive (only the last given one will "
 229 "be in effect):"
 230 msgstr ""
 231
 232 #. type: IP
 233 #: en/persistence.conf.5:72
 234 #, no-wrap
 235 msgid "B<bind>"
 236 msgstr ""
 237
 238 #. type: Plain text
 239 #: en/persistence.conf.5:74
 240 msgid "Bind-mount the source directory to I<DIR>. This is the default."
 241 msgstr ""
 242
 243 #. type: IP
 244 #: en/persistence.conf.5:74
 245 #, no-wrap
 246 msgid "B<link>"
 247 msgstr ""
 248
 249 #. type: Plain text
 250 #: en/persistence.conf.5:83
 251 msgid ""
 252 "Create the directory structure of the source directory on the persistence "
 253 "media in I<DIR> and create symbolic links from the corresponding place in "
 254 "I<DIR> to each file in the source directory.  Existing files or directories "
 255 "with the same name as any link will be overwritten. Note that deleting the "
 256 "links in I<DIR> will only remove the link, not the corresponding file in the "
 257 "source; removed links will reappear after a reboot. To permanently add or "
 258 "delete a file one must do so directly in the source directory."
 259 msgstr ""
 260
 261 #. type: Plain text
 262 #: en/persistence.conf.5:91
 263 msgid ""
 264 "Effectively B<link> will make only files already in the source directory "
 265 "persistent, not any other files in I<DIR>. These files must be manually "
 266 "added to the source directory to make use of this option, and they will "
 267 "appear in I<DIR> in addition to files already there. This option is useful "
 268 "when only certain files need to be persistent, not the whole directory "
 269 "they're in, e.g. some configuration files in a user's home directory."
 270 msgstr ""
 271
 272 #. type: IP
 273 #: en/persistence.conf.5:91
 274 #, no-wrap
 275 msgid "B<union>"
 276 msgstr ""
 277
 278 #. type: Plain text
 279 #: en/persistence.conf.5:101
 280 msgid ""
 281 "Save the rw branch of a union on the persistence media, so only the changes "
 282 "are stored persistently. This can potentially reduce disk usage compared to "
 283 "bind-mounts, and will not hide files added to the read-only media. One "
 284 "caveat is that the union will use I<DIR> from the image's read-only file "
 285 "system, not the real file system root, so files created after boot (e.g. by "
 286 "live-config) will not appear in the union. This option will use the union "
 287 "file system specified by live-boot's B<union> boot parameter, but is not "
 288 "supported with B<union=unionmount>."
 289 msgstr ""
 290
 291 #. type: SH
 292 #: en/persistence.conf.5:102
 293 #, no-wrap
 294 msgid "DIRECTORIES"
 295 msgstr ""
 296
 297 #. type: IP
 298 #: en/persistence.conf.5:103
 299 #, no-wrap
 300 msgid "B</live/persistence>"
 301 msgstr ""
 302
 303 #. type: Plain text
 304 #: en/persistence.conf.5:109
 305 msgid ""
 306 "All persistence volumes will be mounted here (in a directory corresponding "
 307 "to the device name). The B<persistence.conf> file can easily be edited "
 308 "through this mount, as well as any source directories (which is especially "
 309 "practical for custom mounts using the B<link> option)."
 310 msgstr ""
 311
 312 #. type: SH
 313 #: en/persistence.conf.5:110
 314 #, no-wrap
 315 msgid "EXAMPLES"
 316 msgstr ""
 317
 318 #. type: Plain text
 319 #: en/persistence.conf.5:115
 320 msgid ""
 321 "Let's say we have a persistence volume I<VOL> with the a B<persistence.conf> "
 322 "file containing the following four lines (numbered for ease of reference):"
 323 msgstr ""
 324
 325 #. type: TP
 326 #: en/persistence.conf.5:115 en/persistence.conf.5:129
 327 #, no-wrap
 328 msgid "1."
 329 msgstr ""
 330
 331 #. type: Plain text
 332 #: en/persistence.conf.5:118
 333 msgid "/home/user1 link,source=config-files/user1"
 334 msgstr ""
 335
 336 #. type: TP
 337 #: en/persistence.conf.5:118 en/persistence.conf.5:133
 338 #, no-wrap
 339 msgid "2."
 340 msgstr ""
 341
 342 #. type: Plain text
 343 #: en/persistence.conf.5:121
 344 msgid "/home/user2 link,source=config-files/user2"
 345 msgstr ""
 346
 347 #. type: TP
 348 #: en/persistence.conf.5:121 en/persistence.conf.5:137
 349 #, no-wrap
 350 msgid "3."
 351 msgstr ""
 352
 353 #. type: Plain text
 354 #: en/persistence.conf.5:124
 355 msgid "/home"
 356 msgstr ""
 357
 358 #. type: TP
 359 #: en/persistence.conf.5:124 en/persistence.conf.5:140
 360 #, no-wrap
 361 msgid "4."
 362 msgstr ""
 363
 364 #. type: Plain text
 365 #: en/persistence.conf.5:127
 366 msgid "/usr union"
 367 msgstr ""
 368
 369 #. type: Plain text
 370 #: en/persistence.conf.5:129
 371 msgid "The corresponding source directories are:"
 372 msgstr ""
 373
 374 #. type: Plain text
 375 #: en/persistence.conf.5:133
 376 msgid ""
 377 "I<VOL>/config-files/user1 (but it would be I<VOL>/home/user1 without the "
 378 "B<source> option)"
 379 msgstr ""
 380
 381 #. type: Plain text
 382 #: en/persistence.conf.5:137
 383 msgid ""
 384 "I<VOL>/config-files/user2 (but it would be I<VOL>/home/user2 without the "
 385 "B<source> option)"
 386 msgstr ""
 387
 388 #. type: Plain text
 389 #: en/persistence.conf.5:140
 390 msgid "I<VOL>/home"
 391 msgstr ""
 392
 393 #. type: Plain text
 394 #: en/persistence.conf.5:143
 395 msgid "I<VOL>/usr"
 396 msgstr ""
 397
 398 #. type: Plain text
 399 #: en/persistence.conf.5:146
 400 msgid ""
 401 "It was necessary to set the B<source> options for 1 and 2, since they "
 402 "otherwise would become nested with 3's source, which is invalid."
 403 msgstr ""
 404
 405 #. type: Plain text
 406 #: en/persistence.conf.5:151
 407 msgid ""
 408 "Line 3 will be taken care of before line 1 and 2 in order to prevent custom "
 409 "mounts 1 and 2 from being hidden by 3. When line 3 is handled, I<VOL>/home "
 410 "is simply bind-mounted on /home. To illustrate what happens for lines 1 and "
 411 "2, let's say that the following files exist:"
 412 msgstr ""
 413
 414 #. type: TP
 415 #: en/persistence.conf.5:151
 416 #, no-wrap
 417 msgid "a."
 418 msgstr ""
 419
 420 #. type: Plain text
 421 #: en/persistence.conf.5:154
 422 msgid "I<VOL>/config-files/user1/.emacs"
 423 msgstr ""
 424
 425 #. type: TP
 426 #: en/persistence.conf.5:154
 427 #, no-wrap
 428 msgid "b."
 429 msgstr ""
 430
 431 #. type: Plain text
 432 #: en/persistence.conf.5:157
 433 msgid "I<VOL>/config-files/user2/.bashrc"
 434 msgstr ""
 435
 436 #. type: TP
 437 #: en/persistence.conf.5:157
 438 #, no-wrap
 439 msgid "c."
 440 msgstr ""
 441
 442 #. type: Plain text
 443 #: en/persistence.conf.5:160
 444 msgid "I<VOL>/config-files/user2/.ssh/config"
 445 msgstr ""
 446
 447 #. type: Plain text
 448 #: en/persistence.conf.5:162
 449 msgid "Then the following links and directories will be created:"
 450 msgstr ""
 451
 452 #. type: TP
 453 #: en/persistence.conf.5:162 en/persistence.conf.5:165
 454 #: en/persistence.conf.5:171
 455 #, no-wrap
 456 msgid "Link:"
 457 msgstr ""
 458
 459 #. type: Plain text
 460 #: en/persistence.conf.5:165
 461 msgid "/home/user1/.emacs -E<gt> I<VOL>/config-files/user1/.emacs (from a)"
 462 msgstr ""
 463
 464 #. type: Plain text
 465 #: en/persistence.conf.5:168
 466 msgid "/home/user2/.bashrc -E<gt> I<VOL>/config-files/user2/.bashrc (from b)"
 467 msgstr ""
 468
 469 #. type: TP
 470 #: en/persistence.conf.5:168
 471 #, no-wrap
 472 msgid "Dir:"
 473 msgstr ""
 474
 475 #. type: Plain text
 476 #: en/persistence.conf.5:171
 477 msgid "/homea/user2/.ssh (from c)"
 478 msgstr ""
 479
 480 #. type: Plain text
 481 #: en/persistence.conf.5:175
 482 msgid ""
 483 "/home/user2/.ssh/config -E<gt> I<VOL>/config-files/user2/.ssh/config (from c)"
 484 msgstr ""
 485
 486 #. type: Plain text
 487 #: en/persistence.conf.5:181
 488 msgid ""
 489 "One could argue, though, that lines 1 and 2 in the example B<persistence."
 490 "conf> file above are unnecessary since line 3 already would make all of /"
 491 "home persistent. The B<link> option is intended for situations where you "
 492 "don't want a complete directory to be persistent, only certain files in it "
 493 "or its sub-directories."
 494 msgstr ""
 495
 496 #. type: Plain text
 497 #: en/persistence.conf.5:190
 498 msgid ""
 499 "Line 4 can be mounted at any time since its I<DIR> (and source directory) is "
 500 "completely disjoint from all the other custom mounts. When mounted, I<VOL>/"
 501 "usr will be the rw branch due to the B<union> option, and will only contain "
 502 "the difference compared to the underlying read-only file system. Hence "
 503 "packages could be installed into /usr with great space-wise efficiency "
 504 "compared to bind-mounts, since in the latter case all of /usr would have to "
 505 "be copied into I<VOL>/usr during the initial bootstrap."
 506 msgstr ""
 507
 508 #. type: Plain text
 509 #: en/persistence.conf.5:193
 510 msgid "I<live-boot>(7)"
 511 msgstr ""