taskSavannah Administration - Tasks: task #5540, Submission of c++ library for...

 
 

task #5540: Submission of c++ library for object persistence

Submitter:  ElaineTsiang YueLien <elainety>
Submitted:  Tue 09 May 2006 07:30:17 PM UTC
   
 
Should Start On:  Tue 09 May 2006 07:00:00 AM UTC Should be Finished on:  Fri 19 May 2006 07:00:00 AM UTC
Category:  Project Approval Priority:  * 5 - Normal
Status:  Done Privacy:  Public
Assigned to:  kickino Open/Closed:  Closed
* Mandatory Fields

Add a New Comment Rich Markup
   

Tue 23 May 2006 08:13:00 PM UTC, comment #5: 

Hi,

I have approved your project.  You will receive an automated e-mail containing detailed information about the approval.

Regards.

Sebastian Wieseler <kickino>
Fri 19 May 2006 03:16:27 AM UTC, comment #4: 

Hi,

I have COPYING in the top directory libpersist/ now.

New tarball at http://www.gnutopia.org/libpersist/libpersist.tgz.

Cheers,

ElaineTsiang YueLien <elainety>
Thu 18 May 2006 04:58:28 PM UTC, comment #3: 

Hello.

I'll see this messages without any notifications ;-)

Furthermore, your project needs also a COPYING/LICENSE file in ./
and then please provide me with an updated tarball, so that I can have a look at it again..

Thanks.

Sebastian Wieseler <kickino>
Wed 17 May 2006 11:02:18 PM UTC, comment #2: 

Hi Sebastian,

COPYING/LICENSE will be part of packaging. But I'll put a copy in the doc/ area also before I package.

A lot of the code (more than the library proper) are example derived classes and programs. So they are in doc/examples, hence the .C and .H files. I think examples are especially useful for demonstrating how to use a library.

Aside from the talk, I don't have documentation in any usual form yet.

I am sending you a message that this is here. Let me know if that's not necessary.

Cheers,

ElaineTsiang YueLien <elainety>
Wed 17 May 2006 09:20:24 PM UTC, comment #1: 

Hi,
I'm evaluating the project you submitted for approval in Savannah.

Please include a COPYING/LICENSE into your project - http://www.gnu.org/licenses/gpl.txt


Furthermore, why do you include *c and *h files into your doc/ directory? Do you have got any documentation right now?

Regards,

Sebastian Wieseler <kickino>
Tue 09 May 2006 07:30:17 PM UTC, original submission:  

A new project has been registered at Savannah
The project account will remain inactive until a site admin approve or discard the registration.


######### REGISTRATION ADMINISTRATION #########

While this item will be useful to track the registration process, approving or discarding the registration must be done using the specific "Group Administration" page, accessible only to site administrators, effectively logged as site administrators (superuser):

  <https://savannah.nongnu.org/siteadmin/groupedit.php?group_id=8544>


######### REGISTRATION DETAILS #########

Full Name:
----------
  c++ library for object persistence

System Group Name:
-----------------
  libpersist

Type:
-----
  non-GNU software & documentation

License:
--------
  GNU General Public License V2 or later

Description:
------------
  ibpersist is a small library of c++ base classes and templates providing the capability to store and load objects in their entirety across executions. It also provides for object relocation between threads in a NUMA (non-uniform memory access) parallel processing environment.

libpersist was written for use in simulations, where software objects often correspond to simulated objects that are connected to or contained within others. During the build phase, the objects are instantiated, then stored to disk. In the operation phase, the objects are reloaded. The objects are usually built once, and operated many times with variations in inputs or parameters. There is usually no high throughput requirements during the build phase of a simulator. High throughput, however, becomes the most important issue in actual simulation runs.

The core idea is that objects stored to disk as POD are re-constructed as objects. This re-construction is aided by three id-based reference/handler template classes. They replace POPs (plain old pointers) for embedding objects in other objects. Together with supporting template functions, these reference classes relieve the user from the drudgery of explicitly coding for object management for every relevant object.

In a NUMA environment, threads can be made to execute on specified processors and allocate memory from specified memory blocks. This means objects should be relocated to the thread that will execute their member functions. Relocation is a special case of persistence, requiring re-construction after the POD has been moved in memory. After all objects have been relocated to their target memories, all references to the objects must be swizzled (their ids resolved to their addresses), so that they can be de-referenced efficiently like POPs.

libpersist does assume the use of threads, which share a common virtual address space, so that POPs are valid in all threads. It provides an in-memory object manager which keeps a hash table of object id to address translations. This means all objects are accessible in all threads. libpersist does not impose any access restriction. But users can impose their own.

The use of NUMA and threads is NOT part of libpersist. But example derived classes and programs, included as part of the documentation, demonstrate the use of libpersist in NUMA threads.

http://www.gnutopia.org/libpersist/Talk.tar.gz is the tarball of a talk I gave on the concepts of libpersist. It has an openoffice presentation file, together with the version of the source at the time of writing of the talk. The notes for the slides have tags into the source to illustrate the slides in the presentation. Except for minor changes, that version of source will become the release candidate. No makefiles, configuration or other distribution-related files are included. This talk will become the initial version of the libpersist documentation.

Other Software Required:
------------------------
  g++(gcc v3.3) - http://directory.fsf.org/gcc.html

libstdc++.so.5 - http://gcc.gnu.org/onlinedocs/libstdc++/documentation.html

gdbm -  http://directory.fsf.org/gdbm.html
libpthread (glibc v3.3) - http://directory.fsf.org/glibc.html

libnuma - http://packages.debian.org/changelogs/pool/main/n/numactl/numactl_0.9.3-2/libnuma1.copyright

linux kernel 2.6 with NUMA support - http://www.kernel.org/pub/linux/kernel/COPYING

Other Comments:
---------------
  There has been a 'libpersist' already. But I understand it has been folded into Common C++. The ideas for persistence of this libpersist are orthogonal to the ideas in Common C++. This libpersist is also very narrowly focused on object persistence and nothing else. It may have more general applicability than in simulations. I hope others will discover other uses for it.

I have developed libpersist in the environment of the amd64 port of Debian sarge. I hope other contributors can test it on other platforms.]



ElaineTsiang YueLien <elainety>

 

(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach Files:
   
   
Comment:
   

No files currently attached

 

Depends on the following items: None found

Items that depend on this one: None found

 

CC list is empty

 

There are 0 votes so far. Votes easily highlight which items people would like to see resolved in priority, independently of the priority of the item set by tracker managers.

Only logged-in users can vote.

 

Follow 6 latest changes.

Date Changed by Updated Field Previous Value => Replaced by
2006-05-23 kickino StatusIn Progress Done
    Open/ClosedOpen Closed
2006-05-17 elainety Carbon-Copy- Added -email is unavailable-
2006-05-17 kickino StatusNone In Progress
    Assigned toNone kickino
    Percent Complete0% 90%

Back to the top

Powered by Savane 3.13-02a9.
Corresponding source code