Recent changes to libflom

libflom modified by Christian Ferrari

Christian Ferrari — Thu, 05 Mar 2020 21:18:00 -0000

--- v11
+++ v12
@@ -1,3 +1,4 @@
+This page is no more maintained, the current one is at http://www.tiian.org/flom/libflom/libflom.html
 # libflom: FLoM API library, the FLoM development kit #

 **libflom** is the FLoM API library you can use to develop your own application using C, C++, Java, PHP or Python language. Using **libflom** you can synchronize your own C, C++, Java, PHP or Python application with shell scripts/commands that use **flom** command: you can share the same resources managed by the same lock manager (FLoM *daemon*).

libflom modified by Christian Ferrari

Christian Ferrari — Fri, 02 Dec 2016 22:59:17 -0000

--- v10
+++ v11
@@ -19,5 +19,6 @@
 * [libflom for C developers]
 * [libflom for C++ developers]
 * [libflom for Java developers]
+* [libflom for Perl developers]
 * [libflom for PHP developers]
 * [libflom for Python developers]

libflom modified by Christian Ferrari

Christian Ferrari — Wed, 30 Sep 2015 20:22:06 -0000

--- v9
+++ v10
@@ -1,6 +1,6 @@
 # libflom: FLoM API library, the FLoM development kit #

-**libflom** is the FLoM API library you can use to develop your own application using C, C++, PHP or Python language. Using **libflom** you can synchronize your own C, C++, PHP or Python application with shell scripts/commands that use **flom** command: you can share the same resources managed by the same lock manager (FLoM *daemon*).
+**libflom** is the FLoM API library you can use to develop your own application using C, C++, Java, PHP or Python language. Using **libflom** you can synchronize your own C, C++, Java, PHP or Python application with shell scripts/commands that use **flom** command: you can share the same resources managed by the same lock manager (FLoM *daemon*).
 FLoM API documentation is available:

 * online
@@ -18,5 +18,6 @@

 * [libflom for C developers]
 * [libflom for C++ developers]
+* [libflom for Java developers]
 * [libflom for PHP developers]
 * [libflom for Python developers]

libflom modified by Christian Ferrari

Christian Ferrari — Wed, 30 Sep 2015 20:13:28 -0000

--- v8
+++ v9
@@ -3,7 +3,10 @@
 **libflom** is the FLoM API library you can use to develop your own application using C, C++, PHP or Python language. Using **libflom** you can synchronize your own C, C++, PHP or Python application with shell scripts/commands that use **flom** command: you can share the same resources managed by the same lock manager (FLoM *daemon*).
 FLoM API documentation is available:

-* online: http://flom.sourceforge.net/
+* online
+    * C API documentation  http://flom.sourceforge.net/html/C/
+    * C++ API documentation http://flom.sourceforge.net/html/C++/
+    * Java API documentation http://flom.sourceforge.net/html/java/
 * on your system (see [installation]): /usr/local/share/doc/flom/html/

 Some documented usage examples are available inside:

libflom modified by Christian Ferrari

Christian Ferrari — Tue, 26 May 2015 21:15:05 -0000

--- v7
+++ v8
@@ -1,6 +1,6 @@
 # libflom: FLoM API library, the FLoM development kit #

-**libflom** is the FLoM API library you can use to develop your own application using C, C++ or PHP language. Using **libflom** you can synchronize your own C, C++ or PHP application with shell scripts/commands that use **flom** command: you can share the same resources managed by the same lock manager (FLoM *daemon*).
+**libflom** is the FLoM API library you can use to develop your own application using C, C++, PHP or Python language. Using **libflom** you can synchronize your own C, C++, PHP or Python application with shell scripts/commands that use **flom** command: you can share the same resources managed by the same lock manager (FLoM *daemon*).
 FLoM API documentation is available:

 * online: http://flom.sourceforge.net/
@@ -16,3 +16,4 @@
 * [libflom for C developers]
 * [libflom for C++ developers]
 * [libflom for PHP developers]
+* [libflom for Python developers]

libflom modified by Christian Ferrari

Christian Ferrari — Fri, 30 Jan 2015 16:39:41 -0000

