.\"	$Id: tits.8,v 1.5 2003/04/13 09:14:36 steve Exp $
.\"
.\" Copyright (c) 2001 Steve C. Woodford.
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"        This product includes software developed by Steve C. Woodford.
.\" 4. The name of the author may not be used to endorse or promote products
.\"    derived from this software without specific prior written permission.
.\" 
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 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 Feb 4, 2001
.Os
.Dt TITS 8
.Sh NAME
.Nm tits
.Tn Tiny
Terminal Server
.Sh SYNOPSIS
.Nm /usr/local/sbin/tits
.Op config-file
.Sh DESCRIPTION
The
.Nm
command is a server process which provides
.Xr telnet 1
or raw access to one or more tty ports as specified in
.Ar config-file
(or
.Pa /usr/local/etc/tits.conf
if no configuration file is specified on the command line).
.Pp
Any number of
.Xr telnet 1
or raw clients may connect to a single
.Nm
port. Each client will see exactly the same output
as well as being able to send keystrokes
simultaneously.
.Pp
.Nm
implements access control using the
.Xr hosts_access 5
framework to filter incoming network connections.
The service name used to look up each port in the
.Xr hosts_access 5
database is dependent on how the port is specified
in the
.Ar config-file .
If a numerical port is specified, the service name is
the final component of the pathname used to invoke
the program. Thus, this will be
.Nm
in normal operation.
If the port is specified using a service which needs
to be looked up in
.Pa /etc/services ,
this service name is used when checking the
.Xr host_access 5
database.
.Pp
.Nm
multiplexes the data streams between all configured tty ports and
connected clients within a single process. Thus, it
minimises system context switching overhead when
there is a high I/O load.
.Sh FILES
.Pa /usr/local/etc/tits.conf
.Sh SEE ALSO
.Xr telnet 1 ,
.Xr host_access 5 ,
.Xr services 5 ,
.Xr inetd 8 ,
.Xr telnetd 8
.Sh AUTHOR
.Nm
is Copyright 2001, Steve Woodford <scw@netbsd.org>, and is published
under the terms of the BSD-style license specified in the file
.Pa LICENSE ,
supplied with the
.Nm
source distribution.
.Sh BUGS
Only a tiny subset of the
.Xr telnet
protocol specified in the above RFCs is implemented.
.Pp
At this time, there is no `Control Port' providing supervisory
functions for managing a
.Nm
process at runtime.
.Pp
This manual page could be better.