mbusd/doc/mbusd.8.in
kapyar 0bb1a8910e * Updated build infrastructure (x86_64 build fixed);
* Fixed serial interface initialization under Linux;
* Default RTU client response wait timeout increased to 50 ms;
+ Added Eclipse CDT project files.
2013-11-18 08:57:00 +00:00

80 lines
2.5 KiB
Groff

.TH "mbusd" 8 "18 November 2013" "mbusd @VERSION@"
.SH NAME
mbusd \- MODBUS/TCP to MODBUS/RTU gateway server
.SH SYNOPSIS
.B mbusd
.RB [ -h ]
.RB [ -d ]
.RB [ -v
.IR level ]
.RB [ -L
.IR name ]
.RB [ -p
.IR name ]
.RB [ -s
.IR value ]
.RB [ -P
.IR number ]
.RB [ -C
.IR number ]
.RB [ -N
.IR number ]
.RB [ -R
.IR value ]
.RB [ -W
.IR value ]
.RB [ -T
.IR value ]
.SH DESCRIPTION
\fImbusd\fR is MODBUS/TCP to MODBUS/RTU gateway server (currently master mode only is supported).
.SH OPTIONS
.IP \fB-h\fR
Usage help.
.IP \fB-d\fR
Instruct \fImbusd\fR not to fork itself (non-daemonize).
.IP "\fB-v \fIlevel\fR"
Specifies log verbosity level. 0 enables logging of errors only,
1 also enables warnings and 2 enables information messages.
If \fImbusd\fR was compiled in debug mode, valid log levels is up to 9,
where log levels above 2 forces logging of information about additional
internal events.
.IP "\fB-L \fIname\fR"
Specifies log file name. Value '-' forces log data output to STDOUT only if \fB-d\fR switch was given.
.IP "\fB-p \fIname\fR"
Specifies serial port device name.
.IP "\fB-s \fIvalue\fR"
Specifies serial port speed.
.IP "\fB-P \fInumber\fR"
Specifies TCP port number.
.IP "\fB-C \fInumber\fR"
Specifies maximum number of simultaneous connections.
.IP "\fB-N \fInumber\fR"
Specifies maximum number of request retries. 0 - no retries.
.IP "\fB-R \fIvalue\fR"
Specifies pause between requests in milliseconds.
.IP "\fB-W \fIvalue\fR"
Specifies response wait time in milliseconds.
.IP "\fB-T \fIvalue\fR"
Specifies connection timeout value in seconds. 0 - no timeout.
.SH NOTES
Because MODBUS RTU protocol have situations which can't straightforwardly
translated into MODBUS/TCP protocol entities, \fImbusd\fR extends standard exception codes set.
In case of situation when \fImbusd\fR received response with invalid CRC and can't correct
error by re-request, it return MODBUS/TCP packet with exception code 128. In case of situation
when \fImbusd\fR can't receive response from MODBUS RTU device (e.g. addressed controller
is not present on the network), it return MODBUS/TCP packet with exception code 129.
.SH FILES
.PP
The default location of the \fImbusd\fR log file is:
.PP
/var/log/mbusd.log
.SH BUGS
Broadcast messaging on MODBUS network isn't supported.
Please send bug reports to author.
.SH AUTHOR
Victor Antonovich <avmlink@vlink.ru>.
.SH LICENSE
This program is distributed under the BSD-like license, included in
each source file. See also COPYING file in the installation directory.