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