Rev 1 | Only display areas with differences | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed
Rev 1 | Rev 11 | ||
---|---|---|---|
1 | .\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.14 |
1 | .\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.14 |
2 | .\" |
2 | .\" |
3 | .\" Standard preamble: |
3 | .\" Standard preamble: |
4 | .\" ======================================================================== |
4 | .\" ======================================================================== |
5 | .de Sh \" Subsection heading |
5 | .de Sh \" Subsection heading |
6 | .br |
6 | .br |
7 | .if t .Sp |
7 | .if t .Sp |
8 | .ne 5 |
8 | .ne 5 |
9 | .PP |
9 | .PP |
10 | \fB\\$1\fR |
10 | \fB\\$1\fR |
11 | .PP |
11 | .PP |
12 | .. |
12 | .. |
13 | .de Sp \" Vertical space (when we can't use .PP) |
13 | .de Sp \" Vertical space (when we can't use .PP) |
14 | .if t .sp .5v |
14 | .if t .sp .5v |
15 | .if n .sp |
15 | .if n .sp |
16 | .. |
16 | .. |
17 | .de Vb \" Begin verbatim text |
17 | .de Vb \" Begin verbatim text |
18 | .ft CW |
18 | .ft CW |
19 | .nf |
19 | .nf |
20 | .ne \\$1 |
20 | .ne \\$1 |
21 | .. |
21 | .. |
22 | .de Ve \" End verbatim text |
22 | .de Ve \" End verbatim text |
23 | .ft R |
23 | .ft R |
24 | .fi |
24 | .fi |
25 | .. |
25 | .. |
26 | .\" Set up some character translations and predefined strings. \*(-- will |
26 | .\" Set up some character translations and predefined strings. \*(-- will |
27 | .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left |
27 | .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left |
28 | .\" double quote, and \*(R" will give a right double quote. | will give a |
28 | .\" double quote, and \*(R" will give a right double quote. | will give a |
29 | .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to |
29 | .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to |
30 | .\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' |
30 | .\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' |
31 | .\" expand to `' in nroff, nothing in troff, for use with C<>. |
31 | .\" expand to `' in nroff, nothing in troff, for use with C<>. |
32 | .tr \(*W-|\(bv\*(Tr |
32 | .tr \(*W-|\(bv\*(Tr |
33 | .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' |
33 | .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' |
34 | .ie n \{\ |
34 | .ie n \{\ |
35 | . ds -- \(*W- |
35 | . ds -- \(*W- |
36 | . ds PI pi |
36 | . ds PI pi |
37 | . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch |
37 | . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch |
38 | . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch |
38 | . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch |
39 | . ds L" "" |
39 | . ds L" "" |
40 | . ds R" "" |
40 | . ds R" "" |
41 | . ds C` "" |
41 | . ds C` "" |
42 | . ds C' "" |
42 | . ds C' "" |
43 | 'br\} |
43 | 'br\} |
44 | .el\{\ |
44 | .el\{\ |
45 | . ds -- \|\(em\| |
45 | . ds -- \|\(em\| |
46 | . ds PI \(*p |
46 | . ds PI \(*p |
47 | . ds L" `` |
47 | . ds L" `` |
48 | . ds R" '' |
48 | . ds R" '' |
49 | 'br\} |
49 | 'br\} |
50 | .\" |
50 | .\" |
51 | .\" If the F register is turned on, we'll generate index entries on stderr for |
51 | .\" If the F register is turned on, we'll generate index entries on stderr for |
52 | .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index |
52 | .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index |
53 | .\" entries marked with X<> in POD. Of course, you'll have to process the |
53 | .\" entries marked with X<> in POD. Of course, you'll have to process the |
54 | .\" output yourself in some meaningful fashion. |
54 | .\" output yourself in some meaningful fashion. |
55 | .if \nF \{\ |
55 | .if \nF \{\ |
56 | . de IX |
56 | . de IX |
57 | . tm Index:\\$1\t\\n%\t"\\$2" |
57 | . tm Index:\\$1\t\\n%\t"\\$2" |
58 | .. |
58 | .. |
59 | . nr % 0 |
59 | . nr % 0 |
60 | . rr F |
60 | . rr F |
61 | .\} |
61 | .\} |
62 | .\" |
62 | .\" |
63 | .\" For nroff, turn off justification. Always turn off hyphenation; it makes |
63 | .\" For nroff, turn off justification. Always turn off hyphenation; it makes |
64 | .\" way too many mistakes in technical documents. |
64 | .\" way too many mistakes in technical documents. |
65 | .hy 0 |
65 | .hy 0 |
66 | .if n .na |
66 | .if n .na |
67 | .\" |
67 | .\" |
68 | .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). |
68 | .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). |
69 | .\" Fear. Run. Save yourself. No user-serviceable parts. |
69 | .\" Fear. Run. Save yourself. No user-serviceable parts. |
70 | . \" fudge factors for nroff and troff |
70 | . \" fudge factors for nroff and troff |
71 | .if n \{\ |
71 | .if n \{\ |
72 | . ds #H 0 |
72 | . ds #H 0 |
73 | . ds #V .8m |
73 | . ds #V .8m |
74 | . ds #F .3m |
74 | . ds #F .3m |
75 | . ds #[ \f1 |
75 | . ds #[ \f1 |
76 | . ds #] \fP |
76 | . ds #] \fP |
77 | .\} |
77 | .\} |
78 | .if t \{\ |
78 | .if t \{\ |
79 | . ds #H ((1u-(\\\\n(.fu%2u))*.13m) |
79 | . ds #H ((1u-(\\\\n(.fu%2u))*.13m) |
80 | . ds #V .6m |
80 | . ds #V .6m |
81 | . ds #F 0 |
81 | . ds #F 0 |
82 | . ds #[ \& |
82 | . ds #[ \& |
83 | . ds #] \& |
83 | . ds #] \& |
84 | .\} |
84 | .\} |
85 | . \" simple accents for nroff and troff |
85 | . \" simple accents for nroff and troff |
86 | .if n \{\ |
86 | .if n \{\ |
87 | . ds ' \& |
87 | . ds ' \& |
88 | . ds ` \& |
88 | . ds ` \& |
89 | . ds ^ \& |
89 | . ds ^ \& |
90 | . ds , \& |
90 | . ds , \& |
91 | . ds ~ ~ |
91 | . ds ~ ~ |
92 | . ds / |
92 | . ds / |
93 | .\} |
93 | .\} |
94 | .if t \{\ |
94 | .if t \{\ |
95 | . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" |
95 | . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" |
96 | . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' |
96 | . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' |
97 | . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' |
97 | . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' |
98 | . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' |
98 | . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' |
99 | . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' |
99 | . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' |
100 | . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' |
100 | . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' |
101 | .\} |
101 | .\} |
102 | . \" troff and (daisy-wheel) nroff accents |
102 | . \" troff and (daisy-wheel) nroff accents |
103 | .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' |
103 | .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' |
104 | .ds 8 \h'\*(#H'\(*b\h'-\*(#H' |
104 | .ds 8 \h'\*(#H'\(*b\h'-\*(#H' |
105 | .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] |
105 | .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] |
106 | .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' |
106 | .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' |
107 | .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' |
107 | .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' |
108 | .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] |
108 | .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] |
109 | .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] |
109 | .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] |
110 | .ds ae a\h'-(\w'a'u*4/10)'e |
110 | .ds ae a\h'-(\w'a'u*4/10)'e |
111 | .ds Ae A\h'-(\w'A'u*4/10)'E |
111 | .ds Ae A\h'-(\w'A'u*4/10)'E |
112 | . \" corrections for vroff |
112 | . \" corrections for vroff |
113 | .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' |
113 | .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' |
114 | .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' |
114 | .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' |
115 | . \" for low resolution devices (crt and lpr) |
115 | . \" for low resolution devices (crt and lpr) |
116 | .if \n(.H>23 .if \n(.V>19 \ |
116 | .if \n(.H>23 .if \n(.V>19 \ |
117 | \{\ |
117 | \{\ |
118 | . ds : e |
118 | . ds : e |
119 | . ds 8 ss |
119 | . ds 8 ss |
120 | . ds o a |
120 | . ds o a |
121 | . ds d- d\h'-1'\(ga |
121 | . ds d- d\h'-1'\(ga |
122 | . ds D- D\h'-1'\(hy |
122 | . ds D- D\h'-1'\(hy |
123 | . ds th \o'bp' |
123 | . ds th \o'bp' |
124 | . ds Th \o'LP' |
124 | . ds Th \o'LP' |
125 | . ds ae ae |
125 | . ds ae ae |
126 | . ds Ae AE |
126 | . ds Ae AE |
127 | .\} |
127 | .\} |
128 | .rm #[ #] #H #V #F C |
128 | .rm #[ #] #H #V #F C |
129 | .\" ======================================================================== |
129 | .\" ======================================================================== |
130 | .\" |
130 | .\" |
131 | .IX Title "DebPool::Config 5" |
131 | .IX Title "DebPool::Config 5" |
132 | .TH DebPool::Config 5 "2005-01-20" "perl v5.8.4" "DebPool Configuration" |
132 | .TH DebPool::Config 5 "2005-01-20" "perl v5.8.4" "DebPool Configuration" |
133 | .SH "NAME" |
133 | .SH "NAME" |
134 | DebPool::Config \- configuration file format for debpool |
134 | DebPool::Config \- configuration file format for debpool |
135 | .SH "SYNOPSIS" |
135 | .SH "SYNOPSIS" |
136 | .IX Header "SYNOPSIS" |
136 | .IX Header "SYNOPSIS" |
137 | package DebPool::Config; |
137 | package DebPool::Config; |
138 | .PP |
138 | .PP |
139 | %Options = ( |
139 | %Options = ( |
140 | 'option1' => value1, |
140 | 'option1' => value1, |
141 | 'option2' => value2, |
141 | 'option2' => value2, |
142 | ... |
142 | ... |
143 | ); |
143 | ); |
144 | .PP |
144 | .PP |
145 | 1; |
145 | 1; |
146 | .SH "DESCRIPTION" |
146 | .SH "DESCRIPTION" |
147 | .IX Header "DESCRIPTION" |
147 | .IX Header "DESCRIPTION" |
148 | The DebPool::Config file is normally found in three places; |
148 | The DebPool::Config file is normally found in three places; |
149 | \&\fI/usr/share/debpool/Config.pm\fR, \fI/etc/debpool/Config.pm\fR, and |
149 | \&\fI/usr/share/debpool/Config.pm\fR, \fI/etc/debpool/Config.pm\fR, and |
150 | \&\fI$HOME/.debpool/Config.pm\fR (in ascending order of precedence); |
150 | \&\fI$HOME/.debpool/Config.pm\fR (in ascending order of precedence); |
151 | further locations can also be specified on the command line with the |
151 | further locations can also be specified on the command line with the |
152 | \&'\-\-config=<file>' option, which overrides all of these (and is, in turn, |
152 | \&'\-\-config=<file>' option, which overrides all of these (and is, in turn, |
153 | overridden by any command line options). Also of note is the \-\-nodefault |
153 | overridden by any command line options). Also of note is the \-\-nodefault |
154 | option, which prevents any attempt at loading the default (system and user) |
154 | option, which prevents any attempt at loading the default (system and user) |
155 | config files. |
155 | config files. |
156 | .PP |
156 | .PP |
157 | The config files in /etc/debpool and \f(CW$HOME\fR/.debpool are not required to be |
157 | The config files in /etc/debpool and \f(CW$HOME\fR/.debpool are not required to be |
158 | full Perl modules, though they must still declare a package namespace of |
158 | full Perl modules, though they must still declare a package namespace of |
159 | \&'DebPool::Config' and return a true value. |
159 | \&'DebPool::Config' and return a true value. |
160 | .Sh "File/Directory configuration" |
160 | .Sh "File/Directory configuration" |
161 | .IX Subsection "File/Directory configuration" |
161 | .IX Subsection "File/Directory configuration" |
162 | These config values determine what directories various parts of the archive |
162 | These config values determine what directories various parts of the archive |
163 | are put in, and what permissions those directories have, as well as the |
163 | are put in, and what permissions those directories have, as well as the |
164 | default permissions for files. |
164 | default permissions for files. |
165 | .PP |
165 | .PP |
166 | \&\s-1NOTE:\s0 While debpool will attempt to create db_dir, dists_dir, incoming_dir, |
166 | \&\s-1NOTE:\s0 While debpool will attempt to create db_dir, dists_dir, incoming_dir, |
167 | installed_dir, pool_dir, and reject_dir if they do not exist, it will *not* |
167 | installed_dir, pool_dir, and reject_dir if they do not exist, it will *not* |
168 | attempt to do this for archive_dir. |
168 | attempt to do this for archive_dir. |
169 | .PP |
169 | .PP |
170 | \&\s-1WARNING:\s0 If you redefine archive_dir and you want the other four entries to |
170 | \&\s-1WARNING:\s0 If you redefine archive_dir and you want the other four entries to |
171 | reflect this by incorporating the new value, you *MUST* redefine them here |
171 | reflect this by incorporating the new value, you *MUST* redefine them here |
172 | (even if you simply use the default value of 'archive_dir'/<dirname>) so |
172 | (even if you simply use the default value of 'archive_dir'/<dirname>) so |
173 | that they use the new definition of archive_dir. |
173 | that they use the new definition of archive_dir. |
174 | .IP "\fBarchive_dir\fR => \fIarchive directory\fR" 4 |
174 | .IP "\fBarchive_dir\fR => \fIarchive directory\fR" 4 |
175 | .IX Item "archive_dir => archive directory" |
175 | .IX Item "archive_dir => archive directory" |
176 | Base directory of the archive. This is never used directly; however, it |
176 | Base directory of the archive. This is never used directly; however, it |
177 | is normally used to construct relative paths for dists_dir, incoming_dir, |
177 | is normally used to construct relative paths for dists_dir, incoming_dir, |
178 | installed_dir, pool_dir, and reject_dir. |
178 | installed_dir, pool_dir, and reject_dir. |
179 | .Sp |
179 | .Sp |
180 | \&\s-1WARNING:\s0 See the section documentation for important details about |
180 | \&\s-1WARNING:\s0 See the section documentation for important details about |
181 | redefining this value. |
181 | redefining this value. |
182 | .Sp |
182 | .Sp |
183 | Default value: '/var/cache/debpool' |
183 | Default value: '/var/cache/debpool' |
184 | .IP "\fBdb_dir\fR => \fIdists directory\fR" 4 |
184 | .IP "\fBdb_dir\fR => \fIdists directory\fR" 4 |
185 | .IX Item "db_dir => dists directory" |
185 | .IX Item "db_dir => dists directory" |
186 | \&\s-1DB\s0 directory, where the database files for each distribution are kept. |
186 | \&\s-1DB\s0 directory, where the database files for each distribution are kept. |
187 | .Sp |
187 | .Sp |
188 | Default value: \*(L"$Options{'archive_dir'}/db\*(R" |
188 | Default value: \*(L"$Options{'archive_dir'}/db\*(R" |
189 | .IP "\fBdb_dir_mode\fR = \fIpermissions (octal)\fR" 4 |
189 | .IP "\fBdb_dir_mode\fR = \fIpermissions (octal)\fR" 4 |
190 | .IX Item "db_dir_mode = permissions (octal)" |
190 | .IX Item "db_dir_mode = permissions (octal)" |
191 | Permissions for db_dir. |
191 | Permissions for db_dir. |
192 | .Sp |
192 | .Sp |
193 | Default value: 0750 |
193 | Default value: 0750 |
194 | .IP "\fBdb_file_mode\fR = \fIpermissions (octal)\fR" 4 |
194 | .IP "\fBdb_file_mode\fR = \fIpermissions (octal)\fR" 4 |
195 | .IX Item "db_file_mode = permissions (octal)" |
195 | .IX Item "db_file_mode = permissions (octal)" |
196 | Permissions for database files in db_dir. |
196 | Permissions for database files in db_dir. |
197 | .Sp |
197 | .Sp |
198 | Default value: 0640 |
198 | Default value: 0640 |
199 | .IP "\fBdists_dir\fR => \fIdists directory\fR" 4 |
199 | .IP "\fBdists_dir\fR => \fIdists directory\fR" 4 |
200 | .IX Item "dists_dir => dists directory" |
200 | .IX Item "dists_dir => dists directory" |
201 | Dists directory, where distribution files (\fI{Packages,Sources}{,.gz}\fR live. |
201 | Dists directory, where distribution files (\fI{Packages,Sources}{,.gz}\fR live. |
202 | .Sp |
202 | .Sp |
203 | Default value: \*(L"$Options{'archive_dir'}/dists\*(R" |
203 | Default value: \*(L"$Options{'archive_dir'}/dists\*(R" |
204 | .IP "\fBdists_dir_mode\fR = \fIpermissions (octal)\fR" 4 |
204 | .IP "\fBdists_dir_mode\fR = \fIpermissions (octal)\fR" 4 |
205 | .IX Item "dists_dir_mode = permissions (octal)" |
205 | .IX Item "dists_dir_mode = permissions (octal)" |
206 | Permissions for dists_dir and all of it's subdirectories. |
206 | Permissions for dists_dir and all of it's subdirectories. |
207 | .Sp |
207 | .Sp |
208 | Default value: 0755 |
208 | Default value: 0755 |
209 | .IP "\fBdists_file_mode\fR = \fIpermissions (octal)\fR" 4 |
209 | .IP "\fBdists_file_mode\fR = \fIpermissions (octal)\fR" 4 |
210 | .IX Item "dists_file_mode = permissions (octal)" |
210 | .IX Item "dists_file_mode = permissions (octal)" |
211 | Permissions for distribution files ({Packages,Sources}{,.gz}. |
211 | Permissions for distribution files ({Packages,Sources}{,.gz}. |
212 | .Sp |
212 | .Sp |
213 | Default value: 0644 |
213 | Default value: 0644 |
214 | .IP "\fBincoming_dir\fR => \fIincoming directory\fR" 4 |
214 | .IP "\fBincoming_dir\fR => \fIincoming directory\fR" 4 |
215 | .IX Item "incoming_dir => incoming directory" |
215 | .IX Item "incoming_dir => incoming directory" |
216 | Incoming directory, where new packages are uploaded. |
216 | Incoming directory, where new packages are uploaded. |
217 | .Sp |
217 | .Sp |
218 | Default value: \*(L"$Options{'archive_dir'}/incoming\*(R"; |
218 | Default value: \*(L"$Options{'archive_dir'}/incoming\*(R"; |
219 | .IP "\fBincoming_dir_mode\fR = \fIpermissions (octal)\fR" 4 |
219 | .IP "\fBincoming_dir_mode\fR = \fIpermissions (octal)\fR" 4 |
220 | .IX Item "incoming_dir_mode = permissions (octal)" |
220 | .IX Item "incoming_dir_mode = permissions (octal)" |
221 | Permissions for incoming_dir. Should have the sticky bit set if you want a |
221 | Permissions for incoming_dir. Should have the sticky bit set if you want a |
222 | system archive. |
222 | system archive. |
223 | .Sp |
223 | .Sp |
224 | Default value: 01775 |
224 | Default value: 01775 |
225 | .IP "\fBinstalled_dir\fR => \fIinstalled directory\fR" 4 |
225 | .IP "\fBinstalled_dir\fR => \fIinstalled directory\fR" 4 |
226 | .IX Item "installed_dir => installed directory" |
226 | .IX Item "installed_dir => installed directory" |
227 | Incoming directory, where new packages are uploaded. |
227 | Incoming directory, where new packages are uploaded. |
228 | .Sp |
228 | .Sp |
229 | Default value: \*(L"$Options{'archive_dir'}/installed\*(R"; |
229 | Default value: \*(L"$Options{'archive_dir'}/installed\*(R"; |
230 | .IP "\fBinstalled_dir_mode\fR = \fIpermissions (octal)\fR" 4 |
230 | .IP "\fBinstalled_dir_mode\fR = \fIpermissions (octal)\fR" 4 |
231 | .IX Item "installed_dir_mode = permissions (octal)" |
231 | .IX Item "installed_dir_mode = permissions (octal)" |
232 | Permissions for installed_dir. Should have the sticky bit set if you want a |
232 | Permissions for installed_dir. Should have the sticky bit set if you want a |
233 | system archive. |
233 | system archive. |
234 | .Sp |
234 | .Sp |
235 | Default value: 0755 |
235 | Default value: 0755 |
236 | .IP "\fBinstalled_file_mode\fR = \fIpermissions (octal)\fR" 4 |
236 | .IP "\fBinstalled_file_mode\fR = \fIpermissions (octal)\fR" 4 |
237 | .IX Item "installed_file_mode = permissions (octal)" |
237 | .IX Item "installed_file_mode = permissions (octal)" |
238 | Permissions for installed Changes files. |
238 | Permissions for installed Changes files. |
239 | .Sp |
239 | .Sp |
240 | Default value: 0644 |
240 | Default value: 0644 |
241 | .IP "\fBpool_dir\fR => \fIpool directory\fR" 4 |
241 | .IP "\fBpool_dir\fR => \fIpool directory\fR" 4 |
242 | .IX Item "pool_dir => pool directory" |
242 | .IX Item "pool_dir => pool directory" |
243 | Pool directory where all .deb files are stored after being accepted. Normally |
243 | Pool directory where all .deb files are stored after being accepted. Normally |
244 | this is constructed as a relative path from archive_dir. |
244 | this is constructed as a relative path from archive_dir. |
245 | .Sp |
245 | .Sp |
246 | Default value: \*(L"$Options{'archive_dir'}/pool\*(R" |
246 | Default value: \*(L"$Options{'archive_dir'}/pool\*(R" |
247 | .IP "\fBpool_dir_mode\fR = \fIpermissions (octal)\fR" 4 |
247 | .IP "\fBpool_dir_mode\fR = \fIpermissions (octal)\fR" 4 |
248 | .IX Item "pool_dir_mode = permissions (octal)" |
248 | .IX Item "pool_dir_mode = permissions (octal)" |
249 | Permissions for pool_dir and all of it's subdirectories. |
249 | Permissions for pool_dir and all of it's subdirectories. |
250 | .Sp |
250 | .Sp |
251 | Default value: 0755 |
251 | Default value: 0755 |
252 | .IP "\fBpool_file_mode\fR = \fIpermissions (octal)\fR" 4 |
252 | .IP "\fBpool_file_mode\fR = \fIpermissions (octal)\fR" 4 |
253 | .IX Item "pool_file_mode = permissions (octal)" |
253 | .IX Item "pool_file_mode = permissions (octal)" |
254 | Permissions for files installed into the pool area (orig.tar.gz, tar.gz, |
254 | Permissions for files installed into the pool area (orig.tar.gz, tar.gz, |
255 | diff.gz, dsc, deb). |
255 | diff.gz, dsc, deb). |
256 | .Sp |
256 | .Sp |
257 | Default value: 0644 |
257 | Default value: 0644 |
258 | .IP "\fBreject_dir\fR => \fIreject directory\fR" 4 |
258 | .IP "\fBreject_dir\fR => \fIreject directory\fR" 4 |
259 | .IX Item "reject_dir => reject directory" |
259 | .IX Item "reject_dir => reject directory" |
260 | Reject directory, where rejected packages are placed. |
260 | Reject directory, where rejected packages are placed. |
261 | .Sp |
261 | .Sp |
262 | Default value: \*(L"$Options{'archive_dir'}/reject\*(R" |
262 | Default value: \*(L"$Options{'archive_dir'}/reject\*(R" |
263 | .IP "\fBreject_dir_mode\fR = \fIpermissions (octal)\fR" 4 |
263 | .IP "\fBreject_dir_mode\fR = \fIpermissions (octal)\fR" 4 |
264 | .IX Item "reject_dir_mode = permissions (octal)" |
264 | .IX Item "reject_dir_mode = permissions (octal)" |
265 | Permissions for reject_dir. |
265 | Permissions for reject_dir. |
266 | .Sp |
266 | .Sp |
267 | Default value: 0750 |
267 | Default value: 0750 |
268 | .IP "\fBreject_file_mode\fR = \fIpermissions (octal)\fR" 4 |
268 | .IP "\fBreject_file_mode\fR = \fIpermissions (octal)\fR" 4 |
269 | .IX Item "reject_file_mode = permissions (octal)" |
269 | .IX Item "reject_file_mode = permissions (octal)" |
270 | Permissions for rejected package files. |
270 | Permissions for rejected package files. |
271 | .Sp |
271 | .Sp |
272 | Default value: 0640 |
272 | Default value: 0640 |
273 | .IP "\fBlock_file\fR => \fIlockfile\fR" 4 |
273 | .IP "\fBlock_file\fR => \fIlockfile\fR" 4 |
274 | .IX Item "lock_file => lockfile" |
274 | .IX Item "lock_file => lockfile" |
275 | Location of the lockfile to use when running. |
275 | Location of the lockfile to use when running. |
276 | .Sp |
276 | .Sp |
277 | Default value: \*(L"$Options{'archive_dir'}/.lock\*(R" |
277 | Default value: \*(L"$Options{'archive_dir'}/.lock\*(R" |
278 | .IP "\fBcompress_dists\fR = \fIboolean\fR" 4 |
278 | .IP "\fBcompress_dists\fR = \fIboolean\fR" 4 |
279 | .IX Item "compress_dists = boolean" |
279 | .IX Item "compress_dists = boolean" |
280 | This determines whether or not compressed versions of the distribution |
280 | This determines whether or not compressed versions of the distribution |
281 | files (Packages.gz, Sources.gz) are generated. Note that enabling this |
281 | files (Packages.gz, Sources.gz) are generated. Note that enabling this |
282 | introduces a dependancy on gzip. |
282 | introduces a dependancy on gzip. |
283 | .Sh "Archive configuration" |
283 | .Sh "Archive configuration" |
284 | .IX Subsection "Archive configuration" |
284 | .IX Subsection "Archive configuration" |
285 | These values control which distributions, components, and architectures the |
285 | These values control which distributions, components, and architectures the |
286 | archive will support. |
286 | archive will support. |
287 | .IP "\fBdists\fR => \fIhash of distribution names and codenames\fR" 4 |
287 | .IP "\fBdists\fR => \fIhash of distribution names and codenames\fR" 4 |
288 | .IX Item "dists => hash of distribution names and codenames" |
288 | .IX Item "dists => hash of distribution names and codenames" |
289 | A hashref pointing to a hash with entries for all distributions we will |
289 | A hashref pointing to a hash with entries for all distributions we will |
290 | accept packages for, and what the current codename for each distribution |
290 | accept packages for, and what the current codename for each distribution |
291 | is. Note that it is acceptable for more than one distribution to point to a |
291 | is. Note that it is acceptable for more than one distribution to point to a |
292 | given codename (for example, when frozen is active); however, this has some |
292 | given codename (for example, when frozen is active); however, this has some |
293 | strange (and non\-deterministic) consequences for Release files. |
293 | strange (and non\-deterministic) consequences for Release files. |
294 | .Sp |
294 | .Sp |
295 | Default value: |
295 | Default value: |
296 | .Sp |
296 | .Sp |
297 | { 'stable' => 'woody', |
297 | { 'stable' => 'woody', |
298 | 'testing' => 'sarge', |
298 | 'testing' => 'sarge', |
299 | 'unstable' => 'sid', |
299 | 'unstable' => 'sid', |
300 | 'experimental' => 'experimental' } |
300 | 'experimental' => 'experimental' } |
301 | .IP "\fBvirtual_dists\fR => \fIhash of virtual distribution names and targets\fR" 4 |
301 | .IP "\fBvirtual_dists\fR => \fIhash of virtual distribution names and targets\fR" 4 |
302 | .IX Item "virtual_dists => hash of virtual distribution names and targets" |
302 | .IX Item "virtual_dists => hash of virtual distribution names and targets" |
303 | A hashref pointing to a hash with entries for all 'virtual' distributions |
303 | A hashref pointing to a hash with entries for all 'virtual' distributions |
304 | we will accept packages for, and what distribution it should be treated |
304 | we will accept packages for, and what distribution it should be treated |
305 | as. It is acceptable for more than one virtual distribution to point to a |
305 | as. It is acceptable for more than one virtual distribution to point to a |
306 | given target. Note that unlike 'dists' entries, symlinks pointing from the |
306 | given target. Note that unlike 'dists' entries, symlinks pointing from the |
307 | virtual name to the real name will not be created, and no attempt is made |
307 | virtual name to the real name will not be created, and no attempt is made |
308 | to use these names in reverse processes (such as Release files); however, |
308 | to use these names in reverse processes (such as Release files); however, |
309 | virtual distributions may target any name (\*(L"unstable\*(R") or codename (\*(L"sid\*(R") |
309 | virtual distributions may target any name (\*(L"unstable\*(R") or codename (\*(L"sid\*(R") |
310 | which appears in the 'dists' hash. |
310 | which appears in the 'dists' hash. |
311 | .Sp |
311 | .Sp |
312 | Default value: |
312 | Default value: |
313 | .Sp |
313 | .Sp |
314 | { |
314 | { |
315 | } |
315 | } |
316 | .Sp |
316 | .Sp |
317 | Exsample value: |
317 | Exsample value: |
318 | .Sp |
318 | .Sp |
319 | { 'unstable\-hostname' => 'unstable', |
319 | { 'unstable\-hostname' => 'unstable', |
320 | 'testing\-hostname' => 'sarge', |
320 | 'testing\-hostname' => 'sarge', |
321 | } |
321 | } |
322 | .IP "\fBsections\fR => \fIarray of section names\fR" 4 |
322 | .IP "\fBsections\fR => \fIarray of section names\fR" 4 |
323 | .IX Item "sections => array of section names" |
323 | .IX Item "sections => array of section names" |
324 | An arrayref pointing to an array which lists all sections we will accept |
324 | An arrayref pointing to an array which lists all sections we will accept |
325 | packages for. Typically, these will be drawn from the set 'main', |
325 | packages for. Typically, these will be drawn from the set 'main', |
326 | \&'contrib', 'non\-free', 'experimental', 'alien', and 'local' (at least on |
326 | \&'contrib', 'non\-free', 'experimental', 'alien', and 'local' (at least on |
327 | the author's systems). |
327 | the author's systems). |
328 | .Sp |
328 | .Sp |
329 | Default value: [ 'main', 'contrib', 'non\-free' ] |
329 | Default value: [ 'main', 'contrib', 'non\-free' ] |
330 | .IP "\fBarchs\fR => \fIarray of architecture names\fR" 4 |
330 | .IP "\fBarchs\fR => \fIarray of architecture names\fR" 4 |
331 | .IX Item "archs => array of architecture names" |
331 | .IX Item "archs => array of architecture names" |
332 | An arrayref pointing to an array which lists all architectures we will |
332 | An arrayref pointing to an array which lists all architectures we will |
333 | accept packages for. Note that 'source' will always be present, and 'all' |
333 | accept packages for. Note that 'source' will always be present, and 'all' |
334 | will be silently ignored (uploads for Arch: all will still work, but the |
334 | will be silently ignored (uploads for Arch: all will still work, but the |
335 | listings appear in arch-specific Packages files). |
335 | listings appear in arch-specific Packages files). |
336 | .Sp |
336 | .Sp |
337 | Default value: [ 'i386' ] |
337 | Default value: [ 'i386' ] |
338 | .Sh "Release configuration" |
338 | .Sh "Release configuration" |
339 | .IX Subsection "Release configuration" |
339 | .IX Subsection "Release configuration" |
340 | If all of the variables below are defined (release_origin, release_label, |
340 | If all of the variables below are defined (release_origin, release_label, |
341 | and release_description), Release files will be generated for each |
341 | and release_description), Release files will be generated for each |
342 | distribution directory. |
342 | distribution directory. |
343 | .PP |
343 | .PP |
344 | Please note that enabling Release files will introduce a dependancy on the |
344 | Please note that enabling Release files will introduce a dependancy on the |
345 | packages 'libdigest\-md5\-perl' and 'libdigest\-sha1\-perl'. |
345 | packages 'libdigest\-md5\-perl' and 'libdigest\-sha1\-perl'. |
346 | .PP |
346 | .PP |
347 | See also: sign_release |
347 | See also: sign_release |
348 | .IP "\fBrelease_origin\fR => \fIorigin tag\fR" 4 |
348 | .IP "\fBrelease_origin\fR => \fIorigin tag\fR" 4 |
349 | .IX Item "release_origin => origin tag" |
349 | .IX Item "release_origin => origin tag" |
350 | A string to be used for the Origin tag in the Release file. |
350 | A string to be used for the Origin tag in the Release file. |
351 | .Sp |
351 | .Sp |
352 | Default value: undef |
352 | Default value: undef |
353 | .IP "\fBrelease_label\fR => \fIlabel tag\fR" 4 |
353 | .IP "\fBrelease_label\fR => \fIlabel tag\fR" 4 |
354 | .IX Item "release_label => label tag" |
354 | .IX Item "release_label => label tag" |
355 | A string to be used for the Label tag in the Release file. |
355 | A string to be used for the Label tag in the Release file. |
356 | .Sp |
356 | .Sp |
357 | Default value: undef |
357 | Default value: undef |
358 | .IP "\fBrelease_description\fR => \fIdescription tag\fR" 4 |
358 | .IP "\fBrelease_description\fR => \fIdescription tag\fR" 4 |
359 | .IX Item "release_description => description tag" |
359 | .IX Item "release_description => description tag" |
360 | A string to be used for the Description tag in the Release file. (Note that |
360 | A string to be used for the Description tag in the Release file. (Note that |
361 | this should be a single line.) |
361 | this should be a single line.) |
362 | .Sp |
362 | .Sp |
363 | Default value: undef |
363 | Default value: undef |
364 | .IP "\fBrelease_noauto\fR = <array of NonAutomatic release names>" 4 |
364 | .IP "\fBrelease_noauto\fR = <array of NonAutomatic release names>" 4 |
365 | .IX Item "release_noauto = <array of NonAutomatic release names>" |
365 | .IX Item "release_noauto = <array of NonAutomatic release names>" |
366 | An array of release names which should be tagged with 'NonAutomatic: yes' |
366 | An array of release names which should be tagged with 'NonAutomatic: yes' |
367 | in their Release files. This tag will keep \s-1APT\s0 from ever automatically |
367 | in their Release files. This tag will keep \s-1APT\s0 from ever automatically |
368 | selecting a package from that archive as an installation candidate. |
368 | selecting a package from that archive as an installation candidate. |
369 | .Sp |
369 | .Sp |
370 | Default value: [ 'experimental' ] |
370 | Default value: [ 'experimental' ] |
371 | .Sh "Signature configuration" |
371 | .Sh "Signature configuration" |
372 | .IX Subsection "Signature configuration" |
372 | .IX Subsection "Signature configuration" |
373 | Please note that enabling any of these options will cause a dependancy on |
373 | Please note that enabling any of these options will cause a dependancy on |
374 | the 'gnupg' package. See \fI/usr/share/doc/debpool/README.GnuPG\fR for more |
374 | the 'gnupg' package. See \fI/usr/share/doc/debpool/README.GnuPG\fR for more |
375 | information. |
375 | information. |
376 | .IP "\fBrequire_sigs_debs\fR = \fIboolean\fR" 4 |
376 | .IP "\fBrequire_sigs_debs\fR = \fIboolean\fR" 4 |
377 | .IX Item "require_sigs_debs = boolean" |
377 | .IX Item "require_sigs_debs = boolean" |
378 | If true, packages will be rejected unless their package files (.deb) |
378 | If true, packages will be rejected unless their package files (.deb) |
379 | are GPG-signed with a recognized key found one of the keyrings listed |
379 | are GPG-signed with a recognized key found one of the keyrings listed |
380 | in 'gpg_keyrings'. These can be signed with the tools in the 'debsigs' |
380 | in 'gpg_keyrings'. These can be signed with the tools in the 'debsigs' |
381 | package. |
381 | package. |
382 | .Sp |
382 | .Sp |
383 | Default value: 0 (false) |
383 | Default value: 0 (false) |
384 | .Sp |
384 | .Sp |
385 | See also: gpg_keyrings |
385 | See also: gpg_keyrings |
386 | .IP "\fBrequire_sigs_meta\fR = \fIboolean\fR" 4 |
386 | .IP "\fBrequire_sigs_meta\fR = \fIboolean\fR" 4 |
387 | .IX Item "require_sigs_meta = boolean" |
387 | .IX Item "require_sigs_meta = boolean" |
388 | If true, packages will be rejected unless their meta-files (.changes and |
388 | If true, packages will be rejected unless their meta-files (.changes and |
389 | \&.dsc) are GPG-signed with a recognized key found one of the keyrings listed |
389 | \&.dsc) are GPG-signed with a recognized key found one of the keyrings listed |
390 | in 'gpg_keyrings'. These are the files normally signed by the 'debsign' |
390 | in 'gpg_keyrings'. These are the files normally signed by the 'debsign' |
391 | utility in devscripts package. |
391 | utility in devscripts package. |
392 | .Sp |
392 | .Sp |
393 | Default value: 0 (false) |
393 | Default value: 0 (false) |
394 | .Sp |
394 | .Sp |
395 | See also: gpg_keyrings |
395 | See also: gpg_keyrings |
396 | .IP "\fBsign_release\fR = \fIboolean\fR" 4 |
396 | .IP "\fBsign_release\fR = \fIboolean\fR" 4 |
397 | .IX Item "sign_release = boolean" |
397 | .IX Item "sign_release = boolean" |
398 | If true, generated Release files with be GPG-signed with the key specified |
398 | If true, generated Release files with be GPG-signed with the key specified |
399 | in 'gpg_sign_key'. |
399 | in 'gpg_sign_key'. |
400 | .Sp |
400 | .Sp |
401 | Note that this will have no effect unless 'gpg_sign_key' is also defined at |
401 | Note that this will have no effect unless 'gpg_sign_key' is also defined at |
402 | some point. |
402 | some point. |
403 | .Sp |
403 | .Sp |
404 | Default value: 0 (false) |
404 | Default value: 0 (false) |
405 | .Sp |
405 | .Sp |
406 | See also: \*(L"Release configuration\*(R", gpg_sign_key |
406 | See also: \*(L"Release configuration\*(R", gpg_sign_key |
407 | .Sh "GnuPG configuration" |
407 | .Sh "GnuPG configuration" |
408 | .IX Subsection "GnuPG configuration" |
408 | .IX Subsection "GnuPG configuration" |
409 | These values will only be used if the use of GnuPG is triggered in some |
409 | These values will only be used if the use of GnuPG is triggered in some |
410 | fashion (such as any of the values in \*(L"Signature configuration\*(R" being |
410 | fashion (such as any of the values in \*(L"Signature configuration\*(R" being |
411 | enabled) , and thus do not (in themselves) trigger a dependancy on GnuPG. |
411 | enabled) , and thus do not (in themselves) trigger a dependancy on GnuPG. |
412 | Please see \fI/usr/share/doc/debpool/README.GnuPG\fR for more information. |
412 | Please see \fI/usr/share/doc/debpool/README.GnuPG\fR for more information. |
413 | .IP "\fBgpg_bin\fR = \fIGnuPG binary\fR" 4 |
413 | .IP "\fBgpg_bin\fR = \fIGnuPG binary\fR" 4 |
414 | .IX Item "gpg_bin = GnuPG binary" |
414 | .IX Item "gpg_bin = GnuPG binary" |
415 | This is used to specify the GnuPG binary to run. |
415 | This is used to specify the GnuPG binary to run. |
416 | .Sp |
416 | .Sp |
417 | Default value: '/usr/bin/gpg' |
417 | Default value: '/usr/bin/gpg' |
418 | .IP "\fBgpg_home\fR = \fIGnuPG homedir\fR" 4 |
418 | .IP "\fBgpg_home\fR = \fIGnuPG homedir\fR" 4 |
419 | .IX Item "gpg_home = GnuPG homedir" |
419 | .IX Item "gpg_home = GnuPG homedir" |
420 | This is used to specify the GnuPG homedir (via the \-\-homedir option). |
420 | This is used to specify the GnuPG homedir (via the \-\-homedir option). |
421 | .Sp |
421 | .Sp |
422 | Default value: '/home/user/.gnupg' |
422 | Default value: '/home/user/.gnupg' |
423 | .IP "\fBgpg_keyrings\fR = \fIarray of keyring filenames\fR" 4 |
423 | .IP "\fBgpg_keyrings\fR = \fIarray of keyring filenames\fR" 4 |
424 | .IX Item "gpg_keyrings = array of keyring filenames" |
424 | .IX Item "gpg_keyrings = array of keyring filenames" |
425 | An arrayref pointing to an array which lists all of the \s-1GPG\s0 keyrings that |
425 | An arrayref pointing to an array which lists all of the \s-1GPG\s0 keyrings that |
426 | hold keys for approved uploaders. Note that this will have no effect unless |
426 | hold keys for approved uploaders. Note that this will have no effect unless |
427 | at least one of 'require_sigs_debs' or 'require_sigs_meta' is enabled. |
427 | at least one of 'require_sigs_debs' or 'require_sigs_meta' is enabled. |
428 | .Sp |
428 | .Sp |
429 | Default value: [ 'uploaders.gpg' ] |
429 | Default value: [ 'uploaders.gpg' ] |
430 | .Sp |
430 | .Sp |
431 | See also: require_sigs_debs, require_sigs_meta |
431 | See also: require_sigs_debs, require_sigs_meta |
432 | .IP "\fBgpg_sign_key\fR = \fIsignature keyID\fR" 4 |
432 | .IP "\fBgpg_sign_key\fR = \fIsignature keyID\fR" 4 |
433 | .IX Item "gpg_sign_key = signature keyID" |
433 | .IX Item "gpg_sign_key = signature keyID" |
434 | A string which contains the \s-1ID\s0 of the key which we will sign Release files |
434 | A string which contains the \s-1ID\s0 of the key which we will sign Release files |
435 | with. Note that this will have no effect unless 'sign_release' is true. |
435 | with. Note that this will have no effect unless 'sign_release' is true. |
436 | .Sp |
436 | .Sp |
437 | Default value: undef |
437 | Default value: undef |
438 | .Sp |
438 | .Sp |
439 | See also: sign_release |
439 | See also: sign_release |
440 | .IP "\fBgpg_passfile\fR = \fIpassphrase file\fR" 4 |
440 | .IP "\fBgpg_passfile\fR = \fIpassphrase file\fR" 4 |
441 | .IX Item "gpg_passfile = passphrase file" |
441 | .IX Item "gpg_passfile = passphrase file" |
442 | This specifies the name of the file from which we read the GnuPG passphrase |
442 | This specifies the name of the file from which we read the GnuPG passphrase |
443 | for the key listed in gpg_sign_key. Note that it will have no effect unless |
443 | for the key listed in gpg_sign_key. Note that it will have no effect unless |
444 | \&'sign_release' is true and 'gpg_sign_key' is defined. |
444 | \&'sign_release' is true and 'gpg_sign_key' is defined. |
445 | .Sp |
445 | .Sp |
446 | Default value: '/home/user/.gnupg/passphrase'; |
446 | Default value: '/home/user/.gnupg/passphrase'; |
447 | .Sp |
447 | .Sp |
448 | See also: sign_release, gpg_sign_key |
448 | See also: sign_release, gpg_sign_key |
449 | .Sh "Logging configuration" |
449 | .Sh "Logging configuration" |
450 | .IX Subsection "Logging configuration" |
450 | .IX Subsection "Logging configuration" |
451 | These are values which control the logging system. |
451 | These are values which control the logging system. |
452 | .IP "\fBlog_file\fR = \fIfilename\fR" 4 |
452 | .IP "\fBlog_file\fR = \fIfilename\fR" 4 |
453 | .IX Item "log_file = filename" |
453 | .IX Item "log_file = filename" |
454 | If this option is defined, logging output will be sent to the filename |
454 | If this option is defined, logging output will be sent to the filename |
455 | specified. Note that an undefined value is considered an explicit request |
455 | specified. Note that an undefined value is considered an explicit request |
456 | to log nothing. |
456 | to log nothing. |
457 | .Sh "Misc. configuration" |
457 | .Sh "Misc. configuration" |
458 | .IX Subsection "Misc. configuration" |
458 | .IX Subsection "Misc. configuration" |
459 | These are values which don't particularly fit into any of the other |
459 | These are values which don't particularly fit into any of the other |
460 | sections. |
460 | sections. |
461 | .RS 4 |
461 | .RS 4 |
462 | .IP "\fBdaemon\fR = \fIboolean\fR" 4 |
462 | .IP "\fBdaemon\fR = \fIboolean\fR" 4 |
463 | .IX Item "daemon = boolean" |
463 | .IX Item "daemon = boolean" |
464 | This determines whether debpool runs as a daemon (never exiting except on |
464 | This determines whether debpool runs as a daemon (never exiting except on |
465 | fatal errors, rescanning the Incoming directory periodically), or on a |
465 | fatal errors, rescanning the Incoming directory periodically), or on a |
466 | single-run basis. True values cause debpool to run as a daemon. |
466 | single-run basis. True values cause debpool to run as a daemon. |
467 | .Sp |
467 | .Sp |
468 | Default value: 0 (false) |
468 | Default value: 0 (false) |
469 | .IP "\fBsleep\fR = \fIdelay\fR" 4 |
469 | .IP "\fBsleep\fR = \fIdelay\fR" 4 |
470 | .IX Item "sleep = delay" |
470 | .IX Item "sleep = delay" |
471 | This option determines how long the daemon sleeps for, between each |
471 | This option determines how long the daemon sleeps for, between each |
472 | processing run. Note that signals (such as \s-1SIGHUP\s0, \s-1SIGINT\s0, or \s-1SIGTERM\s0) |
472 | processing run. Note that signals (such as \s-1SIGHUP\s0, \s-1SIGINT\s0, or \s-1SIGTERM\s0) |
473 | will force the daemon to wake up before this expires, so don't worry about |
473 | will force the daemon to wake up before this expires, so don't worry about |
474 | setting it too long. |
474 | setting it too long. |
475 | .Sp |
475 | .Sp |
476 | Default value: 300 (5 minutes) |
476 | Default value: 300 (5 minutes) |
477 | .IP "\fBrollback\fR = \fIboolean\fR" 4 |
477 | .IP "\fBrollback\fR = \fIboolean\fR" 4 |
478 | .IX Item "rollback = boolean" |
478 | .IX Item "rollback = boolean" |
479 | This determines whether older packages in the incoming queue are allowed |
479 | This determines whether older packages in the incoming queue are allowed |
480 | to replace newer versions already in the archive (roll back the archive |
480 | to replace newer versions already in the archive (roll back the archive |
481 | version). |
481 | version). |
482 | .Sp |
482 | .Sp |
483 | Default value: 0 (false) |
483 | Default value: 0 (false) |
484 | .IP "\fBrebuild-files\fR = \fIboolean\fR" 4 |
484 | .IP "\fBrebuild-files\fR = \fIboolean\fR" 4 |
485 | .IX Item "rebuild-files = boolean" |
485 | .IX Item "rebuild-files = boolean" |
486 | This option can be set in configfiles, but is more commonly used from the |
486 | This option can be set in configfiles, but is more commonly used from the |
487 | commandline; if set, it forces all of the distribution files (Packages and |
487 | commandline; if set, it forces all of the distribution files (Packages and |
488 | Sources) to be rebuilt, whether or not they need it. This should almost |
488 | Sources) to be rebuilt, whether or not they need it. This should almost |
489 | never be used in conjunction with the daemon option. |
489 | never be used in conjunction with the daemon option. |
490 | .Sp |
490 | .Sp |
491 | Default value: 0 (false) |
491 | Default value: 0 (false) |
492 | .IP "\fBrebuild-dbs\fR = \fIboolean\fR" 4 |
492 | .IP "\fBrebuild-dbs\fR = \fIboolean\fR" 4 |
493 | .IX Item "rebuild-dbs = boolean" |
493 | .IX Item "rebuild-dbs = boolean" |
494 | This option should not be set in configfiles, only used from the |
494 | This option should not be set in configfiles, only used from the |
495 | commandline; if set, it forces all of the metadata files to be rebuilt from |
495 | commandline; if set, it forces all of the metadata files to be rebuilt from |
496 | scratch. It should, of course, also not be used with the daemon option. |
496 | scratch. It should, of course, also not be used with the daemon option. |
497 | .Sp |
497 | .Sp |
498 | \&\s-1WARNING:\s0 This feature is not yet implemented, and will (silently) fail to |
498 | \&\s-1WARNING:\s0 This feature is not yet implemented, and will (silently) fail to |
499 | do anything, at this time. It will be implemented in a future version. |
499 | do anything, at this time. It will be implemented in a future version. |
500 | .Sp |
500 | .Sp |
501 | Default value: 0 (false) |
501 | Default value: 0 (false) |
502 | .IP "\fBrebuild-all\fR = \fIboolean\fR" 4 |
502 | .IP "\fBrebuild-all\fR = \fIboolean\fR" 4 |
503 | .IX Item "rebuild-all = boolean" |
503 | .IX Item "rebuild-all = boolean" |
504 | This option should not be set in configfiles, only used from the |
504 | This option should not be set in configfiles, only used from the |
505 | commandline; if set, it is equivalent to turning on all other rebuild |
505 | commandline; if set, it is equivalent to turning on all other rebuild |
506 | options (currently \-\-rebuild\-files and \-\-rebuild\-dbs). |
506 | options (currently \-\-rebuild\-files and \-\-rebuild\-dbs). |
507 | .Sp |
507 | .Sp |
508 | \&\s-1WARNING:\s0 This feature depends on rebuild\-dbs, which is not yet implemented; |
508 | \&\s-1WARNING:\s0 This feature depends on rebuild\-dbs, which is not yet implemented; |
509 | only the \-\-rebuild\-files section will be triggered. |
509 | only the \-\-rebuild\-files section will be triggered. |
510 | .Sp |
510 | .Sp |
511 | Default value: 0 (false) |
511 | Default value: 0 (false) |
512 | .IP "\fBconfig\fR = \fIconfigfile\fR" 4 |
512 | .IP "\fBconfig\fR = \fIconfigfile\fR" 4 |
513 | .IX Item "config = configfile" |
513 | .IX Item "config = configfile" |
514 | This is a special option that should not be put into configfiles; it is |
514 | This is a special option that should not be put into configfiles; it is |
515 | intended only for command-line use. It may be issued multiple times; each |
515 | intended only for command-line use. It may be issued multiple times; each |
516 | time it is used, it will add the named config file to the list which |
516 | time it is used, it will add the named config file to the list which |
517 | DebPool will load (later config files override earlier ones, in case of any |
517 | DebPool will load (later config files override earlier ones, in case of any |
518 | conflicts). |
518 | conflicts). |
519 | .Sp |
519 | .Sp |
520 | Default value: N/A |
520 | Default value: N/A |
521 | .RE |
521 | .RE |
522 | .RS 4 |
522 | .RS 4 |
523 | .SH "CAVEATS" |
523 | .SH "CAVEATS" |
524 | .IX Header "CAVEATS" |
524 | .IX Header "CAVEATS" |
525 | Command line options will override all Config.pm declarations. |
525 | Command line options will override all Config.pm declarations. |
526 | .SH "SEE ALSO" |
526 | .SH "SEE ALSO" |
527 | .IX Header "SEE ALSO" |
527 | .IX Header "SEE ALSO" |
528 | \&\fIdebpool\fR\|(1) |
528 | \&\fIdebpool\fR\|(1) |
529 | .SH "AUTHOR" |
529 | .SH "AUTHOR" |
530 | .IX Header "AUTHOR" |
530 | .IX Header "AUTHOR" |
531 | Joel Baker <fenton@debian.org> |
531 | Joel Baker <fenton@debian.org> |