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