--- v6
+++ v7
@@ -16,88 +16,3 @@
 * [libflom for C developers]
 * [libflom for C++ developers]
 * [libflom for PHP developers]
-
-## The libflom programming kompass for C developers ##
-
-FLoM API is very easy to understand and use; these are the basic concepts:
-
-* *flom.h* is the header file you must include
-* *flom_handle_t* is the data type you must use to communicate with FLoM (you must treat this type of objects as opaque objects: for every useful property there's a getter/setter method and you don't have to mind what's the meaning of the object content)
-* you can use a "static programming style", allocating *flom_handle_t* objects on the stack or you can use a "dynamic programming style", allocating *flom_handle_t* objects in the heap: that's your choice and FLoM API does not force you to use a specific style
-
-### Static programming style example ###
-
-[basic_static.c](https://sourceforge.net/p/flom/code/ci/master/tree/doc/examples/basic_static.c) example can be considered the *hello world FLoM equivalent* for *static programming style*:
-1. allocate a *flom_handle_t* object on the stack declaring it
-2. initialize the object using method (function) *flom_handle_init*
-3. serialize your program using method (function) *flom_handle_lock*
-4. do everything your program must perform inside the serialization window
-5. deserialize your program using method (function) *flom_handle_unlock*
-6. clean-up the object using method (function) *flom_handle_clean*
-
-**Note:** you must clean-up every initialized *flom_handle_t* object; if you don't clean-up every object you will generate memory leaks.
-
-### Dynamic programming style example ###
-
-[basic_dynamic.c](https://sourceforge.net/p/flom/code/ci/master/tree/doc/examples/basic_dynamic.c) example can be considered the *hello world FLoM equivalent* for *dynamic programming style*:
-1. declare a *flom_handle_t* object pointer
-2. create a new object using method (function) *flom_handle_new*
-3. serialize your program using method (function) *flom_handle_lock*
-4. do everything your program must perform inside the serialization window
-5. deserialize your program using method (function) *flom_handle_unlock*
-6. delete the object using method (function) *flom_handle_delete*
-
-**Note:** you must delete every created *flom_handle_t* object; if you don't delete every object you will generate memory leaks.
-
-#### Static and dynamic programming styles ####
-
-**Note:** the availability of two different programming styles does **not** mean you can mix them!
-If you defined a static *flom_handle_t* object, you could not apply *flom_handle_delete* method against it.
-If you created a dynamic *flom_handle_t* object, you could not apply *flom_handle_init* and *flom_handle_clean* methods against it.
-Don't mix the styles, that pattern is **not** supported.
-
-## Advanced examples ##
-Basic examples do not explain as you can specify the name of the logical resource, the quantity of a numerical resource and the other parameters you typically use with **flom** command line.
-[advanced_static.c](https://sourceforge.net/p/flom/code/ci/master/tree/doc/examples/advanced_static.c) and [advanced_dynamic.c](https://sourceforge.net/p/flom/code/ci/master/tree/doc/examples/advanced_dynamic.c) examples show how some properties can be set before entering in the serialization phase.
-The complete list of the available setter/getter methods can be retrieved from:
-
-* [function](http://flom.sourceforge.net/globals_func.html) API page
-* [flom_handle.h](https://sourceforge.net/p/flom/code/ci/master/tree/src/flom_handle.h) header file
-
-## The libflom programming kompass for C++ developers ##
-
-FLoM API is very easy to understand and use; these are the basic concepts:
-
-* *flom.hh* is the header file you must include
-* *FlomHandle* is the class you must use to communicate with FLoM (you must treat this type of objects as opaque objects: for every useful property there's a getter/setter method and you don't have to mind what's the meaning of the object content)
-* you can use a "static programming style", allocating *FlomHandle* objects on the stack or you can use a "dynamic programming style", allocating *FlomHandle* objects in the heap: that's your choice and FLoM API does not force you to use a specific style
-
-### Static programming style example ###
-
-[BasicStatic.cc](https://sourceforge.net/p/flom/code/ci/master/tree/doc/examples/BasicStatic.cc) example can be considered the *hello world FLoM equivalent* for *static programming style*:
-1. allocate a *FlomHandle* object on the stack declaring it
-2. serialize your program using method *lock()*
-3. do everything your program must perform inside the serialization window
-5. deserialize your program using method *unlock()*
-
-**Note:** C++ clean-ups every statically initialized *FlomHandle* object for you: you don't have to mind about memory leaks.
-
-### Dynamic programming style example ###
-
-[BasicDynamic.cc](https://sourceforge.net/p/flom/code/ci/master/tree/doc/examples/BasicDynamic.cc) example can be considered the *hello world FLoM equivalent* for *dynamic programming style*:
-1. declare a *FlomHandle* object pointer
-2. create a new object using *new*
-3. serialize your program using method *lock()*
-4. do everything your program must perform inside the serialization window
-5. deserialize your program using method *unlock()*
-6. delete the object using *delete*
-
-**Note:** you must delete every created *FlomHandle* object; if you don't delete every object you will generate memory leaks.
-
-## Advanced examples ##
-Basic examples do not explain as you can specify the name of the logical resource, the quantity of a numerical resource and the other parameters you typically use with **flom** command line.
-[AdvancedStatic.cc](https://sourceforge.net/p/flom/code/ci/master/tree/doc/examples/AdvancedStatic.cc) and [AdvancedDynamic.cc](https://sourceforge.net/p/flom/code/ci/master/tree/doc/examples/AdvancedDynamic.cc) examples show how some properties can be set before entering in the serialization phase.
-The complete list of the available setter/getter methods can be retrieved from:
-
-* [FlomHandle class](http://flom.sourceforge.net/classflom_1_1_flom_handle.html) API page
-* [FlomHandle.hh](https://sourceforge.net/p/flom/code/ci/master/tree/src/FlomHandle.hh) header file

libflom modified by Christian Ferrari

Christian Ferrari — Fri, 30 Jan 2015 16:36:13 -0000

--- v5
+++ v6
@@ -10,6 +10,12 @@

 * tarball: doc/examples directory
 * on your system (see [installation]): /usr/local/share/doc/flom/examples/
+
+Choose the language of interest:
+
+* [libflom for C developers]
+* [libflom for C++ developers]
+* [libflom for PHP developers]

 ## The libflom programming kompass for C developers ##

libflom modified by Christian Ferrari

Christian Ferrari — Fri, 30 Jan 2015 16:32:55 -0000

--- v4
+++ v5
@@ -1,6 +1,6 @@
 # libflom: FLoM API library, the FLoM development kit #

-**libflom** is the FLoM API library you can use to develop your own application using C or C++ language. Using **libflom** you can synchronize your own C or C++ application with shell scripts/commands that use **flom** command: you can share the same resources managed by the same lock manager (FLoM *daemon*).
+**libflom** is the FLoM API library you can use to develop your own application using C, C++ or PHP language. Using **libflom** you can synchronize your own C, C++ or PHP application with shell scripts/commands that use **flom** command: you can share the same resources managed by the same lock manager (FLoM *daemon*).
 FLoM API documentation is available:

 * online: http://flom.sourceforge.net/

libflom modified by Christian Ferrari

Christian Ferrari — Sat, 20 Dec 2014 22:20:49 -0000

--- v3
+++ v4
@@ -1,6 +1,6 @@
 # libflom: FLoM API library, the FLoM development kit #

-**libflom** is the FLoM API library you can use to develop your own application using C language. Using **libflom** you can synchronize your own C application with shell scripts/commands that use **flom** command: you can share the same resources managed by the same lock manager (FLoM *daemon*).
+**libflom** is the FLoM API library you can use to develop your own application using C or C++ language. Using **libflom** you can synchronize your own C or C++ application with shell scripts/commands that use **flom** command: you can share the same resources managed by the same lock manager (FLoM *daemon*).
 FLoM API documentation is available:

 * online: http://flom.sourceforge.net/
@@ -11,13 +11,13 @@
 * tarball: doc/examples directory
 * on your system (see [installation]): /usr/local/share/doc/flom/examples/

-## The libflom programming kompass ##
+## The libflom programming kompass for C developers ##

 FLoM API is very easy to understand and use; these are the basic concepts:

 * *flom.h* is the header file you must include
 * *flom_handle_t* is the data type you must use to communicate with FLoM (you must treat this type of objects as opaque objects: for every useful property there's a getter/setter method and you don't have to mind what's the meaning of the object content)
-* you can use a "static programming style", allocating *flom_handle_t* objects on the stack or you can use a "dynamic programming style", allocating *flom_handle_t* object in the heap: that's your choice and FLoM API does not force you to use a specific style
+* you can use a "static programming style", allocating *flom_handle_t* objects on the stack or you can use a "dynamic programming style", allocating *flom_handle_t* objects in the heap: that's your choice and FLoM API does not force you to use a specific style

 ### Static programming style example ###

@@ -57,3 +57,41 @@

 * [function](http://flom.sourceforge.net/globals_func.html) API page
 * [flom_handle.h](https://sourceforge.net/p/flom/code/ci/master/tree/src/flom_handle.h) header file
+
+## The libflom programming kompass for C++ developers ##
+
+FLoM API is very easy to understand and use; these are the basic concepts:
+
+* *flom.hh* is the header file you must include
+* *FlomHandle* is the class you must use to communicate with FLoM (you must treat this type of objects as opaque objects: for every useful property there's a getter/setter method and you don't have to mind what's the meaning of the object content)
+* you can use a "static programming style", allocating *FlomHandle* objects on the stack or you can use a "dynamic programming style", allocating *FlomHandle* objects in the heap: that's your choice and FLoM API does not force you to use a specific style
+
+### Static programming style example ###
+
+[BasicStatic.cc](https://sourceforge.net/p/flom/code/ci/master/tree/doc/examples/BasicStatic.cc) example can be considered the *hello world FLoM equivalent* for *static programming style*:
+1. allocate a *FlomHandle* object on the stack declaring it
+2. serialize your program using method *lock()*
+3. do everything your program must perform inside the serialization window
+5. deserialize your program using method *unlock()*
+
+**Note:** C++ clean-ups every statically initialized *FlomHandle* object for you: you don't have to mind about memory leaks.
+
+### Dynamic programming style example ###
+
+[BasicDynamic.cc](https://sourceforge.net/p/flom/code/ci/master/tree/doc/examples/BasicDynamic.cc) example can be considered the *hello world FLoM equivalent* for *dynamic programming style*:
+1. declare a *FlomHandle* object pointer
+2. create a new object using *new*
+3. serialize your program using method *lock()*
+4. do everything your program must perform inside the serialization window
+5. deserialize your program using method *unlock()*
+6. delete the object using *delete*
+
+**Note:** you must delete every created *FlomHandle* object; if you don't delete every object you will generate memory leaks.
+
+## Advanced examples ##
+Basic examples do not explain as you can specify the name of the logical resource, the quantity of a numerical resource and the other parameters you typically use with **flom** command line.
+[AdvancedStatic.cc](https://sourceforge.net/p/flom/code/ci/master/tree/doc/examples/AdvancedStatic.cc) and [AdvancedDynamic.cc](https://sourceforge.net/p/flom/code/ci/master/tree/doc/examples/AdvancedDynamic.cc) examples show how some properties can be set before entering in the serialization phase.
+The complete list of the available setter/getter methods can be retrieved from:
+
+* [FlomHandle class](http://flom.sourceforge.net/classflom_1_1_flom_handle.html) API page
+* [FlomHandle.hh](https://sourceforge.net/p/flom/code/ci/master/tree/src/FlomHandle.hh) header file

libflom modified by Christian Ferrari

Christian Ferrari — Thu, 11 Dec 2014 22:06:08 -0000

--- v2
+++ v3
@@ -8,10 +8,10 @@

 Some documented usage examples are available inside:

-* tarball: doc/examples directories
+* tarball: doc/examples directory
 * on your system (see [installation]): /usr/local/share/doc/flom/examples/

-## the libflom programming kompass ##
+## The libflom programming kompass ##

 FLoM API is very easy to understand and use; these are the basic concepts:

@@ -41,7 +41,7 @@
 5. deserialize your program using method (function) *flom_handle_unlock*
 6. delete the object using method (function) *flom_handle_delete*

-**Note:** you must delete every created *flom_handle_t* object; if you don't clean-up every object you will generate memory leaks.
+**Note:** you must delete every created *flom_handle_t* object; if you don't delete every object you will generate memory leaks.

 #### Static and dynamic programming styles ####