2009-07-06 14:20:53

by Filippo Giunchedi

[permalink] [raw]
Subject: [PATCH 1/2] add test/rctest.1 manpage

---
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 <[email protected]> and Maxim Krasnyansky
+<[email protected]>, man page by Filippo Giunchedi <[email protected]>
+.PP
--
1.6.3.3



2009-07-06 17:37:14

by Marcel Holtmann

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

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



2009-07-06 16:05:03

by Filippo Giunchedi

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

---
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


2009-07-06 16:05:05

by Filippo Giunchedi

[permalink] [raw]
Subject: [PATCH 3/3] include test/hciemu.1 into man_MANS and EXTRA_DIST

---
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


2009-07-06 16:05:04

by Filippo Giunchedi

[permalink] [raw]
Subject: [PATCH 2/3] add test/hciemu.1 manpage

---
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 <[email protected]> and Maxim Krasnyansky
+<[email protected]>, man page by Filippo Giunchedi <[email protected]>
+.PP
--
1.6.3.3


2009-07-06 14:20:54

by Filippo Giunchedi

[permalink] [raw]
Subject: [PATCH 2/2] include test/rctest.1 into man_MANS and EXTRA_DIST

---
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