.Dd July 15, 2025
.Dt valid-utf8 1
.Os
.Sh NAME
.Nm valid-utf8
.Nd check whether text is utf-8 encoded or not
.Sh SYNOPSIS
.Nm
.Fl h
.Nm
.Fl \-version
.Nm
.Op Ar
.Sh DESCRIPTION
The
.Nm
utility reads the files given as arguments, and sets its exit status to 0 when
the text has been detected to be valid UTF-8, or to 1 otherwise.
When no file arguments are given,
.Nm
will read from the standard input.
.Pp
.Nm
will not write anything to the standard output, and will only write error
messages, if any, to the standard error output.
.Pp
This behaviour makes
.Nm
useful as a
.Ar -exec
criterion for the
.Xr find 1
tool.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl h, \-help
Print help text and exit.
.It Fl \-version
Print version info and exit.
.El
.\" .Sh ENVIRONMENT
.\" For sections 1, 6, 7, and 8 only.
.\" .Sh FILES
.Sh EXIT STATUS
.\" For sections 1, 6, and 8 only.
.Nm
exits 0 when the text is encoded in valid UTF-8, and 1 otherwise, or if an error
occurs.
.\" .Sh EXAMPLES
.\" .Sh DIAGNOSTICS
.\" For sections 1, 4, 6, 7, 8, and 9 printf/stderr messages only.
.Sh SEE ALSO
.Xr find 1 .
.\" .Xr foobar 1
.\" .Sh STANDARDS
.\" .Sh HISTORY
.Sh AUTHORS
.An Bob Polis
.\" .Sh CAVEATS
.\" .Sh BUGS
.\" .Sh SECURITY CONSIDERATIONS