[PATCH 1/2] add test/rctest.1 manpage

[PATCH 1/2] add test/rctest.1 manpage

[Filippo Giunchedi]

---
 test/rctest.1 |   90 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 90 insertions(+), 0 deletions(-)
 create mode 100644 test/rctest.1

diff --git a/test/rctest.1 b/test/rctest.1
new file mode 100644
index 0000000..b83d694
--- /dev/null
+++ b/test/rctest.1
@@ -0,0 +1,90 @@
+.TH RCTEST 1 "Jul 6 2009" BlueZ ""
+.SH NAME
+rctest \- RFCOMM testing
+.SH SYNOPSIS
+.B rctest
+<\fImode\fR> [\fIoptions\fR] [\fIbdaddr\fR]
+
+.SH DESCRIPTION
+.LP
+.B
+rctest
+is used to test RFCOMM communications on the BlueZ stack
+
+.SH MODES
+.TP
+.B -r
+listen and receive
+.TP
+.B -w
+listen and send
+.TP
+.B -d
+listen and dump incoming data
+.TP
+.B -s
+connect and send
+.TP
+.B -u
+connect and receive
+.TP
+.B -n
+connect and be silent
+.TP
+.B -c
+connect, disconnect, connect, ...
+.TP
+.B -m
+multiple connects
+
+.SH OPTIONS
+.TP
+.BI -b\  bytes
+send/receive \fIbytes\fR bytes
+.TP
+.BI -i\  device
+select the specified \fIdevice\fR
+.TP
+.BI -P\  channel
+select the specified \fIchannel\fR
+.TP
+.BI -U\  uuid
+select the specified \fIuuid\fR
+.TP
+.BI -L\  seconds
+enable SO_LINGER options for \fIseconds\fR
+.TP
+.BI -F\  seconds
+enable deferred setup for \fIseconds\fR
+.TP
+.BI -B\  filename
+use data packets from \fIfilename\fR
+.TP
+.BI -N\  num
+send \fInum\fR frames
+.TP
+.BI -C\  num
+send \fInum\fR frames before delay (default: 1)
+.TP
+.BI -D\  milliseconds
+delay \fImilliseconds\fR after sending \fInum\fR frames (default: 0)
+.TP
+.B -A
+request authentication
+.TP
+.B -E
+request encryption
+.TP
+.B -S
+secure connection
+.TP
+.B -M
+become master
+.TP
+.B -T
+enable timestamps
+
+.SH AUTHORS
+Written by Marcel Holtmann <marcel@holtmann.org> and Maxim Krasnyansky
+<maxk@qualcomm.com>, man page by Filippo Giunchedi <filippo@debian.org>
+.PP
-- 
1.6.3.3

[PATCH 2/2] include test/rctest.1 into man_MANS and EXTRA_DIST

[Filippo Giunchedi]

---
 test/Makefile.am |   15 ++++++++++-----
 1 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/test/Makefile.am b/test/Makefile.am
index e54e88e..7bd68c0 100644
--- a/test/Makefile.am
+++ b/test/Makefile.am
@@ -36,15 +36,20 @@ btiotest_LDADD = $(top_builddir)/common/libhelper.a @GLIB_LIBS@ @BLUEZ_LIBS@
 
 noinst_MANS = bdaddr.8
 
+if MANPAGES
+man_MANS = rctest.1
+endif
+
 AM_CFLAGS = @BLUEZ_CFLAGS@ @DBUS_CFLAGS@ @GLIB_CFLAGS@
 endif
 
 INCLUDES = -I$(top_srcdir)/common
 
-EXTRA_DIST = apitest hsplay hsmicro bdaddr.8 dbusdef.py monitor-bluetooth \
-		list-devices test-discovery test-manager test-adapter \
-		test-device test-service test-serial test-telephony \
-		test-network simple-agent simple-service service-record.dtd \
-		service-did.xml service-spp.xml service-opp.xml service-ftp.xml
+EXTRA_DIST = apitest hsplay hsmicro bdaddr.8 rctest.1 dbusdef.py \
+		monitor-bluetooth list-devices test-discovery test-manager \
+		test-adapter test-device test-service test-serial \
+		test-telephony test-network simple-agent simple-service \
+		service-record.dtd service-did.xml service-spp.xml \
+		service-opp.xml service-ftp.xml
 
 MAINTAINERCLEANFILES = Makefile.in
