Debian Codegraph @

doc/man/po4a/po/debconf.pot

raw
1 # SOME DESCRIPTIVE TITLE
2 # Copyright (C) YEAR Free Software Foundation, Inc.
3 # This file is distributed under the same license as the PACKAGE package.
4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
5 #
6 #, fuzzy
7 msgid ""
8 msgstr ""
9 "Project-Id-Version: PACKAGE VERSION\n"
10 "POT-Creation-Date: 2024-01-21 19:23+0000\n"
11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
13 "Language-Team: LANGUAGE <[email protected]>\n"
14 "Language: \n"
15 "MIME-Version: 1.0\n"
16 "Content-Type: text/plain; charset=UTF-8\n"
17 "Content-Transfer-Encoding: 8bit\n"
18
19 #. type: SH
20 #: ../../debconf:3 ../../Debconf/Client/ConfModule.pm:3
21 #: ../../debconf-apt-progress:3 ../../debconf-escape:3
22 #: ../../debconf-communicate:3 ../../debconf-copydb:3 ../../debconf-getlang:3
23 #: ../../debconf-get-selections:3 ../../debconf-loadtemplate:3
24 #: ../../debconf-mergetemplate:3 ../../debconf-set-selections:3
25 #: ../../debconf-show:3 ../../dpkg-preconfigure:3 ../../dpkg-reconfigure:3
26 #: debconf.conf.5:2 confmodule.3:2 debconf.7:2 debconf-devel.7:2
27 #, no-wrap
28 msgid "NAME"
29 msgstr ""
30
31 #. type: textblock
32 #: ../../debconf:5
33 msgid "debconf - run a debconf-using program"
34 msgstr ""
35
36 #. type: SH
37 #: ../../debconf:9 ../../Debconf/Client/ConfModule.pm:7
38 #: ../../debconf-apt-progress:7 ../../debconf-escape:7
39 #: ../../debconf-communicate:9 ../../debconf-copydb:17 ../../debconf-getlang:16
40 #: ../../debconf-get-selections:7 ../../debconf-loadtemplate:14
41 #: ../../debconf-mergetemplate:17 ../../debconf-set-selections:7
42 #: ../../debconf-show:7 ../../dpkg-preconfigure:7 ../../dpkg-reconfigure:7
43 #: debconf.conf.5:12 confmodule.3:4
44 #, no-wrap
45 msgid "SYNOPSIS"
46 msgstr ""
47
48 #. type: verbatim
49 #: ../../debconf:11
50 #, no-wrap
51 msgid ""
52 " debconf [options] command [args]\n"
53 "\n"
54 msgstr ""
55
56 #. type: SH
57 #: ../../debconf:13 ../../Debconf/Client/ConfModule.pm:20
58 #: ../../debconf-apt-progress:15 ../../debconf-escape:12
59 #: ../../debconf-communicate:13 ../../debconf-copydb:30
60 #: ../../debconf-getlang:21 ../../debconf-get-selections:11
61 #: ../../debconf-loadtemplate:18 ../../debconf-mergetemplate:21
62 #: ../../debconf-set-selections:12 ../../debconf-show:13
63 #: ../../dpkg-preconfigure:13 ../../dpkg-reconfigure:11 debconf.conf.5:4
64 #: confmodule.3:12 debconf.7:4 debconf-devel.7:4
65 #, no-wrap
66 msgid "DESCRIPTION"
67 msgstr ""
68
69 #. type: textblock
70 #: ../../debconf:15
71 msgid ""
72 "Debconf is a configuration system for Debian packages. For a debconf "
73 "overview and documentation for sysadmins, see L<debconf(7)> (in the "
74 "debconf-doc package)."
75 msgstr ""
76
77 #. type: textblock
78 #: ../../debconf:19
79 msgid ""
80 "The B<debconf> program runs a program under debconf's control, setting it up "
81 "to talk with debconf on stdio. The program's output is expected to be "
82 "debconf protocol commands, and it is expected to read result codes on "
83 "stdin. See L<debconf-devel(7)> for details about the debconf protocol."
84 msgstr ""
85
86 #. type: textblock
87 #: ../../debconf:24
88 msgid ""
89 "The command to be run under debconf must be specified in a way that will let "
90 "your PATH find it."
91 msgstr ""
92
93 #. type: textblock
94 #: ../../debconf:27
95 msgid ""
96 "This command is not the usual way that debconf is used. It's more typical "
97 "for debconf to be used via L<dpkg-preconfigure(8)> or "
98 "L<dpkg-reconfigure(8)>."
99 msgstr ""
100
101 #. type: =head1
102 #: ../../debconf:30 ../../debconf-apt-progress:43 ../../debconf-copydb:36
103 #: ../../debconf-mergetemplate:45 ../../debconf-set-selections:56
104 #: ../../debconf-show:24 ../../dpkg-preconfigure:20 ../../dpkg-reconfigure:21
105 msgid "OPTIONS"
106 msgstr ""
107
108 #. type: =item
109 #: ../../debconf:34
110 msgid "B<-o>I<package>, B<--owner=>I<package>"
111 msgstr ""
112
113 #. type: textblock
114 #: ../../debconf:36
115 msgid ""
116 "Tell debconf what package the command it is running is a part of. This is "
117 "necessary to get ownership of registered questions right, and to support "
118 "unregister and purge commands properly."
119 msgstr ""
120
121 #. type: =item
122 #: ../../debconf:40 ../../dpkg-preconfigure:24 ../../dpkg-reconfigure:25
123 msgid "B<-f>I<type>, B<--frontend=>I<type>"
124 msgstr ""
125
126 #. type: textblock
127 #: ../../debconf:42 ../../dpkg-preconfigure:26
128 msgid "Select the frontend to use."
129 msgstr ""
130
131 #. type: =item
132 #: ../../debconf:44 ../../dpkg-preconfigure:28 ../../dpkg-reconfigure:36
133 msgid "B<-p>I<value>, B<--priority=>I<value>"
134 msgstr ""
135
136 #. type: textblock
137 #: ../../debconf:46
138 msgid "Specify the minimum priority of question that will be displayed."
139 msgstr ""
140
141 #. type: =item
142 #: ../../debconf:48 ../../dpkg-preconfigure:34 ../../dpkg-reconfigure:42
143 msgid "B<--terse>"
144 msgstr ""
145
146 #. type: textblock
147 #: ../../debconf:50 ../../dpkg-preconfigure:36 ../../dpkg-reconfigure:44
148 msgid "Enables terse output mode. This affects only some frontends."
149 msgstr ""
150
151 #. type: =head1
152 #: ../../debconf:54 ../../debconf-apt-progress:107 ../../debconf-copydb:75
153 #: ../../debconf-set-selections:47
154 msgid "EXAMPLES"
155 msgstr ""
156
157 #. type: textblock
158 #: ../../debconf:56
159 msgid "To debug a shell script that uses debconf, you might use:"
160 msgstr ""
161
162 #. type: verbatim
163 #: ../../debconf:58
164 #, no-wrap
165 msgid ""
166 " DEBCONF_DEBUG=developer debconf my-shell-prog\n"
167 "\n"
168 msgstr ""
169
170 #. type: textblock
171 #: ../../debconf:60
172 msgid "Or, you might use this:"
173 msgstr ""
174
175 #. type: verbatim
176 #: ../../debconf:62
177 #, no-wrap
178 msgid ""
179 " debconf --frontend=readline sh -x my-shell-prog\n"
180 "\n"
181 msgstr ""
182
183 #. type: SH
184 #: ../../debconf:64 ../../Debconf/Client/ConfModule.pm:154
185 #: ../../debconf-escape:21 ../../debconf-communicate:39
186 #: ../../debconf-copydb:102 ../../debconf-getlang:74
187 #: ../../debconf-loadtemplate:31 ../../debconf-mergetemplate:61
188 #: ../../debconf-set-selections:70 ../../dpkg-preconfigure:59
189 #: ../../dpkg-reconfigure:77 debconf.conf.5:537 confmodule.3:36 debconf.7:376
190 #: debconf-devel.7:958
191 #, no-wrap
192 msgid "SEE ALSO"
193 msgstr ""
194
195 #. type: textblock
196 #: ../../debconf:66
197 msgid "L<debconf-devel(7)>, L<debconf(7)>"
198 msgstr ""
199
200 #. type: SH
201 #: ../../debconf:117 ../../Debconf/Client/ConfModule.pm:159
202 #: ../../debconf-escape:72 ../../debconf-communicate:74
203 #: ../../debconf-copydb:175 ../../debconf-getlang:256
204 #: ../../debconf-get-selections:78 ../../debconf-loadtemplate:48
205 #: ../../debconf-mergetemplate:181 ../../debconf-set-selections:226
206 #: ../../debconf-show:152 ../../dpkg-preconfigure:258
207 #: ../../dpkg-reconfigure:309 debconf.conf.5:539 confmodule.3:42 debconf.7:382
208 #: debconf-devel.7:968
209 #, no-wrap
210 msgid "AUTHOR"
211 msgstr ""
212
213 #. type: textblock
214 #: ../../debconf:119 ../../Debconf/Client/ConfModule.pm:161
215 #: ../../debconf-apt-progress:658 ../../debconf-communicate:76
216 #: ../../debconf-copydb:177 ../../debconf-getlang:258
217 #: ../../debconf-loadtemplate:50 ../../debconf-mergetemplate:183
218 #: ../../dpkg-preconfigure:260 ../../dpkg-reconfigure:311
219 msgid "Joey Hess <[email protected]>"
220 msgstr ""
221
222 #. type: textblock
223 #: ../../Debconf/Client/ConfModule.pm:5
224 msgid "Debconf::Client::ConfModule - client module for ConfModules"
225 msgstr ""
226
227 #. type: verbatim
228 #: ../../Debconf/Client/ConfModule.pm:9
229 #, no-wrap
230 msgid ""
231 " use Debconf::Client::ConfModule ':all';\n"
232 " version('2.0');\n"
233 " my $capb=capb('backup');\n"
234 " input(\"medium\", \"foo/bar\");\n"
235 " my @ret=go();\n"
236 " if ($ret[0] == 30) {\n"
237 " \t# Back button pressed.\n"
238 " \t...\n"
239 " }\n"
240 " ...\n"
241 "\n"
242 msgstr ""
243
244 #. type: textblock
245 #: ../../Debconf/Client/ConfModule.pm:22
246 msgid ""
247 "This is a module to ease writing ConfModules for Debian's configuration "
248 "management system. It can communicate with a FrontEnd via the debconf "
249 "protocol (which is documented in full in the debconf_specification in Debian "
250 "policy)."
251 msgstr ""
252
253 #. type: textblock
254 #: ../../Debconf/Client/ConfModule.pm:27
255 msgid ""
256 "The design is that each command in the protocol is represented by one "
257 "function in this module (with the name lower-cased). Call the function and "
258 "pass in any parameters you want to follow the command. If the function is "
259 "called in scalar context, it will return any textual return code. If it is "
260 "called in list context, an array consisting of the numeric return code and "
261 "the textual return code will be returned."
262 msgstr ""
263
264 #. type: textblock
265 #: ../../Debconf/Client/ConfModule.pm:34
266 msgid ""
267 "This module uses Exporter to export all functions it defines. To import "
268 "everything, simply import \":all\"."
269 msgstr ""
270
271 #. type: =item
272 #: ../../Debconf/Client/ConfModule.pm:62
273 msgid "import"
274 msgstr ""
275
276 #. type: textblock
277 #: ../../Debconf/Client/ConfModule.pm:64
278 msgid ""
279 "Ensure that a FrontEnd is running. It's a little hackish. If "
280 "DEBIAN_HAS_FRONTEND is set, a FrontEnd is assumed to be running. If not, "
281 "one is started up automatically and stdin and out are connected to it. Note "
282 "that this function is always run when the module is loaded in the usual way."
283 msgstr ""
284
285 #. type: =item
286 #: ../../Debconf/Client/ConfModule.pm:95
287 msgid "stop"
288 msgstr ""
289
290 #. type: textblock
291 #: ../../Debconf/Client/ConfModule.pm:97
292 msgid ""
293 "The frontend doesn't send a return code here, so we cannot try to read it or "
294 "we'll block."
295 msgstr ""
296
297 #. type: =item
298 #: ../../Debconf/Client/ConfModule.pm:107
299 msgid "AUTOLOAD"
300 msgstr ""
301
302 #. type: textblock
303 #: ../../Debconf/Client/ConfModule.pm:109
304 msgid "Creates handler functions for commands on the fly."
305 msgstr ""
306
307 #. type: textblock
308 #: ../../Debconf/Client/ConfModule.pm:156
309 msgid ""
310 "The debconf specification "
311 "(/usr/share/doc/debian-policy/debconf_specification.txt.gz)."
312 msgstr ""
313
314 #. type: textblock
315 #: ../../debconf-apt-progress:5
316 msgid ""
317 "debconf-apt-progress - install packages using debconf to display a progress "
318 "bar"
319 msgstr ""
320
321 #. type: verbatim
322 #: ../../debconf-apt-progress:9
323 #, no-wrap
324 msgid ""
325 " debconf-apt-progress [--] command [args ...]\n"
326 " debconf-apt-progress --config\n"
327 " debconf-apt-progress --start\n"
328 " debconf-apt-progress --from waypoint --to waypoint [--] command [args "
329 "...]\n"
330 " debconf-apt-progress --stop\n"
331 "\n"
332 msgstr ""
333
334 #. type: textblock
335 #: ../../debconf-apt-progress:17
336 msgid ""
337 "B<debconf-apt-progress> installs packages using debconf to display a "
338 "progress bar. The given I<command> should be any command-line apt frontend; "
339 "specifically, it must send progress information to the file descriptor "
340 "selected by the C<APT::Status-Fd> configuration option, and must keep the "
341 "file descriptors nominated by the C<APT::Keep-Fds> configuration option open "
342 "when invoking debconf (directly or indirectly), as those file descriptors "
343 "will be used for the debconf passthrough protocol."
344 msgstr ""
345
346 #. type: textblock
347 #: ../../debconf-apt-progress:25
348 msgid ""
349 "The arguments to the command you supply should generally include B<-y> (for "
350 "B<apt-get> or B<aptitude>) or similar to avoid the apt frontend prompting "
351 "for input. B<debconf-apt-progress> cannot do this itself because the "
352 "appropriate argument may differ between apt frontends."
353 msgstr ""
354
355 #. type: textblock
356 #: ../../debconf-apt-progress:30
357 msgid ""
358 "The B<--start>, B<--stop>, B<--from>, and B<--to> options may be used to "
359 "create a progress bar with multiple segments for different stages of "
360 "installation, provided that the caller is a debconf confmodule. The caller "
361 "may also interact with the progress bar itself using the debconf protocol if "
362 "it so desires."
363 msgstr ""
364
365 #. type: textblock
366 #: ../../debconf-apt-progress:36
367 msgid ""
368 "debconf locks its config database when it starts up, which makes it "
369 "unfortunately inconvenient to have one instance of debconf displaying the "
370 "progress bar and another passing through questions from packages being "
371 "installed. If you're using a multiple-segment progress bar, you'll need to "
372 "eval the output of the B<--config> option before starting the debconf "
373 "frontend to work around this. See L<the EXAMPLES section/EXAMPLES> below."
374 msgstr ""
375
376 #. type: =item
377 #: ../../debconf-apt-progress:47
378 msgid "B<--config>"
379 msgstr ""
380
381 #. type: textblock
382 #: ../../debconf-apt-progress:49
383 msgid "Print environment variables necessary to start up a progress bar frontend."
384 msgstr ""
385
386 #. type: =item
387 #: ../../debconf-apt-progress:51
388 msgid "B<--start>"
389 msgstr ""
390
391 #. type: textblock
392 #: ../../debconf-apt-progress:53
393 msgid ""
394 "Start up a progress bar, running from 0 to 100 by default. Use B<--from> and "
395 "B<--to> to use other endpoints."
396 msgstr ""
397
398 #. type: =item
399 #: ../../debconf-apt-progress:56
400 msgid "B<--from> I<waypoint>"
401 msgstr ""
402
403 #. type: textblock
404 #: ../../debconf-apt-progress:58
405 msgid ""
406 "If used with B<--start>, make the progress bar begin at I<waypoint> rather "
407 "than 0."
408 msgstr ""
409
410 #. type: textblock
411 #: ../../debconf-apt-progress:61
412 msgid ""
413 "Otherwise, install packages with their progress bar beginning at this "
414 "\"waypoint\". Must be used with B<--to>."
415 msgstr ""
416
417 #. type: =item
418 #: ../../debconf-apt-progress:64
419 msgid "B<--to> I<waypoint>"
420 msgstr ""
421
422 #. type: textblock
423 #: ../../debconf-apt-progress:66
424 msgid ""
425 "If used with B<--start>, make the progress bar end at I<waypoint> rather "
426 "than 100."
427 msgstr ""
428
429 #. type: textblock
430 #: ../../debconf-apt-progress:69
431 msgid ""
432 "Otherwise, install packages with their progress bar ending at this "
433 "\"waypoint\". Must be used with B<--from>."
434 msgstr ""
435
436 #. type: =item
437 #: ../../debconf-apt-progress:72
438 msgid "B<--stop>"
439 msgstr ""
440
441 #. type: textblock
442 #: ../../debconf-apt-progress:74
443 msgid "Stop a running progress bar."
444 msgstr ""
445
446 #. type: =item
447 #: ../../debconf-apt-progress:76
448 msgid "B<--no-progress>"
449 msgstr ""
450
451 #. type: textblock
452 #: ../../debconf-apt-progress:78
453 msgid ""
454 "Avoid starting, stopping, or stepping the progress bar. Progress messages "
455 "from apt, media change events, and debconf questions will still be passed "
456 "through to debconf."
457 msgstr ""
458
459 #. type: =item
460 #: ../../debconf-apt-progress:82
461 msgid "B<--dlwaypoint> I<percentage>"
462 msgstr ""
463
464 #. type: textblock
465 #: ../../debconf-apt-progress:84
466 msgid ""
467 "Specify what percent of the progress bar to use for downloading packages. "
468 "The remainder will be used for installing packages. The default is to use "
469 "15% for downloading and the remaining 85% for installing."
470 msgstr ""
471
472 #. type: =item
473 #: ../../debconf-apt-progress:88
474 msgid "B<--logfile> I<file>"
475 msgstr ""
476
477 #. type: textblock
478 #: ../../debconf-apt-progress:90
479 msgid "Send the normal output from apt to the given file."
480 msgstr ""
481
482 #. type: =item
483 #: ../../debconf-apt-progress:92
484 msgid "B<--logstderr>"
485 msgstr ""
486
487 #. type: textblock
488 #: ../../debconf-apt-progress:94
489 msgid ""
490 "Send the normal output from apt to stderr. If you supply neither "
491 "B<--logfile> nor B<--logstderr>, the normal output from apt will be "
492 "discarded."
493 msgstr ""
494
495 #. type: =item
496 #: ../../debconf-apt-progress:98
497 msgid "B<-->"
498 msgstr ""
499
500 #. type: textblock
501 #: ../../debconf-apt-progress:100
502 msgid ""
503 "Terminate options. Since you will normally need to give at least the B<-y> "
504 "argument to the command being run, you will usually need to use B<--> to "
505 "prevent that being interpreted as an option to B<debconf-apt-progress> "
506 "itself."
507 msgstr ""
508
509 #. type: textblock
510 #: ../../debconf-apt-progress:109
511 msgid ""
512 "Install the GNOME desktop and an X window system development environment "
513 "within a progress bar:"
514 msgstr ""
515
516 #. type: verbatim
517 #: ../../debconf-apt-progress:112
518 #, no-wrap
519 msgid ""
520 " debconf-apt-progress -- aptitude -y install gnome x-window-system-dev\n"
521 "\n"
522 msgstr ""
523
524 #. type: textblock
525 #: ../../debconf-apt-progress:114
526 msgid ""
527 "Install the GNOME, KDE, and XFCE desktops within a single progress bar, "
528 "allocating 45% of the progress bar for each of GNOME and KDE and the "
529 "remaining 10% for XFCE:"
530 msgstr ""
531
532 #. type: verbatim
533 #: ../../debconf-apt-progress:118
534 #, no-wrap
535 msgid ""
536 " #! /bin/sh\n"
537 " set -e\n"
538 " case $1 in\n"
539 " '')\n"
540 " eval \"$(debconf-apt-progress --config)\"\n"
541 " \"$0\" debconf\n"
542 " ;;\n"
543 " debconf)\n"
544 " . /usr/share/debconf/confmodule\n"
545 " debconf-apt-progress --start\n"
546 " debconf-apt-progress --from 0 --to 45 -- apt-get -y install gnome\n"
547 " debconf-apt-progress --from 45 --to 90 -- apt-get -y install kde\n"
548 " debconf-apt-progress --from 90 --to 100 -- apt-get -y install xfce4\n"
549 " debconf-apt-progress --stop\n"
550 " ;;\n"
551 " esac\n"
552 "\n"
553 msgstr ""
554
555 #. type: =head1
556 #: ../../debconf-apt-progress:135
557 msgid "RETURN CODE"
558 msgstr ""
559
560 #. type: textblock
561 #: ../../debconf-apt-progress:137
562 msgid ""
563 "The exit code of the specified command is returned, unless the user hit the "
564 "cancel button on the progress bar. If the cancel button was hit, a value of "
565 "30 is returned. To avoid ambiguity, if the command returned 30, a value of 3 "
566 "will be returned."
567 msgstr ""
568
569 #. type: =head1
570 #: ../../debconf-apt-progress:654
571 msgid "AUTHORS"
572 msgstr ""
573
574 #. type: textblock
575 #: ../../debconf-apt-progress:656 ../../debconf-escape:74
576 msgid "Colin Watson <[email protected]>"
577 msgstr ""
578
579 #. type: textblock
580 #: ../../debconf-escape:5
581 msgid "debconf-escape - helper when working with debconf's escape capability"
582 msgstr ""
583
584 #. type: verbatim
585 #: ../../debconf-escape:9
586 #, no-wrap
587 msgid ""
588 " debconf-escape -e < unescaped-text\n"
589 " debconf-escape -u < escaped-text\n"
590 "\n"
591 msgstr ""
592
593 #. type: textblock
594 #: ../../debconf-escape:14
595 msgid ""
596 "When debconf has the 'escape' capability set, it will expect commands you "
597 "send it to have backslashes and newlines escaped (as C<\\\\> and C<\\n> "
598 "respectively) and will in turn escape backslashes and newlines in its "
599 "replies. This can be used, for example, to substitute multi-line strings "
600 "into templates, or to get multi-line extended descriptions reliably using "
601 "C<METAGET>."
602 msgstr ""
603
604 #. type: textblock
605 #: ../../debconf-escape:23
606 msgid "L<debconf-devel(7)> (available in the debconf-doc package)"
607 msgstr ""
608
609 #. type: textblock
610 #: ../../debconf-communicate:5
611 msgid "debconf-communicate - communicate with debconf"
612 msgstr ""
613
614 #. type: verbatim
615 #: ../../debconf-communicate:11
616 #, no-wrap
617 msgid ""
618 " echo commands | debconf-communicate [options] [package]\n"
619 "\n"
620 msgstr ""
621
622 #. type: textblock
623 #: ../../debconf-communicate:15
624 msgid ""
625 "B<debconf-communicate> allows you to communicate with debconf on the fly, "
626 "from the command line. The package argument is the name of the package which "
627 "you are pretending to be as you communicate with debconf, and it may be "
628 "omitted if you are lazy. It reads commands in the form used by the debconf "
629 "protocol from stdin. For documentation on the available commands and their "
630 "usage, see the debconf specification."
631 msgstr ""
632
633 #. type: textblock
634 #: ../../debconf-communicate:22
635 msgid ""
636 "The commands are executed in sequence. The textual return code of each is "
637 "printed out to standard output."
638 msgstr ""
639
640 #. type: textblock
641 #: ../../debconf-communicate:25
642 msgid ""
643 "The return value of this program is the numeric return code of the last "
644 "executed command."
645 msgstr ""
646
647 #. type: SH
648 #: ../../debconf-communicate:28 debconf.conf.5:444
649 #, no-wrap
650 msgid "EXAMPLE"
651 msgstr ""
652
653 #. type: verbatim
654 #: ../../debconf-communicate:30
655 #, no-wrap
656 msgid ""
657 " echo get debconf/frontend | debconf-communicate\n"
658 "\n"
659 msgstr ""
660
661 #. type: textblock
662 #: ../../debconf-communicate:32
663 msgid "Print out the value of the debconf/frontend question."
664 msgstr ""
665
666 #. type: =head1
667 #: ../../debconf-communicate:34 ../../debconf-loadtemplate:25
668 #: ../../debconf-set-selections:20
669 msgid "WARNING"
670 msgstr ""
671
672 #. type: textblock
673 #: ../../debconf-communicate:36
674 msgid ""
675 "This program should never be used from a maintainer script of a package that "
676 "uses debconf! It may however, be useful in debugging."
677 msgstr ""
678
679 #. type: textblock
680 #: ../../debconf-communicate:41
681 msgid "L<debconf-loadtemplate(1)>"
682 msgstr ""
683
684 #. type: textblock
685 #: ../../debconf-copydb:5
686 msgid "debconf-copydb - copy a debconf database"
687 msgstr ""
688
689 #. type: verbatim
690 #: ../../debconf-copydb:19
691 #, no-wrap
692 msgid ""
693 " debconf-copydb sourcedb destdb [--pattern=pattern] "
694 "[--owner-pattern=pattern] [--config=Foo:bar]\n"
695 "\n"
696 msgstr ""
697
698 #. type: textblock
699 #: ../../debconf-copydb:32
700 msgid ""
701 "B<debconf-copydb> copies items from an existing debconf database into "
702 "another, possibly new database. The two databases may have different "
703 "formats; if so a conversion will automatically be done."
704 msgstr ""
705
706 #. type: =item
707 #: ../../debconf-copydb:40
708 msgid "I<sourcedb>"
709 msgstr ""
710
711 #. type: textblock
712 #: ../../debconf-copydb:42
713 msgid ""
714 "The name of the source database. Typically it will be defined in your "
715 "debconf.conf (or .debconfrc) file."
716 msgstr ""
717
718 #. type: =item
719 #: ../../debconf-copydb:45
720 msgid "I<destdb>"
721 msgstr ""
722
723 #. type: textblock
724 #: ../../debconf-copydb:47
725 msgid ""
726 "The name of the destination database. It may be defined in debconf.conf or "
727 ".debconfrc, or you might define it on the command line (see below)."
728 msgstr ""
729
730 #. type: =item
731 #: ../../debconf-copydb:51
732 msgid "B<-p> I<pattern>, B<--pattern> I<pattern>"
733 msgstr ""
734
735 #. type: textblock
736 #: ../../debconf-copydb:53
737 msgid ""
738 "If this is specified, only items in I<sourcedb> whose names match the "
739 "pattern will be copied."
740 msgstr ""
741
742 #. type: =item
743 #: ../../debconf-copydb:56
744 msgid "B<--owner-pattern> I<pattern>"
745 msgstr ""
746
747 #. type: textblock
748 #: ../../debconf-copydb:58
749 msgid ""
750 "If this is specified, only items in I<sourcedb> whose owners match the "
751 "pattern will be copied."
752 msgstr ""
753
754 #. type: =item
755 #: ../../debconf-copydb:61
756 msgid "B<-c> I<foo:bar>, B<--config> I<Foo:bar>"
757 msgstr ""
758
759 #. type: textblock
760 #: ../../debconf-copydb:63
761 msgid "Set option Foo to bar. This is similar to writing:"
762 msgstr ""
763
764 #. type: verbatim
765 #: ../../debconf-copydb:65
766 #, no-wrap
767 msgid ""
768 " Foo: bar\n"
769 "\n"
770 msgstr ""
771
772 #. type: textblock
773 #: ../../debconf-copydb:67
774 msgid ""
775 "In debconf.conf, except you probably want to leave off the space on the "
776 "command line (or quote it: \"Foo: bar\"). Generally must be used multiple "
777 "times, to build up a full configuration stanza. While blank lines are used "
778 "to separate stanzas in debconf.conf, this program will assume that "
779 "\"Name:dbname\" denotes the beginning of a new stanza."
780 msgstr ""
781
782 #. type: verbatim
783 #: ../../debconf-copydb:77
784 #, no-wrap
785 msgid ""
786 " debconf-copydb configdb backup\n"
787 "\n"
788 msgstr ""
789
790 #. type: textblock
791 #: ../../debconf-copydb:79
792 msgid ""
793 "Copy all of configdb to backup, assuming you already have the backup "
794 "database defined in debconf.conf."
795 msgstr ""
796
797 #. type: verbatim
798 #: ../../debconf-copydb:82
799 #, no-wrap
800 msgid ""
801 " debconf-copydb configdb newdb --pattern='^slrn/' \\\n"
802 " \t--config=Name:newdb --config=Driver:File \\\n"
803 "\t--config=Filename:newdb.dat\n"
804 "\n"
805 msgstr ""
806
807 #. type: textblock
808 #: ../../debconf-copydb:86
809 msgid ""
810 "Copy slrn's data out of configdb, and into newdb. newdb is not defined in "
811 "the rc file, so the --config switches set up the database on the fly."
812 msgstr ""
813
814 #. type: verbatim
815 #: ../../debconf-copydb:89
816 #, no-wrap
817 msgid ""
818 " debconf-copydb configdb stdout -c Name:stdout -c Driver:Pipe \\\n"
819 " \t-c InFd:none --pattern='^foo/'\n"
820 "\n"
821 msgstr ""
822
823 #. type: textblock
824 #: ../../debconf-copydb:92
825 msgid "Spit out all the items in the debconf database related to package foo."
826 msgstr ""
827
828 #. type: verbatim
829 #: ../../debconf-copydb:94
830 #, no-wrap
831 msgid ""
832 " debconf-copydb configdb pipe --config=Name:pipe \\\n"
833 " --config=Driver:Pipe --config=InFd:none | \\\n"
834 " \tssh remotehost debconf-copydb pipe configdb \\\n"
835 "\t\t--config=Name:pipe --config=Driver:Pipe\n"
836 "\n"
837 msgstr ""
838
839 #. type: textblock
840 #: ../../debconf-copydb:99
841 msgid ""
842 "This uses the special purpose pipe driver to copy a database to a remote "
843 "system."
844 msgstr ""
845
846 #. type: textblock
847 #: ../../debconf-copydb:104
848 msgid "L<debconf.conf(5)>"
849 msgstr ""
850
851 #. type: textblock
852 #: ../../debconf-getlang:5
853 msgid "debconf-getlang - extract a language from a templates file"
854 msgstr ""
855
856 #. type: verbatim
857 #: ../../debconf-getlang:18
858 #, no-wrap
859 msgid ""
860 " debconf-getlang lang master [translation]\n"
861 " debconf-getlang --stats master translation [...]\n"
862 "\n"
863 msgstr ""
864
865 #. type: textblock
866 #: ../../debconf-getlang:23
867 msgid ""
868 "Note: This utility is deprecated; you should switch to using the po-debconf "
869 "package."
870 msgstr ""
871
872 #. type: textblock
873 #: ../../debconf-getlang:25
874 msgid ""
875 "This program helps make and manage translations of debconf templates. There "
876 "are basically three situations in which this program might be called:"
877 msgstr ""
878
879 #. type: =item
880 #: ../../debconf-getlang:30
881 msgid "A translation is just being started."
882 msgstr ""
883
884 #. type: textblock
885 #: ../../debconf-getlang:32
886 msgid ""
887 "You want to provide the translator with a file they can work on that has the "
888 "English fields from your templates file, plus blank Field-ll fields for the "
889 "target language that they can fill in."
890 msgstr ""
891
892 #. type: textblock
893 #: ../../debconf-getlang:36
894 msgid ""
895 "To do this, run the program with first parameter being the code for the "
896 "language that is being translated to, and the second parameter being the "
897 "filename of the English templates file."
898 msgstr ""
899
900 #. type: =item
901 #: ../../debconf-getlang:40
902 msgid "A translation is well under way."
903 msgstr ""
904
905 #. type: textblock
906 #: ../../debconf-getlang:42
907 msgid ""
908 "You have changed some English text, or added more items to your templates "
909 "file, and you want to send the translators a file with the English text plus "
910 "their current translations (or you are the translator, and you want to "
911 "generate such a file for your own use)."
912 msgstr ""
913
914 #. type: textblock
915 #: ../../debconf-getlang:47
916 msgid ""
917 "To accomplish this, run the program with the first parameter being the the "
918 "code for the language that is being translated to, the second parameter "
919 "being the filename of the master English templates file, and the third "
920 "parameter being the filename of the current translated file."
921 msgstr ""
922
923 #. type: textblock
924 #: ../../debconf-getlang:52
925 msgid ""
926 "When run this way, the program is smart enough to notice fuzzy "
927 "translations. For example a fuzzy Description will be output as "
928 "Description-<lang>-fuzzy, and a new, blank Description-<lang> will be "
929 "added. Translators should remove the -fuzzy fields as they correct the "
930 "fuzzy translations."
931 msgstr ""
932
933 #. type: =item
934 #: ../../debconf-getlang:58
935 msgid "Checking the status of a translation"
936 msgstr ""
937
938 #. type: textblock
939 #: ../../debconf-getlang:60
940 msgid ""
941 "To check the status of a translation, use the --status flag, and pass the "
942 "english template file as the first parameter, and all the other translated "
943 "templates after that. It will output statistics for each of them. For "
944 "example:"
945 msgstr ""
946
947 #. type: verbatim
948 #: ../../debconf-getlang:65
949 #, no-wrap
950 msgid ""
951 " debconf-getlang --stats debian/templates debian/templates.*\n"
952 "\n"
953 msgstr ""
954
955 #. type: =head1
956 #: ../../debconf-getlang:69
957 msgid "NOTE"
958 msgstr ""
959
960 #. type: textblock
961 #: ../../debconf-getlang:71
962 msgid ""
963 "Note that the text in the generated templates may be word-wrapped by "
964 "debconf."
965 msgstr ""
966
967 #. type: textblock
968 #: ../../debconf-getlang:76
969 msgid "L<debconf-mergetemplate(1)>"
970 msgstr ""
971
972 #. type: textblock
973 #: ../../debconf-get-selections:5
974 msgid "debconf-get-selections - output contents of debconf database"
975 msgstr ""
976
977 #. type: textblock
978 #: ../../debconf-get-selections:9
979 msgid "debconf-get-selections [--installer]"
980 msgstr ""
981
982 #. type: textblock
983 #: ../../debconf-get-selections:13
984 msgid ""
985 "Output the current debconf database in a format understandable by "
986 "debconf-set-selections."
987 msgstr ""
988
989 #. type: textblock
990 #: ../../debconf-get-selections:16
991 msgid ""
992 "To dump the debconf database of the debian-installer, from "
993 "/var/log/installer/cdebconf, use the --installer parameter."
994 msgstr ""
995
996 #. type: textblock
997 #: ../../debconf-get-selections:80 ../../debconf-set-selections:228
998 msgid "Petter Reinholdtsen <[email protected]>"
999 msgstr ""
1000
1001 #. type: textblock
1002 #: ../../debconf-loadtemplate:5
1003 msgid "debconf-loadtemplate - load template file into debconf database"
1004 msgstr ""
1005
1006 #. type: verbatim
1007 #: ../../debconf-loadtemplate:16
1008 #, no-wrap
1009 msgid ""
1010 " debconf-loadtemplate owner file [file ..]\n"
1011 "\n"
1012 msgstr ""
1013
1014 #. type: textblock
1015 #: ../../debconf-loadtemplate:20
1016 msgid ""
1017 "Loads one or more template files into the debconf database. The first "
1018 "parameter specifies the owner of the templates (typically, the owner is the "
1019 "name of a debian package). The remaining parameters are template files to "
1020 "load."
1021 msgstr ""
1022
1023 #. type: textblock
1024 #: ../../debconf-loadtemplate:27
1025 msgid ""
1026 "This program should never be used from a maintainer script of a package that "
1027 "uses debconf! It may however, be useful in debugging, or to seed the debconf "
1028 "database."
1029 msgstr ""
1030
1031 #. type: textblock
1032 #: ../../debconf-loadtemplate:33
1033 msgid "L<debconf-communicate(1)>"
1034 msgstr ""
1035
1036 #. type: textblock
1037 #: ../../debconf-mergetemplate:5
1038 msgid "debconf-mergetemplate - merge together multiple debconf template files"
1039 msgstr ""
1040
1041 #. type: verbatim
1042 #: ../../debconf-mergetemplate:19
1043 #, no-wrap
1044 msgid ""
1045 " debconf-mergetemplate [options] [templates.ll ...] templates\n"
1046 "\n"
1047 msgstr ""
1048
1049 #. type: textblock
1050 #: ../../debconf-mergetemplate:23
1051 msgid ""
1052 "Note: This utility is deprecated. You should switch to using po-debconf's "
1053 "po2debconf program."
1054 msgstr ""
1055
1056 #. type: textblock
1057 #: ../../debconf-mergetemplate:26
1058 msgid ""
1059 "This program is useful if you have multiple debconf templates files which "
1060 "you want to merge together into one big file. All the specified files will "
1061 "be read in, merged, and output to standard output."
1062 msgstr ""
1063
1064 #. type: textblock
1065 #: ../../debconf-mergetemplate:30
1066 msgid ""
1067 "This can be especially useful if you are dealing with translated template "
1068 "files. In this case, you might have your main template file, plus several "
1069 "other files provided by the translators. These files will have translated "
1070 "fields in them, and maybe the translators left in the english versions of "
1071 "the fields they translated, for their reference."
1072 msgstr ""
1073
1074 #. type: textblock
1075 #: ../../debconf-mergetemplate:36
1076 msgid ""
1077 "So, you want to merge together all the translated templates files with your "
1078 "main templates file. Any fields that are unique to the translated files need "
1079 "to be added in to the correct templates, but any fields they have in common "
1080 "should be superseded by the fields in the main file (which might be more "
1081 "up-to-date)."
1082 msgstr ""
1083
1084 #. type: textblock
1085 #: ../../debconf-mergetemplate:42
1086 msgid ""
1087 "This program handles that case properly, just list each of the translated "
1088 "templates files, and then your main templates file last."
1089 msgstr ""
1090
1091 #. type: =item
1092 #: ../../debconf-mergetemplate:49
1093 msgid "--outdated"
1094 msgstr ""
1095
1096 #. type: textblock
1097 #: ../../debconf-mergetemplate:51
1098 msgid ""
1099 "Merge in even outdated translations. The default is to drop them with a "
1100 "warning message."
1101 msgstr ""
1102
1103 #. type: =item
1104 #: ../../debconf-mergetemplate:54
1105 msgid "--drop-old-templates"
1106 msgstr ""
1107
1108 #. type: textblock
1109 #: ../../debconf-mergetemplate:56
1110 msgid ""
1111 "If a translation has an entire template that is not in the master file (and "
1112 "thus is probably an old template), drop that entire template."
1113 msgstr ""
1114
1115 #. type: textblock
1116 #: ../../debconf-mergetemplate:63
1117 msgid "L<debconf-getlang(1)>"
1118 msgstr ""
1119
1120 #. type: textblock
1121 #: ../../debconf-set-selections:5
1122 msgid "debconf-set-selections - insert new values into the debconf database"
1123 msgstr ""
1124
1125 #. type: verbatim
1126 #: ../../debconf-set-selections:9
1127 #, no-wrap
1128 msgid ""
1129 " debconf-set-selections file\n"
1130 " debconf-get-selections | ssh newhost debconf-set-selections\n"
1131 "\n"
1132 msgstr ""
1133
1134 #. type: textblock
1135 #: ../../debconf-set-selections:14
1136 msgid ""
1137 "B<debconf-set-selections> can be used to pre-seed the debconf database with "
1138 "answers, or to change answers in the database. Each question will be marked "
1139 "as seen to prevent debconf from asking the question interactively."
1140 msgstr ""
1141
1142 #. type: textblock
1143 #: ../../debconf-set-selections:18
1144 msgid "Reads from a file if a filename is given, otherwise from stdin."
1145 msgstr ""
1146
1147 #. type: textblock
1148 #: ../../debconf-set-selections:22
1149 msgid ""
1150 "Only use this command to seed debconf values for packages that will be or "
1151 "are installed. Otherwise you can end up with values in the database for "
1152 "uninstalled packages that will not go away, or with worse problems involving "
1153 "shared values. It is recommended that this only be used to seed the database "
1154 "if the originating machine has an identical install."
1155 msgstr ""
1156
1157 #. type: =head1
1158 #: ../../debconf-set-selections:28
1159 msgid "DATA FORMAT"
1160 msgstr ""
1161
1162 #. type: textblock
1163 #: ../../debconf-set-selections:30
1164 msgid ""
1165 "The data is a series of lines. Lines beginning with a # character are "
1166 "comments. Blank lines are ignored. All other lines set the value of one "
1167 "question, and should contain four values, each separated by one character of "
1168 "whitespace. The first value is the name of the package that owns the "
1169 "question. The second is the name of the question, the third value is the "
1170 "type of this question, and the fourth value (through the end of the line) "
1171 "is the value to use for the answer of the question."
1172 msgstr ""
1173
1174 #. type: textblock
1175 #: ../../debconf-set-selections:38
1176 msgid ""
1177 "Alternatively, the third value can be \"seen\"; then the preseed line only "
1178 "controls whether the question is marked as seen in debconf's database. Note "
1179 "that preseeding a question's value defaults to marking that question as "
1180 "seen, so to override the default value without marking a question seen, you "
1181 "need two lines."
1182 msgstr ""
1183
1184 #. type: textblock
1185 #: ../../debconf-set-selections:44
1186 msgid ""
1187 "Lines can be continued to the next line by ending them with a \"\\\" "
1188 "character."
1189 msgstr ""
1190
1191 #. type: verbatim
1192 #: ../../debconf-set-selections:49
1193 #, no-wrap
1194 msgid ""
1195 " # Force debconf priority to critical.\n"
1196 " debconf debconf/priority select critical\n"
1197 "\n"
1198 msgstr ""
1199
1200 #. type: verbatim
1201 #: ../../debconf-set-selections:52
1202 #, no-wrap
1203 msgid ""
1204 " # Override default frontend to readline, but allow user to select.\n"
1205 " debconf debconf/frontend select readline\n"
1206 " debconf debconf/frontend seen false\n"
1207 "\n"
1208 msgstr ""
1209
1210 #. type: =item
1211 #: ../../debconf-set-selections:60
1212 msgid "B<--verbose>, B<-v>"
1213 msgstr ""
1214
1215 #. type: textblock
1216 #: ../../debconf-set-selections:62
1217 msgid "verbose output"
1218 msgstr ""
1219
1220 #. type: =item
1221 #: ../../debconf-set-selections:64
1222 msgid "B<--checkonly>, B<-c>"
1223 msgstr ""
1224
1225 #. type: textblock
1226 #: ../../debconf-set-selections:66
1227 msgid "only check the input file format, do not save changes to database"
1228 msgstr ""
1229
1230 #. type: textblock
1231 #: ../../debconf-set-selections:72
1232 msgid "L<debconf-get-selections(1)> (available in the debconf-utils package)"
1233 msgstr ""
1234
1235 #. type: textblock
1236 #: ../../debconf-show:5
1237 msgid "debconf-show - query the debconf database"
1238 msgstr ""
1239
1240 #. type: verbatim
1241 #: ../../debconf-show:9
1242 #, no-wrap
1243 msgid ""
1244 " debconf-show packagename [...] [--db=dbname]\n"
1245 " debconf-show --listowners [--db=dbname]\n"
1246 " debconf-show --listdbs\n"
1247 "\n"
1248 msgstr ""
1249
1250 #. type: textblock
1251 #: ../../debconf-show:15
1252 msgid "B<debconf-show> lets you query the debconf database in different ways."
1253 msgstr ""
1254
1255 #. type: textblock
1256 #: ../../debconf-show:17
1257 msgid ""
1258 "The most common use is \"debconf-show packagename\", which displays all "
1259 "items in the debconf database owned by a given package, and their current "
1260 "values. Questions that have been asked already are prefixed with an '*'."
1261 msgstr ""
1262
1263 #. type: textblock
1264 #: ../../debconf-show:21
1265 msgid ""
1266 "This can be useful as a debugging aid, and especially handy in bug reports "
1267 "involving a package's use of debconf."
1268 msgstr ""
1269
1270 #. type: =item
1271 #: ../../debconf-show:28
1272 msgid "B<--db=>I<dbname>"
1273 msgstr ""
1274
1275 #. type: textblock
1276 #: ../../debconf-show:30
1277 msgid ""
1278 "Specify the database to query. By default, debconf-show queries the main "
1279 "database."
1280 msgstr ""
1281
1282 #. type: =item
1283 #: ../../debconf-show:33
1284 msgid "B<--listowners>"
1285 msgstr ""
1286
1287 #. type: textblock
1288 #: ../../debconf-show:35
1289 msgid ""
1290 "Lists all owners of questions in the database. Generally an owner is "
1291 "equivalent to a debian package name."
1292 msgstr ""
1293
1294 #. type: =item
1295 #: ../../debconf-show:38
1296 msgid "B<--listdbs>"
1297 msgstr ""
1298
1299 #. type: textblock
1300 #: ../../debconf-show:40
1301 msgid "Lists all available databases."
1302 msgstr ""
1303
1304 #. type: textblock
1305 #: ../../debconf-show:154
1306 msgid "Joey Hess <[email protected]> and Sylvain Ferriol"
1307 msgstr ""
1308
1309 #. type: textblock
1310 #: ../../dpkg-preconfigure:5
1311 msgid "dpkg-preconfigure - let packages ask questions prior to their installation"
1312 msgstr ""
1313
1314 #. type: verbatim
1315 #: ../../dpkg-preconfigure:9
1316 #, no-wrap
1317 msgid ""
1318 " dpkg-preconfigure [options] package.deb\n"
1319 "\n"
1320 msgstr ""
1321
1322 #. type: verbatim
1323 #: ../../dpkg-preconfigure:11
1324 #, no-wrap
1325 msgid ""
1326 " dpkg-preconfigure --apt\n"
1327 "\n"
1328 msgstr ""
1329
1330 #. type: textblock
1331 #: ../../dpkg-preconfigure:15
1332 msgid ""
1333 "B<dpkg-preconfigure> lets packages ask questions before they are installed. "
1334 "It operates on a set of debian packages, and all packages that use debconf "
1335 "will have their config script run so they can examine the system and ask "
1336 "questions."
1337 msgstr ""
1338
1339 #. type: textblock
1340 #: ../../dpkg-preconfigure:30
1341 msgid ""
1342 "Set the lowest priority of questions you are interested in. Any questions "
1343 "with a priority below the selected priority will be ignored and their "
1344 "default answers will be used."
1345 msgstr ""
1346
1347 #. type: =item
1348 #: ../../dpkg-preconfigure:38
1349 msgid "B<--apt>"
1350 msgstr ""
1351
1352 #. type: textblock
1353 #: ../../dpkg-preconfigure:40
1354 msgid ""
1355 "Run in apt mode. It will expect to read a set of package filenames from "
1356 "stdin, rather than getting them as parameters. Typically this is used to "
1357 "make apt run dpkg-preconfigure on all packages before they are installed. "
1358 "To do this, add something like this to /etc/apt/apt.conf:"
1359 msgstr ""
1360
1361 #. type: verbatim
1362 #: ../../dpkg-preconfigure:45
1363 #, no-wrap
1364 msgid ""
1365 " // Pre-configure all packages before\n"
1366 " // they are installed.\n"
1367 " DPkg::Pre-Install-Pkgs {\n"
1368 " \t\"dpkg-preconfigure --apt --priority=low\";\n"
1369 " };\n"
1370 "\n"
1371 msgstr ""
1372
1373 #. type: =item
1374 #: ../../dpkg-preconfigure:51 ../../dpkg-reconfigure:69
1375 msgid "B<-h>, B<--help>"
1376 msgstr ""
1377
1378 #. type: textblock
1379 #: ../../dpkg-preconfigure:53 ../../dpkg-reconfigure:71
1380 msgid "Display usage help."
1381 msgstr ""
1382
1383 #. type: textblock
1384 #: ../../dpkg-preconfigure:61 ../../dpkg-reconfigure:79
1385 msgid "L<debconf(7)>"
1386 msgstr ""
1387
1388 #. type: textblock
1389 #: ../../dpkg-reconfigure:5
1390 msgid "dpkg-reconfigure - reconfigure an already installed package"
1391 msgstr ""
1392
1393 #. type: verbatim
1394 #: ../../dpkg-reconfigure:9
1395 #, no-wrap
1396 msgid ""
1397 " dpkg-reconfigure [options] packages\n"
1398 "\n"
1399 msgstr ""
1400
1401 #. type: textblock
1402 #: ../../dpkg-reconfigure:13
1403 msgid ""
1404 "B<dpkg-reconfigure> reconfigures packages after they have already been "
1405 "installed. Pass it the names of a package or packages to reconfigure. It "
1406 "will ask configuration questions, much like when the package was first "
1407 "installed."
1408 msgstr ""
1409
1410 #. type: textblock
1411 #: ../../dpkg-reconfigure:18
1412 msgid ""
1413 "If you just want to see the current configuration of a package, see "
1414 "L<debconf-show(1)> instead."
1415 msgstr ""
1416
1417 #. type: textblock
1418 #: ../../dpkg-reconfigure:27
1419 msgid ""
1420 "Select the frontend to use. The default frontend can be permanently changed "
1421 "by:"
1422 msgstr ""
1423
1424 #. type: verbatim
1425 #: ../../dpkg-reconfigure:30
1426 #, no-wrap
1427 msgid ""
1428 " dpkg-reconfigure debconf\n"
1429 "\n"
1430 msgstr ""
1431
1432 #. type: textblock
1433 #: ../../dpkg-reconfigure:32
1434 msgid ""
1435 "Note that if you normally have debconf set to use the noninteractive "
1436 "frontend, dpkg-reconfigure will use the dialog frontend instead, so you "
1437 "actually get to reconfigure the package."
1438 msgstr ""
1439
1440 #. type: textblock
1441 #: ../../dpkg-reconfigure:38
1442 msgid ""
1443 "Specify the minimum priority of question that will be displayed. "
1444 "dpkg-reconfigure normally shows low priority questions no matter what your "
1445 "default priority is. See L<debconf(7)> for a list."
1446 msgstr ""
1447
1448 #. type: =item
1449 #: ../../dpkg-reconfigure:46
1450 msgid "B<--default-priority>"
1451 msgstr ""
1452
1453 #. type: textblock
1454 #: ../../dpkg-reconfigure:48
1455 msgid ""
1456 "Use whatever the default priority of question is, instead of forcing the "
1457 "priority to low."
1458 msgstr ""
1459
1460 #. type: =item
1461 #: ../../dpkg-reconfigure:51
1462 msgid "B<-u>, B<--unseen-only>"
1463 msgstr ""
1464
1465 #. type: textblock
1466 #: ../../dpkg-reconfigure:53
1467 msgid ""
1468 "By default, all questions are shown, even if they have already been "
1469 "answered. If this parameter is set though, only questions that have not yet "
1470 "been seen will be asked."
1471 msgstr ""
1472
1473 #. type: =item
1474 #: ../../dpkg-reconfigure:57
1475 msgid "B<--force>"
1476 msgstr ""
1477
1478 #. type: textblock
1479 #: ../../dpkg-reconfigure:59
1480 msgid ""
1481 "Force dpkg-reconfigure to reconfigure a package even if the package is in an "
1482 "inconsistent or broken state. Use with caution."
1483 msgstr ""
1484
1485 #. type: =item
1486 #: ../../dpkg-reconfigure:62
1487 msgid "B<--no-reload>"
1488 msgstr ""
1489
1490 #. type: textblock
1491 #: ../../dpkg-reconfigure:64
1492 msgid ""
1493 "Prevent dpkg-reconfigure from reloading templates. Use with caution; this "
1494 "will prevent dpkg-reconfigure from repairing broken templates databases. "
1495 "However, it may be useful in constrained environments where rewriting the "
1496 "templates database is expensive."
1497 msgstr ""
1498
1499 #. type: TH
1500 #: debconf.conf.5:1
1501 #, no-wrap
1502 msgid "DEBCONF.CONF"
1503 msgstr ""
1504
1505 #. type: Plain text
1506 #: debconf.conf.5:4
1507 msgid "debconf.conf - debconf configuration file"
1508 msgstr ""
1509
1510 #. type: Plain text
1511 #: debconf.conf.5:12
1512 msgid ""
1513 "Debconf is a configuration system for Debian packages. /etc/debconf.conf and "
1514 "~/.debconfrc are configuration files debconf uses to determine which "
1515 "databases it should use. These databases are used for storing two types of "
1516 "information; dynamic config data the user enters into it, and static "
1517 "template data. Debconf offers a flexible, extensible database backend. New "
1518 "drivers can be created with a minimum of effort, and sets of drivers can be "
1519 "combined in various ways."
1520 msgstr ""
1521
1522 #. type: Plain text
1523 #: debconf.conf.5:17
1524 #, no-wrap
1525 msgid ""
1526 " # This is a sample config file that is\n"
1527 " # sufficient to use debconf.\n"
1528 " Config: configdb\n"
1529 " Templates: templatedb\n"
1530 msgstr ""
1531
1532 #. type: Plain text
1533 #: debconf.conf.5:21
1534 #, no-wrap
1535 msgid ""
1536 " Name: configdb\n"
1537 " Driver: File\n"
1538 " Filename: /var/cache/debconf/config.dat\n"
1539 msgstr ""
1540
1541 #. type: Plain text
1542 #: debconf.conf.5:26
1543 #, no-wrap
1544 msgid ""
1545 " Name: templatedb\n"
1546 " Driver: File\n"
1547 " Mode: 644\n"
1548 " Filename: /var/cache/debconf/templates.dat\n"
1549 msgstr ""
1550
1551 #. type: SH
1552 #: debconf.conf.5:26
1553 #, no-wrap
1554 msgid "FILE FORMAT"
1555 msgstr ""
1556
1557 #. type: Plain text
1558 #: debconf.conf.5:30
1559 msgid ""
1560 "The format of this file is a series of stanzas, each separated by at least "
1561 "one wholly blank line. Comment lines beginning with a \"#\" character are "
1562 "ignored."
1563 msgstr ""
1564
1565 #. type: Plain text
1566 #: debconf.conf.5:33
1567 msgid ""
1568 "The first stanza of the file is special, is used to configure debconf as a "
1569 "whole. Two fields are required to be in this first stanza:"
1570 msgstr ""
1571
1572 #. type: TP
1573 #: debconf.conf.5:34
1574 #, no-wrap
1575 msgid "B<Config>"
1576 msgstr ""
1577
1578 #. type: Plain text
1579 #: debconf.conf.5:37
1580 msgid "Specifies the name of the database from which to load config data."
1581 msgstr ""
1582
1583 #. type: TP
1584 #: debconf.conf.5:37
1585 #, no-wrap
1586 msgid "B<Templates>"
1587 msgstr ""
1588
1589 #. type: Plain text
1590 #: debconf.conf.5:40
1591 msgid "Specifies the name of the database to use for the template cache."
1592 msgstr ""
1593
1594 #. type: Plain text
1595 #: debconf.conf.5:43
1596 msgid "Additional fields that can be used include:"
1597 msgstr ""
1598
1599 #. type: TP
1600 #: debconf.conf.5:44
1601 #, no-wrap
1602 msgid "B<Frontend>"
1603 msgstr ""
1604
1605 #. type: Plain text
1606 #: debconf.conf.5:48
1607 msgid ""
1608 "The frontend Debconf should use, overriding any frontend set in the debconf "
1609 "database."
1610 msgstr ""
1611
1612 #. type: TP
1613 #: debconf.conf.5:48
1614 #, no-wrap
1615 msgid "B<Priority>"
1616 msgstr ""
1617
1618 #. type: Plain text
1619 #: debconf.conf.5:52
1620 msgid ""
1621 "The priority Debconf should use, overriding any priority set in the debconf "
1622 "database."
1623 msgstr ""
1624
1625 #. type: TP
1626 #: debconf.conf.5:52
1627 #, no-wrap
1628 msgid "B<Admin-Email>"
1629 msgstr ""
1630
1631 #. type: Plain text
1632 #: debconf.conf.5:59
1633 msgid ""
1634 "The email address Debconf should send mail to if it needs to make sure that "
1635 "the admin has seen an important message. Defaults to \"root\", but can be "
1636 "set to any valid email address to send the mail there. If you prefer to "
1637 "never have debconf send you mail, specify a blank address. This can be "
1638 "overridden on the fly with the DEBCONF_ADMIN_EMAIL environment variable."
1639 msgstr ""
1640
1641 #. type: Plain text
1642 #: debconf.conf.5:59 debconf.conf.5:395
1643 #, no-wrap
1644 msgid "B<Debug>"
1645 msgstr ""
1646
1647 #. type: Plain text
1648 #: debconf.conf.5:67
1649 msgid ""
1650 "If set, this will cause debconf to output debugging information to standard "
1651 "error. The value it is set to can be something like \"user\", \"developer\", "
1652 "\"db\", or a regular expression. Typically, rather than setting it "
1653 "permanently in a config file, you will only want to temporarily turn on "
1654 "debugging, and the DEBCONF_DEBUG environment variable can be set instead to "
1655 "accomplish that."
1656 msgstr ""
1657
1658 #. type: TP
1659 #: debconf.conf.5:67
1660 #, no-wrap
1661 msgid "B<NoWarnings>"
1662 msgstr ""
1663
1664 #. type: Plain text
1665 #: debconf.conf.5:72
1666 msgid ""
1667 "If set, this will make debconf not display warnings about various things. "
1668 "This can be overridden on the fly with the DEBCONF_NOWARNINGS environment "
1669 "variable."
1670 msgstr ""
1671
1672 #. type: TP
1673 #: debconf.conf.5:72
1674 #, no-wrap
1675 msgid "B<Log>"
1676 msgstr ""
1677
1678 #. type: Plain text
1679 #: debconf.conf.5:77
1680 msgid ""
1681 "Makes debconf log debugging information as it runs, to the syslog. The value "
1682 "it is set to controls that is logged. See Debug, above for an explanation of "
1683 "the values that can be set to control what is logged."
1684 msgstr ""
1685
1686 #. type: TP
1687 #: debconf.conf.5:77
1688 #, no-wrap
1689 msgid "B<Terse>"
1690 msgstr ""
1691
1692 #. type: Plain text
1693 #: debconf.conf.5:82
1694 msgid ""
1695 "If set to \"true\", makes some debconf frontends use a special terse display "
1696 "mode that outputs as little as possible. Defaults to false. Terse mode may "
1697 "be temporarily set via the DEBCONF_TERSE environment variable."
1698 msgstr ""
1699
1700 #. type: Plain text
1701 #: debconf.conf.5:87
1702 #, no-wrap
1703 msgid ""
1704 "For example, the first stanza of a file might look like this:\n"
1705 " Config: configdb\n"
1706 " Templates: templatedb\n"
1707 msgstr ""
1708
1709 #. type: Plain text
1710 #: debconf.conf.5:91
1711 #, no-wrap
1712 msgid ""
1713 "Each remaining stanza in the file sets up a database. A database stanza\n"
1714 "begins by naming the database:\n"
1715 " Name: configdb\n"
1716 msgstr ""
1717
1718 #. type: Plain text
1719 #: debconf.conf.5:95
1720 #, no-wrap
1721 msgid ""
1722 "Then it indicates what database driver should be used for this database.\n"
1723 "See DRIVERS, below, for information about what drivers are available.\n"
1724 " Driver: File\n"
1725 msgstr ""
1726
1727 #. type: Plain text
1728 #: debconf.conf.5:100
1729 #, no-wrap
1730 msgid ""
1731 "You can indicate that the database is not essential to the proper\n"
1732 "functioning of debconf by saying it is not required. This will make "
1733 "debconf\n"
1734 "muddle on if the database fails for some reason.\n"
1735 " Required: false\n"
1736 msgstr ""
1737
1738 #. type: Plain text
1739 #: debconf.conf.5:104
1740 #, no-wrap
1741 msgid ""
1742 "You can mark any database as readonly and debconf will not write anything\n"
1743 "to it.\n"
1744 " Readonly: true\n"
1745 msgstr ""
1746
1747 #. type: Plain text
1748 #: debconf.conf.5:107
1749 msgid ""
1750 "You can also limit what types of data can go into the database with Accept- "
1751 "and Reject- lines; see ACCESS CONTROLS, below."
1752 msgstr ""
1753
1754 #. type: Plain text
1755 #: debconf.conf.5:112
1756 #, no-wrap
1757 msgid ""
1758 "The remainder of each database stanza is used to provide configuration\n"
1759 "specific to that driver. For example, the Text driver needs to know\n"
1760 "a directory to put the database in, so you might say:\n"
1761 " Filename: /var/cache/debconf/config.dat\n"
1762 msgstr ""
1763
1764 #. type: SH
1765 #: debconf.conf.5:112
1766 #, no-wrap
1767 msgid "DRIVERS"
1768 msgstr ""
1769
1770 #. type: Plain text
1771 #: debconf.conf.5:119
1772 msgid ""
1773 "A number of drivers are available, and more can be written with little "
1774 "difficulty. Drivers come in two general types. First there are real drivers "
1775 "-- drivers that actually access and store data in some kind of database, "
1776 "which might be on the local filesystem, or on a remote system. Then there "
1777 "are meta-drivers that combine other drivers together to form more "
1778 "interesting systems. Let's start with the former."
1779 msgstr ""
1780
1781 #. type: TP
1782 #: debconf.conf.5:120
1783 #, no-wrap
1784 msgid "B<File>"
1785 msgstr ""
1786
1787 #. type: Plain text
1788 #: debconf.conf.5:127
1789 msgid ""
1790 "This database driver allows debconf to store a whole database in a single "
1791 "flat text file. This makes it easy to archive, transfer between machines, "
1792 "and edit. It is one of the more compact database formats in terms of disk "
1793 "space used. It is also one of the slowest."
1794 msgstr ""
1795
1796 #. type: Plain text
1797 #: debconf.conf.5:130
1798 msgid ""
1799 "On the downside, the entire file has to be read in each time debconf starts "
1800 "up, and saving it is also slow."
1801 msgstr ""
1802
1803 #. type: Plain text
1804 #: debconf.conf.5:132 debconf.conf.5:168 debconf.conf.5:238 debconf.conf.5:309
1805 msgid "The following things are configurable for this driver."
1806 msgstr ""
1807
1808 #. type: TP
1809 #: debconf.conf.5:133
1810 #, no-wrap
1811 msgid "B<Filename>"
1812 msgstr ""
1813
1814 #. type: Plain text
1815 #: debconf.conf.5:136
1816 msgid "The file to use as the database. This is a required field."
1817 msgstr ""
1818
1819 #. type: TP
1820 #: debconf.conf.5:136 debconf.conf.5:203
1821 #, no-wrap
1822 msgid "B<Mode>"
1823 msgstr ""
1824
1825 #. type: Plain text
1826 #: debconf.conf.5:140
1827 msgid ""
1828 "The permissions to create the file with if it does not exist. Defaults to "
1829 "600, since the file could contain passwords in some circumstances."
1830 msgstr ""
1831
1832 #. type: TP
1833 #: debconf.conf.5:140 debconf.conf.5:176 debconf.conf.5:310
1834 #, no-wrap
1835 msgid "B<Format>"
1836 msgstr ""
1837
1838 #. type: Plain text
1839 #: debconf.conf.5:144 debconf.conf.5:180
1840 msgid ""
1841 "The format of the file. See FORMATS below. Defaults to using a rfc-822 like "
1842 "format."
1843 msgstr ""
1844
1845 #. type: Plain text
1846 #: debconf.conf.5:144 debconf.conf.5:180 debconf.conf.5:371
1847 #, no-wrap
1848 msgid "B<Backup>"
1849 msgstr ""
1850
1851 #. type: Plain text
1852 #: debconf.conf.5:148 debconf.conf.5:184
1853 msgid ""
1854 "Whether a backup should be made of the old file before changing it. "
1855 "Defaults to true."
1856 msgstr ""
1857
1858 #. type: Plain text
1859 #: debconf.conf.5:151 debconf.conf.5:187 debconf.conf.5:209
1860 msgid "As example stanza setting up a database using this driver:"
1861 msgstr ""
1862
1863 #. type: Plain text
1864 #: debconf.conf.5:155
1865 #, no-wrap
1866 msgid ""
1867 " Name: mydb\n"
1868 " Driver: File\n"
1869 " Filename: /var/cache/debconf/mydb.dat\n"
1870 msgstr ""
1871
1872 #. type: TP
1873 #: debconf.conf.5:156
1874 #, no-wrap
1875 msgid "B<DirTree>"
1876 msgstr ""
1877
1878 #. type: Plain text
1879 #: debconf.conf.5:166
1880 msgid ""
1881 "This database driver allows debconf to store data in a hierarchical "
1882 "directory structure. The names of the various debconf templates and "
1883 "questions are used as-is to form directories with files in them. This format "
1884 "for the database is the easiest to browse and fiddle with by hand. It has "
1885 "very good load and save speeds. It also typically occupies the most space, "
1886 "since a lot of small files and subdirectories do take up some additional "
1887 "room."
1888 msgstr ""
1889
1890 #. type: TP
1891 #: debconf.conf.5:169
1892 #, no-wrap
1893 msgid "B<Directory>"
1894 msgstr ""
1895
1896 #. type: Plain text
1897 #: debconf.conf.5:172
1898 msgid "The directory to put the files in. Required."
1899 msgstr ""
1900
1901 #. type: TP
1902 #: debconf.conf.5:172
1903 #, no-wrap
1904 msgid "B<Extension>"
1905 msgstr ""
1906
1907 #. type: Plain text
1908 #: debconf.conf.5:176
1909 msgid ""
1910 "An extension to add to the names of files. Must be set to a non-empty "
1911 "string; defaults to \".dat\""
1912 msgstr ""
1913
1914 #. type: Plain text
1915 #: debconf.conf.5:192
1916 #, no-wrap
1917 msgid ""
1918 " Name: mydb\n"
1919 " Driver: DirTree\n"
1920 " Directory: /var/cache/debconf/mydb\n"
1921 " Extension: .txt\n"
1922 msgstr ""
1923
1924 #. type: TP
1925 #: debconf.conf.5:193
1926 #, no-wrap
1927 msgid "B<PackageDir>"
1928 msgstr ""
1929
1930 #. type: Plain text
1931 #: debconf.conf.5:200
1932 msgid ""
1933 "This database driver is a compromise between the File and DirTree "
1934 "databases. It uses a directory, in which there is (approximately) one file "
1935 "per package that uses debconf. This is fairly fast, while using little more "
1936 "room than the File database driver."
1937 msgstr ""
1938
1939 #. type: Plain text
1940 #: debconf.conf.5:203
1941 msgid "This driver is configurable in the same ways as is the DirTree driver, plus:"
1942 msgstr ""
1943
1944 #. type: Plain text
1945 #: debconf.conf.5:207
1946 msgid ""
1947 "The permissions to create files with. Defaults to 600, since the files could "
1948 "contain passwords in some circumstances."
1949 msgstr ""
1950
1951 #. type: Plain text
1952 #: debconf.conf.5:213
1953 #, no-wrap
1954 msgid ""
1955 " Name: mydb\n"
1956 " Driver: PackageDir\n"
1957 " Directory: /var/cache/debconf/mydb\n"
1958 msgstr ""
1959
1960 #. type: TP
1961 #: debconf.conf.5:214
1962 #, no-wrap
1963 msgid "B<LDAP>"
1964 msgstr ""
1965
1966 #. type: Plain text
1967 #: debconf.conf.5:218
1968 msgid "WARNING: This database driver is currently experimental. Use with caution."
1969 msgstr ""
1970
1971 #. type: Plain text
1972 #: debconf.conf.5:226
1973 msgid ""
1974 "This database driver accesses a LDAP directory for debconf configuration "
1975 "data. Due to the nature of the beast, LDAP directories should typically be "
1976 "accessed in read-only mode. This is because multiple accesses can take "
1977 "place, and it's generally better for data consistency if nobody tries to "
1978 "modify the data while this is happening. Of course, write access is "
1979 "supported for those cases where you do want to update the config data in the "
1980 "directory."
1981 msgstr ""
1982
1983 #. type: Plain text
1984 #: debconf.conf.5:229
1985 msgid ""
1986 "For information about setting up a LDAP server for debconf, read "
1987 "/usr/share/doc/debconf-doc/README.LDAP (from the debconf-doc package)."
1988 msgstr ""
1989
1990 #. type: Plain text
1991 #: debconf.conf.5:232
1992 msgid ""
1993 "To use this database driver, you must have the libnet-ldap-perl package "
1994 "installed. Debconf suggests that package, but does not depend on it."
1995 msgstr ""
1996
1997 #. type: Plain text
1998 #: debconf.conf.5:236
1999 msgid ""
2000 "Please carefully consider the security implications of using a remote "
2001 "debconf database. Unless you trust the source, and you trust the intervening "
2002 "network, it is not a very safe thing to do."
2003 msgstr ""
2004
2005 #. type: TP
2006 #: debconf.conf.5:239
2007 #, no-wrap
2008 msgid "B<server>"
2009 msgstr ""
2010
2011 #. type: Plain text
2012 #: debconf.conf.5:242
2013 msgid "The host name or IP address of an LDAP server to connect to."
2014 msgstr ""
2015
2016 #. type: TP
2017 #: debconf.conf.5:242
2018 #, no-wrap
2019 msgid "B<port>"
2020 msgstr ""
2021
2022 #. type: Plain text
2023 #: debconf.conf.5:246
2024 msgid ""
2025 "The port on which to connect to the LDAP server. If none is given, the "
2026 "default port is used."
2027 msgstr ""
2028
2029 #. type: TP
2030 #: debconf.conf.5:246
2031 #, no-wrap
2032 msgid "B<basedn>"
2033 msgstr ""
2034
2035 #. type: Plain text
2036 #: debconf.conf.5:251
2037 msgid ""
2038 "The DN under which all config items will be stored. Each config item will be "
2039 "assumed to live in a DN of cn=E<lt>item nameE<gt>,E<lt>Base DNE<gt>. If this "
2040 "structure is not followed, all bets are off."
2041 msgstr ""
2042
2043 #. type: TP
2044 #: debconf.conf.5:251
2045 #, no-wrap
2046 msgid "B<binddn>"
2047 msgstr ""
2048
2049 #. type: Plain text
2050 #: debconf.conf.5:255
2051 msgid ""
2052 "The DN to bind to the directory as. Anonymous bind will be used if none is "
2053 "specified."
2054 msgstr ""
2055
2056 #. type: TP
2057 #: debconf.conf.5:255
2058 #, no-wrap
2059 msgid "B<bindpasswd>"
2060 msgstr ""
2061
2062 #. type: Plain text
2063 #: debconf.conf.5:259
2064 msgid ""
2065 "The password to use in an authenticated bind (used with binddn, above). If "
2066 "not specified, anonymous bind will be used."
2067 msgstr ""
2068
2069 #. type: Plain text
2070 #: debconf.conf.5:265
2071 msgid ""
2072 "This option should not be used in the general case. Anonymous binding should "
2073 "be sufficient most of the time for read-only access. Specifying a bind DN "
2074 "and password should be reserved for the occasional case where you wish to "
2075 "update the debconf configuration data."
2076 msgstr ""
2077
2078 #. type: TP
2079 #: debconf.conf.5:266
2080 #, no-wrap
2081 msgid "B<keybykey>"
2082 msgstr ""
2083
2084 #. type: Plain text
2085 #: debconf.conf.5:272
2086 msgid ""
2087 "Enable access to individual LDAP entries, instead of fetching them all at "
2088 "once in the beginning. This is very useful if you want to monitor your LDAP "
2089 "logs for specific debconf keys requested. In this way, you could also write "
2090 "custom handling code on the LDAP server part."
2091 msgstr ""
2092
2093 #. type: Plain text
2094 #: debconf.conf.5:279
2095 msgid ""
2096 "Note that when this option is enabled, the connection to the LDAP server is "
2097 "kept active during the whole Debconf run. This is a little different from "
2098 "the all-in-one behavior where two brief connections are made to LDAP; in the "
2099 "beginning to retrieve all the entries, and in the end to save eventual "
2100 "changes."
2101 msgstr ""
2102
2103 #. type: Plain text
2104 #: debconf.conf.5:284
2105 msgid ""
2106 "An example stanza setting up a database using this driver, assuming the "
2107 "remote database is on example.com and can be accessed anonymously:"
2108 msgstr ""
2109
2110 #. type: Plain text
2111 #: debconf.conf.5:291
2112 #, no-wrap
2113 msgid ""
2114 " Name: ldapdb\n"
2115 " Driver: LDAP\n"
2116 " Readonly: true\n"
2117 " Server: example.com\n"
2118 " BaseDN: cn=debconf,dc=example,dc=com\n"
2119 " KeyByKey: 0\n"
2120 msgstr ""
2121
2122 #. type: Plain text
2123 #: debconf.conf.5:294
2124 msgid ""
2125 "Another example, this time the LDAP database is on localhost, and can be "
2126 "written to:"
2127 msgstr ""
2128
2129 #. type: Plain text
2130 #: debconf.conf.5:301
2131 #, no-wrap
2132 msgid ""
2133 " Name: ldapdb\n"
2134 " Driver: LDAP\n"
2135 " Server: localhost\n"
2136 " BaseDN: cn=debconf,dc=domain,dc=com\n"
2137 " BindPasswd: secret\n"
2138 " KeyByKey: 1\n"
2139 msgstr ""
2140
2141 #. type: TP
2142 #: debconf.conf.5:302
2143 #, no-wrap
2144 msgid "B<Pipe>"
2145 msgstr ""
2146
2147 #. type: Plain text
2148 #: debconf.conf.5:307
2149 msgid ""
2150 "This special-purpose database driver reads and writes the database from "
2151 "standard input/output. It may be useful for people with special needs."
2152 msgstr ""
2153
2154 #. type: Plain text
2155 #: debconf.conf.5:314
2156 msgid ""
2157 "The format to read and write. See FORMATS below. Defaults to using a rfc-822 "
2158 "like format."
2159 msgstr ""
2160
2161 #. type: TP
2162 #: debconf.conf.5:314
2163 #, no-wrap
2164 msgid "B<Infd>"
2165 msgstr ""
2166
2167 #. type: Plain text
2168 #: debconf.conf.5:318
2169 msgid ""
2170 "File descriptor number to read from. Defaults to reading from stdin. If set "
2171 "to \"none\", the database will not read any data on startup."
2172 msgstr ""
2173
2174 #. type: TP
2175 #: debconf.conf.5:318
2176 #, no-wrap
2177 msgid "B<Outfd>"
2178 msgstr ""
2179
2180 #. type: Plain text
2181 #: debconf.conf.5:322
2182 msgid ""
2183 "File descriptor number to write to. Defaults to writing to stdout. If set to "
2184 "\"none\", the database will be thrown away on shutdown."
2185 msgstr ""
2186
2187 #. type: Plain text
2188 #: debconf.conf.5:326
2189 msgid "That's all of the real drivers, now moving on to meta-drivers.."
2190 msgstr ""
2191
2192 #. type: TP
2193 #: debconf.conf.5:326 debconf.conf.5:354
2194 #, no-wrap
2195 msgid "B<Stack>"
2196 msgstr ""
2197
2198 #. type: Plain text
2199 #: debconf.conf.5:335
2200 msgid ""
2201 "This driver stacks up a number of other databases (of any type), and allows "
2202 "them to be accessed as one. When debconf asks for a value, the first "
2203 "database on the stack that contains the value returns it. If debconf writes "
2204 "something to the database, the write normally goes to the first driver on "
2205 "the stack that has the item debconf is modifying, and if none do, the new "
2206 "item is added to the first writable database on the stack."
2207 msgstr ""
2208
2209 #. type: Plain text
2210 #: debconf.conf.5:343
2211 msgid ""
2212 "Things become more interesting if one of the databases on the stack is "
2213 "readonly. Consider a stack of the databases foo, bar, and baz, where foo and "
2214 "baz are both readonly. Debconf wants to change an item, and this item is "
2215 "only present in baz, which is readonly. The stack driver is smart enough to "
2216 "realize that won't work, and it will copy the item from baz to bar, and the "
2217 "write will take place in bar. Now the item in baz is shadowed by the item in "
2218 "bar, and it will not longer be visible to debconf."
2219 msgstr ""
2220
2221 #. type: Plain text
2222 #: debconf.conf.5:350
2223 msgid ""
2224 "This kind of thing is particularly useful if you want to point many systems "
2225 "at a central, readonly database, while still allowing things to be "
2226 "overridden on each system. When access controls are added to the picture, "
2227 "stacks allow you to do many other interesting things, like redirect all "
2228 "passwords to one database while a database underneath it handles everything "
2229 "else."
2230 msgstr ""
2231
2232 #. type: Plain text
2233 #: debconf.conf.5:352
2234 msgid "Only one piece of configuration is needed to set up a stack:"
2235 msgstr ""
2236
2237 #. type: Plain text
2238 #: debconf.conf.5:358
2239 msgid ""
2240 "This is where you specify a list of other databases, by name, to tell it "
2241 "what makes up the stack."
2242 msgstr ""
2243
2244 #. type: Plain text
2245 #: debconf.conf.5:361 debconf.conf.5:387
2246 msgid "For example:"
2247 msgstr ""
2248
2249 #. type: Plain text
2250 #: debconf.conf.5:365
2251 #, no-wrap
2252 msgid ""
2253 " Name: megadb\n"
2254 " Driver: stack\n"
2255 " Stack: passworddb, configdb, companydb\n"
2256 msgstr ""
2257
2258 #. type: Plain text
2259 #: debconf.conf.5:368
2260 msgid "WARNING: The stack driver is not very well tested yet. Use at your own risk."
2261 msgstr ""
2262
2263 #. type: Plain text
2264 #: debconf.conf.5:374
2265 msgid ""
2266 "This driver passes all requests on to another database driver. But it also "
2267 "copies all write requests to a backup database driver."
2268 msgstr ""
2269
2270 #. type: Plain text
2271 #: debconf.conf.5:376 debconf.conf.5:400
2272 msgid "You must specify the following fields to set up this driver:"
2273 msgstr ""
2274
2275 #. type: TP
2276 #: debconf.conf.5:378 debconf.conf.5:402
2277 #, no-wrap
2278 msgid "B<Db>"
2279 msgstr ""
2280
2281 #. type: Plain text
2282 #: debconf.conf.5:381 debconf.conf.5:405
2283 msgid "The database to read from and write to."
2284 msgstr ""
2285
2286 #. type: TP
2287 #: debconf.conf.5:381
2288 #, no-wrap
2289 msgid "B<Backupdb>"
2290 msgstr ""
2291
2292 #. type: Plain text
2293 #: debconf.conf.5:384
2294 msgid "The name of the database to send copies of writes to."
2295 msgstr ""
2296
2297 #. type: Plain text
2298 #: debconf.conf.5:392
2299 #, no-wrap
2300 msgid ""
2301 " Name: backup\n"
2302 " Driver: Backup\n"
2303 " Db: mydb\n"
2304 " Backupdb: mybackupdb\n"
2305 msgstr ""
2306
2307 #. type: Plain text
2308 #: debconf.conf.5:398
2309 msgid ""
2310 "This driver passes all requests on to another database driver, outputting "
2311 "verbose debugging output about the request and the result."
2312 msgstr ""
2313
2314 #. type: SH
2315 #: debconf.conf.5:407
2316 #, no-wrap
2317 msgid "ACCESS CONTROLS"
2318 msgstr ""
2319
2320 #. type: Plain text
2321 #: debconf.conf.5:411
2322 msgid ""
2323 "When you set up a database, you can also use some fields to specify access "
2324 "controls. You can specify that a database only accepts passwords, for "
2325 "example, or make a database only accept things with \"foo\" in their name."
2326 msgstr ""
2327
2328 #. type: TP
2329 #: debconf.conf.5:411
2330 #, no-wrap
2331 msgid "B<Readonly>"
2332 msgstr ""
2333
2334 #. type: Plain text
2335 #: debconf.conf.5:416
2336 msgid ""
2337 "As was mentioned earlier, this access control, if set to \"true\", makes a "
2338 "database readonly. Debconf will read values from it, but will never write "
2339 "anything to it."
2340 msgstr ""
2341
2342 #. type: TP
2343 #: debconf.conf.5:416
2344 #, no-wrap
2345 msgid "B<Accept-Name>"
2346 msgstr ""
2347
2348 #. type: Plain text
2349 #: debconf.conf.5:422
2350 msgid ""
2351 "The text in this field is a perl-compatible regular expression that is "
2352 "matched against the names of items as they are requested from the "
2353 "database. Only if an items name matches the regular expression, will the "
2354 "database allow debconf to access or modify it."
2355 msgstr ""
2356
2357 #. type: TP
2358 #: debconf.conf.5:422
2359 #, no-wrap
2360 msgid "B<Reject-Name>"
2361 msgstr ""
2362
2363 #. type: Plain text
2364 #: debconf.conf.5:426
2365 msgid ""
2366 "Like Accept-Name, except any item name matching this regular expression will "
2367 "be rejected."
2368 msgstr ""
2369
2370 #. type: TP
2371 #: debconf.conf.5:426
2372 #, no-wrap
2373 msgid "B<Accept-Type>"
2374 msgstr ""
2375
2376 #. type: Plain text
2377 #: debconf.conf.5:431
2378 msgid ""
2379 "Another regular expression, this matches against the type of the item that "
2380 "is being accessed. Only if the type matches the regex will access be "
2381 "granted."
2382 msgstr ""
2383
2384 #. type: TP
2385 #: debconf.conf.5:431
2386 #, no-wrap
2387 msgid "B<Reject-Type>"
2388 msgstr ""
2389
2390 #. type: Plain text
2391 #: debconf.conf.5:435
2392 msgid ""
2393 "Like Accept-Type, except any type matching this regular expression will be "
2394 "rejected."
2395 msgstr ""
2396
2397 #. type: SH
2398 #: debconf.conf.5:435
2399 #, no-wrap
2400 msgid "FORMATS"
2401 msgstr ""
2402
2403 #. type: Plain text
2404 #: debconf.conf.5:439
2405 msgid ""
2406 "Some of the database drivers use format modules to control the actual format "
2407 "in which the database is stored on disk. These formats are currently "
2408 "supported:"
2409 msgstr ""
2410
2411 #. type: TP
2412 #: debconf.conf.5:439
2413 #, no-wrap
2414 msgid "B<822>"
2415 msgstr ""
2416
2417 #. type: Plain text
2418 #: debconf.conf.5:444
2419 msgid ""
2420 "This is a file format loosely based upon the rfc-822 format for email "
2421 "message headers. Similar formats are used throughout Debian; in the dpkg "
2422 "status file, and so on."
2423 msgstr ""
2424
2425 #. type: Plain text
2426 #: debconf.conf.5:446
2427 msgid "Here is a more complicated example of a debconf.conf file."
2428 msgstr ""
2429
2430 #. type: Plain text
2431 #: debconf.conf.5:452
2432 #, no-wrap
2433 msgid ""
2434 " # This stanza is used for general debconf setup.\n"
2435 " Config: stack\n"
2436 " Templates: templates\n"
2437 " Log: developer\n"
2438 " Debug: developer\n"
2439 msgstr ""
2440
2441 #. type: Plain text
2442 #: debconf.conf.5:457
2443 #, no-wrap
2444 msgid ""
2445 " # This is my own local database.\n"
2446 " Name: mydb\n"
2447 " Driver: DirTree\n"
2448 " Directory: /var/cache/debconf/config\n"
2449 msgstr ""
2450
2451 #. type: Plain text
2452 #: debconf.conf.5:469
2453 #, no-wrap
2454 msgid ""
2455 " # This is another database that I use to hold\n"
2456 " # only X server configuration.\n"
2457 " Name: X\n"
2458 " Driver: File\n"
2459 " Filename: /etc/X11/debconf.dat\n"
2460 " Mode: 644\n"
2461 " # It's sorta hard to work out what questions\n"
2462 " # belong to X; it should be using a deeper\n"
2463 " # tree structure so I could just match on ^X/\n"
2464 " # Oh well.\n"
2465 " Accept-Name: xserver|xfree86|xbase\n"
2466 msgstr ""
2467
2468 #. type: Plain text
2469 #: debconf.conf.5:485
2470 #, no-wrap
2471 msgid ""
2472 " # This is our company's global, read-only\n"
2473 " # (for me!) debconf database.\n"
2474 " Name: company\n"
2475 " Driver: LDAP\n"
2476 " Server: debconf.foo.com\n"
2477 " BaseDN: cn=debconf,dc=foo,dc=com\n"
2478 " BindDN: uid=admin,dc=foo,dc=com\n"
2479 " BindPasswd: secret\n"
2480 " Readonly: true\n"
2481 " # I don't want any passwords that might be\n"
2482 " # floating around in there.\n"
2483 " Reject-Type: password\n"
2484 " # If this db is not accessible for whatever\n"
2485 " # reason, carry on anyway.\n"
2486 " Required: false\n"
2487 msgstr ""
2488
2489 #. type: Plain text
2490 #: debconf.conf.5:493
2491 #, no-wrap
2492 msgid ""
2493 " # I use this database to hold\n"
2494 " # passwords safe and secure.\n"
2495 " Name: passwords\n"
2496 " Driver: File\n"
2497 " Filename: /etc/debconf/passwords\n"
2498 " Mode: 600\n"
2499 " Accept-Type: password\n"
2500 msgstr ""
2501
2502 #. type: Plain text
2503 #: debconf.conf.5:506
2504 #, no-wrap
2505 msgid ""
2506 " # Let's put them all together\n"
2507 " # in a database stack.\n"
2508 " Name: stack\n"
2509 " Driver: Stack\n"
2510 " Stack: passwords, X, mydb, company\n"
2511 " # So, all passwords go to the password database.\n"
2512 " # Most X configuration stuff goes to the X\n"
2513 " # database, and anything else goes to my main\n"
2514 " # database. Values are looked up in each of those\n"
2515 " # in turn, and if none has a particular value, it\n"
2516 " # is looked up in the company-wide LDAP database\n"
2517 " # (unless it's a password).\n"
2518 msgstr ""
2519
2520 #. type: Plain text
2521 #: debconf.conf.5:514
2522 #, no-wrap
2523 msgid ""
2524 " # A database is also used to hold templates. We\n"
2525 " # don't need to make this as fancy.\n"
2526 " Name: templates\n"
2527 " Driver: File\n"
2528 " Mode: 644\n"
2529 " Format: 822\n"
2530 " Filename: /var/cache/debconf/templates\n"
2531 msgstr ""
2532
2533 #. type: SH
2534 #: debconf.conf.5:514 confmodule.3:22
2535 #, no-wrap
2536 msgid "NOTES"
2537 msgstr ""
2538
2539 #. type: Plain text
2540 #: debconf.conf.5:517
2541 msgid ""
2542 "If you use something like ${HOME} in this file, it will be replaced with the "
2543 "value of the named environment variable."
2544 msgstr ""
2545
2546 #. type: Plain text
2547 #: debconf.conf.5:521
2548 msgid ""
2549 "Environment variables can also be used to override the databases on the fly, "
2550 "see B<debconf>(7)"
2551 msgstr ""
2552
2553 #. type: Plain text
2554 #: debconf.conf.5:524
2555 msgid ""
2556 "The field names (the part of the line before the colon) is "
2557 "case-insensitive. The values, though, are case sensitive."
2558 msgstr ""
2559
2560 #. type: SH
2561 #: debconf.conf.5:524
2562 #, no-wrap
2563 msgid "PLANNED ENHANCEMENTS"
2564 msgstr ""
2565
2566 #. type: Plain text
2567 #: debconf.conf.5:533
2568 msgid ""
2569 "More drivers and formats. Some ideas include: A SQL driver, with the "
2570 "capability to access a remote database. A DHCP driver, that makes available "
2571 "some special things like hostname, IP address, and DNS servers. A driver "
2572 "that pulls values out of public DNS records TXT fields. A format that is "
2573 "compatible with the output of cdebconf. An override driver, which can "
2574 "override the value field or flags of all requests that pass through it."
2575 msgstr ""
2576
2577 #. type: SH
2578 #: debconf.conf.5:533
2579 #, no-wrap
2580 msgid "FILES"
2581 msgstr ""
2582
2583 #. type: Plain text
2584 #: debconf.conf.5:535
2585 msgid "/etc/debconf.conf"
2586 msgstr ""
2587
2588 #. type: Plain text
2589 #: debconf.conf.5:537
2590 msgid "~/.debconfrc"
2591 msgstr ""
2592
2593 #. type: Plain text
2594 #: debconf.conf.5:539
2595 msgid "B<debconf>(7)"
2596 msgstr ""
2597
2598 #. type: Plain text
2599 #: debconf.conf.5:540 confmodule.3:43 debconf.7:383 debconf-devel.7:969
2600 msgid "Joey Hess E<lt>[email protected]<gt>"
2601 msgstr ""
2602
2603 #. type: TH
2604 #: confmodule.3:1
2605 #, no-wrap
2606 msgid "CONFMODULE"
2607 msgstr ""
2608
2609 #. type: Plain text
2610 #: confmodule.3:4
2611 msgid "confmodule - communicate with Debian configuration system FrontEnd."
2612 msgstr ""
2613
2614 #. type: Plain text
2615 #: confmodule.3:12
2616 #, no-wrap
2617 msgid ""
2618 " #!/bin/sh -e\n"
2619 " . /usr/share/debconf/confmodule\n"
2620 " db_version 2.0\n"
2621 " db_capb 'backup'\n"
2622 " CAPB=$RET\n"
2623 " db_input 'foo/bar' || true\n"
2624 " db_go || true\n"
2625 msgstr ""
2626
2627 #. type: Plain text
2628 #: confmodule.3:22
2629 msgid ""
2630 "This is a library of shell functions that eases communication with Debian's "
2631 "configuration management system. It can communicate with a FrontEnd via the "
2632 "debconf protocol. The design is that each command in the protocol is "
2633 "represented by one function in this module. The functionname is the same as "
2634 "the command, except it is prefixed with \"db_\" and is lower-case. Call the "
2635 "function and pass in any parameters you want to follow the command. Any "
2636 "textual return code from the FrontEnd will be returned to you in the $RET "
2637 "variable, while the numeric return code from the FrontEnd will be returned "
2638 "as a return code (and so those return codes must be captured or ignored)."
2639 msgstr ""
2640
2641 #. type: Plain text
2642 #: confmodule.3:29
2643 #, no-wrap
2644 msgid ""
2645 "Once this library is loaded, any text you later output will go to standard\n"
2646 "error, rather than standard output. This is a good thing in general, "
2647 "because\n"
2648 "text sent to standard output is interpreted by the FrontEnd as "
2649 "commands. If\n"
2650 "you do want to send a command directly to the FrontEnd, you must output it\n"
2651 "to file descriptor 3, like this:\n"
2652 " echo GET foo/bar E<gt>&3\n"
2653 msgstr ""
2654
2655 #. type: Plain text
2656 #: confmodule.3:36
2657 msgid ""
2658 "The library checks to make sure it is actually speaking to a FrontEnd by "
2659 "examining the DEBIAN_HAS_FRONTEND variable. If it is set, a FrontEnd is "
2660 "assumed to be running. If not, the library turns into one, and runs a copy "
2661 "of the script that loaded the library connected to it. This means that if "
2662 "you source this library, you should do so very near to the top of your "
2663 "script, because everything before the sourcing of the library may well be "
2664 "run again."
2665 msgstr ""
2666
2667 #. type: Plain text
2668 #: confmodule.3:42
2669 msgid ""
2670 "B<debconf-devel>(7), B<dpkg-preconfigure>(8), B<dpkg-reconfigure>(8), "
2671 "debconf_specification in the debian-policy package"
2672 msgstr ""
2673
2674 #. type: TH
2675 #: debconf.7:1
2676 #, no-wrap
2677 msgid "DEBCONF"
2678 msgstr ""
2679
2680 #. type: Plain text
2681 #: debconf.7:4
2682 msgid "debconf - Debian package configuration system"
2683 msgstr ""
2684
2685 #. type: Plain text
2686 #: debconf.7:8
2687 msgid ""
2688 "Debconf is a configuration system for Debian packages. There is a "
2689 "rarely-used command named debconf, documented in B<debconf>(1)"
2690 msgstr ""
2691
2692 #. type: Plain text
2693 #: debconf.7:16
2694 msgid ""
2695 "Debconf provides a consistent interface for configuring packages, allowing "
2696 "you to choose from several user interface frontends. It supports "
2697 "preconfiguring packages before they are installed, which allows large "
2698 "installs and upgrades to ask you for all the necessary information up front, "
2699 "and then go do the work while you do something else. It lets you, if you're "
2700 "in a hurry, skip over less important questions and information while "
2701 "installing a package (and revisit it later)."
2702 msgstr ""
2703
2704 #. type: SH
2705 #: debconf.7:16
2706 #, no-wrap
2707 msgid "Preconfiguring packages"
2708 msgstr ""
2709
2710 #. type: Plain text
2711 #: debconf.7:22
2712 msgid ""
2713 "Debconf can configure packages before they are even installed onto your "
2714 "system. This is useful because it lets all the questions the packages are "
2715 "going to ask be asked at the beginning of an install, so the rest of the "
2716 "install can proceed while you are away getting a cup of coffee."
2717 msgstr ""
2718
2719 #. type: Plain text
2720 #: debconf.7:27
2721 msgid ""
2722 "If you use apt (version 0.5 or above), and you have apt-utils installed, "
2723 "each package apt installs will be automatically preconfigured. This is "
2724 "controlled via I</etc/apt/apt.conf.d/70debconf>"
2725 msgstr ""
2726
2727 #. type: Plain text
2728 #: debconf.7:33
2729 msgid ""
2730 "Sometimes you might want to preconfigure a package by hand, when you're not "
2731 "installing it with apt. You can use B<dpkg-preconfigure>(8) to do that, "
2732 "just pass it the filenames of the packages you want to preconfigure. You "
2733 "will need apt-utils installed for that to work."
2734 msgstr ""
2735
2736 #. type: SH
2737 #: debconf.7:33
2738 #, no-wrap
2739 msgid "Reconfiguring packages"
2740 msgstr ""
2741
2742 #. type: Plain text
2743 #: debconf.7:40
2744 msgid ""
2745 "Suppose you installed the package, and answered debconf's questions, but now "
2746 "that you've used it awhile, you realize you want to go back and change some "
2747 "of your answers. In the past, reinstalling a package was often the thing to "
2748 "do when you got in this situation, but when you reinstall the package, "
2749 "debconf seems to remember you have answered the questions, and doesn't ask "
2750 "them again (this is a feature)."
2751 msgstr ""
2752
2753 #. type: Plain text
2754 #: debconf.7:44
2755 #, no-wrap
2756 msgid ""
2757 "Luckily, debconf makes it easy to reconfigure any package that uses it.\n"
2758 "Suppose you want to reconfigure debconf itself. Just run, as root:\n"
2759 " dpkg-reconfigure debconf\n"
2760 msgstr ""
2761
2762 #. type: Plain text
2763 #: debconf.7:49
2764 msgid ""
2765 "This will ask all the questions you saw when debconf was first installed. "
2766 "It may ask you other questions as well, since it asks even low priority "
2767 "questions that may have been skipped when the package was installed. You "
2768 "can use it on any other package that uses debconf, as well."
2769 msgstr ""
2770
2771 #. type: SH
2772 #: debconf.7:49
2773 #, no-wrap
2774 msgid "Frontends"
2775 msgstr ""
2776
2777 #. type: Plain text
2778 #: debconf.7:53
2779 msgid ""
2780 "One of debconf's unique features is that the interface it presents to you is "
2781 "only one of many, that can be swapped in at will. There are many debconf "
2782 "frontends available:"
2783 msgstr ""
2784
2785 #. type: TP
2786 #: debconf.7:53
2787 #, no-wrap
2788 msgid "B<dialog>"
2789 msgstr ""
2790
2791 #. type: Plain text
2792 #: debconf.7:60
2793 msgid ""
2794 "The default frontend, this uses the B<whiptail>(1) or B<dialog>(1) "
2795 "programs to display questions to you. It works in text mode."
2796 msgstr ""
2797
2798 #. type: TP
2799 #: debconf.7:60
2800 #, no-wrap
2801 msgid "B<readline>"
2802 msgstr ""
2803
2804 #. type: Plain text
2805 #: debconf.7:72
2806 msgid ""
2807 "The most traditional frontend, this looks quite similar to how Debian "
2808 "configuration always has been: a series of questions, printed out at the "
2809 "console using plain text, and prompts done using the readline library. It "
2810 "even supports tab completion. The libterm-readline-gnu-perl package is "
2811 "strongly recommended if you chose to use this frontend; the default readline "
2812 "module does not support prompting with default values. At the minimum, "
2813 "you'll need the perl-modules package installed to use this frontend."
2814 msgstr ""
2815
2816 #. type: Plain text
2817 #: debconf.7:77
2818 msgid ""
2819 "This frontend has some special hotkeys. Pageup (or ctrl-u) will go back to "
2820 "the previous question (if that is supported by the package that is using "
2821 "debconf), and pagedown (or ctrl-v) will skip forward to the next question."
2822 msgstr ""
2823
2824 #. type: Plain text
2825 #: debconf.7:80
2826 msgid ""
2827 "This is the best frontend for remote admin work over a slow connection, or "
2828 "for those who are comfortable with unix."
2829 msgstr ""
2830
2831 #. type: TP
2832 #: debconf.7:81
2833 #, no-wrap
2834 msgid "B<noninteractive>"
2835 msgstr ""
2836
2837 #. type: Plain text
2838 #: debconf.7:90
2839 msgid ""
2840 "This is the anti-frontend. It never interacts with you at all, and makes the "
2841 "default answers be used for all questions. It might mail error messages to "
2842 "root, but that's it; otherwise it is completely silent and unobtrusive, a "
2843 "perfect frontend for automatic installs. If you are using this front-end, "
2844 "and require non-default answers to questions, you will need to preseed the "
2845 "debconf database; see the section below on Unattended Package Installation "
2846 "for more details."
2847 msgstr ""
2848
2849 #. type: TP
2850 #: debconf.7:90
2851 #, no-wrap
2852 msgid "B<gnome>"
2853 msgstr ""
2854
2855 #. type: Plain text
2856 #: debconf.7:96
2857 msgid ""
2858 "This is a modern X GUI using the gtk and gnome libraries. Of course, it "
2859 "requires a valid DISPLAY to work; debconf will fall back to other frontends "
2860 "if it can't work. Note that this frontend requires you have the libgtk3-perl "
2861 "package installed."
2862 msgstr ""
2863
2864 #. type: TP
2865 #: debconf.7:96
2866 #, no-wrap
2867 msgid "B<kde>"
2868 msgstr ""
2869
2870 #. type: Plain text
2871 #: debconf.7:102
2872 msgid ""
2873 "This frontend provides a modern X GUI based on the KDE Platform. You of "
2874 "course need a DISPLAY to use this frontend and you must install "
2875 "debconf-kde-helper package. The frontend will fall back to dialog if some of "
2876 "the prerequisites are not met."
2877 msgstr ""
2878
2879 #. type: TP
2880 #: debconf.7:102
2881 #, no-wrap
2882 msgid "B<editor>"
2883 msgstr ""
2884
2885 #. type: Plain text
2886 #: debconf.7:110
2887 msgid ""
2888 "This is for those fanatics who have to do everything in a text editor. It "
2889 "runs your editor on a file that looks something like a typical unix config "
2890 "file, and you edit the file to communicate with debconf. Debconf's author "
2891 "prefers to not comment regarding the circumstances that led to this frontend "
2892 "being written."
2893 msgstr ""
2894
2895 #. type: TP
2896 #: debconf.7:110
2897 #, no-wrap
2898 msgid "B<web>"
2899 msgstr ""
2900
2901 #. type: Plain text
2902 #: debconf.7:120
2903 msgid ""
2904 "This frontend acts as a web server, that you connect to with your web "
2905 "browser, to browse the questions and answer them. It has a lot of promise, "
2906 "but is a little rough so far. When this frontend starts up, it will print "
2907 "out the location you should point your web browser to. You have to run the "
2908 "web browser on the same machine you are configuring, for security reasons."
2909 msgstr ""
2910
2911 #. type: Plain text
2912 #: debconf.7:126
2913 msgid ""
2914 "Do keep in mind that this is not a very secure frontend. Anyone who has "
2915 "access to the computer being configured can currently access the web server "
2916 "and configure things while this frontend is running. So this is more of a "
2917 "proof of concept than anything."
2918 msgstr ""
2919
2920 #. type: Plain text
2921 #: debconf.7:133
2922 #, no-wrap
2923 msgid ""
2924 "You can change the default frontend debconf uses by reconfiguring\n"
2925 "debconf. On the other hand, if you just want to change the frontend\n"
2926 "for a minute, you can set the DEBIAN_FRONTEND environment variable to\n"
2927 "the name of the frontend to use. For example:\n"
2928 " DEBIAN_FRONTEND=readline apt-get install slrn\n"
2929 msgstr ""
2930
2931 #. type: Plain text
2932 #: debconf.7:141
2933 msgid ""
2934 "The B<dpkg-reconfigure>(8) and B<dpkg-preconfigure>(8) commands also let "
2935 "you pass I<--frontend=> to them, followed by the frontend you want them to "
2936 "use."
2937 msgstr ""
2938
2939 #. type: Plain text
2940 #: debconf.7:145
2941 msgid ""
2942 "Note that not all frontends will work in all circumstances. If a frontend "
2943 "fails to start up for some reason, debconf will print out a message "
2944 "explaining why, and fall back to the next-most similar frontend."
2945 msgstr ""
2946
2947 #. type: SH
2948 #: debconf.7:145
2949 #, no-wrap
2950 msgid "Priorities"
2951 msgstr ""
2952
2953 #. type: Plain text
2954 #: debconf.7:152
2955 msgid ""
2956 "Another nice feature of debconf is that the questions it asks you are "
2957 "prioritized. If you don't want to be bothered about every little thing, you "
2958 "can set up debconf to only ask you the most important questions. On the "
2959 "other hand, if you are a control freak, you can make it show you all "
2960 "questions. Each question has a priority. In increasing order of importance:"
2961 msgstr ""
2962
2963 #. type: TP
2964 #: debconf.7:152 debconf-devel.7:294
2965 #, no-wrap
2966 msgid "B<low>"
2967 msgstr ""
2968
2969 #. type: Plain text
2970 #: debconf.7:156
2971 msgid ""
2972 "Very trivial questions that have defaults that will work in the vast "
2973 "majority of cases."
2974 msgstr ""
2975
2976 #. type: TP
2977 #: debconf.7:156 debconf-devel.7:298
2978 #, no-wrap
2979 msgid "B<medium>"
2980 msgstr ""
2981
2982 #. type: Plain text
2983 #: debconf.7:159
2984 msgid "Normal questions that have reasonable defaults."
2985 msgstr ""
2986
2987 #. type: TP
2988 #: debconf.7:159 debconf-devel.7:301
2989 #, no-wrap
2990 msgid "B<high>"
2991 msgstr ""
2992
2993 #. type: Plain text
2994 #: debconf.7:162
2995 msgid "Questions that don't have a reasonable default."
2996 msgstr ""
2997
2998 #. type: TP
2999 #: debconf.7:162 debconf-devel.7:304
3000 #, no-wrap
3001 msgid "B<critical>"
3002 msgstr ""
3003
3004 #. type: Plain text
3005 #: debconf.7:165
3006 msgid "Questions that you really, really need to see (or else)."
3007 msgstr ""
3008
3009 #. type: Plain text
3010 #: debconf.7:175
3011 msgid ""
3012 "Only questions with a priority equal to or greater than the priority you "
3013 "choose will be shown to you. You can set the priority value by reconfiguring "
3014 "debconf, or temporarily by passing I<--priority=> followed by the value to "
3015 "the B<dpkg-reconfigure>(8) and B<dpkg-preconfigure>(8) commands, or by "
3016 "setting the DEBIAN_PRIORITY environment variable."
3017 msgstr ""
3018
3019 #. type: SH
3020 #: debconf.7:175
3021 #, no-wrap
3022 msgid "Backend Database"
3023 msgstr ""
3024
3025 #. type: Plain text
3026 #: debconf.7:187
3027 msgid ""
3028 "Debconf uses a rather flexible and potentially complicated backend database "
3029 "for storing data such as the answers to questions. The file "
3030 "B</etc/debconf.conf> is used to configure this database. If you need to set "
3031 "up something complicated, like make debconf read a remote database to get "
3032 "defaults, with local overrides, read the B<debconf.conf>(5) man page for "
3033 "all the gory details. Generally, the backend database is located in "
3034 "B</var/cache/debconf/> ."
3035 msgstr ""
3036
3037 #. type: SH
3038 #: debconf.7:187
3039 #, no-wrap
3040 msgid "Unattended Package Installation"
3041 msgstr ""
3042
3043 #. type: Plain text
3044 #: debconf.7:194
3045 msgid ""
3046 "If you have many machines to manage you will sometimes find yourself in the "
3047 "position of needing to perform an unattended installation or upgrade of "
3048 "packages on many systems, when the default answers to some configuration "
3049 "questions are not acceptable. There are many ways to approach this; all "
3050 "involve setting up a database and making debconf use it to get the answers "
3051 "you want."
3052 msgstr ""
3053
3054 #. type: Plain text
3055 #: debconf.7:198
3056 msgid ""
3057 "You should really read B<debconf.conf>(5) before this section, as you need "
3058 "to understand how debconf's databases work."
3059 msgstr ""
3060
3061 #. type: Plain text
3062 #: debconf.7:205
3063 msgid ""
3064 "The easiest way to set up the database is to install the packages on one "
3065 "machine and answer their questions as usual. Or you might just use "
3066 "B<dpkg-preconfigure>(8) to configure a set of packages without actually "
3067 "installing them. Or you might even decide to write a plain text debconf "
3068 "database by hand or something."
3069 msgstr ""
3070
3071 #. type: Plain text
3072 #: debconf.7:209
3073 msgid ""
3074 "Once you have the database, you need to figure out how to make the remote "
3075 "systems use it. This depends of course on the configuration of those systems "
3076 "and what database types they are set up to use."
3077 msgstr ""
3078
3079 #. type: Plain text
3080 #: debconf.7:213
3081 msgid ""
3082 "If you are using the LDAP debconf database, an entire network of debian "
3083 "machines can also have any or all package installation questions answered "
3084 "automatically by a single LDAP server."
3085 msgstr ""
3086
3087 #. type: Plain text
3088 #: debconf.7:222
3089 msgid ""
3090 "But perhaps you're using something a little bit easier to set up like, say, "
3091 "the default debconf database configuration, or you just don't want your "
3092 "remote systems to use LDAP all the time. In this case the best approach is "
3093 "to temporarily configure the remote systems to stack your database "
3094 "underneath their own existing databases, so they pull default values out of "
3095 "it. Debconf offers two environment variables, DEBCONF_DB_FALLBACK and "
3096 "DEBCONF_DB_OVERRIDE, to make it easy to do this on the fly. Here is a sample "
3097 "use:"
3098 msgstr ""
3099
3100 #. type: Plain text
3101 #: debconf.7:226
3102 #, no-wrap
3103 msgid ""
3104 " cat /var/cache/debconf/config.dat | \\e\n"
3105 " ssh root@target \"DEBIAN_FRONTEND=noninteractive \\e\n"
3106 " DEBCONF_DB_FALLBACK=Pipe apt-get upgrade\"\n"
3107 msgstr ""
3108
3109 #. type: Plain text
3110 #: debconf.7:232
3111 msgid ""
3112 "This makes the debconf on the remote host read in the data that is piped "
3113 "across the ssh connection and interpret it as a plain text format debconf "
3114 "database. It then uses that database as a fallback database -- a read-only "
3115 "database that is queried for answers to questions if the system's main "
3116 "debconf database lacks answers."
3117 msgstr ""
3118
3119 #. type: Plain text
3120 #: debconf.7:234
3121 msgid "Here's another way to use the DEBCONF_DB_FALLBACK environment variable:"
3122 msgstr ""
3123
3124 #. type: Plain text
3125 #: debconf.7:237
3126 #, no-wrap
3127 msgid ""
3128 " ssh -R 389:ldap:389 root@target \\e\n"
3129 " \t\"DEBCONF_DB_FALLBACK='LDAP{host:localhost}' apt-get upgrade\"\n"
3130 msgstr ""
3131
3132 #. type: Plain text
3133 #: debconf.7:242
3134 msgid ""
3135 "Here ssh is used to set up a tunneled LDAP connection and run debconf. "
3136 "Debconf is told to use the LDAP server as the fallback database. Note the "
3137 "use of \"{host:localhost}\" to configure how debconf accesses the LDAP "
3138 "database by providing the \"host\" field with a value of \"localhost\"."
3139 msgstr ""
3140
3141 #. type: Plain text
3142 #: debconf.7:244
3143 msgid "Here's another method:"
3144 msgstr ""
3145
3146 #. type: Plain text
3147 #: debconf.7:247
3148 #, no-wrap
3149 msgid ""
3150 " scp config.dat root@target:\n"
3151 " ssh root@target \"DEBCONF_DB_FALLBACK='File{/root/config.dat}' apt-get "
3152 "upgrade\n"
3153 msgstr ""
3154
3155 #. type: Plain text
3156 #: debconf.7:252
3157 msgid ""
3158 "Here you copy the database over with scp, and then ssh over and make debconf "
3159 "use the file you copied over. This illustrates a shorthand you can use in "
3160 "the DEBCONF_DB_FALLBACK parameters -- if a field name is left off, it "
3161 "defaults to \"filename\"."
3162 msgstr ""
3163
3164 #. type: Plain text
3165 #: debconf.7:261
3166 msgid ""
3167 "There is only one problem with these uses of the DEBCONF_DB_FALLBACK "
3168 "parameter: While the fallback database can provide answers to questions the "
3169 "other debconf databases have never seen, it is only queried as a fallback; "
3170 "after the other databases. If you need to instead temporarily override an "
3171 "existing value on the remote host, you should instead use the "
3172 "DEBCONF_DB_OVERRIDE variable. Like DEBCONF_DB_FALLBACK, it sets up a "
3173 "temporary database, but this database is consulted before any others, and "
3174 "can be used to override existing values."
3175 msgstr ""
3176
3177 #. type: SH
3178 #: debconf.7:261
3179 #, no-wrap
3180 msgid "Developing for Debconf"
3181 msgstr ""
3182
3183 #. type: Plain text
3184 #: debconf.7:266
3185 msgid ""
3186 "Package developers and others who want to develop packages that use debconf "
3187 "should read B<debconf-devel>(7) ."
3188 msgstr ""
3189
3190 #. type: Plain text
3191 #: debconf.7:274
3192 msgid ""
3193 "Briefly, debconf communicates with maintainer scripts or other programs via "
3194 "standard input and output, using a simple line-oriented command language "
3195 "similar to that used by common internet protocols such as SMTP. Programs use "
3196 "this protocol to ask debconf to display questions to the user, and retrieve "
3197 "the user's answers. The questions themselves are defined in a separate file, "
3198 "called the \"templates file\", which has a format not unlike a debian "
3199 "control file."
3200 msgstr ""
3201
3202 #. type: Plain text
3203 #: debconf.7:278
3204 msgid ""
3205 "Debian packages which use debconf typically provide both a templates file "
3206 "and a \"config\" script (run to preconfigure the package) in the control "
3207 "metadata section of the package."
3208 msgstr ""
3209
3210 #. type: SH
3211 #: debconf.7:278
3212 #, no-wrap
3213 msgid "ENVIRONMENT"
3214 msgstr ""
3215
3216 #. type: TP
3217 #: debconf.7:279
3218 #, no-wrap
3219 msgid "B<DEBIAN_FRONTEND>"
3220 msgstr ""
3221
3222 #. type: Plain text
3223 #: debconf.7:282
3224 msgid "Used to temporarily change the frontend debconf uses. See above."
3225 msgstr ""
3226
3227 #. type: TP
3228 #: debconf.7:282
3229 #, no-wrap
3230 msgid "B<DEBIAN_PRIORITY>"
3231 msgstr ""
3232
3233 #. type: Plain text
3234 #: debconf.7:286
3235 msgid ""
3236 "Used to temporarily change the minimum priority of question debconf will "
3237 "display. See above."
3238 msgstr ""
3239
3240 #. type: TP
3241 #: debconf.7:286 debconf-devel.7:576
3242 #, no-wrap
3243 msgid "B<DEBCONF_DEBUG>"
3244 msgstr ""
3245
3246 #. type: Plain text
3247 #: debconf.7:292
3248 msgid ""
3249 "Turns on debugging output on standard error. May be set to a facility name "
3250 "or a regular expression which matches a facility name (such as '.*' to "
3251 "output all debug info). The facility names include:"
3252 msgstr ""
3253
3254 #. type: TP
3255 #: debconf.7:292
3256 #, no-wrap
3257 msgid "B<user>"
3258 msgstr ""
3259
3260 #. type: Plain text
3261 #: debconf.7:295
3262 msgid "Debugging info of interest to a debconf user."
3263 msgstr ""
3264
3265 #. type: TP
3266 #: debconf.7:295
3267 #, no-wrap
3268 msgid "B<developer>"
3269 msgstr ""
3270
3271 #. type: Plain text
3272 #: debconf.7:298
3273 msgid "Debugging info of interest to a package developer."
3274 msgstr ""
3275
3276 #. type: TP
3277 #: debconf.7:298
3278 #, no-wrap
3279 msgid "B<db>"
3280 msgstr ""
3281
3282 #. type: Plain text
3283 #: debconf.7:301
3284 msgid "Debugging info about the backend database."
3285 msgstr ""
3286
3287 #. type: TP
3288 #: debconf.7:302
3289 #, no-wrap
3290 msgid "B<DEBCONF_NOWARNINGS>"
3291 msgstr ""
3292
3293 #. type: Plain text
3294 #: debconf.7:306
3295 msgid ""
3296 "Set to \"yes\" to disable some warnings that debconf may display. Does not "
3297 "suppress display of fatal errors."
3298 msgstr ""
3299
3300 #. type: TP
3301 #: debconf.7:306
3302 #, no-wrap
3303 msgid "B<DEBCONF_TERSE>"
3304 msgstr ""
3305
3306 #. type: Plain text
3307 #: debconf.7:310
3308 msgid ""
3309 "Set to \"yes\" to enable terse mode, in which debconf frontends cut down on "
3310 "the verbiage as much as possible."
3311 msgstr ""
3312
3313 #. type: TP
3314 #: debconf.7:310
3315 #, no-wrap
3316 msgid "B<DEBCONF_DB_FALLBACK>"
3317 msgstr ""
3318
3319 #. type: Plain text
3320 #: debconf.7:320
3321 msgid ""
3322 "Stack a database after the normally used databases, so that it is used as a "
3323 "fallback to get configuration information from. See \"Unattended Package "
3324 "Installation\" above. If the value of the variable is the name of an "
3325 "existing database in debconf.conf, then that database will be used. "
3326 "Otherwise, the environment variable can be used to configure a database on "
3327 "the fly, by telling the type of database, and optionally passing field:value "
3328 "settings, inside curly braces after the type. Spaces are used to separate "
3329 "fields, so you cannot specify a field value containing whitespace."
3330 msgstr ""
3331
3332 #. type: Plain text
3333 #: debconf.7:323
3334 #, no-wrap
3335 msgid ""
3336 "Thus, this uses the fallbackdb in debconf.conf:\n"
3337 " DEBCONF_DB_FALLBACK=fallbackdb\n"
3338 msgstr ""
3339
3340 #. type: Plain text
3341 #: debconf.7:327
3342 #, no-wrap
3343 msgid ""
3344 "While this sets up a new database of type File, and tells it a filename to\n"
3345 "use and turns off backups:\n"
3346 " DEBCONF_DB_FALLBACK=File{Filename:/root/config.dat Backup:no}\n"
3347 msgstr ""
3348
3349 #. type: Plain text
3350 #: debconf.7:330
3351 #, no-wrap
3352 msgid ""
3353 "And as a shorthand, this sets up a database of type File with a filename:\n"
3354 " DEBCONF_DB_FALLBACK=File{/root/config.dat}\n"
3355 msgstr ""
3356
3357 #. type: Plain text
3358 #: debconf.7:333
3359 msgid ""
3360 "Note that if a fallback database is set up on the fly, it will be read-only "
3361 "by default."
3362 msgstr ""
3363
3364 #. type: TP
3365 #: debconf.7:333
3366 #, no-wrap
3367 msgid "B<DEBCONF_DB_OVERRIDE>"
3368 msgstr ""
3369
3370 #. type: Plain text
3371 #: debconf.7:338
3372 msgid ""
3373 "Stack a database before the normally used databases, so that it can override "
3374 "values from them. The value of the variable works the same as does the value "
3375 "of DEBCONF_DB_FALLBACK."
3376 msgstr ""
3377
3378 #. type: TP
3379 #: debconf.7:338
3380 #, no-wrap
3381 msgid "B<DEBCONF_DB_REPLACE>"
3382 msgstr ""
3383
3384 #. type: Plain text
3385 #: debconf.7:343
3386 msgid ""
3387 "Use a given database instead of the normally used databases. This may be "
3388 "useful for testing with a separate database without having to create a "
3389 "separate debconf.conf, or to avoid locking the normal databases."
3390 msgstr ""
3391
3392 #. type: TP
3393 #: debconf.7:343
3394 #, no-wrap
3395 msgid "B<DEBCONF_SYSTEMRC>"
3396 msgstr ""
3397
3398 #. type: Plain text
3399 #: debconf.7:349
3400 msgid ""
3401 "If this environment variable is set, debconf will ignore a user's "
3402 "~/.debconfrc file, and use the system one instead. If it is set to the name "
3403 "of a regular file, debconf will use that file in preference to the system "
3404 "configuration files."
3405 msgstr ""
3406
3407 #. type: TP
3408 #: debconf.7:349
3409 #, no-wrap
3410 msgid "B<DEBCONF_FORCE_DIALOG>"
3411 msgstr ""
3412
3413 #. type: Plain text
3414 #: debconf.7:353
3415 msgid ""
3416 "If this environment variable is set, debconf will use dialog in preference "
3417 "to whiptail for the dialog frontend."
3418 msgstr ""
3419
3420 #. type: TP
3421 #: debconf.7:353
3422 #, no-wrap
3423 msgid "B<DEBCONF_FORCE_XDIALOG>"
3424 msgstr ""
3425
3426 #. type: Plain text
3427 #: debconf.7:357
3428 msgid ""
3429 "If this environment variable is set, debconf will use Xdialog in preference "
3430 "to whiptail for the dialog frontend."
3431 msgstr ""
3432
3433 #. type: TP
3434 #: debconf.7:357
3435 #, no-wrap
3436 msgid "B<DEBCONF_NONINTERACTIVE_SEEN>"
3437 msgstr ""
3438
3439 #. type: Plain text
3440 #: debconf.7:361
3441 msgid ""
3442 "Set to \"true\" to cause the seen flag to be set for questions asked in the "
3443 "noninteractive frontend."
3444 msgstr ""
3445
3446 #. type: SH
3447 #: debconf.7:361
3448 #, no-wrap
3449 msgid "BUGS"
3450 msgstr ""
3451
3452 #. type: Plain text
3453 #: debconf.7:363
3454 msgid "Probably quite a few, there's a lot of code here."
3455 msgstr ""
3456
3457 #. type: Plain text
3458 #: debconf.7:365
3459 msgid "If you do file a bug report, be sure to include the following information:"
3460 msgstr ""
3461
3462 #. type: TP
3463 #: debconf.7:365 debconf.7:368 debconf.7:371 debconf-devel.7:469
3464 #: debconf-devel.7:473 debconf-devel.7:479 debconf-devel.7:484
3465 #: debconf-devel.7:489
3466 #, no-wrap
3467 msgid "B<*>"
3468 msgstr ""
3469
3470 #. type: Plain text
3471 #: debconf.7:368
3472 msgid "The debconf frontend you were using when the problem occurred"
3473 msgstr ""
3474
3475 #. type: Plain text
3476 #: debconf.7:371
3477 msgid "What you did to trigger the problem."
3478 msgstr ""
3479
3480 #. type: Plain text
3481 #: debconf.7:376
3482 msgid ""
3483 "The full text of any error messages. If you can reproduce the bug, do so "
3484 "with DEBCONF_DEBUG='.*' set and exported. This speeds up debugging a lot."
3485 msgstr ""
3486
3487 #. type: Plain text
3488 #: debconf.7:382
3489 msgid ""
3490 "B<debconf.conf>(5), B<debconf-devel>(7), B<dpkg-preconfigure>(8), "
3491 "B<dpkg-reconfigure>(8), B<debconf>(1),"
3492 msgstr ""
3493
3494 #. type: TH
3495 #: debconf-devel.7:1
3496 #, no-wrap
3497 msgid "DEBCONF-DEVEL"
3498 msgstr ""
3499
3500 #. type: Plain text
3501 #: debconf-devel.7:4
3502 msgid "debconf - developers guide"
3503 msgstr ""
3504
3505 #. type: Plain text
3506 #: debconf-devel.7:6
3507 msgid "This is a guide for developing packages that use debconf."
3508 msgstr ""
3509
3510 #. type: Plain text
3511 #: debconf-devel.7:9
3512 msgid ""
3513 "This manual assumes that you are familiar with debconf as a user, and are "
3514 "familiar with the basics of debian package construction."
3515 msgstr ""
3516
3517 #. type: Plain text
3518 #: debconf-devel.7:18
3519 msgid ""
3520 "This manual begins by explaining two new files that are added to debian "
3521 "packages that use debconf. Then it explains how the debconf protocol works, "
3522 "and points you at some libraries that will let your programs speak the "
3523 "protocol. It discusses other maintainer scripts that debconf is typically "
3524 "used in: the postinst and postrm scripts. Then moves on to more advanced "
3525 "topics like shared debconf templates, debugging, and some common techniques "
3526 "and pitfalls of programming with debconf. It closes with a discussion of "
3527 "debconf's current shortcomings."
3528 msgstr ""
3529
3530 #. type: SH
3531 #: debconf-devel.7:18
3532 #, no-wrap
3533 msgid "THE CONFIG SCRIPT"
3534 msgstr ""
3535
3536 #. type: Plain text
3537 #: debconf-devel.7:23
3538 msgid ""
3539 "Debconf adds an additional maintainer script, the config script, to the set "
3540 "of maintainer scripts that can be in debian packages (the postinst, preinst, "
3541 "postrm, and prerm). The config script is responsible for asking any "
3542 "questions necessary to configure the package."
3543 msgstr ""
3544
3545 #. type: Plain text
3546 #: debconf-devel.7:28
3547 msgid ""
3548 "Note: It is a little confusing that dpkg refers to running a package's "
3549 "postinst script as \"configuring\" the package, since a package that uses "
3550 "debconf is often fully pre-configured, by its config script, before the "
3551 "postinst ever runs. Oh well."
3552 msgstr ""
3553
3554 #. type: Plain text
3555 #: debconf-devel.7:34
3556 msgid ""
3557 "Like the postinst, the config script is passed two parameters when it is "
3558 "run. The first tells what action is being performed, and the second is the "
3559 "version of the package that is currently installed. So, like in a postinst, "
3560 "you can use dpkg --compare-versions on $2 to make some behavior happen only "
3561 "on upgrade from a particular version of a package, and things like that."
3562 msgstr ""
3563
3564 #. type: Plain text
3565 #: debconf-devel.7:36
3566 msgid "The config script can be run in one of three ways:"
3567 msgstr ""
3568
3569 #. type: TP
3570 #: debconf-devel.7:36
3571 #, no-wrap
3572 msgid "B<1>"
3573 msgstr ""
3574
3575 #. type: Plain text
3576 #: debconf-devel.7:40
3577 msgid ""
3578 "If a package is pre-configured, with dpkg-preconfigure, its config script is "
3579 "run, and is passed the parameters \"configure\", and installed-version."
3580 msgstr ""
3581
3582 #. type: TP
3583 #: debconf-devel.7:40
3584 #, no-wrap
3585 msgid "B<2>"
3586 msgstr ""
3587
3588 #. type: Plain text
3589 #: debconf-devel.7:47
3590 msgid ""
3591 "When a package's postinst is run, debconf will try to run the config script "
3592 "then too, and it will be passed the same parameters it was passed when it is "
3593 "pre-configured. This is necessary because the package might not have been "
3594 "pre-configured, and the config script still needs to get a chance to "
3595 "run. See HACKS for details."
3596 msgstr ""
3597
3598 #. type: TP
3599 #: debconf-devel.7:47
3600 #, no-wrap
3601 msgid "B<3>"
3602 msgstr ""
3603
3604 #. type: Plain text
3605 #: debconf-devel.7:52
3606 msgid ""
3607 "If a package is reconfigured, with dpkg-reconfigure, its config script it "
3608 "run, and is passed the parameters \"reconfigure\" and installed-version."
3609 msgstr ""
3610
3611 #. type: Plain text
3612 #: debconf-devel.7:58
3613 msgid ""
3614 "Note that since a typical package install or upgrade using apt runs steps 1 "
3615 "and 2, the config script will typically be run twice. It should do nothing "
3616 "the second time (to ask questions twice in a row is annoying), and it should "
3617 "definitely be idempotent. Luckily, debconf avoids repeating questions by "
3618 "default, so this is generally easy to accomplish."
3619 msgstr ""
3620
3621 #. type: Plain text
3622 #: debconf-devel.7:64
3623 msgid ""
3624 "Note that the config script is run before the package is unpacked. It should "
3625 "only use commands that are in essential packages. The only dependency of "
3626 "your package that is guaranteed to be met when its config script is run is a "
3627 "dependency (possibly versioned) on debconf itself."
3628 msgstr ""
3629
3630 #. type: Plain text
3631 #: debconf-devel.7:70
3632 msgid ""
3633 "The config script should not need to modify the filesystem at all. It just "
3634 "examines the state of the system, and asks questions, and debconf stores the "
3635 "answers to be acted on later by the postinst script. Conversely, the "
3636 "postinst script should almost never use debconf to ask questions, but should "
3637 "instead act on the answers to questions asked by the config script."
3638 msgstr ""
3639
3640 #. type: SH
3641 #: debconf-devel.7:70
3642 #, no-wrap
3643 msgid "THE TEMPLATES FILE"
3644 msgstr ""
3645
3646 #. type: Plain text
3647 #: debconf-devel.7:73
3648 msgid ""
3649 "A package that uses debconf probably wants to ask some questions. These "
3650 "questions are stored, in template form, in the templates file."
3651 msgstr ""
3652
3653 #. type: Plain text
3654 #: debconf-devel.7:78
3655 msgid ""
3656 "Like the config script, the templates file is put in the control.tar.gz "
3657 "section of a deb. Its format is similar to a debian control file; a set of "
3658 "stanzas separated by blank lines, with each stanza having a RFC822-like "
3659 "form:"
3660 msgstr ""
3661
3662 #. type: Plain text
3663 #: debconf-devel.7:94
3664 #, no-wrap
3665 msgid ""
3666 " Template: foo/bar\n"
3667 " Type: string\n"
3668 " Default: foo\n"
3669 " Description: This is a sample string question.\n"
3670 " This is its extended description.\n"
3671 " .\n"
3672 " Notice that:\n"
3673 " - Like in a debian package description, a dot\n"
3674 " on its own line sets off a new paragraph.\n"
3675 " - Most text is word-wrapped, but doubly-indented\n"
3676 " text is left alone, so you can use it for lists\n"
3677 " of items, like this list. Be careful, since\n"
3678 " it is not word-wrapped, if it's too wide\n"
3679 " it will look bad. Using it for short items\n"
3680 " is best (so this is a bad example).\n"
3681 msgstr ""
3682
3683 #. type: Plain text
3684 #: debconf-devel.7:99
3685 #, no-wrap
3686 msgid ""
3687 " Template: foo/baz\n"
3688 " Type: boolean\n"
3689 " Description: Clear enough, no?\n"
3690 " This is another question, of boolean type.\n"
3691 msgstr ""
3692
3693 #. type: Plain text
3694 #: debconf-devel.7:103
3695 msgid ""
3696 "For some real-life examples of templates files, see "
3697 "/var/lib/dpkg/info/debconf.templates, and other .templates files in that "
3698 "directory."
3699 msgstr ""
3700
3701 #. type: Plain text
3702 #: debconf-devel.7:105
3703 msgid "Let's look at each of the fields in turn.."
3704 msgstr ""
3705
3706 #. type: TP
3707 #: debconf-devel.7:105
3708 #, no-wrap
3709 msgid "B<Template>"
3710 msgstr ""
3711
3712 #. type: Plain text
3713 #: debconf-devel.7:111
3714 msgid ""
3715 "The name of the template, in the 'Template' field, is generally prefixed "
3716 "with the name of the package. After that the namespace is wide open; you can "
3717 "use a simple flat layout like the one above, or set up \"subdirectories\" "
3718 "containing related questions."
3719 msgstr ""
3720
3721 #. type: TP
3722 #: debconf-devel.7:111
3723 #, no-wrap
3724 msgid "B<Type>"
3725 msgstr ""
3726
3727 #. type: Plain text
3728 #: debconf-devel.7:115
3729 msgid ""
3730 "The type of the template determines what kind of widget is displayed to the "
3731 "user. The currently supported types are:"
3732 msgstr ""
3733
3734 #. type: TP
3735 #: debconf-devel.7:116
3736 #, no-wrap
3737 msgid "B<string>"
3738 msgstr ""
3739
3740 #. type: Plain text
3741 #: debconf-devel.7:119
3742 msgid "Results in a free-form input field that the user can type any string into."
3743 msgstr ""
3744
3745 #. type: TP
3746 #: debconf-devel.7:119
3747 #, no-wrap
3748 msgid "B<password>"
3749 msgstr ""
3750
3751 #. type: Plain text
3752 #: debconf-devel.7:124
3753 msgid ""
3754 "Prompts the user for a password. Use this with caution; be aware that the "
3755 "password the user enters will be written to debconf's database. You should "
3756 "probably clean that value out of the database as soon as is possible."
3757 msgstr ""
3758
3759 #. type: TP
3760 #: debconf-devel.7:124
3761 #, no-wrap
3762 msgid "B<boolean>"
3763 msgstr ""
3764
3765 #. type: Plain text
3766 #: debconf-devel.7:127
3767 msgid "A true/false choice."
3768 msgstr ""
3769
3770 #. type: TP
3771 #: debconf-devel.7:127
3772 #, no-wrap
3773 msgid "B<select>"
3774 msgstr ""
3775
3776 #. type: Plain text
3777 #: debconf-devel.7:132
3778 msgid ""
3779 "A choice between one of a number of values. The choices must be specified in "
3780 "a field named 'Choices'. Separate the possible values with commas and "
3781 "spaces, like this:"
3782 msgstr ""
3783
3784 #. type: Plain text
3785 #: debconf-devel.7:134
3786 #, no-wrap
3787 msgid " Choices: yes, no, maybe\n"
3788 msgstr ""
3789
3790 #. type: TP
3791 #: debconf-devel.7:135
3792 #, no-wrap
3793 msgid "B<multiselect>"
3794 msgstr ""
3795
3796 #. type: Plain text
3797 #: debconf-devel.7:139
3798 msgid ""
3799 "Like the select data type, except the user can choose any number of items "
3800 "from the choices list (or choose none of them)."
3801 msgstr ""
3802
3803 #. type: TP
3804 #: debconf-devel.7:139
3805 #, no-wrap
3806 msgid "B<note>"
3807 msgstr ""
3808
3809 #. type: Plain text
3810 #: debconf-devel.7:147
3811 msgid ""
3812 "Rather than being a question per se, this datatype indicates a note that can "
3813 "be displayed to the user. It should be used only for important notes that "
3814 "the user really should see, since debconf will go to great pains to make "
3815 "sure the user sees it; halting the install for them to press a key. It's "
3816 "best to use these only for warning about very serious problems, and the "
3817 "error datatype is often more suitable."
3818 msgstr ""
3819
3820 #. type: TP
3821 #: debconf-devel.7:147
3822 #, no-wrap
3823 msgid "B<error>"
3824 msgstr ""
3825
3826 #. type: Plain text
3827 #: debconf-devel.7:152
3828 msgid ""
3829 "This datatype is used for error messages, such as input validation errors. "
3830 "Debconf will show a question of this type even if the priority is too high "
3831 "or the user has already seen it."
3832 msgstr ""
3833
3834 #. type: TP
3835 #: debconf-devel.7:152
3836 #, no-wrap
3837 msgid "B<title>"
3838 msgstr ""
3839
3840 #. type: Plain text
3841 #: debconf-devel.7:155
3842 msgid "This datatype is used for titles, to be set with the SETTITLE command."
3843 msgstr ""
3844
3845 #. type: TP
3846 #: debconf-devel.7:155
3847 #, no-wrap
3848 msgid "B<text>"
3849 msgstr ""
3850
3851 #. type: Plain text
3852 #: debconf-devel.7:162
3853 msgid ""
3854 "This datatype can be used for fragments of text, such as labels, that can be "
3855 "used for cosmetic reasons in the displays of some frontends. Other frontends "
3856 "will not use it at all. There is no point in using this datatype yet, since "
3857 "no frontends support it well. It may even be removed in the future."
3858 msgstr ""
3859
3860 #. type: TP
3861 #: debconf-devel.7:163
3862 #, no-wrap
3863 msgid "B<Default>"
3864 msgstr ""
3865
3866 #. type: Plain text
3867 #: debconf-devel.7:171
3868 msgid ""
3869 "The 'Default' field tells debconf what the default value should be. For "
3870 "multiselect, it can be a list of choices, separated by commas and spaces, "
3871 "similar to the 'Choices' field. For select, it should be one of the "
3872 "choices. For boolean, it is \"true\" or \"false\", while it can be anything "
3873 "for a string, and it is ignored for passwords."
3874 msgstr ""
3875
3876 #. type: Plain text
3877 #: debconf-devel.7:178
3878 msgid ""
3879 "Don't make the mistake of thinking that the default field contains the "
3880 "\"value\" of the question, or that it can be used to change the value of the "
3881 "question. It does not, and cannot, it just provides a default value for the "
3882 "first time the question is displayed. To provide a default that changes on "
3883 "the fly, you'd have to use the SET command to change the value of a "
3884 "question."
3885 msgstr ""
3886
3887 #. type: TP
3888 #: debconf-devel.7:179
3889 #, no-wrap
3890 msgid "B<Description>"
3891 msgstr ""
3892
3893 #. type: Plain text
3894 #: debconf-devel.7:187
3895 msgid ""
3896 "The 'Description' field, like the description of a Debian package, has two "
3897 "parts: A short description and an extended description. Note that some "
3898 "debconf frontends don't display the long description, or might only display "
3899 "it if the user asks for help. So the short description should be able to "
3900 "stand on its own."
3901 msgstr ""
3902
3903 #. type: Plain text
3904 #: debconf-devel.7:193
3905 msgid ""
3906 "If you can't think up a long description, then first, think some more. Post "
3907 "to debian-devel. Ask for help. Take a writing class! That extended "
3908 "description is important. If after all that you still can't come up with "
3909 "anything, leave it blank. There is no point in duplicating the short "
3910 "description."
3911 msgstr ""
3912
3913 #. type: Plain text
3914 #: debconf-devel.7:198
3915 msgid ""
3916 "Text in the extended description will be word-wrapped, unless it is prefixed "
3917 "by additional whitespace (beyond the one required space). You can break it "
3918 "up into separate paragraphs by putting \" .\" on a line by itself between "
3919 "them."
3920 msgstr ""
3921
3922 #. type: SH
3923 #: debconf-devel.7:199
3924 #, no-wrap
3925 msgid "QUESTIONS"
3926 msgstr ""
3927
3928 #. type: Plain text
3929 #: debconf-devel.7:211
3930 msgid ""
3931 "A question is an instantiated template. By asking debconf to display a "
3932 "question, your config script can interact with the user. When debconf loads "
3933 "a templates file (this happens whenever a config or postinst script is run), "
3934 "it automatically instantiates a question from each template. It is actually "
3935 "possible to instantiate several independent questions from the same template "
3936 "(using the REGISTER command), but that is rarely necessary. Templates are "
3937 "static data that comes from the templates file, while questions are used to "
3938 "store dynamic data, like the current value of the question, whether a user "
3939 "has seen a question, and so on. Keep the distinction between a template and "
3940 "a question in mind, but don't worry too much about it."
3941 msgstr ""
3942
3943 #. type: SH
3944 #: debconf-devel.7:211
3945 #, no-wrap
3946 msgid "SHARED TEMPLATES"
3947 msgstr ""
3948
3949 #. type: Plain text
3950 #: debconf-devel.7:218
3951 msgid ""
3952 "It's actually possible to have a template and a question that are shared "
3953 "among a set of packages. All the packages have to provide an identical copy "
3954 "of the template in their templates files. This can be useful if a bunch of "
3955 "packages need to ask the same question, and you only want to bother the user "
3956 "with it once. Shared templates are generally put in the shared/ "
3957 "pseudo-directory in the debconf template namespace."
3958 msgstr ""
3959
3960 #. type: SH
3961 #: debconf-devel.7:218
3962 #, no-wrap
3963 msgid "THE DEBCONF PROTOCOL"
3964 msgstr ""
3965
3966 #. type: Plain text
3967 #: debconf-devel.7:224
3968 msgid ""
3969 "Config scripts communicate with debconf using the debconf protocol. This is "
3970 "a simple line-oriented protocol, similar to common internet protocols such "
3971 "as SMTP. The config script sends debconf a command by writing the command to "
3972 "standard output. Then it can read debconf's reply from standard input."
3973 msgstr ""
3974
3975 #. type: Plain text
3976 #: debconf-devel.7:230
3977 msgid ""
3978 "Debconf's reply can be broken down into two parts: A numeric result code "
3979 "(the first word of the reply), and an optional extended result code (the "
3980 "remainder of the reply). The numeric code uses 0 to indicate success, and "
3981 "other numbers to indicate various kinds of failure. For full details, see "
3982 "the table in Debian policy's debconf specification document."
3983 msgstr ""
3984
3985 #. type: Plain text
3986 #: debconf-devel.7:235
3987 msgid ""
3988 "The extended return code is generally free form and unspecified, so you "
3989 "should generally ignore it, and should certainly not try to parse it in a "
3990 "program to work out what debconf is doing. The exception is commands like "
3991 "GET, that cause a value to be returned in the extended return code."
3992 msgstr ""
3993
3994 #. type: Plain text
3995 #: debconf-devel.7:239
3996 msgid ""
3997 "Generally you'll want to use a language-specific library that handles the "
3998 "nuts and bolts of setting up these connections to debconf and communicating "
3999 "with it."
4000 msgstr ""
4001
4002 #. type: Plain text
4003 #: debconf-devel.7:242
4004 msgid ""
4005 "For now, here are the commands in the protocol. This is not the definitive "
4006 "definition, see Debian policy's debconf specification document for that."
4007 msgstr ""
4008
4009 #. type: TP
4010 #: debconf-devel.7:242
4011 #, no-wrap
4012 msgid "B<VERSION number>"
4013 msgstr ""
4014
4015 #. type: Plain text
4016 #: debconf-devel.7:250
4017 msgid ""
4018 "You generally don't need to use this command. It exchanges with debconf the "
4019 "protocol version number that is being used. The current protocol version is "
4020 "2.0, and versions in the 2.x series will be backwards-compatible. You may "
4021 "specify the protocol version number you are speaking and debconf will return "
4022 "the version of the protocol it speaks in the extended result code. If the "
4023 "version you specify is too low, debconf will reply with numeric code 30."
4024 msgstr ""
4025
4026 #. type: TP
4027 #: debconf-devel.7:250
4028 #, no-wrap
4029 msgid "B<CAPB capabilities>"
4030 msgstr ""
4031
4032 #. type: Plain text
4033 #: debconf-devel.7:257
4034 msgid ""
4035 "You generally don't need to use this command. It exchanges with debconf a "
4036 "list of supported capabilities (separated by spaces). Capabilities that both "
4037 "you and debconf support will be used, and debconf will reply with all the "
4038 "capabilities it supports."
4039 msgstr ""
4040
4041 #. type: Plain text
4042 #: debconf-devel.7:267
4043 msgid ""
4044 "If 'escape' is found among your capabilities, debconf will expect commands "
4045 "you send it to have backslashes and newlines escaped (as \\e\\e and \\en "
4046 "respectively) and will in turn escape backslashes and newlines in its "
4047 "replies. This can be used, for example, to substitute multi-line strings "
4048 "into templates, or to get multi-line extended descriptions reliably using "
4049 "METAGET. In this mode, you must escape input text yourself (you can use "
4050 "B<debconf-escape>(1) to help with this if you want), but the confmodule "
4051 "libraries will unescape replies for you."
4052 msgstr ""
4053
4054 #. type: TP
4055 #: debconf-devel.7:268
4056 #, no-wrap
4057 msgid "B<SETTITLE question>"
4058 msgstr ""
4059
4060 #. type: Plain text
4061 #: debconf-devel.7:275
4062 msgid ""
4063 "This sets the title debconf displays to the user, using the short "
4064 "description of the template for the specified question. The template should "
4065 "be of type title. You rarely need to use this command since debconf can "
4066 "automatically generate a title based on your package's name."
4067 msgstr ""
4068
4069 #. type: Plain text
4070 #: debconf-devel.7:278
4071 msgid ""
4072 "Setting the title from a template means they are stored in the same place as "
4073 "the rest of the debconf questions, and allows them to be translated."
4074 msgstr ""
4075
4076 #. type: TP
4077 #: debconf-devel.7:279
4078 #, no-wrap
4079 msgid "B<TITLE string>"
4080 msgstr ""
4081
4082 #. type: Plain text
4083 #: debconf-devel.7:284
4084 msgid ""
4085 "This sets the title debconf displays to the user to the specified string. "
4086 "Use of the SETTITLE command is normally to be preferred as it allows for "
4087 "translation of the title."
4088 msgstr ""
4089
4090 #. type: TP
4091 #: debconf-devel.7:284
4092 #, no-wrap
4093 msgid "B<INPUT priority question>"
4094 msgstr ""
4095
4096 #. type: Plain text
4097 #: debconf-devel.7:291
4098 msgid ""
4099 "Ask debconf to prepare to display a question to the user. The question is "
4100 "not actually displayed until a GO command is issued; this lets several INPUT "
4101 "commands be given in series, to build up a set of questions, which might all "
4102 "be asked on a single screen."
4103 msgstr ""
4104
4105 #. type: Plain text
4106 #: debconf-devel.7:294
4107 msgid ""
4108 "The priority field tells debconf how important it is that this question be "
4109 "shown to the user. The priority values are:"
4110 msgstr ""
4111
4112 #. type: Plain text
4113 #: debconf-devel.7:298
4114 msgid ""
4115 "Very trivial items that have defaults that will work in the vast majority of "
4116 "cases; only control freaks see these."
4117 msgstr ""
4118
4119 #. type: Plain text
4120 #: debconf-devel.7:301
4121 msgid "Normal items that have reasonable defaults."
4122 msgstr ""
4123
4124 #. type: Plain text
4125 #: debconf-devel.7:304
4126 msgid "Items that don't have a reasonable default."
4127 msgstr ""
4128
4129 #. type: Plain text
4130 #: debconf-devel.7:307
4131 msgid "Items that will probably break the system without user intervention."
4132 msgstr ""
4133
4134 #. type: Plain text
4135 #: debconf-devel.7:312
4136 msgid ""
4137 "Debconf decides if the question is actually displayed, based on its "
4138 "priority, and whether the user has seen it before, and which frontend is "
4139 "being used. If the question will not be displayed, debconf replies with code "
4140 "30."
4141 msgstr ""
4142
4143 #. type: TP
4144 #: debconf-devel.7:313
4145 #, no-wrap
4146 msgid "B<GO>"
4147 msgstr ""
4148
4149 #. type: Plain text
4150 #: debconf-devel.7:318
4151 msgid ""
4152 "Tells debconf to display the accumulated set of questions (from INPUT "
4153 "commands) to the user."
4154 msgstr ""
4155
4156 #. type: Plain text
4157 #: debconf-devel.7:321
4158 msgid ""
4159 "If the backup capability is supported and the user indicates they want to "
4160 "back up a step, debconf replies with code 30."
4161 msgstr ""
4162
4163 #. type: TP
4164 #: debconf-devel.7:322
4165 #, no-wrap
4166 msgid "B<CLEAR>"
4167 msgstr ""
4168
4169 #. type: Plain text
4170 #: debconf-devel.7:326
4171 msgid ""
4172 "Clears the accumulated set of questions (from INPUT commands) without "
4173 "displaying them."
4174 msgstr ""
4175
4176 #. type: TP
4177 #: debconf-devel.7:326
4178 #, no-wrap
4179 msgid "B<BEGINBLOCK>"
4180 msgstr ""
4181
4182 #. type: TP
4183 #: debconf-devel.7:328
4184 #, no-wrap
4185 msgid "B<ENDBLOCK>"
4186 msgstr ""
4187
4188 #. type: Plain text
4189 #: debconf-devel.7:336
4190 msgid ""
4191 "Some debconf frontends can display a number of questions to the user at "
4192 "once. Maybe in the future a frontend will even be able to group these "
4193 "questions into blocks on screen. BEGINBLOCK and ENDBLOCK can be placed "
4194 "around a set of INPUT commands to indicate blocks of questions (and blocks "
4195 "can even be nested). Since no debconf frontend is so sophisticated yet, "
4196 "these commands are ignored for now."
4197 msgstr ""
4198
4199 #. type: TP
4200 #: debconf-devel.7:336
4201 #, no-wrap
4202 msgid "B<STOP>"
4203 msgstr ""
4204
4205 #. type: Plain text
4206 #: debconf-devel.7:340
4207 msgid ""
4208 "This command tells debconf that you're done talking to it. Often debconf can "
4209 "detect termination of your program and this command is not necessary."
4210 msgstr ""
4211
4212 #. type: TP
4213 #: debconf-devel.7:340
4214 #, no-wrap
4215 msgid "B<GET question>"
4216 msgstr ""
4217
4218 #. type: Plain text
4219 #: debconf-devel.7:345
4220 msgid ""
4221 "After using INPUT and GO to display a question, you can use this command to "
4222 "get the value the user entered. The value is returned in the extended result "
4223 "code."
4224 msgstr ""
4225
4226 #. type: TP
4227 #: debconf-devel.7:345
4228 #, no-wrap
4229 msgid "B<SET question value>"
4230 msgstr ""
4231
4232 #. type: Plain text
4233 #: debconf-devel.7:349
4234 msgid ""
4235 "This sets the value of a question, and it can be used to override the "
4236 "default value with something your program calculates on the fly."
4237 msgstr ""
4238
4239 #. type: TP
4240 #: debconf-devel.7:349
4241 #, no-wrap
4242 msgid "B<RESET question>"
4243 msgstr ""
4244
4245 #. type: Plain text
4246 #: debconf-devel.7:353
4247 msgid ""
4248 "This resets the question to its default value (as is specified in the "
4249 "'Default' field of its template)."
4250 msgstr ""
4251
4252 #. type: TP
4253 #: debconf-devel.7:353
4254 #, no-wrap
4255 msgid "B<SUBST question key value>"
4256 msgstr ""
4257
4258 #. type: Plain text
4259 #: debconf-devel.7:362
4260 msgid ""
4261 "Questions can have substitutions embedded in their 'Description' and "
4262 "'Choices' fields (use of substitutions in 'Choices' fields is a bit of a "
4263 "hack though; a better mechanism will eventually be developed). These "
4264 "substitutions look like \"${key}\". When the question is displayed, the "
4265 "substitutions are replaced with their values. This command can be used to "
4266 "set the value of a substitution. This is useful if you need to display some "
4267 "message to the user that you can't hard-code in the templates file."
4268 msgstr ""
4269
4270 #. type: Plain text
4271 #: debconf-devel.7:365
4272 msgid ""
4273 "Do not try to use SUBST to change the default value of a question; it won't "
4274 "work since there is a SET command explicitly for that purpose."
4275 msgstr ""
4276
4277 #. type: TP
4278 #: debconf-devel.7:365
4279 #, no-wrap
4280 msgid "B<FGET question flag>"
4281 msgstr ""
4282
4283 #. type: Plain text
4284 #: debconf-devel.7:369
4285 msgid ""
4286 "Questions can have flags associated with them. The flags can have a value of "
4287 "\"true\" or \"false\". This command returns the value of a flag."
4288 msgstr ""
4289
4290 #. type: TP
4291 #: debconf-devel.7:369
4292 #, no-wrap
4293 msgid "B<FSET question flag value>"
4294 msgstr ""
4295
4296 #. type: Plain text
4297 #: debconf-devel.7:374
4298 msgid ""
4299 "This sets the value of a question's flag. The value must be either \"true\" "
4300 "or \"false\"."
4301 msgstr ""
4302
4303 #. type: Plain text
4304 #: debconf-devel.7:380
4305 msgid ""
4306 "One common flag is the \"seen\" flag. It is normally only set if a user has "
4307 "already seen a question. Debconf usually only displays questions to users if "
4308 "they have the seen flag set to \"false\" (or if it is reconfiguring a "
4309 "package). Sometimes you want the user to see a question again -- in these "
4310 "cases you can set the seen flag to false to force debconf to redisplay it."
4311 msgstr ""
4312
4313 #. type: TP
4314 #: debconf-devel.7:381
4315 #, no-wrap
4316 msgid "B<METAGET question field>"
4317 msgstr ""
4318
4319 #. type: Plain text
4320 #: debconf-devel.7:385
4321 msgid ""
4322 "This returns the value of any field of a question's associated template (the "
4323 "Description, for example)."
4324 msgstr ""
4325
4326 #. type: TP
4327 #: debconf-devel.7:385
4328 #, no-wrap
4329 msgid "B<REGISTER template question>"
4330 msgstr ""
4331
4332 #. type: Plain text
4333 #: debconf-devel.7:391
4334 msgid ""
4335 "This creates a new question that is bound to a template. By default each "
4336 "template has an associated question with the same name. However, any number "
4337 "of questions can really be associated with a template, and this lets you "
4338 "create more such questions."
4339 msgstr ""
4340
4341 #. type: TP
4342 #: debconf-devel.7:391
4343 #, no-wrap
4344 msgid "B<UNREGISTER question>"
4345 msgstr ""
4346
4347 #. type: Plain text
4348 #: debconf-devel.7:394
4349 msgid "This removes a question from the database."
4350 msgstr ""
4351
4352 #. type: TP
4353 #: debconf-devel.7:394
4354 #, no-wrap
4355 msgid "B<PURGE>"
4356 msgstr ""
4357
4358 #. type: Plain text
4359 #: debconf-devel.7:398
4360 msgid ""
4361 "Call this in your postrm when your package is purged. It removes all of your "
4362 "package's questions from debconf's database."
4363 msgstr ""
4364
4365 #. type: TP
4366 #: debconf-devel.7:398
4367 #, no-wrap
4368 msgid "B<X_LOADTEMPLATEFILE /path/to/templates [owner]>"
4369 msgstr ""
4370
4371 #. type: Plain text
4372 #: debconf-devel.7:402
4373 msgid ""
4374 "This extension loads the specified template file into debconf's database. "
4375 "The owner defaults to the package that is being configured with debconf."
4376 msgstr ""
4377
4378 #. type: Plain text
4379 #: debconf-devel.7:404
4380 msgid "Here is a simple example of the debconf protocol in action."
4381 msgstr ""
4382
4383 #. type: Plain text
4384 #: debconf-devel.7:418
4385 #, no-wrap
4386 msgid ""
4387 " INPUT medium debconf/frontend\n"
4388 " 30 question skipped\n"
4389 " FSET debconf/frontend seen false\n"
4390 " 0 false\n"
4391 " INPUT high debconf/frontend\n"
4392 " 0 question will be asked\n"
4393 " GO\n"
4394 " [ Here debconf displays a question to the user. ]\n"
4395 " 0 ok\n"
4396 " GET no/such/question\n"
4397 " 10 no/such/question doesn't exist\n"
4398 " GET debconf/frontend\n"
4399 " 0 Dialog\n"
4400 msgstr ""
4401
4402 #. type: SH
4403 #: debconf-devel.7:418
4404 #, no-wrap
4405 msgid "LIBRARIES"
4406 msgstr ""
4407
4408 #. type: Plain text
4409 #: debconf-devel.7:422
4410 msgid ""
4411 "Setting things up so you can talk to debconf, and speaking the debconf "
4412 "protocol by hand is a little too much work, so some thin libraries exist to "
4413 "relieve this minor drudgery."
4414 msgstr ""
4415
4416 #. type: Plain text
4417 #: debconf-devel.7:430
4418 msgid ""
4419 "For shell programming, there is the /usr/share/debconf/confmodule library, "
4420 "which you can source at the top of a shell script, and talk to debconf in a "
4421 "fairly natural way, using lower-case versions of the debconf protocol "
4422 "commands, that are prefixed with \"db_\" (ie, \"db_input\" and "
4423 "\"db_go\"). For details, see B<confmodule>(3) ."
4424 msgstr ""
4425
4426 #. type: Plain text
4427 #: debconf-devel.7:434
4428 msgid ""
4429 "Perl programmers can use the B<Debconf::Client::ConfModule>(3pm) perl "
4430 "module, and python programmers can use the debconf python module."
4431 msgstr ""
4432
4433 #. type: Plain text
4434 #: debconf-devel.7:438
4435 msgid ""
4436 "The rest of this manual will use the /usr/share/debconf/confmodule library "
4437 "in example shell scripts. Here is an example config script using that "
4438 "library, that just asks a question:"
4439 msgstr ""
4440
4441 #. type: Plain text
4442 #: debconf-devel.7:445
4443 #, no-wrap
4444 msgid ""
4445 " #!/bin/sh\n"
4446 " set -e\n"
4447 " . /usr/share/debconf/confmodule\n"
4448 " db_set mypackage/reboot-now false\n"
4449 " db_input high mypackage/reboot-now || true\n"
4450 " db_go || true\n"
4451 msgstr ""
4452
4453 #. type: Plain text
4454 #: debconf-devel.7:450
4455 msgid ""
4456 "Notice the uses of \"|| true\" to prevent the script from dying if debconf "
4457 "decides it can't display a question, or the user tries to back up. In those "
4458 "situations, debconf returns a non-zero exit code, and since this shell "
4459 "script is set -e, an untrapped exit code would make it abort."
4460 msgstr ""
4461
4462 #. type: Plain text
4463 #: debconf-devel.7:454
4464 msgid ""
4465 "And here is a corresponding postinst script, that uses the user's answer to "
4466 "the question to see if the system should be rebooted (a rather absurd "
4467 "example..):"
4468 msgstr ""
4469
4470 #. type: Plain text
4471 #: debconf-devel.7:462
4472 #, no-wrap
4473 msgid ""
4474 " #!/bin/sh\n"
4475 " set -e\n"
4476 " . /usr/share/debconf/confmodule\n"
4477 " db_get mypackage/reboot-now\n"
4478 " if [ \"$RET\" = true ]; then\n"
4479 " \tshutdown -r now\n"
4480 " fi\n"
4481 msgstr ""
4482
4483 #. type: Plain text
4484 #: debconf-devel.7:465
4485 msgid ""
4486 "Notice the use of the $RET variable to get at the extended return code from "
4487 "the GET command, which holds the user's answer to the question."
4488 msgstr ""
4489
4490 #. type: SH
4491 #: debconf-devel.7:465
4492 #, no-wrap
4493 msgid "THE POSTINST SCRIPT"
4494 msgstr ""
4495
4496 #. type: Plain text
4497 #: debconf-devel.7:469
4498 msgid ""
4499 "The last section had an example of a postinst script that uses debconf to "
4500 "get the value of a question, and act on it. Here are some things to keep in "
4501 "mind when writing postinst scripts that use debconf:"
4502 msgstr ""
4503
4504 #. type: Plain text
4505 #: debconf-devel.7:473
4506 msgid ""
4507 "Avoid asking questions in the postinst. Instead, the config script should "
4508 "ask questions using debconf, so that pre-configuration will work."
4509 msgstr ""
4510
4511 #. type: Plain text
4512 #: debconf-devel.7:479
4513 msgid ""
4514 "Always source /usr/share/debconf/confmodule at the top of your postinst, "
4515 "even if you won't be running any db_* commands in it. This is required to "
4516 "make sure the config script gets a chance to run (see HACKS for details)."
4517 msgstr ""
4518
4519 #. type: Plain text
4520 #: debconf-devel.7:484
4521 msgid ""
4522 "Avoid outputting anything to stdout in your postinst, since that can confuse "
4523 "debconf, and postinst should not be verbose anyway. Output to stderr is ok, "
4524 "if you must."
4525 msgstr ""
4526
4527 #. type: Plain text
4528 #: debconf-devel.7:489
4529 msgid ""
4530 "If your postinst launches a daemon, make sure you tell debconf to STOP at "
4531 "the end, since debconf can become a little confused about when your postinst "
4532 "is done otherwise."
4533 msgstr ""
4534
4535 #. type: Plain text
4536 #: debconf-devel.7:494
4537 msgid ""
4538 "Make your postinst script accept a first parameter of \"reconfigure\". It "
4539 "can treat it just like \"configure\". This will be used in a later version "
4540 "of debconf to let postinsts know when they are reconfigured."
4541 msgstr ""
4542
4543 #. type: SH
4544 #: debconf-devel.7:494
4545 #, no-wrap
4546 msgid "OTHER SCRIPTS"
4547 msgstr ""
4548
4549 #. type: Plain text
4550 #: debconf-devel.7:502
4551 msgid ""
4552 "Besides the config script and postinst, you can use debconf in any of the "
4553 "other maintainer scripts. Most commonly, you'll be using debconf in your "
4554 "postrm, to call the PURGE command when your package is purged, to clean out "
4555 "its entries in the debconf database. (This is automatically set up for you "
4556 "by B<dh_installdebconf>(1)B<,> by the way.)"
4557 msgstr ""
4558
4559 #. type: Plain text
4560 #: debconf-devel.7:510
4561 msgid ""
4562 "A more involved use of debconf would be if you want to use it in the postrm "
4563 "when your package is purged, to ask a question about deleting something. Or "
4564 "maybe you find you need to use it in the preinst or prerm for some "
4565 "reason. All of these uses will work, though they'll probably involve asking "
4566 "questions and acting on the answers in the same program, rather than "
4567 "separating the two activities as is done in the config and postinst scripts."
4568 msgstr ""
4569
4570 #. type: Plain text
4571 #: debconf-devel.7:515
4572 msgid ""
4573 "Note that if your package's sole use of debconf is in the postrm, you should "
4574 "make your package's postinst source /usr/share/debconf/confmodule, to give "
4575 "debconf a chance to load up your templates file into its database. Then the "
4576 "templates will be available when your package is being purged."
4577 msgstr ""
4578
4579 #. type: Plain text
4580 #: debconf-devel.7:522
4581 msgid ""
4582 "You can also use debconf in other, standalone programs. The issue to watch "
4583 "out for here is that debconf is not intended to be, and must not be used as "
4584 "a registry. This is unix after all, and programs are configured by files in "
4585 "/etc, not by some nebulous debconf database (that is only a cache anyway and "
4586 "might get blown away). So think long and hard before using debconf in a "
4587 "standalone program."
4588 msgstr ""
4589
4590 #. type: Plain text
4591 #: debconf-devel.7:527
4592 msgid ""
4593 "There are times when it can make sense, as in the apt-setup program which "
4594 "uses debconf to prompt the user in a manner consistent with the rest of the "
4595 "debian install process, and immediately acts on their answers to set up "
4596 "apt's sources.list."
4597 msgstr ""
4598
4599 #. type: SH
4600 #: debconf-devel.7:527
4601 #, no-wrap
4602 msgid "LOCALIZATION"
4603 msgstr ""
4604
4605 #. type: Plain text
4606 #: debconf-devel.7:534
4607 msgid ""
4608 "Debconf supports localization of templates files. This is accomplished by "
4609 "adding more fields, with translated text in them. Any of the fields can be "
4610 "translated. For example, you might want to translate the description into "
4611 "Spanish. Just make a field named 'Description-es' that holds the "
4612 "translation. If a translated field is not available, debconf falls back to "
4613 "the normal English field."
4614 msgstr ""
4615
4616 #. type: Plain text
4617 #: debconf-devel.7:540
4618 msgid ""
4619 "Besides the 'Description' field, you should translate the 'Choices' field of "
4620 "a select or multiselect template. Be sure to list the translated choices in "
4621 "the same order as they appear in the main 'Choices' field. You do not need "
4622 "to translate the 'Default' field of a select or multiselect question, and "
4623 "the value of the question will be automatically returned in English."
4624 msgstr ""
4625
4626 #. type: Plain text
4627 #: debconf-devel.7:552
4628 msgid ""
4629 "You will find it easier to manage translations if you keep them in separate "
4630 "files; one file per translation. In the past, the B<debconf-getlang>(1) and "
4631 "B<debconf-mergetemplate>(1) programs were used to manage debian/template.ll "
4632 "files. This has been superseded by the B<po-debconf>(7) package, which lets "
4633 "you deal with debconf translations in .po files, just like any other "
4634 "translations. Your translators will thank you for using this new improved "
4635 "mechanism."
4636 msgstr ""
4637
4638 #. type: Plain text
4639 #: debconf-devel.7:558
4640 msgid ""
4641 "For the details on po-debconf, see its man page. If you're using debhelper, "
4642 "converting to po-debconf is as simple as running the "
4643 "B<debconf-gettextize>(1) command once, and adding a Build-Dependency on "
4644 "po-debconf and on debhelper (E<gt>= 4.1.13)."
4645 msgstr ""
4646
4647 #. type: SH
4648 #: debconf-devel.7:558
4649 #, no-wrap
4650 msgid "PUTTING IT ALL TOGETHER"
4651 msgstr ""
4652
4653 #. type: Plain text
4654 #: debconf-devel.7:568
4655 msgid ""
4656 "So you have a config script, a templates file, a postinst script that uses "
4657 "debconf, and so on. Putting these pieces together into a debian package "
4658 "isn't hard. You can do it by hand, or can use B<dh_installdebconf>(1) which "
4659 "will merge your translated templates, copy the files into the right places "
4660 "for you, and can even generate the call to PURGE that should go in your "
4661 "postrm script. Make sure that your package depends on debconf (E<gt>= 0.5), "
4662 "since earlier versions were not compatible with everything described in this "
4663 "manual. And you're done."
4664 msgstr ""
4665
4666 #. type: Plain text
4667 #: debconf-devel.7:571
4668 msgid ""
4669 "Well, except for testing, debugging, and actually using debconf for more "
4670 "interesting things than asking a few basic questions. For that, read on.."
4671 msgstr ""
4672
4673 #. type: SH
4674 #: debconf-devel.7:571
4675 #, no-wrap
4676 msgid "DEBUGGING"
4677 msgstr ""
4678
4679 #. type: Plain text
4680 #: debconf-devel.7:576
4681 msgid ""
4682 "So you have a package that's supposed to use debconf, but it doesn't quite "
4683 "work. Maybe debconf is just not asking that question you set up. Or maybe "
4684 "something weirder is happening; it spins forever in some kind of loop, or "
4685 "worse. Luckily, debconf has plenty of debugging facilities."
4686 msgstr ""
4687
4688 #. type: Plain text
4689 #: debconf-devel.7:583
4690 msgid ""
4691 "The first thing to reach for is the DEBCONF_DEBUG environment variable. If "
4692 "you set and export DEBCONF_DEBUG=developer, debconf will output to stderr a "
4693 "dump of the debconf protocol as your program runs. It'll look something like "
4694 "this -- the typo is made clear:"
4695 msgstr ""
4696
4697 #. type: Plain text
4698 #: debconf-devel.7:588
4699 #, no-wrap
4700 msgid ""
4701 " debconf (developer): E<lt>-- input high debconf/frontand\n"
4702 " debconf (developer): --E<gt> 10 \"debconf/frontand\" doesn't exist\n"
4703 " debconf (developer): E<lt>-- go\n"
4704 " debconf (developer): --E<gt> 0 ok\n"
4705 msgstr ""
4706
4707 #. type: Plain text
4708 #: debconf-devel.7:592
4709 msgid ""
4710 "It's rather useful to use debconf's readline frontend when you're debugging "
4711 "(in the author's opinion), as the questions don't get in the way, and all "
4712 "the debugging output is easily preserved and logged."
4713 msgstr ""
4714
4715 #. type: TP
4716 #: debconf-devel.7:593
4717 #, no-wrap
4718 msgid "B<DEBCONF_C_VALUES>"
4719 msgstr ""
4720
4721 #. type: Plain text
4722 #: debconf-devel.7:599
4723 msgid ""
4724 "If this environment variable is set to 'true', the frontend will display the "
4725 "values in Choices-C fields (if present) of select and multiselect templates "
4726 "rather than the descriptive values."
4727 msgstr ""
4728
4729 #. type: TP
4730 #: debconf-devel.7:600
4731 #, no-wrap
4732 msgid "B<debconf-communicate>"
4733 msgstr ""
4734
4735 #. type: Plain text
4736 #: debconf-devel.7:606
4737 msgid ""
4738 "Another useful tool is the B<debconf-communicate>(1) program. Fire it up "
4739 "and you can speak the raw debconf protocol to debconf, interactively. This "
4740 "is a great way to try stuff out on the fly."
4741 msgstr ""
4742
4743 #. type: TP
4744 #: debconf-devel.7:606
4745 #, no-wrap
4746 msgid "B<debconf-show>"
4747 msgstr ""
4748
4749 #. type: Plain text
4750 #: debconf-devel.7:612
4751 msgid ""
4752 "If a user is reporting a problem, B<debconf-show>(1) can be used to dump "
4753 "out all the questions owned by your package, displaying their values and "
4754 "whether the user has seen them."
4755 msgstr ""
4756
4757 #. type: TP
4758 #: debconf-devel.7:612
4759 #, no-wrap
4760 msgid "B<.debconfrc>"
4761 msgstr ""
4762
4763 #. type: Plain text
4764 #: debconf-devel.7:623
4765 msgid ""
4766 "To avoid the often tedious build/install/debug cycle, it can be useful to "
4767 "load up your templates with B<debconf-loadtemplate>(1) and run your config "
4768 "script by hand with the B<debconf>(1) command. However, you still have to "
4769 "do that as root, right? Not so good. And ideally you'd like to be able to "
4770 "see what a fresh installation of your package looks like, with a clean "
4771 "debconf database."
4772 msgstr ""
4773
4774 #. type: Plain text
4775 #: debconf-devel.7:629
4776 msgid ""
4777 "It turns out that if you set up a ~/.debconfrc file for a normal user, "
4778 "pointing at a personal config.dat and template.dat for the user, you can "
4779 "load up templates and run config scripts all you like, without any root "
4780 "access. If you want to start over with a clean database, just blow away the "
4781 "*.dat files."
4782 msgstr ""
4783
4784 #. type: Plain text
4785 #: debconf-devel.7:634
4786 msgid ""
4787 "For details about setting this up, see B<debconf.conf>(5)B<,> and note that "
4788 "/etc/debconf.conf makes a good template for a personal ~/.debconfrc file."
4789 msgstr ""
4790
4791 #. type: SH
4792 #: debconf-devel.7:635
4793 #, no-wrap
4794 msgid "ADVANCED PROGRAMMING WITH DEBCONF"
4795 msgstr ""
4796
4797 #. type: SS
4798 #: debconf-devel.7:636
4799 #, no-wrap
4800 msgid "Config file handling"
4801 msgstr ""
4802
4803 #. type: Plain text
4804 #: debconf-devel.7:643
4805 msgid ""
4806 "Many of you seem to want to use debconf to help manage config files that are "
4807 "part of your package. Perhaps there is no good default to ship in a "
4808 "conffile, and so you want to use debconf to prompt the user, and write out a "
4809 "config file based on their answers. That seems easy enough to do, but then "
4810 "you consider upgrades, and what to do when someone modifies the config file "
4811 "you generate, and dpkg-reconfigure, and ..."
4812 msgstr ""
4813
4814 #. type: Plain text
4815 #: debconf-devel.7:651
4816 msgid ""
4817 "There are a lot of ways to do this, and most of them are wrong, and will "
4818 "often earn you annoyed bug reports. Here is one right way to do it. It "
4819 "assumes that your config file is really just a series of shell variables "
4820 "being set, with comments in between, and so you can just source the file to "
4821 "\"load\" it. If you have a more complicated format, reading (and writing) "
4822 "it becomes a bit trickier."
4823 msgstr ""
4824
4825 #. type: Plain text
4826 #: debconf-devel.7:653
4827 msgid "Your config script will look something like this:"
4828 msgstr ""
4829
4830 #. type: Plain text
4831 #: debconf-devel.7:658 debconf-devel.7:680
4832 #, no-wrap
4833 msgid ""
4834 " #!/bin/sh\n"
4835 " CONFIGFILE=/etc/foo.conf\n"
4836 " set -e\n"
4837 " . /usr/share/debconf/confmodule\n"
4838 msgstr ""
4839
4840 #. type: Plain text
4841 #: debconf-devel.7:662
4842 #, no-wrap
4843 msgid ""
4844 " # Load config file, if it exists.\n"
4845 " if [ -e $CONFIGFILE ]; then\n"
4846 " \t. $CONFIGFILE || true\n"
4847 msgstr ""
4848
4849 #. type: Plain text
4850 #: debconf-devel.7:668
4851 #, no-wrap
4852 msgid ""
4853 " \t# Store values from config file into\n"
4854 " \t# debconf db.\n"
4855 " \tdb_set mypackage/foo \"$FOO\"\n"
4856 " \tdb_set mypackage/bar \"$BAR\"\n"
4857 " fi\n"
4858 msgstr ""
4859
4860 #. type: Plain text
4861 #: debconf-devel.7:673
4862 #, no-wrap
4863 msgid ""
4864 " # Ask questions.\n"
4865 " db_input medium mypackage/foo || true\n"
4866 " db_input medium mypackage/bar || true\n"
4867 " db_go || true\n"
4868 msgstr ""
4869
4870 #. type: Plain text
4871 #: debconf-devel.7:675
4872 msgid "And the postinst will look something like this:"
4873 msgstr ""
4874
4875 #. type: Plain text
4876 #: debconf-devel.7:689
4877 #, no-wrap
4878 msgid ""
4879 " # Generate config file, if it doesn't exist.\n"
4880 " # An alternative is to copy in a template\n"
4881 " # file from elsewhere.\n"
4882 " if [ ! -e $CONFIGFILE ]; then\n"
4883 " \techo \"# Config file for my package\" E<gt> $CONFIGFILE\n"
4884 " \techo \"FOO=\" E<gt>E<gt> $CONFIGFILE\n"
4885 " \techo \"BAR=\" E<gt>E<gt> $CONFIGFILE\n"
4886 " fi\n"
4887 msgstr ""
4888
4889 #. type: Plain text
4890 #: debconf-devel.7:699
4891 #, no-wrap
4892 msgid ""
4893 " # Substitute in the values from the debconf db.\n"
4894 " # There are obvious optimizations possible here.\n"
4895 " # The cp before the sed ensures we do not mess up\n"
4896 " # the config file's ownership and permissions.\n"
4897 " db_get mypackage/foo\n"
4898 " FOO=\"$RET\"\n"
4899 " db_get mypackage/bar\n"
4900 " BAR=\"$RET\"\n"
4901 " cp -a -f $CONFIGFILE $CONFIGFILE.tmp\n"
4902 msgstr ""
4903
4904 #. type: Plain text
4905 #: debconf-devel.7:706
4906 #, no-wrap
4907 msgid ""
4908 " # If the admin deleted or commented some variables but then set\n"
4909 " # them via debconf, (re-)add them to the conffile.\n"
4910 " test -z \"$FOO\" || grep -Eq '^ *FOO=' $CONFIGFILE || \\e\n"
4911 " \techo \"FOO=\" E<gt>E<gt> $CONFIGFILE\n"
4912 " test -z \"$BAR\" || grep -Eq '^ *BAR=' $CONFIGFILE || \\e\n"
4913 " \techo \"BAR=\" E<gt>E<gt> $CONFIGFILE\n"
4914 msgstr ""
4915
4916 #. type: Plain text
4917 #: debconf-devel.7:711
4918 #, no-wrap
4919 msgid ""
4920 " sed -e \"s/^ *FOO=.*/FOO=\\e\"$FOO\\e\"/\" \\e\n"
4921 " -e \"s/^ *BAR=.*/BAR=\\e\"$BAR\\e\"/\" \\e\n"
4922 " E<lt> $CONFIGFILE E<gt> $CONFIGFILE.tmp\n"
4923 " mv -f $CONFIGFILE.tmp $CONFIGFILE\n"
4924 msgstr ""
4925
4926 #. type: Plain text
4927 #: debconf-devel.7:719
4928 msgid ""
4929 "Consider how these two scripts handle all the cases. On fresh installs the "
4930 "questions are asked by the config script, and a new config file generated by "
4931 "the postinst. On upgrades and reconfigures, the config file is read in, and "
4932 "the values in it are used to change the values in the debconf database, so "
4933 "the admin's manual changes are not lost. The questions are asked again (and "
4934 "may or may not be displayed). Then the postinst substitutes the values back "
4935 "into the config file, leaving the rest of it unchanged."
4936 msgstr ""
4937
4938 #. type: SS
4939 #: debconf-devel.7:719
4940 #, no-wrap
4941 msgid "Letting the user back up"
4942 msgstr ""
4943
4944 #. type: Plain text
4945 #: debconf-devel.7:725
4946 msgid ""
4947 "Few things are more frustrating when using a system like debconf than being "
4948 "asked a question, and answering it, then moving on to another screen with a "
4949 "new question on it, and realizing that hey, you made a mistake, with that "
4950 "last question, and you want to go back to it, and discovering that you "
4951 "can't."
4952 msgstr ""
4953
4954 #. type: Plain text
4955 #: debconf-devel.7:731
4956 msgid ""
4957 "Since debconf is driven by your config script, it can't jump back to a "
4958 "previous question on its own but with a little help from you, it can "
4959 "accomplish this feat. The first step is to make your config script let "
4960 "debconf know it is capable of handling the user pressing a back button. You "
4961 "use the CAPB command to do this, passing backup as a parameter."
4962 msgstr ""
4963
4964 #. type: Plain text
4965 #: debconf-devel.7:735
4966 msgid ""
4967 "Then after each GO command, you must test to see if the user asked to back "
4968 "up (debconf returns a code of 30), and if so jump back to the previous "
4969 "question."
4970 msgstr ""
4971
4972 #. type: Plain text
4973 #: debconf-devel.7:741
4974 msgid ""
4975 "There are several ways to write the control structures of your program so it "
4976 "can jump back to previous questions when necessary. You can write goto-laden "
4977 "spaghetti code. Or you can create several functions and use recursion. But "
4978 "perhaps the cleanest and easiest way is to construct a state machine. Here "
4979 "is a skeleton of a state machine that you can fill out and expand."
4980 msgstr ""
4981
4982 #. type: Plain text
4983 #: debconf-devel.7:746
4984 #, no-wrap
4985 msgid ""
4986 " #!/bin/sh\n"
4987 " set -e\n"
4988 " . /usr/share/debconf/confmodule\n"
4989 " db_capb backup\n"
4990 msgstr ""
4991
4992 #. type: Plain text
4993 #: debconf-devel.7:773
4994 #, no-wrap
4995 msgid ""
4996 " STATE=1\n"
4997 " while true; do\n"
4998 " \tcase \"$STATE\" in\n"
4999 " \t1)\n"
5000 " \t\t# Two unrelated questions.\n"
5001 " \t\tdb_input medium my/question || true\n"
5002 " \t\tdb_input medium my/other_question || true\n"
5003 " \t;;\n"
5004 " \t2)\n"
5005 " \t\t# Only ask this question if the\n"
5006 " \t\t# first question was answered in\n"
5007 " \t\t# the affirmative.\n"
5008 " \tdb_get my/question\n"
5009 " \t\tif [ \"$RET\" = \"true\" ]; then\n"
5010 " \t\t\tdb_input medium my/dep_question || true\n"
5011 " \t\tfi\n"
5012 " \t;;\n"
5013 " \t*)\n"
5014 " \t\t# The default case catches when $STATE is greater than the\n"
5015 " \t\t# last implemented state, and breaks out of the loop. This\n"
5016 " \t\t# requires that states be numbered consecutively from 1\n"
5017 " \t\t# with no gaps, as the default case will also be entered\n"
5018 " \t\t# if there is a break in the numbering\n"
5019 " \t\tbreak # exits the enclosing \"while\" loop\n"
5020 " \t;;\n"
5021 " \tesac\n"
5022 msgstr ""
5023
5024 #. type: Plain text
5025 #: debconf-devel.7:780
5026 #, no-wrap
5027 msgid ""
5028 " \tif db_go; then\n"
5029 " \t\tSTATE=$((STATE + 1))\n"
5030 " \telse\n"
5031 " \t\tSTATE=$((STATE - 1))\n"
5032 " \tfi\n"
5033 " done\n"
5034 msgstr ""
5035
5036 #. type: Plain text
5037 #: debconf-devel.7:791
5038 #, no-wrap
5039 msgid ""
5040 " if [ $STATE -eq 0 ]; then\n"
5041 " \t# The user has asked to back up from the first\n"
5042 " \t# question. This case is problematical. Regular\n"
5043 " \t# dpkg and apt package installation isn't capable\n"
5044 " \t# of backing up questions between packages as this\n"
5045 " \t# is written, so this will exit leaving the package\n"
5046 " \t# unconfigured - probably the best way to handle\n"
5047 " \t# the situation.\n"
5048 " \texit 10\n"
5049 " fi\n"
5050 msgstr ""
5051
5052 #. type: Plain text
5053 #: debconf-devel.7:796
5054 msgid ""
5055 "Note that if all your config script does is ask a few unrelated questions, "
5056 "then there is no need for the state machine. Just ask them all, and GO; "
5057 "debconf will do its best to present them all in one screen, and the user "
5058 "won't need to back up."
5059 msgstr ""
5060
5061 #. type: SS
5062 #: debconf-devel.7:796
5063 #, no-wrap
5064 msgid "Preventing infinite loops"
5065 msgstr ""
5066
5067 #. type: Plain text
5068 #: debconf-devel.7:800
5069 msgid ""
5070 "One gotcha with debconf comes up if you have a loop in your config "
5071 "script. Suppose you're asking for input and validating it, and looping if "
5072 "it's not valid:"
5073 msgstr ""
5074
5075 #. type: Plain text
5076 #: debconf-devel.7:810
5077 #, no-wrap
5078 msgid ""
5079 " ok=''\n"
5080 " do while [ ! \"$ok\" ];\n"
5081 " \tdb_input low foo/bar || true\n"
5082 " \tdb_go || true\n"
5083 " \tdb_get foo/bar\n"
5084 " \tif [ \"$RET\" ]; then\n"
5085 " \t\tok=1\n"
5086 " \tfi\n"
5087 " done\n"
5088 msgstr ""
5089
5090 #. type: Plain text
5091 #: debconf-devel.7:817
5092 msgid ""
5093 "This looks ok at first glance. But consider what happens if the value of "
5094 "foo/bar is \"\" when this loop is entered, and the user has their priority "
5095 "set high, or is using a non-interactive frontend, and so they are not really "
5096 "asked for input. The value of foo/bar is not changed by the db_input, and so "
5097 "it fails the test and loops. And loops ..."
5098 msgstr ""
5099
5100 #. type: Plain text
5101 #: debconf-devel.7:823
5102 msgid ""
5103 "One fix for this is to make sure that before the loop is entered, the value "
5104 "of foo/bar is set to something that will pass the test in the loop. So for "
5105 "example if the default value of foo/bar is \"1\", then you could RESET "
5106 "foo/bar just before entering the loop."
5107 msgstr ""
5108
5109 #. type: Plain text
5110 #: debconf-devel.7:827
5111 msgid ""
5112 "Another fix is to check the return code of the INPUT command. If it is 30 "
5113 "then the user is not being shown the question you asked them, and you should "
5114 "break out of the loop."
5115 msgstr ""
5116
5117 #. type: SS
5118 #: debconf-devel.7:827
5119 #, no-wrap
5120 msgid "Choosing among related packages"
5121 msgstr ""
5122
5123 #. type: Plain text
5124 #: debconf-devel.7:832
5125 msgid ""
5126 "Sometimes a set of related packages can be installed, and you want to prompt "
5127 "the user which of the set should be used by default. Examples of such sets "
5128 "are window managers, or ispell dictionary files."
5129 msgstr ""
5130
5131 #. type: Plain text
5132 #: debconf-devel.7:838
5133 msgid ""
5134 "While it would be possible for each package in the set to simply prompt, "
5135 "\"Should this package be default?\", this leads to a lot of repetitive "
5136 "questions if several of the packages are installed. It's possible with "
5137 "debconf to present a list of all the packages in the set and allow the user "
5138 "to choose between them. Here's how."
5139 msgstr ""
5140
5141 #. type: Plain text
5142 #: debconf-devel.7:841
5143 msgid "Make all the packages in the set use a shared template. Something like this:"
5144 msgstr ""
5145
5146 #. type: Plain text
5147 #: debconf-devel.7:848
5148 #, no-wrap
5149 msgid ""
5150 " Template: shared/window-manager\n"
5151 " Type: select\n"
5152 " Choices: ${choices}\n"
5153 " Description: Select the default window manager.\n"
5154 " Select the window manager that will be started by\n"
5155 " default when X starts.\n"
5156 msgstr ""
5157
5158 #. type: Plain text
5159 #: debconf-devel.7:851
5160 msgid ""
5161 "Each package should include a copy of the template. Then it should include "
5162 "some code like this in its config script:"
5163 msgstr ""
5164
5165 #. type: Plain text
5166 #: debconf-devel.7:856
5167 #, no-wrap
5168 msgid ""
5169 " db_metaget shared/window-manager owners\n"
5170 " OWNERS=$RET\n"
5171 " db_metaget shared/window-manager choices\n"
5172 " CHOICES=$RET\n"
5173 msgstr ""
5174
5175 #. type: Plain text
5176 #: debconf-devel.7:861
5177 #, no-wrap
5178 msgid ""
5179 " if [ \"$OWNERS\" != \"$CHOICES\" ]; then\n"
5180 " \tdb_subst shared/window-manager choices $OWNERS\n"
5181 " \tdb_fset shared/window-manager seen false\n"
5182 " fi\n"
5183 msgstr ""
5184
5185 #. type: Plain text
5186 #: debconf-devel.7:864
5187 #, no-wrap
5188 msgid ""
5189 " db_input medium shared/window-manager || true\n"
5190 " db_go || true\n"
5191 msgstr ""
5192
5193 #. type: Plain text
5194 #: debconf-devel.7:872
5195 msgid ""
5196 "A bit of an explanation is called for. By the time your config script runs, "
5197 "debconf has already read in all the templates for the packages that are "
5198 "being installed. Since the set of packages share a question, debconf records "
5199 "that fact in the owners field. By a strange coincidence, the format of the "
5200 "owners field is the same as that of the choices field (a comma and space "
5201 "delimited list of values)."
5202 msgstr ""
5203
5204 #. type: Plain text
5205 #: debconf-devel.7:877
5206 msgid ""
5207 "The METAGET command can be used to get the list of owners and the list of "
5208 "choices. If they are different, then a new package has been installed. So "
5209 "use the SUBST command to change the list of choices to be the same as the "
5210 "list of owners, and ask the question."
5211 msgstr ""
5212
5213 #. type: Plain text
5214 #: debconf-devel.7:881
5215 msgid ""
5216 "When a package is removed, you probably want to see if that package is the "
5217 "currently selected choice, and if so, prompt the user to select a different "
5218 "package to replace it."
5219 msgstr ""
5220
5221 #. type: Plain text
5222 #: debconf-devel.7:885
5223 msgid ""
5224 "This can be accomplished by adding something like this to the prerm scripts "
5225 "of all related packages (replacing E<lt>packageE<gt> with the package name):"
5226 msgstr ""
5227
5228 #. type: Plain text
5229 #: debconf-devel.7:890
5230 #, no-wrap
5231 msgid ""
5232 " if [ -e /usr/share/debconf/confmodule ]; then\n"
5233 " \t. /usr/share/debconf/confmodule\n"
5234 " \t# I no longer claim this question.\n"
5235 " \tdb_unregister shared/window-manager\n"
5236 msgstr ""
5237
5238 #. type: Plain text
5239 #: debconf-devel.7:901
5240 #, no-wrap
5241 msgid ""
5242 " \t# See if the shared question still exists.\n"
5243 " \tif db_get shared/window-manager; then\n"
5244 " \t\tdb_metaget shared/window-manager owners\n"
5245 " \t\tdb_subst shared/window-manager choices $RET\n"
5246 " \t\tdb_metaget shared/window-manager value\n"
5247 " \t\tif [ \"E<lt>packageE<gt>\" = \"$RET\" ] ; then\n"
5248 " \t\t\tdb_fset shared/window-manager seen false\n"
5249 " \t\t\tdb_input high shared/window-manager || true\n"
5250 " \t\t\tdb_go || true\n"
5251 " \t\tfi\n"
5252 msgstr ""
5253
5254 #. type: Plain text
5255 #: debconf-devel.7:906
5256 #, no-wrap
5257 msgid ""
5258 " \t\t# Now do whatever the postinst script did\n"
5259 " \t\t# to update the window manager symlink.\n"
5260 " \tfi\n"
5261 " fi\n"
5262 msgstr ""
5263
5264 #. type: SH
5265 #: debconf-devel.7:906
5266 #, no-wrap
5267 msgid "HACKS"
5268 msgstr ""
5269
5270 #. type: Plain text
5271 #: debconf-devel.7:909
5272 msgid ""
5273 "Debconf is currently not fully integrated into dpkg (but I want to change "
5274 "this in the future), and so some messy hacks are currently called for."
5275 msgstr ""
5276
5277 #. type: Plain text
5278 #: debconf-devel.7:920
5279 msgid ""
5280 "The worst of these involves getting the config script to run. The way that "
5281 "works now is the config script will be run when the package is "
5282 "pre-configured. Then, when the postinst script runs, it starts up debconf "
5283 "again. Debconf notices it is being used by the postinst script, and so it "
5284 "goes off and runs the config script. This can only work if your postinst "
5285 "loads up one of the debconf libraries though, so postinsts always have to "
5286 "take care to do that. We hope to address this later by adding explicit "
5287 "support to dpkg for debconf. The B<debconf>(1) program is a step in this "
5288 "direction."
5289 msgstr ""
5290
5291 #. type: Plain text
5292 #: debconf-devel.7:931
5293 msgid ""
5294 "A related hack is getting debconf running when a config script, postinst, or "
5295 "other program that uses it starts up. After all, they expect to be able to "
5296 "talk to debconf right away. The way this is accomplished for now is that "
5297 "when such a script loads a debconf library (like "
5298 "/usr/share/debconf/confmodule), and debconf is not already running, it is "
5299 "started up, and a new copy of the script is re-execed. The only noticeable "
5300 "result is that you need to put the line that loads a debconf library at the "
5301 "very top of the script, or weird things will happen. We hope to address this "
5302 "later by changing how debconf is invoked, and turning it into something more "
5303 "like a transient daemon."
5304 msgstr ""
5305
5306 #. type: Plain text
5307 #: debconf-devel.7:942
5308 msgid ""
5309 "It's rather hackish how debconf figures out what templates files to load, "
5310 "and when it loads them. When the config, preinst, and postinst scripts "
5311 "invoke debconf, it will automatically figure out where the templates file "
5312 "is, and load it. Standalone programs that use debconf will cause debconf to "
5313 "look for templates files in "
5314 "/usr/share/debconf/templates/progname.templates. And if a postrm wants to "
5315 "use debconf at purge time, the templates won't be available unless debconf "
5316 "had a chance to load them in its postinst. This is messy, but rather "
5317 "unavoidable. In the future some of these programs may be able to use "
5318 "debconf-loadtemplate by hand though."
5319 msgstr ""
5320
5321 #. type: Plain text
5322 #: debconf-devel.7:950
5323 msgid ""
5324 "/usr/share/debconf/confmodule's historic behavior of playing with file "
5325 "descriptors and setting up a fd #3 that talks to debconf, can cause all "
5326 "sorts of trouble when a postinst runs a daemon, since the daemon ends up "
5327 "talking to debconf, and debconf can't figure out when the script "
5328 "terminates. The STOP command can work around this. In the future, we are "
5329 "considering making debconf communication happen over a socket or some other "
5330 "mechanism than stdio."
5331 msgstr ""
5332
5333 #. type: Plain text
5334 #: debconf-devel.7:958
5335 msgid ""
5336 "Debconf sets DEBCONF_RECONFIGURE=1 before running postinst scripts, so a "
5337 "postinst script that needs to avoid some expensive operation when "
5338 "reconfigured can look at that variable. This is a hack because the right "
5339 "thing would be to pass $1 = \"reconfigure\", but doing so without breaking "
5340 "all the postinsts that use debconf is difficult. The migration plan away "
5341 "from this hack is to encourage people to write postinsts that accept "
5342 "\"reconfigure\", and once they all do, begin passing that parameter."
5343 msgstr ""
5344
5345 #. type: Plain text
5346 #: debconf-devel.7:961
5347 msgid "B<debconf>(7) is the debconf user's guide."
5348 msgstr ""
5349
5350 #. type: Plain text
5351 #: debconf-devel.7:964
5352 msgid ""
5353 "The debconf specification in debian policy is the canonical definition of "
5354 "the debconf "
5355 "protocol. /usr/share/doc/debian-policy/debconf_specification.txt.gz"
5356 msgstr ""
5357
5358 #. type: Plain text
5359 #: debconf-devel.7:968
5360 msgid ""
5361 "B<debconf.conf>(5) has much useful information, including some info about "
5362 "the backend database."
5363 msgstr ""