Beast cleaner is a simple console program to find and delete stalled, not maintained by packages files on FreeBSD. The files are deleted one by one, thus it is possible to delete only selected ones. If you read this file on GitHub: please don't send pull requests here. All will be automatically closed. Any code propositions should go to the Fossil repository.
WARNING: The program is very simple and can produce false-positives results. It is strongly recommended to create a backup or snapshot before you start deleting files. Also, be sure to know what you are deleting. ;)
To delete stalled files, you will need to run the program with root privileges. They are not needed to just find the stalled files.
There are available binary packages for the newest stable FreeBSD 64-bit on the download page. If you want to use Nish on different version or architecture, you have to build it from the source.
You will need:
You can install them manually or by using Nimble.
In that second option, type nimble install https://github.com/thindil/beastcleaner
to
install the program and all dependencies. Generally it is recommended to use
nimble release
to build the project in release (optimized) mode or
nimble debug
to build it in the debug mode.
To install nimble on FreeBSD, type: pkg install nimble
.
- To find only the stalled files, run the program without any arguments. For
example:
./beastcleaner
. It will print the list vialess
command. - If you want to delete stalled files, you have to run the program as root
user with argument clean. For example:
sudo ./beastcleaner clean
. You will need to confirm each deletion of a file from the list. - You can set the location of the file with the list of stalled files by adding
option
--fileslist
to the program, for example:./beastcleaner --fileslist=thelist.txt
. - If you provide the file with the list of stalled files when deleting the
stalled files, via
--fileslist
option, it will be used instead of generating the new one.
The project is released under 3-Clause BSD license.
That's all for now, as usual, I have probably forgotten about something important ;)
Bartek thindil Jasicki