I had some problems figuring out how csd-housekeeping works:
It is a bit unclear which volumes are checked and what thresholds are configured by default and looked for a documentation.
The README states:
Every minute, the plugin checks the mounted volume to see if they have low disk space, according to the settings stored in org.cinnamon.settings-daemon.plugins.housekeeping.
The plugin shows a notification when a volume is full.
See:
|
**low disk space** |
|
|
|
Every minute, the plugin checks the mounted volume to see if they have low disk space, according to the settings stored in ``org.cinnamon.settings-daemon.plugins.housekeeping``. |
|
|
|
The plugin shows a notification when a volume is full. |
I found the following (defaults?):
❯ gsettings list-recursively org.cinnamon.settings-daemon.plugins.housekeeping
org.cinnamon.settings-daemon.plugins.housekeeping free-percent-notify 0.050000000000000003
org.cinnamon.settings-daemon.plugins.housekeeping free-percent-notify-again 0.01
org.cinnamon.settings-daemon.plugins.housekeeping free-size-gb-no-notify 1
org.cinnamon.settings-daemon.plugins.housekeeping ignore-paths @as []
org.cinnamon.settings-daemon.plugins.housekeeping min-notify-period 10
I am also not sure if an ordinary user knows where to look for "the settings stored in org.cinnamon.settings-daemon.plugins.housekeeping".
(At least I could not find anything about it in the User Guide or Troubleshooting Guide in the Linux Mint Documentation).
I found some comments / a short description of the settings in the source code, see: https://github.com/linuxmint/cinnamon-settings-daemon/blob/master/data/org.cinnamon.settings-daemon.plugins.housekeeping.gschema.xml.in.in
So we have:
- free-percent-notify: Percentage free space threshold for initial warning of low disk space. If the percentage free space drops below this, a warning will be shown.
- free-percent-notify-again: Specify the percentage that the free disk space should reduce by before issuing a subsequent warning.
- free-size-gb-no-notify: Specify an amount in GB. If the amount of free space is more than this, no warning will be shown.
- ignore-paths: Specify a list of mount paths to ignore when they run low on space.
- min-notify-period: Specify a time in minutes. Subsequent warnings for a volume will not appear more often than this period.
If I read this correctly , a "Low Disk Space" warning notification is issued for a volume when the volume has less than 5% (free-percent-notify) and less than 1 GB (free-size-gb-no-notify) free disk space available, right?
The notification shows an "Ignore" button and is not immediately clear what it means.
What happens, if you (do not) press that button?
I assume that closing the notification with "X" and pressing "Ignore" does the same and means something like "I did see the warning and decided to do nothing about it".
I will still get a warning if the free disk space drops below "free-percent-notify-again", right?
It is also not obvious if and when a notification is ever shown again.
In my tests "min-notify-period" had no effect.
As far as I can tell the ("free-percent-notify") notification is only shown once per session and the warning is only shown again, if the user logs out and in again, but not in the running session.
The consequence is, that if the user frees up some disk space after a warning is shown and the disk space drops below "free-percent-notify" threshold again, no notification is shown.
I think this is separate bug, but first we should document the expected behavior.
I also noticed that on some systems "Examine" is shown and on others not.
After browsing the source, I figured out that the "Examine" is only shown if "Baobat" is installed.
This should also be mentioned somewhere.
And finally: If I mount a volume in a running session, the volume does not seem to be checked.
It this expected? Can we force csd-housekeeping to reload the mounted volumes?
(I just tried kill -SIGHUP $(pgrep csd-housekeepin) and this seems to do the trick.)
Sorry for the long post, but all this came up while writing this issue and figuring out how things work.
I hope we can use this information to update the documentation somewhere.
Thank you all for developing Linux Mint & Cinnamon! ❤️
I had some problems figuring out how csd-housekeeping works:
It is a bit unclear which volumes are checked and what thresholds are configured by default and looked for a documentation.
The README states:
See:
cinnamon-settings-daemon/README.rst
Lines 54 to 58 in bb4287d
I found the following (defaults?):
I am also not sure if an ordinary user knows where to look for "the settings stored in org.cinnamon.settings-daemon.plugins.housekeeping".
(At least I could not find anything about it in the User Guide or Troubleshooting Guide in the Linux Mint Documentation).
I found some comments / a short description of the settings in the source code, see: https://github.com/linuxmint/cinnamon-settings-daemon/blob/master/data/org.cinnamon.settings-daemon.plugins.housekeeping.gschema.xml.in.in
So we have:
If I read this correctly , a "Low Disk Space" warning notification is issued for a volume when the volume has less than 5% (free-percent-notify) and less than 1 GB (free-size-gb-no-notify) free disk space available, right?
The notification shows an "Ignore" button and is not immediately clear what it means.
What happens, if you (do not) press that button?
I assume that closing the notification with "X" and pressing "Ignore" does the same and means something like "I did see the warning and decided to do nothing about it".
I will still get a warning if the free disk space drops below "free-percent-notify-again", right?
It is also not obvious if and when a notification is ever shown again.
In my tests "min-notify-period" had no effect.
As far as I can tell the ("free-percent-notify") notification is only shown once per session and the warning is only shown again, if the user logs out and in again, but not in the running session.
The consequence is, that if the user frees up some disk space after a warning is shown and the disk space drops below "free-percent-notify" threshold again, no notification is shown.
I think this is separate bug, but first we should document the expected behavior.
I also noticed that on some systems "Examine" is shown and on others not.
After browsing the source, I figured out that the "Examine" is only shown if "Baobat" is installed.
This should also be mentioned somewhere.
And finally: If I mount a volume in a running session, the volume does not seem to be checked.
It this expected? Can we force csd-housekeeping to reload the mounted volumes?
(I just tried
kill -SIGHUP $(pgrep csd-housekeepin)and this seems to do the trick.)Sorry for the long post, but all this came up while writing this issue and figuring out how things work.
I hope we can use this information to update the documentation somewhere.
Thank you all for developing Linux Mint & Cinnamon! ❤️