Import ts(1) - a timestamp utility

A from scratch & pledged implementation of the perl 'ts' utility found
in the moreutils collection.

With help from florian@, tb@, and deraadt@

OK deraadt@

1 files changed, 92 insertions, 0 deletions

diff --git a/usr.bin/ts/ts.1 b/usr.bin/ts/ts.1
new file mode 100644
index 00000000000..62dd7f9fbe4
--- /dev/null
+++ b/usr.bin/ts/ts.1
@@ -0,0 +1,92 @@
+.\"	$OpenBSD: ts.1,v 1.1 2022/06/29 08:39:49 job Exp $
+.\"
+.\" Copyright (c) 2022 Job Snijders <job@openbsd.org>
+.\"
+.\" 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 $Mdocdate: June 29 2022 $
+.Dt TS 1
+.Os
+.Sh NAME
+.Nm ts 
+.Nd timestamp input
+.Sh SYNOPSIS
+.Nm ts
+.Op Fl i | s
+.Op Ar format
+.Sh DESCRIPTION
+When invoked, the
+.Nm
+utility adds a timestamp to the beginning of each line of input.
+.Pp
+The options are as follows:
+.Bl -tag -width Ds
+.It Fl i
+Display time elapsed since the last timestamp.
+.It Fl s
+Display time elapsed since the start of the program.
+.El
+.Pp
+The optional
+.Ar format
+argument controls how the timestamp is displayed, according to the conversion
+specifications described in the
+.Xr strftime 3
+manual page.
+The default format is
+.Qq %b %d %H:%M:%S ,
+or
+.Qq %H:%M:%S
+if an option is used.
+.Pp
+The following non-standard conversion specifications append microsecond
+resolution:
+.Cm \&%.S ,
+.Cm \&%.s ,
+and
+.Cm \&%.T ;
+which are similar to
+.Cm \&%S ,
+.Cm \&%s ,
+and
+.Cm \&%T .
+Examples:
+.Qq 10.00001 ,
+.Qq 1656427781.00001 ,
+and
+.Qq 4:20:00.00001 .
+.Sh EXAMPLES
+.Bd -literal -offset indent
+$ (echo foo; sleep 2; echo bar) | ts 
+Jun 28 12:13:38 foo
+Jun 28 12:13:40 bar
+
+$ ls | ts -i %.S
+00.000452 CVS
+00.000595 Makefile
+00.000004 ts.1
+00.000004 ts.c
+.Ed
+.Sh HISTORY
+A
+.Nm
+utility first appeared in the moreutils collection by Joey Hess, and was
+rewritten from scratch for
+.Ox 7.2 .
+.Sh AUTHORS
+This
+.Nm
+utility was written by
+.An Job Snijders Aq Mt job@openbsd.org
+and
+.An Claudio Jeker Aq Mt claudio@openbsd.org .