Release notes
****************************************************************************
-Release date: Sept 2nd, 2014.
+Release date: Sept 2nd, 2014.
OS: Ubuntu 12.0.4 and above
-Requires boost version 1.55 to build.
-Code buildable in gcc 4.6.3 and above.
-NOTE: Boost is not distributed but should be installed in the Ubuntu machine.
+Requires boost version 1.55 to build.
+Code buildable in gcc 4.6.3 and above.
+NOTE: Boost is not distributed but should be installed in the Ubuntu machine.
*****************************************************************************
-What\92s new?
+What\92s new?
--------------------------------------------
Class OCPlatform (Header file: OCPlatform.h)
startPresence API
*****************
-This API allows the server to notify its presence via multicast.
+This API allows the server to notify its presence via multicast.
-NOTE: This applies to server side functionality only.
+NOTE: This applies to server side functionality only.
*******************
stopPresence API
This API allows the server to stop presence notification.
-NOTE: This applies to server side functionality.
+NOTE: This applies to server side functionality.
******************
subscribePresence API
******************
-This API allows a client to subscribe to a device's presence notifications. Notifications include new addition of resource on the device, deletion of a resource on the device, change in properties of a resource.
+This API allows a client to subscribe to a device's presence notifications. Notifications include new addition of resource on the device, deletion of a resource on the device, change in properties of a resource.
NOTE: This applies to client side functionality only.
NOTE: In this release, when client uses subscribePresence API, it gets notified only for new addition of resource on the device (server).
unsubscribePresence API
*******************
-This API allows a client to unsubscribe from a device's presence events.
+This API allows a client to unsubscribe from a device's presence events.
NOTE: This applies to client side functionality only.
OCStartPresence API
*****************
-This API will start sending out presence notifications to clients via multicast.
+This API will start sending out presence notifications to clients via multicast.
-NOTE: This applies to server side functionality only.
+NOTE: This applies to server side functionality only.
*******************
OCStopPresence API
*******************
-This API will stop sending out presence notifications to clients via multicast.
+This API will stop sending out presence notifications to clients via multicast.
-NOTE: This applies to server side functionality.
+NOTE: This applies to server side functionality.
------------
Other Notes:
------------
-Security model is still open.
-APIs have OCStackResult as return type. This is will indicate success or failure for the API operation.
+Security model is still open.
+APIs have OCStackResult as return type. This is will indicate success or failure for the API operation.
-Implementation for presence code is in both C (base) and C++ (SDK). In C (base) stack, presence code is defined with 'WITH_PRESENCE' preprocessor macro.
+Implementation for presence code is in both C (base) and C++ (SDK). In C (base) stack, presence code is defined with 'WITH_PRESENCE' preprocessor macro.
Maximum length of URI supported is 64 bytes (sent from the client)
Maximum length of query supported is 64 bytes (sent from the client)
How to build:
-------------
-REFER https://oic-review.01.org/gerrit for more details on getting oic-resource repo.
-If the code is not cloned:
-Clone the oic-resource repo using this command: git clone oic:oic-resource
-Clone the oic-utilities repo using this command: git clone oic:oic-utilities
+REFER https://oic-review.01.org/gerrit for more details on getting oic-resource repo.
+If the code is not cloned:
+Clone the oic-resource repo using this command: git clone oic:oic-resource
+Clone the oic-utilities repo using this command: git clone oic:oic-utilities
-NOTE: If the repo is already cloned, use 'git pull' inside oic-resource folder to get the latest code.
+NOTE: If the repo is already cloned, use 'git pull' inside oic-resource folder to get the latest code.
-In repo oic-core, root folder ccf-opensource consists of \91OIC\92 folder. Inside OIC folder there is a Makefile.
+In repo oic-core, root folder ccf-opensource consists of \91OIC\92 folder. Inside OIC folder there is a Makefile.
-Before building, make sure to have contents from oic-utilities repo at the folder level where oic-resource is.
+Before building, make sure to have contents from oic-utilities repo at the folder level where oic-resource is.
-Inside oic-resource directory, use \91make\92 to build the entire OIC code. This would build the C++ SDK, core(i.e base) and samples.
+Inside oic-resource directory, use \91make\92 to build the entire OIC code. This would build the C++ SDK, core(i.e base) and samples.
-Use \91make BUILD=debug\92 to build the entire OIC code in debug mode. This would build the C++ SDK, core(i.e base) and samples. All the executables for debug build
+Use \91make BUILD=debug\92 to build the entire OIC code in debug mode. This would build the C++ SDK, core(i.e base) and samples. All the executables for debug build
are in 'debug/samples'.
--------
Samples:
--------
-After building the code in oic-resource, executables are in directory named 'release/samples'.
+After building the code in oic-resource, executables are in directory named 'release/samples'.
A sample for hosting a resource on a server and a sample for client for discovering resources are provided in the following paths:
Server sample location: oic-resource/examples/simpleserver.cpp