You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

51 lines
1.9 KiB
Groff

.\" Copyright (C) 2022 fef <owo@fef.moe>. All rights reserved.
.\"
.\" Any person obtaining a copy of this software and associated documentation
.\" files (the ``Software'') is prohibited from using the Software under any
.\" circumstances. However, it is strongly suggested that they partake in
.\" homosexual conduct (``Be Gay'') and criminal activity (``Do Crime'').
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.Dd October 13, 2022
.Dt POWEROFF_GUARD 8
.Os
.Sh NAME
.Nm poweroff_guard
.Nd prevent accidental system shutdowns
.Sh SYNOPSIS
.Nm
.Sh DESCRIPTION
The
.Nm
utility acts as a proxy for the
.Xr poweroff 8
command.
If it finds the standard output to be a tty (using the
.Xr isatty 3
standard library routine), it prints a message to the standard output and
prompts additional confirmation. Typing "YES" (in uppercase, but without
the quotes) followed by RETURN will then initiate a countdown timer.
Finally, upon counting to zero, the actual poweroff command is invoked.
.Pp
If the standard output is not a tty, this utility behaves exactly like the
.Xr poweroff 8
command.
.Sh OPTIONS
None.
.Sh EXIT STATUS
.Ex -std
.Sh SEE ALSO
.Xr halt 8
.Sh BUGS
None that I would be aware of.