-- 
1.6.3.3

[PATCH 1/3] test/hciemu.c: verbose usage message

[Filippo Giunchedi]

---
 test/hciemu.c |    8 +++++++-
 1 files changed, 7 insertions(+), 1 deletions(-)

diff --git a/test/hciemu.c b/test/hciemu.c
index 9f651bc..68fabb0 100644
--- a/test/hciemu.c
+++ b/test/hciemu.c
@@ -1172,7 +1172,13 @@ static void usage(void)
 {
 	printf("hciemu - HCI emulator ver %s\n", VERSION);
 	printf("Usage: \n");
-	printf("\thciemu [-n] local_address\n");
+	printf("\thciemu [options] local_address\n"
+		"Options:\n"
+		"\t[-d device] use specified device\n"
+		"\t[-b bdaddr] emulate specified address\n"
+		"\t[-s file] create snoop file\n"
+		"\t[-n] do not detach\n"
+		"\t[-h] help, you are looking at it\n");
 }
 
 static struct option main_options[] = {
-- 
1.6.3.3

[PATCH 2/3] add test/hciemu.1 manpage

[Filippo Giunchedi]

---
 test/hciemu.1 |   31 +++++++++++++++++++++++++++++++
 1 files changed, 31 insertions(+), 0 deletions(-)
 create mode 100644 test/hciemu.1

diff --git a/test/hciemu.1 b/test/hciemu.1
new file mode 100644
index 0000000..cecaeb7
--- /dev/null
+++ b/test/hciemu.1
@@ -0,0 +1,31 @@
+.TH HCIEMU 1 "Jul 6 2009" BlueZ ""
+.SH NAME
+hciemu \- HCI emulator
+.SH SYNOPSIS
+.B hciemu
+[\fIoptions\fR] \fIlocal_address\fR
+
+.SH DESCRIPTION
+.LP
+.B
+hciemu
+is used to emulate an HCI via \fBhci_vhci\fR kernel module
+
+.SH OPTIONS
+.TP
+.BI -d\  device
+use specified \fIdevice\fR
+.TP
+.BI -b\  bdaddr
+emulate \fIbdaddr\fR
+.TP
+.BI -s\  file
+create snoop file \fIfile\fR
+.TP
+.B -n
+do not detach
+
+.SH AUTHORS
+Written by Marcel Holtmann <marcel@holtmann.org> and Maxim Krasnyansky
+<maxk@qualcomm.com>, man page by Filippo Giunchedi <filippo@debian.org>
+.PP
-- 
1.6.3.3

[PATCH 3/3] include test/hciemu.1 into man_MANS and EXTRA_DIST

[Filippo Giunchedi]

---
 test/Makefile.am |    4 ++--
 1 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/test/Makefile.am b/test/Makefile.am
index 7bd68c0..2e58d24 100644
--- a/test/Makefile.am
+++ b/test/Makefile.am
@@ -37,7 +37,7 @@ btiotest_LDADD = $(top_builddir)/common/libhelper.a @GLIB_LIBS@ @BLUEZ_LIBS@
 noinst_MANS = bdaddr.8
 
 if MANPAGES
-man_MANS = rctest.1
+man_MANS = rctest.1 hciemu.1
 endif
 
 AM_CFLAGS = @BLUEZ_CFLAGS@ @DBUS_CFLAGS@ @GLIB_CFLAGS@
@@ -45,7 +45,7 @@ endif
 
 INCLUDES = -I$(top_srcdir)/common
 
-EXTRA_DIST = apitest hsplay hsmicro bdaddr.8 rctest.1 dbusdef.py \
+EXTRA_DIST = apitest hsplay hsmicro bdaddr.8 rctest.1 hciemu.1 dbusdef.py \
 		monitor-bluetooth list-devices test-discovery test-manager \
 		test-adapter test-device test-service test-serial \
 		test-telephony test-network simple-agent simple-service \
-- 
1.6.3.3

Re: [PATCH 1/2] add test/rctest.1 manpage

[Marcel Holtmann]

Hi Filippo,

> ---
>  test/rctest.1 |   90 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  1 files changed, 90 insertions(+), 0 deletions(-)
>  create mode 100644 test/rctest.1

all 5 patches have been applied. Thanks.

Regards

Marcel