daytimed.8

.\"
.\" Copyright (c) 2020,2022 Scott Bennett <scottb@fastmail.com>
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd July 19, 2022
.Dt DAYTIMED 8
.Os
.Sh NAME
.Nm daytimed
.Nd simple Daytime Protocol daemon
.Sh SYNOPSIS
.Nm daytimed
.Op Fl d
.Sh DESCRIPTION
.Nm
is a privilege-dropping server that implements the Daytime Protocol as specified
in RFC 867.
It responds to TCP connections on port
.Em 13 ,
returns a human-readable date string to the client,
then closes the connection.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl d
Do not daemonize.
.Nm
will run in the foreground and output debug messages to stdout.
.El
.Pp
In debug mode
.Pq Fl d ,
root privileges are not required for startup and the server will listen on
.Em localhost
port
.Em 13013 .
.Sh AUTHORS
.An Scott Bennett
.Sh CAVEATS
.Nm
only builds and works on
.Ox 6.6
or newer, because it relies on
.Xr pledge 2
and the built-in make infrastructure.
Portability could be achieved with minimal effort, but that is outside the scope of my
current goals.
.Pp
.Nm
only listens on IPv4 addresses.