Raspberry Pi is up and running and currently executing the test programme.
It’s been flawless. Wrote an image of the Pi port of Debian on an SD card, this has gcc, make, nano, etc, on board. Booted perfectly, logged in, transferred the liblfds source code, compiled it all, first time I’ve build on Linux for a bit so fixed one of two bugs (and as ever always surprised that the MS compiler I’m using doesn’t complain when I used undefined enum types – yes, you read that right!)
Fabulous. Got my own tiny form factor 32-bit quad-core ARM platform, for 70 bucks all told. Couldn’t ask for more.
The Raspberry Pi arrived yesterday.
I ordered the wrong type of SD card – d’oh. I should have ordered a micro SD card.
The local water main broke this morning – it’s just been fixed – so I can now ablute and then head out to buy a card.
Directories and filenames are long form, prototypes are short form.
I’ve omitted “multipleconsumer_mutipleproducer” – it’s the default. I might include it in the future, if the addition of other data structure variants would make its use beneficial. Right now it’s not needed, that level of naming complexity does not exist, so it is omitted.
Now I can finally get on with the docs, in their final, proper form.
It’s alphabetic, with least varying parts first.
With lock-free, you basically get three forms of data structures; fully singlethreaded (which isn’t really lock-free, there are no locks), two threaded where one thread writes and the other only reads (say, single producer/consumer queue), and fully multi-threaded (any number of concurrent whatevers).
I’m toying with the idea of adding in single-threaded variants of these data structures.
The outstanding question for me now though is the long form name.
“lfds700_queue_bounded_singleconsumer_singleproducer” needs to be what it is, but do I really want to add “multipleconsumer_multipleproducer” on the end of every fully multi-threaded data structure name?
The Raspberry Pi 2 Model B has a MICRO SD slot, not as SD slot…
Anyone want a very nice 16GB SD card?
So there are data structures and variants upon them, so you can’t just say “queue”. You have to indicate variant.
The current long form versions of the names are;
These forms prefix on all prototypes, i.e.
Obviously, so long a name is awkward.
The public headers and the per-data structure directory will retain the long form name, to aid comprehension. Possibly the filenames will retain the long form too. However, the prototype must be shortened.
Question is, to what?
These following seem to be the three options;
Just finished the first pass of the API docs for queue_spscb 🙂 the first full set of docs for an API.
Still wrestling with one last design question – API names.
For example, we have “lfds700_addonly_singlylinked_list”. So, you know what it is from the name, but the name is long. Currently, that name is fully propagated; the directories have that name, the files have that name, the prototypes have that name.
The reason for it is so people coming to the library can immediately and inherently know what they’re looking at.
I’m thinking though (and this was how it was, until I made the full name fully propagate) I could keep the directory names long form, but change the filenames and prototypes to a shorthand, like this;
Much more compact – but now you rely on the user somewhere seeing the long name, because without it, it’s not lear what that data structure is.
I’ve just experienced a leap second bug!
mySQL when it passes through a leap second goes to 100% CPU on one core.
You have to manually set the date to fix it.
First pass at getting the Windows kernel builds is done, for WDK 7.1 and 8.0.
Reinstalled VC2012 on a fresh VM and have just brought all the VC solutions back up to date.
Now making a clone of the VC2012 VM and adding WDK 8.0 to it, for that build.
After that, onto an Amazon Linux VM for Linux user-mode and kernel-mode.