LibraryUnload fails

Question

I can load my library, but I cannot unload it with LibraryUnload. I do have a void WolframLibrary_uninitialize(WolframLibraryData libData) (which does nothing). I get the following error:

LibraryFunction::unloadlib: The library "/my/library.so" cannot be unloaded.

I am not loading any function after loading the library. The OS is Linux x86_64.

I don't seem to be able to unload not even the demo library:

LibraryLoad@"demo"
LibraryUnload@%

This gets me the same error.

EDIT: As worked out by Szabolcs and halirutan, I need to load one function at least (LibraryFunctionLoad) to have the initialization function called, and so being able to call LibraryUnload successfully. Yet, my ultimate goal is to be able to reload a new build of the library: this seems impossible because calling LibraryUnload doesn't actually close the handle of the library, and further calls to LibraryFunctionLoad reuse it. I checked with lsof, and if I delete the library and try to reload it I get that the new file is ignored and instead a handle to the old file (tagged correctly as DEL in lsof) is kept.

Answer 1

Todd Gayley once mentioned that LibraryLoad is for pre-loading depend libraries you need. So for instance, if you write a function which needs some numeric-library, you can load this before calling the functions in your library.

You don't need to pre-load the WolframLibrary library you have developed because you implicitly load it by loading the functions in it.

Therefore, I believe the solution to your problem is that you have to call LibraryFunctionLoad on one of the functions you are developing and after that LibraryUnload should work as expected.

Furthermore, you should unload all functions with LibraryFunctionUnload before unloading the library.

Answer 2

(Information worth sharing for Windows users despite the linux tag in original question.)

As this comment mentioned, there is an additional problem on Windows platform, which I will try to describe here, as long as a solution to it.

The LibraryUnload failure problem on Windows

Suppose one has a "standalone" library myLib.dll, which has nothing to do with Mathematica or LibraryLink. Then one has a libLink.dll, which uses myLib and provides functions to Mathematica through LibraryLink.

As libLink depends on myLib, one may try to pre-load myLib before loading libLink, and it works with no problem:

LibraryLoad["myLib.dll"]
myfunc = LibraryFunctionLoad["libLink.dll", ... ]

But then, on Windows, if one tries to unload them with

LibraryUnload["libLink.dll"]
LibraryUnload["myLib.dll"]

The former one will succeed but the latter one will fail with an error message

LibraryFunction::unloadlib: The library myLib.dll cannot be unloaded.

Using tools such as Process Explorer one can see the file's handle has not been released by the kernel.

The solution

The described problem can be frustrating when one is developing myLib. One has to kill the kernel each time before re-compiling myLib. The solution, which was found and kindly shared to me by ilian (who has very generously reviewed my code and looked into the problem.), is

NOT to manually pre-load myLib with LibraryLoad at first place.

Instead, one may modify the OS environment so Windows can find all the depended libraries and manage them automatically:

SetEnvironment["PATH" -> Environment["PATH"] <> ";" <> "path_to_folder_of_myLib.dll"]
myfunc = LibraryFunctionLoad["libLink.dll", ... ]

Unloading will now be as simple as:

LibraryUnload["libLink.dll"]

After that, if there is no other reference to myLib.dll, it will be editable.