.\" Manual page for ncpd
.\" $Id$
.\" CHECKIN $Date$
.\"
.\" Process this file with
.\" groff -man -Tascii ncpd.8 for ASCII output, or
.\" groff -man -Tps ncpd.8 for Postscript output
.\"
.TH ncpd 8 "@MANDATE@" "plptools @VERSION@" "System administration commands"
.SH NAME
ncpd \- Daemon which handles the serial link to a Psion
.SH SYNOPSIS
.B ncpd
.B [-V]
.B [-h]
.BI "[-v " log-class ]
.B [-d]
.B [-e]
.BI "[-p [" host ":]" port ]
.BI "[-s " device ]
.BI "[-b " baud-rate ]
.BI [ long-options ]

.SH DESCRIPTION
ncpd is the daemon which handles the serial link to your Psion.
It listens at port @DPORT@ for local connections and provides
basic PLP/NCP services for plpfuse and plpftp and other front-ends.
It auto-connects to the psion, even after unplugging/switching off
therefore it can run always in background (if you have a spare
serial-device)

.SH OPTIONS
.TP
.B \-V, --version
Display the version and exit
.TP
.B \-h, --help
Display a short help text and exit.
.TP
.B \-e, --autoexit
Exit automatically if the device is disconnected. Furthermore, use the
current tty as I/O device. This option is intended for starting ncpd on
demand using mgetty's auto-detect function. (A patch for mgetty is needed
for that).
.TP
.BI "\-v, --verbose=" log-class
Increase the logging level of the program. the possible values for log-class
are:
.RS
.TP
.I nl
Set NCP debug level to LOG
.TP
.I nd
Set NCP debug level to DEBUG
.TP
.I ll
Set Link debug level to LOG
.TP
.I ld
Set Link debug level to DEBUG
.TP
.I pl
Set Packet debug level to LOG
.TP
.I pd
Set Packet debug level to DEBUG
.TP
.I ph
Set Packet debug level to HANDSHAKE
.TP
.I m
Set overall debug level to verbose
.TP
.I all
Turn on all the above logging on.
.RE
.TP
.B "\-d, --dontfork"
Do not background the daemon.
.TP
.BI "\-p, --port=[" host: ] port
Specify the port to listen on - by default the value for the host is
127.0.0.1 and the value for the port is looked up in /etc/services using
the key
.B psion/tcp.
If it is not found there, a builtin value of @DPORT@
is used.
.TP
.BI "\-s, --serial=" device
Specify the serial device to use to connect to the Psion - this defaults to
@DDEV@
.TP
.BI "\-b, --baudrate=" baud-rate
Specify the baud rate to use for the serial connection. If the word
.B auto
is specified, ncpd cycles through baud-rates of 115200, 57600, 38400, 19200
and 9600 baud. Default setting is @DSNAME@.

.SH SEE ALSO
plpfuse(8), plpprintd(8), plpftp(1) and sisinstall(1)

.SH AUTHOR
Fritz Elfert
Heavily based on p3nfsd by Rudolf Koenig (rfkoenig@immd4.informatik.uni-erlangen.de)
and
plp_1_7 by Philip Proudman (phil@proudman51.freeserve.co.uk)
Patches from Matt Gumbley (matt@gumbley.demon.co.uk)
Man page by John Lines (john+plpman@paladin.demon.co.uk)