mirror of
https://github.com/hectorm/hblock.git
synced 2026-04-23 15:36:34 +05:30
137 lines
3.5 KiB
Groff
137 lines
3.5 KiB
Groff
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.16.
|
|
.TH HBLOCK "1" "October 2020" "hBlock 2.1.7" "User Commands"
|
|
.SH NAME
|
|
hBlock \- manual page for hBlock 2.1.7
|
|
.SH SYNOPSIS
|
|
.B hblock
|
|
[\fI\,OPTION\/\fR]...
|
|
.SH DESCRIPTION
|
|
hBlock is a POSIX\-compliant shell script that gets a list of domains that serve
|
|
ads, tracking scripts and malware from multiple sources and creates a hosts
|
|
file, among other formats, that prevents your system from connecting to them.
|
|
.SH OPTIONS
|
|
.HP
|
|
\fB\-O\fR, \fB\-\-output\fR <FILE>, ${HBLOCK_OUTPUT_FILE}
|
|
.IP
|
|
Output file location.
|
|
.IP
|
|
(default: \fI\,/etc/hosts\/\fP)
|
|
.HP
|
|
\fB\-H\fR, \fB\-\-header\fR <FILE>, ${HBLOCK_HEADER_FILE}
|
|
.IP
|
|
File to be included at the beginning of the output file.
|
|
.IP
|
|
If the default file does not exist or equals "builtin" the built\-in
|
|
value is used instead.
|
|
.IP
|
|
(default: \fI\,/etc/hblock/header\/\fP)
|
|
.HP
|
|
\fB\-F\fR, \fB\-\-footer\fR <FILE>, ${HBLOCK_FOOTER_FILE}
|
|
.IP
|
|
File to be included at the end of the output file.
|
|
.IP
|
|
If the default file does not exist or equals "builtin" the built\-in
|
|
value is used instead.
|
|
.IP
|
|
(default: \fI\,/etc/hblock/footer\/\fP)
|
|
.HP
|
|
\fB\-S\fR, \fB\-\-sources\fR <FILE>, ${HBLOCK_SOURCES_FILE}
|
|
.IP
|
|
File with line separated URLs used to generate the blocklist.
|
|
.IP
|
|
If the default file does not exist or equals "builtin" the built\-in
|
|
value is used instead.
|
|
.IP
|
|
(default: \fI\,/etc/hblock/sources.list\/\fP)
|
|
.HP
|
|
\fB\-A\fR, \fB\-\-allowlist\fR <FILE>, ${HBLOCK_ALLOWLIST_FILE}
|
|
.IP
|
|
File with line separated entries to be removed from the blocklist.
|
|
.IP
|
|
If the default file does not exist or equals "builtin" the built\-in
|
|
value is used instead.
|
|
.IP
|
|
(default: \fI\,/etc/hblock/allow.list\/\fP)
|
|
.HP
|
|
\fB\-D\fR, \fB\-\-denylist\fR <FILE>, ${HBLOCK_DENYLIST_FILE}
|
|
.IP
|
|
File with line separated entries to be added to the blocklist.
|
|
.IP
|
|
If the default file does not exist or equals "builtin" the built\-in
|
|
value is used instead.
|
|
.IP
|
|
(default: \fI\,/etc/hblock/deny.list\/\fP)
|
|
.HP
|
|
\fB\-R\fR, \fB\-\-redirection\fR <REDIRECTION>, ${HBLOCK_REDIRECTION}
|
|
.IP
|
|
Redirection for all entries in the blocklist.
|
|
.IP
|
|
(default: 0.0.0.0)
|
|
.HP
|
|
\fB\-W\fR, \fB\-\-wrap\fR <NUMBER>, ${HBLOCK_WRAP}
|
|
.IP
|
|
Break blocklist lines after this number of entries.
|
|
.IP
|
|
(default: 1)
|
|
.HP
|
|
\fB\-T\fR, \fB\-\-template\fR <TEMPLATE>, ${HBLOCK_TEMPLATE}
|
|
.IP
|
|
Template applied to each entry.
|
|
.IP
|
|
%D = <DOMAIN>, %R = <REDIRECTION>
|
|
.IP
|
|
(default: %R %D)
|
|
.HP
|
|
\fB\-C\fR, \fB\-\-comment\fR <COMMENT>, ${HBLOCK_COMMENT}
|
|
.IP
|
|
Character used for comments.
|
|
.IP
|
|
(default: #)
|
|
.HP
|
|
\fB\-l\fR, \fB\-\-[no\-]lenient\fR, ${HBLOCK_LENIENT}
|
|
.IP
|
|
Match all entries from sources regardless of their IP, instead
|
|
of 0.0.0.0, 127.0.0.1, ::, ::1 or nothing.
|
|
.IP
|
|
(default: false)
|
|
.HP
|
|
\fB\-r\fR, \fB\-\-[no\-]regex\fR, ${HBLOCK_REGEX}
|
|
.IP
|
|
Use POSIX BREs in the allowlist instead of fixed strings.
|
|
.IP
|
|
(default: false)
|
|
.HP
|
|
\fB\-c\fR, \fB\-\-[no\-]continue\fR, ${HBLOCK_CONTINUE}
|
|
.IP
|
|
Do not abort if a download error occurs.
|
|
.IP
|
|
(default: false)
|
|
.HP
|
|
\fB\-q\fR, \fB\-\-[no\-]quiet\fR, ${HBLOCK_QUIET}
|
|
.IP
|
|
Suppress non\-error messages.
|
|
.IP
|
|
(default: false)
|
|
.HP
|
|
\fB\-x\fR, \fB\-\-color\fR <auto|true|false>, ${HBLOCK_COLOR}
|
|
.IP
|
|
Colorize the output.
|
|
.IP
|
|
(default: auto)
|
|
.HP
|
|
\fB\-v\fR, \fB\-\-version\fR
|
|
.IP
|
|
Show version number and quit.
|
|
.HP
|
|
\fB\-h\fR, \fB\-\-help\fR
|
|
.IP
|
|
Show this help and quit.
|
|
.SH "REPORTING BUGS"
|
|
Report bugs to: <https://github.com/hectorm/hblock/issues>
|
|
.PP
|
|
.br
|
|
Author: Héctor Molinero Fernández <hector@molinero.dev>
|
|
.br
|
|
License: MIT, https://opensource.org/licenses/MIT
|
|
.br
|
|
Repository: https://github.com/hectorm/hblock
|