.\" Manual page for ncpd
.\"
.\" 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 all the time if you can dedicate a serial device
to it.

.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 default 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), sisinstall(1)

.SH AUTHOR
Fritz Elfert
.br
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)
.br
Patches from Matt Gumbley (matt@gumbley.demon.co.uk)
.br
Man page by John Lines (john+plpman@paladin.demon.co.uk)