Converting Old Plugins

In version 0.4.0, eboxy's plugin API has changed in a way that breaks backwards compatibility. This was necessary due to a design flaw in the way strings were returned in 0.3.x (property getter and method functions returned const char * pointers that could never be freed, resulting in memory leaks). The solution was to change these functions to return char *, and make the rule that the caller always frees the returned string if the pointer isn't null. At the same time the opportunity was taken to make property setter functions return an error code, so that eboxy can determine if a plugin object property was set correctly or not.

To bring your own plugins up to date with the changes, you need to do the following: