From 7d09e5fd81e5abacad94f77d64caa62840a9f287 Mon Sep 17 00:00:00 2001
From: Andy Piper <andypiperuk@gmail.com>
Date: Mon, 4 Mar 2013 16:55:10 +0000
Subject: [PATCH 1/2] README file, OS X build support Added top-level README.md
 with details of building, links to info Added OS X build rule to Makefile. NB
 needs updating for samples Added Paho logo to doc dir for potential future
 use.

---
 README.md        |  77 ++++++++++++++++++++++++++++++++++
 build/Makefile   | 107 ++++++++++++++++++++++++++++++++++++-----------
 doc/pahologo.png | Bin 0 -> 12197 bytes
 3 files changed, 159 insertions(+), 25 deletions(-)
 create mode 100644 README.md
 create mode 100644 doc/pahologo.png

diff --git a/README.md b/README.md
new file mode 100644
index 00000000..848418b0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,77 @@
+# Eclipse Paho MQTT C client
+
+
+This repository contains the source code for the [Eclipse Paho](http://eclipse.org/paho) MQTT C client library. 
+
+This code builds libraries which enable applications to connect to an [MQTT](http://mqtt.org) broker to publish messages, and to subscribe to topics and receive published messages.
+
+Both synchronous and asynchronous modes of operation are supported.
+
+## Build requirements / compilation
+
+The build process requires GNU Make and gcc, and also requires OpenSSL libraries and includes to be available. There are make rules for a number of Linux "flavors" including ARM and s390, OS X, AIX and Solaris.
+
+The documentation requires doxygen and optionally graphviz. 
+
+Before compiling, set some environment variables (or pass these values to the make command directly) in order to configure library locations and other options.
+
+Specify the location of OpenSSL using `SSL_DIR`
+
+e.g. using [homebrew](http://mxcl.github.com/homebrew/) on OS X:
+
+`export SSL_DIR=/usr/local/Cellar/openssl/1.0.1e`
+
+Specify where the source files are in relation to where the make command is being executed.
+
+``export MQTTCLIENT_DIR=../src``
+
+To build the samples, enable the option (`BUILD_SAMPLES`), and specify the location of the code:
+
+```
+export BUILD_SAMPLES=YES
+export SAMPLES_DIR=../src/samples
+```
+
+One more useful environment variable is ``TARGET_PLATFORM``. This provides for cross-compilation. Currently the only recognised value is "Arm" - for instance to cross-compile a Linux ARM version of the libraries:
+
+``export TARGET_PLATFORM=Arm``
+
+## Libraries
+
+The Paho C client comprises four shared libraries:
+
+ * libmqttv3a.so - asynchronous
+ * libmqttv3as.so - asynchronous with SSL
+ * libmqttv3c.so - "classic" / synchronous
+ * libmqttv3cs.so - "classic" / synchronous with SSL
+
+## Usage and API
+
+Detailed API documentation is available by building the Doxygen docs in the  ``doc`` directory. A [snapshot is also available online](http://www.eclipse.org/paho/files/mqttdoc/Cclient/index.html).
+
+## Runtime tracing
+
+A number of environment variables control runtime tracing of the C library. 
+
+Tracing is switched on using ``MQTT_C_CLIENT_TRACE`` (a value of ON traces to stdout, any other value should specify a file to trace to). 
+
+The verbosity of the output is controlled using the  ``MQTT_C_CLIENT_TRACE_LEVEL`` environment variable - valid values are ERROR, PROTOCOL, MINIMUM, MEDIUM and MAXIMUM (from least to most verbose).
+
+The variable ``MQTT_C_CLIENT_TRACE_MAX_LINES`` limits the number of lines of trace that are output.
+
+```
+export MQTT_C_CLIENT_TRACE=ON
+export MQTT_C_CLIENT_TRACE_LEVEL=PROTOCOL
+```
+
+## Reporting bugs
+
+Please report bugs under the "MQTT" Component in [Eclipse Bugzilla](http://bugs.eclipse.org/bugs) for the Paho Technology project.
+
+## More information
+
+Discussion of the Paho clients takes place on the [Eclipse paho-dev mailing list](https://dev.eclipse.org/mailman/listinfo/paho-dev).
+
+General questions about the MQTT protocol are discussed in the [MQTT Google Group](https://groups.google.com/forum/?hl=en-US&fromgroups#!forum/mqtt).
+
+There is much more information available via the [MQTT community site](http://mqtt.org).
diff --git a/build/Makefile b/build/Makefile
index 46a6b88a..7707ac40 100644
--- a/build/Makefile
+++ b/build/Makefile
@@ -1,7 +1,11 @@
 # Build output is produced in the current directory.
+
 # MQTTCLIENT_DIR must point to the base directory containing the MQTT client source code.
 # Example:  make -f makefile MQTTCLIENT_DIR=V3Client/MQTTClient
+
 # Note: this makefile requires gnu make which you may need to obtain if compiling on AIX or Solaris
+# Note: on OS X you should install XCode and the associated command-line tools
+
 ifndef MQTTCLIENT_DIR
   MQTTCLIENT_DIR = $(CURDIR)
 endif
@@ -15,7 +19,7 @@ SAMPLES_DIR = ${SSL_DIR}/../com.ibm.mq.mqxr.listener/SDK/clients/c/samples/
 endif
 
 MQTTLIB = mqttv3c
-VPATH   = ${MQTTCLIENT_DIR}  
+VPATH   = ${MQTTCLIENT_DIR}
 ALL_SOURCE_FILES = $(wildcard $(MQTTCLIENT_DIR)/*.c)
 SOURCE_FILES = $(filter-out $(MQTTCLIENT_DIR)/MQTTAsync.c $(MQTTCLIENT_DIR)/MQTTVersion.c $(MQTTCLIENT_DIR)/SSLSocket.c, $(ALL_SOURCE_FILES))
 ALL_HEADERS = $(MQTTCLIENT_DIR)/*.h
@@ -32,13 +36,13 @@ MQTTLIB_AS = mqttv3as
 SOURCE_FILES_AS = $(filter-out $(MQTTCLIENT_DIR)/MQTTClient.c $(MQTTCLIENT_DIR)/MQTTVersion.c, $(ALL_SOURCE_FILES))
 
 # In most cases the targets will be built for the native platform. However, to allow for cross compiling,
-# a target platform variable can be set to override the platform choice. If this variable is set to 
-# a recognised string (currently just 'Arm') the appropriate values of OSTYPE and MACHINETYPE are set.  
+# a target platform variable can be set to override the platform choice. If this variable is set to
+# a recognised string (currently just 'Arm') the appropriate values of OSTYPE and MACHINETYPE are set.
 ifeq ($(TARGET_PLATFORM),Arm)
 	OSTYPE = Linux
 	MACHINETYPE = Arm
 else
-	ifeq ($(OS),Windows_NT)   
+	ifeq ($(OS),Windows_NT)
 		OSTYPE = $(OS)
 	else
 		OSTYPE = $(shell uname -s)
@@ -67,12 +71,12 @@ ifeq ($(MACHINETYPE),x86_64)
 ifdef BUILD_SAMPLES
 all: linux_ia64 ${MQTTLIB_IA64} ${MQTTLIB_IA64_A} ${MQTTLIB_IA64_S} ${MQTTLIB_IA64_AS} samples
 else
-all: linux_ia64 ${MQTTLIB_IA64} ${MQTTLIB_IA64_A} ${MQTTLIB_IA64_S} ${MQTTLIB_IA64_AS} 
+all: linux_ia64 ${MQTTLIB_IA64} ${MQTTLIB_IA64_A} ${MQTTLIB_IA64_S} ${MQTTLIB_IA64_AS}
 endif
 
 linux_ia64:
 	-mkdir linux_ia64
-	
+
 samples:
 	-mkdir ${SAMPLES_DIR}/linux_ia64
 	${CC} -m64 -I ${MQTTCLIENT_DIR} -L ${MQTTCLIENT_DIR}/linux_ia64 -o ${SAMPLES_DIR}/linux_ia64/MQTTV3Sample ${SAMPLES_DIR}/MQTTV3Sample.c -lmqttv3c -lpthread
@@ -83,20 +87,20 @@ samples:
 ${MQTTLIB_IA64}: ${SOURCE_FILES} ${HEADERS}
 	${CC} -m64 ${CCFLAGS_SO} ${LDFLAGS} -o $@ ${SOURCE_FILES}
 	strip $@
-	
+
 ${MQTTLIB_IA64_S}: ${SOURCE_FILES_S} ${HEADERS}
 	${CC} -m64 ${CCFLAGS_SO} ${LDFLAGS_S} -o $@ ${SOURCE_FILES_S} -DOPENSSL
 	strip $@
 
 ${MQTTLIB_IA64_A}: ${SOURCE_FILES_A} ${HEADERS_A}
-	${CC} -m64 ${CCFLAGS_SO} ${LDFLAGS_A} -o $@ ${SOURCE_FILES_A} 
+	${CC} -m64 ${CCFLAGS_SO} ${LDFLAGS_A} -o $@ ${SOURCE_FILES_A}
 	strip $@
 
 ${MQTTLIB_IA64_AS}: ${SOURCE_FILES_AS} ${HEADERS_A}
 	${CC} -m64 ${CCFLAGS_SO} ${LDFLAGS_AS} -o $@ ${SOURCE_FILES_AS} -DOPENSSL
 	strip $@
-	
-else 
+
+else
 ifeq ($(MACHINETYPE),ppc64)
 	CC = gcc
 
@@ -113,7 +117,7 @@ ifeq ($(MACHINETYPE),ppc64)
 	MQTTLIB_PPC64_A = linux_ppc64/lib${MQTTLIB_A}.so
 	MQTTLIB_PPC64_AS = linux_ppc64/lib${MQTTLIB_AS}.so
 
-all: linux_ppc64 ${MQTTLIB_PPC64} ${MQTTLIB_PPC64_A} #${MQTTLIB_PPC64_S} ${MQTTLIB_PPC64_AS} 
+all: linux_ppc64 ${MQTTLIB_PPC64} ${MQTTLIB_PPC64_A} #${MQTTLIB_PPC64_S} ${MQTTLIB_PPC64_AS}
 
 linux_ppc64:
 	-mkdir linux_ppc64
@@ -121,20 +125,20 @@ linux_ppc64:
 ${MQTTLIB_PPC64}: ${SOURCE_FILES} ${HEADERS}
 	${CC} -m64 ${CCFLAGS_SO} ${LDFLAGS} -o $@ ${SOURCE_FILES}
 	strip $@
-	
+
 ${MQTTLIB_PPC64_S}: ${SOURCE_FILES_S} ${HEADERS}
 	${CC} -m64 ${CCFLAGS_SO} ${LDFLAGS_S} -o $@ ${SOURCE_FILES_S} -DOPENSSL
 	strip $@
 
 ${MQTTLIB_PPC64_A}: ${SOURCE_FILES_A} ${HEADERS_A}
-	${CC} -m64 ${CCFLAGS_SO} ${LDFLAGS_A} -o $@ ${SOURCE_FILES_A} 
+	${CC} -m64 ${CCFLAGS_SO} ${LDFLAGS_A} -o $@ ${SOURCE_FILES_A}
 	strip $@
 
 ${MQTTLIB_PPC64_AS}: ${SOURCE_FILES_AS} ${HEADERS_A}
 	${CC} -m64 ${CCFLAGS_SO} ${LDFLAGS_AS} -o $@ ${SOURCE_FILES_AS} -DOPENSSL
 	strip $@
-	
-else 
+
+else
 ifeq ($(MACHINETYPE),s390x)
   CC 	   = gcc
 
@@ -144,7 +148,7 @@ ifeq ($(MACHINETYPE),s390x)
   LDFLAGS_EXE = -lpthread
 
   MQTTLIB_390 = linux_s390x/lib${MQTTLIB}.so
-  
+
   all: ${MQTTLIB_390}
 
 ${MQTTLIB_390}: ${SOURCE_FILES} ${HEADERS}
@@ -232,7 +236,7 @@ linux_ia32:
 ${MQTTLIB_IA32}: ${SOURCE_FILES} ${HEADERS}
 	${CC} -m32 ${CCFLAGS_SO} ${LDFLAGS} -o $@ ${SOURCE_FILES}
 	strip $@
-	
+
 ${MQTTLIB_IA32_S}: ${SOURCE_FILES_S} ${HEADERS}
 	${CC} -m32 ${CCFLAGS_SO} ${LDFLAGS_S} -o $@ ${SOURCE_FILES_S} -DOPENSSL
 	strip $@
@@ -254,6 +258,59 @@ endif
 
 endif
 
+ifeq ($(OSTYPE),Darwin)
+
+ifeq ($(MACHINETYPE),x86_64)
+	CC = gcc
+
+	CCFLAGS_SO = -fPIC -Os -Wall -I ${SSL_DIR}/include
+	CCFLAGS_EXE = -I ${MQTTCLIENT_DIR}
+	LDFLAGS = -shared -Wl,-install_name,lib${MQTTLIB}.so
+	LDFLAGS_S = -shared -Wl,-install_name,lib${MQTTLIB_S}.so -ldl -Wl,-all_load -L${SSL_DIR}/lib -lcrypto -lssl
+	LDFLAGS_A = -shared -Wl,-install_name,lib${MQTTLIB_A}.so
+	LDFLAGS_AS = -shared -Wl,-install_name,lib${MQTTLIB_AS}.so -ldl -Wl,-all_load -L${SSL_DIR}/lib -lcrypto -lssl
+	LDFLAGS_EXE = -lpthread
+
+	MQTTLIB_IA64 = darwin_ia64/lib${MQTTLIB}.so
+	MQTTLIB_IA64_S = darwin_ia64/lib${MQTTLIB_S}.so
+	MQTTLIB_IA64_A = darwin_ia64/lib${MQTTLIB_A}.so
+	MQTTLIB_IA64_AS = darwin_ia64/lib${MQTTLIB_AS}.so
+
+ifdef BUILD_SAMPLES
+all: darwin_ia64 ${MQTTLIB_IA64} ${MQTTLIB_IA64_A} ${MQTTLIB_IA64_S} ${MQTTLIB_IA64_AS} samples
+else
+all: darwin_ia64 ${MQTTLIB_IA64} ${MQTTLIB_IA64_A} ${MQTTLIB_IA64_S} ${MQTTLIB_IA64_AS}
+endif
+
+darwin_ia64:
+	-mkdir darwin_ia64
+
+samples:
+	-mkdir ${SAMPLES_DIR}/darwin_ia64
+	${CC} -m64 -I ${MQTTCLIENT_DIR} -L ${MQTTCLIENT_DIR}/darwin_ia64 -o ${SAMPLES_DIR}/darwin_ia64/MQTTV3Sample ${SAMPLES_DIR}/MQTTV3Sample.c -lmqttv3c -lpthread
+	${CC} -m64 -I ${MQTTCLIENT_DIR} -L ${MQTTCLIENT_DIR}/darwin_ia64 -o ${SAMPLES_DIR}/darwin_ia64/MQTTV3SSample ${SAMPLES_DIR}/MQTTV3SSample.c -lmqttv3cs -lpthread
+	${CC} -m64 -I ${MQTTCLIENT_DIR} -L ${MQTTCLIENT_DIR}/darwin_ia64 -o ${SAMPLES_DIR}/darwin_ia64/MQTTV3ASample ${SAMPLES_DIR}/MQTTV3ASample.c -lmqttv3a -lpthread
+	${CC} -m64 -I ${MQTTCLIENT_DIR} -L ${MQTTCLIENT_DIR}/darwin_ia64 -o ${SAMPLES_DIR}/darwin_ia64/MQTTV3ASSample ${SAMPLES_DIR}/MQTTV3ASSample.c -lmqttv3as -lpthread
+
+${MQTTLIB_IA64}: ${SOURCE_FILES} ${HEADERS}
+	${CC} -m64 ${CCFLAGS_SO} ${LDFLAGS} -o $@ ${SOURCE_FILES}
+	strip -x $@
+
+${MQTTLIB_IA64_S}: ${SOURCE_FILES_S} ${HEADERS}
+	${CC} -m64 ${CCFLAGS_SO} ${LDFLAGS_S} -o $@ ${SOURCE_FILES_S} -DOPENSSL
+	strip -x $@
+
+${MQTTLIB_IA64_A}: ${SOURCE_FILES_A} ${HEADERS_A}
+	${CC} -m64 ${CCFLAGS_SO} ${LDFLAGS_A} -o $@ ${SOURCE_FILES_A}
+	strip -x $@
+
+${MQTTLIB_IA64_AS}: ${SOURCE_FILES_AS} ${HEADERS_A}
+	${CC} -m64 ${CCFLAGS_SO} ${LDFLAGS_AS} -o $@ ${SOURCE_FILES_AS} -DOPENSSL
+	strip -x $@
+
+endif
+
+endif
 
 ifeq ($(OSTYPE),AIX)
 # applications must be linked with -I. -L. -lmqttv3c -Wl,-brtl -pthread
@@ -279,16 +336,16 @@ ifeq ($(OSTYPE),Windows_NT)
 
   # compiler flags
   CPPFLAGS = /D "WIN32" /D "_UNICODE" /D "UNICODE" /D "_CRT_SECURE_NO_WARNINGS"
-  CFLAGS = /nologo /c /O2 /W3 /Fd /MD /TC   
+  CFLAGS = /nologo /c /O2 /W3 /Fd /MD /TC
   CPPFLAGS_S = /D "OPENSSL" /I ${SSL_DIR}/include
 
   # linker flags
-  LINKFLAGS = /nologo /machine:x86 /manifest 
+  LINKFLAGS = /nologo /machine:x86 /manifest
   WINLIBS = kernel32.lib user32.lib gdi32.lib winspool.lib comdlg32.lib advapi32.lib shell32.lib ole32.lib oleaut32.lib uuid.lib odbc32.lib odbccp32.lib ws2_32.lib
   WINLIBS_S = crypt32.lib ssleay32.lib libeay32.lib
   SSLLIBPATH = /LIBPATH:${SSL_DIR}/output/lib
   # Flags to link C libraries
-  LIBLINKFLAGS = /dll   
+  LIBLINKFLAGS = /dll
   IMP = /implib:$(@:.dll=.lib)
   LIBPDB = /pdb:$(@:.dll=.pdb)
   LIBMAP = /map:$(@:.dll=.map)
@@ -298,7 +355,7 @@ ifeq ($(OSTYPE),Windows_NT)
   MAINLINKFLAGS = /subsystem:console
   EXEPDB = /pdb:$(@:.exe=.pdb)
   EXEMAP = /map:$(@:.exe=.map)
-  MAINLDFLAGS = $(LINKFLAGS) $(WINLIBS) $(MAINLINKFLAGS) $(EXEPDB) $(EXEMAP) 
+  MAINLDFLAGS = $(LINKFLAGS) $(WINLIBS) $(MAINLINKFLAGS) $(EXEPDB) $(EXEMAP)
 
   MQTTLDLIB = windows_ia32/$(MQTTLIB).lib
   MQTTDLL   = windows_ia32/$(MQTTLIB).dll
@@ -349,11 +406,11 @@ $(MQTTDLL_AS): ${SOURCE_FILES}  ${HEADERS}
 	$(LD) $(LIBLDFLAGS_S) *.obj /out:$(MQTTDLL_AS)
 	mt -manifest windows_ia32/mqttv3as.dll.manifest -outputresource:$(MQTTDLL_AS)\;2
 
-endif  
+endif
 
 #########################################################################################################
-# The following was how the C Clients were built using cygwin GNU make and has been left here as a reference 
-# This has been converted to use ming GNU make (which uses the native format of file names) 
+# The following was how the C Clients were built using cygwin GNU make and has been left here as a reference
+# This has been converted to use ming GNU make (which uses the native format of file names)
 #
 #$(MQTTDLL): $(shell cygpath -au ${SOURCE_FILES})  $(shell cygpath -au ${HEADERS})
 #	-mkdir windows_ia32
@@ -362,4 +419,4 @@ endif
 #	mt -manifest windows_ia32/mqttv3c.dll.manifest -outputresource:$(MQTTDLL)\;2
 #
 #endif
-#########################################################################################################  
+#########################################################################################################
diff --git a/doc/pahologo.png b/doc/pahologo.png
new file mode 100644
index 0000000000000000000000000000000000000000..27f197d8e54aadaca7e8677e51f50df290c54963
GIT binary patch
literal 12197
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

literal 0
HcmV?d00001


From 97abb656a663fb45e3e23d601239dfe98c246044 Mon Sep 17 00:00:00 2001
From: Andy Piper <andypiperuk@gmail.com>
Date: Mon, 4 Mar 2013 21:53:25 +0000
Subject: [PATCH 2/2] Improved usage information (e.g. for C++ usage)

---
 README.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/README.md b/README.md
index 848418b0..5239ba0a 100644
--- a/README.md
+++ b/README.md
@@ -49,6 +49,17 @@ The Paho C client comprises four shared libraries:
 
 Detailed API documentation is available by building the Doxygen docs in the  ``doc`` directory. A [snapshot is also available online](http://www.eclipse.org/paho/files/mqttdoc/Cclient/index.html).
 
+Samples are available in the Doxygen docs and also in ``src/samples`` for reference.
+
+Note that using the C headers from a C++ program requires the following declaration as part of the C++ code:
+
+```
+    extern "C" {
+    #include "MQTTClient.h"
+    #include "MQTTClientPersistence.h"
+    }
+```
+
 ## Runtime tracing
 
 A number of environment variables control runtime tracing of the C library.