.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH STARTSRV 8 "May 23, 2006"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
startsrv \- invoke ttysrv for a particular host.
.SH SYNOPSIS
.B startsrv
.RI host
.SH DESCRIPTION
.PP
\fBstartsrv\fP fires up \fBttysrv\fP for a given host. It will kill any
already running instance for that host, then read
\fB/etc/remote-tty/opt/<host>.srv\fP for any options to pass to ttysrv
(defaulting to those that set 9600,8n1),
\fB/etc/remote-tty/prot/<host>.sock\fP for the permissions the socket should
be set to (default 660),
\fB/etc/remote-tty/owner/<host>.sock\fP for the owner of the socket
(default rttymgr:dialout) and \fB/etc/remote-tty/prot/<host>.log\fP for the
permissions of the logfile (default 640).
.PP
The device node used is \fB/etc/remote-tty/dev/<host>\fP. This will normally
be a symlink to the correct file in \fB/dev\fP.
.PP
\fBttysrv\fP is configured to log to \fB/var/log/remote-tty/<host>/<host>\fP,
with a pidfile at \fB/var/run/remote-tty/pid/<host>\fP and the socket at
\fB/var/run/remote-tty/sock/<host>\fP.
.SH SEE ALSO
.BR remote-tty (1),
.BR ttysrv (8).
.SH AUTHOR
rtty was written by Paul Vixie <vixie@isc.org>. This manual page was written
by Jonathan McDowell <noodles@earth.li> for the Debian project (but may be
used by others).