Add man page
Signed-off-by: William Brawner <me@wbrawner.com>
This commit is contained in:
parent
bfc2c462f0
commit
4233362bf0
3 changed files with 89 additions and 0 deletions
|
@ -25,3 +25,5 @@ project(
|
||||||
|
|
||||||
add_subdirectory(src)
|
add_subdirectory(src)
|
||||||
|
|
||||||
|
add_subdirectory(doc)
|
||||||
|
|
||||||
|
|
3
doc/CMakeLists.txt
Normal file
3
doc/CMakeLists.txt
Normal file
|
@ -0,0 +1,3 @@
|
||||||
|
if(PIHELPER_EXECUTABLE)
|
||||||
|
install(FILES pihelper.1 DESTINATION "${CMAKE_INSTALL_PREFIX}/${CMAKE_INSTALL_DATAROOTDIR}/man/man1")
|
||||||
|
endif()
|
84
doc/pihelper.1
Normal file
84
doc/pihelper.1
Normal file
|
@ -0,0 +1,84 @@
|
||||||
|
.TH PIHELPER 1 2020-01-10 "PiHelper 0.1.0"
|
||||||
|
.SH NAME
|
||||||
|
pihelper \- enable, disable, or view the status of a Pi-hole
|
||||||
|
.SH SYNOPSIS
|
||||||
|
.B pihelper [
|
||||||
|
.I options
|
||||||
|
]
|
||||||
|
.SH DESCRIPTION
|
||||||
|
Pihelper is a command-line utility used to enable, disable, or view the status of a given Pi-hole. It supports using alternative configuration files in order to manage multiple Pi-holes.
|
||||||
|
.SH OPTIONS
|
||||||
|
.IP "-c, --configure"
|
||||||
|
.RS
|
||||||
|
Create (or replace) the pihelper configuration.
|
||||||
|
.RE
|
||||||
|
.IP "-d, --disable <seconds>"
|
||||||
|
.RS
|
||||||
|
Disable the Pi-hole for a given number of seconds.
|
||||||
|
.br
|
||||||
|
.br
|
||||||
|
If no argument is passed, disable the Pi-hole permanently.
|
||||||
|
.RE
|
||||||
|
.IP "-e, --enable"
|
||||||
|
.RS
|
||||||
|
Enable the Pi-hole.
|
||||||
|
.RE
|
||||||
|
.IP "-f, --file <file>"
|
||||||
|
.RS
|
||||||
|
Use the given configuration file.
|
||||||
|
.RE
|
||||||
|
.IP "-h, --help"
|
||||||
|
.RS
|
||||||
|
Display the help message.
|
||||||
|
.RE
|
||||||
|
.IP "-q, --quiet"
|
||||||
|
.RS
|
||||||
|
Suppress all output.
|
||||||
|
.RE
|
||||||
|
.IP "-v, --verbose"
|
||||||
|
.RS
|
||||||
|
Print additional output.
|
||||||
|
.RE
|
||||||
|
.SH EXIT STATUS
|
||||||
|
The exit status for
|
||||||
|
.B pihelper
|
||||||
|
is dependent upon the status of the Pi-hole.
|
||||||
|
.IP \-1
|
||||||
|
.B pihelper
|
||||||
|
was unable to connect to the Pi-hole.
|
||||||
|
.IP 0
|
||||||
|
The Pi-hole is enabled
|
||||||
|
.IP 1
|
||||||
|
The Pi-hole is disabled.
|
||||||
|
.SH FILES
|
||||||
|
.IP ~/.config/pihelper.conf
|
||||||
|
The default configuration file.
|
||||||
|
.SH EXAMPLES
|
||||||
|
Print the status of the Pi-hole:
|
||||||
|
.PP
|
||||||
|
.RS
|
||||||
|
pihelper
|
||||||
|
.RE
|
||||||
|
.PP
|
||||||
|
Enable the Pi-hole:
|
||||||
|
.PP
|
||||||
|
.RS
|
||||||
|
pihelper -e
|
||||||
|
.RE
|
||||||
|
.PP
|
||||||
|
Disable the Pi-hole permanently:
|
||||||
|
.PP
|
||||||
|
.RS
|
||||||
|
pihelper -d
|
||||||
|
.RE
|
||||||
|
.PP
|
||||||
|
Disable the Pi-hole for 5 minutes:
|
||||||
|
.PP
|
||||||
|
.RS
|
||||||
|
pihelper -d300
|
||||||
|
.SH AUTHOR
|
||||||
|
Originally written by William Brawner <me@wbrawner.com>
|
||||||
|
.SH COPYRIGHT
|
||||||
|
Copyright (c) 2019-2020 William Brawner
|
||||||
|
.PP
|
||||||
|
PiHelper is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
|
Loading…
Reference in a new issue