Tookmund / Swapspace

A fork of Jeroen T. Vermeulen's excellent dynamic swap space manager
GNU General Public License v2.0
139 stars 13 forks source link

Documentation #22

Open wmertens opened 4 years ago

wmertens commented 4 years ago

The description of the algorithm is spread throughout the source, it would be nice to aggregate it into the readme.

There's also a very interesting diatribe at https://github.com/Tookmund/Swapspace/blob/master/src/main.c#L160 that would be worth moving to the readme or a separate .md file

jtv commented 4 years ago

@wmertens thanks, I'm delighted that somebody remarked on it after those 15 years or so. :-)

Tookmund commented 4 years ago

It would certainly be useful to have all the documentation in one place, I'll have to look into it.

Tookmund commented 4 years ago

@wmertens does doc/technicaldetails.md cover what you want from an algorithm description?

I split the documentation up a while ago and I think that may have just made it less discoverable. I'm going to mention these files in the README, but it might be a better idea in the long run to just merge them all back together. I'll think about it.

wmertens commented 4 years ago

Funny, I just missed the doc directory entirely. I suppose I thought it contained the machinery for the manpages.

Yes, linking to the technical details from the readme would be great, but there is still information missing.

My problem was that I ended up having 12GB of swap, largely unused, and I was wondering how long it would take for it to drop back.

I also had no clue about the maximum of 32 swap files in the Linux kernel.

I ended up setting my swap file maximum to 500MB, and the cooldown to 50s, which seems to work well on my laptop with 8GB RAM and 60GB SSD disk (dual boot, a loaner).

Still, those settings aren't for everyone, and it would be good to have a list of trade-offs.