1
1
# NAME
2
2
3
- hBlock - manual page for hBlock 3.4.5
3
+ hBlock - manual page for hBlock 3.5.0
4
4
5
5
# SYNOPSIS
6
6
@@ -18,178 +18,184 @@ from connecting to them.
18
18
** -O** , ** --output** \< FILE\| -\> , \$ {HBLOCK_OUTPUT_FILE}
19
19
20
20
> Output file location.
21
- >
21
+
22
22
> If equals "-", it is printed to stdout.
23
- >
23
+
24
24
> (default: * /etc/hosts* )
25
25
26
26
** -H** , ** --header** \< FILE\| builtin\| none\| -\> , \$ {HBLOCK_HEADER_FILE}
27
27
28
28
> File to be included at the beginning of the output file.
29
- >
29
+
30
30
> If equals "builtin", the built-in value is used.
31
- >
31
+
32
32
> If equals "none", an empty value is used.
33
- >
33
+
34
34
> If equals "-", the stdin content is used.
35
- >
35
+
36
36
> If unspecified and any of the following files exists, its content is
37
37
> used.
38
- >
38
+
39
39
> \$ {XDG_CONFIG_HOME}/hblock/header
40
- >
40
+
41
41
> * /etc/hblock/header*
42
- >
42
+
43
43
> (default: builtin)
44
44
45
45
** -F** , ** --footer** \< FILE\| builtin\| none\| -\> , \$ {HBLOCK_FOOTER_FILE}
46
46
47
47
> File to be included at the end of the output file.
48
- >
48
+
49
49
> If equals "builtin", the built-in value is used.
50
- >
50
+
51
51
> If equals "none", an empty value is used.
52
- >
52
+
53
53
> If equals "-", the stdin content is used.
54
- >
54
+
55
55
> If unspecified and any of the following files exists, its content is
56
56
> used.
57
- >
57
+
58
58
> \$ {XDG_CONFIG_HOME}/hblock/footer
59
- >
59
+
60
60
> * /etc/hblock/footer*
61
- >
61
+
62
62
> (default: builtin)
63
63
64
64
** -S** , ** --sources** \< FILE\| builtin\| none\| -\> ,
65
65
\$ {HBLOCK_SOURCES_FILE}
66
66
67
67
> File with line separated URLs used to generate the blocklist.
68
- >
68
+
69
69
> If equals "builtin", the built-in value is used.
70
- >
70
+
71
71
> If equals "none", an empty value is used.
72
- >
72
+
73
73
> If equals "-", the stdin content is used.
74
- >
74
+
75
75
> If unspecified and any of the following files exists, its content is
76
76
> used.
77
- >
77
+
78
78
> \$ {XDG_CONFIG_HOME}/hblock/sources.list
79
- >
79
+
80
80
> * /etc/hblock/sources.list*
81
- >
81
+
82
82
> (default: builtin)
83
83
84
84
** -A** , ** --allowlist** \< FILE\| builtin\| none\| -\> ,
85
85
\$ {HBLOCK_ALLOWLIST_FILE}
86
86
87
87
> File with line separated entries to be removed from the blocklist.
88
- >
88
+
89
89
> If equals "builtin", the built-in value is used.
90
- >
90
+
91
91
> If equals "none", an empty value is used.
92
- >
92
+
93
93
> If equals "-", the stdin content is used.
94
- >
94
+
95
95
> If unspecified and any of the following files exists, its content is
96
96
> used.
97
- >
97
+
98
98
> \$ {XDG_CONFIG_HOME}/hblock/allow.list
99
- >
99
+
100
100
> * /etc/hblock/allow.list*
101
- >
101
+
102
102
> (default: builtin)
103
103
104
104
** -D** , ** --denylist** \< FILE\| builtin\| none\| -\> ,
105
105
\$ {HBLOCK_DENYLIST_FILE}
106
106
107
107
> File with line separated entries to be added to the blocklist.
108
- >
108
+
109
109
> If equals "builtin", the built-in value is used.
110
- >
110
+
111
111
> If equals "none", an empty value is used.
112
- >
112
+
113
113
> If equals "-", the stdin content is used.
114
- >
114
+
115
115
> If unspecified and any of the following files exists, its content is
116
116
> used.
117
- >
117
+
118
118
> \$ {XDG_CONFIG_HOME}/hblock/deny.list
119
- >
119
+
120
120
> * /etc/hblock/deny.list*
121
- >
121
+
122
122
> (default: builtin)
123
123
124
124
** -R** , ** --redirection** \< REDIRECTION\> , \$ {HBLOCK_REDIRECTION}
125
125
126
126
> Redirection for all entries in the blocklist.
127
- >
127
+
128
128
> (default: 0.0.0.0)
129
129
130
130
** -W** , ** --wrap** \< NUMBER\> , \$ {HBLOCK_WRAP}
131
131
132
132
> Break blocklist lines after this number of entries.
133
- >
133
+
134
134
> (default: 1)
135
135
136
136
** -T** , ** --template** \< TEMPLATE\> , \$ {HBLOCK_TEMPLATE}
137
137
138
138
> Template applied to each entry.
139
- >
139
+
140
140
> %D = \< DOMAIN\> , %R = \< REDIRECTION\>
141
- >
141
+
142
142
> (default: %R %D)
143
143
144
144
** -C** , ** --comment** \< COMMENT\> , \$ {HBLOCK_COMMENT}
145
145
146
146
> Character used for comments.
147
- >
147
+
148
148
> (default: \# )
149
149
150
150
** -l** , ** --\[ no-\] lenient** , \$ {HBLOCK_LENIENT}
151
151
152
152
> Match all entries from sources regardless of their IP, instead of
153
153
> 0.0.0.0, 127.0.0.1, ::, ::1 or nothing.
154
- >
154
+
155
155
> (default: false)
156
156
157
157
** -r** , ** --\[ no-\] regex** , \$ {HBLOCK_REGEX}
158
158
159
159
> Use POSIX BREs in the allowlist instead of fixed strings.
160
- >
160
+
161
161
> (default: false)
162
162
163
163
** -f** , ** --\[ no-\] filter-subdomains** , \$ {HBLOCK_FILTER_SUBDOMAINS}
164
164
165
165
> Do not include subdomains when the parent domain is also blocked.
166
166
> Useful for reducing the blocklist size in cases such as when DNS
167
167
> blocking makes these subdomains redundant.
168
- >
168
+
169
169
> (default: false)
170
170
171
+ ** -n** , ** --retry** \< NUMBER\> , \$ {HBLOCK_RETRY}
172
+
173
+ > Number of times to retry a failed download.
174
+
175
+ > (default: 0)
176
+
171
177
** -c** , ** --\[ no-\] continue** , \$ {HBLOCK_CONTINUE}
172
178
173
179
> Do not abort if a download error occurs.
174
- >
180
+
175
181
> (default: false)
176
182
177
183
** -p** , ** --parallel** , \$ {HBLOCK_PARALLEL}
178
184
179
185
> Maximum concurrency for parallel downloads.
180
- >
186
+
181
187
> (default: 4)
182
188
183
189
** -q** , ** --\[ no-\] quiet** , \$ {HBLOCK_QUIET}
184
190
185
191
> Suppress non-error messages.
186
- >
192
+
187
193
> (default: false)
188
194
189
195
** -x** , ** --color** \< auto\| true\| false\> , \$ {HBLOCK_COLOR}
190
196
191
197
> Colorize the output.
192
- >
198
+
193
199
> (default: auto)
194
200
195
201
** -v** , ** --version**
0 commit comments