unburden-home-dir(1)

unburden-home-dir1

Unburdens home directories from caches and trashes

Usage

Overview

unburden-home-dir unburdens the home directory from files and directory which cause high I/O or disk usage but are neither important if they are lost, e.g. caches or trash directory.

When being run it moves the files and directories given in the configuration file to a location outside the home directory, e.g. /tmp or /scratch, and puts appropriate symbolic links in the home directory instead.

Options

-b

use the given string as basename instead of "unburden-home-dir".

-c

read an additional configuration file.

-C

read only the given configuration file

-f

just unburden those directory matched by the given filter (a perl regular expression) - it matches the already unburdened directories if used together with -u.

-F

Do not check for files in use with lsof before (re)moving files.

-l

read an additional list file

-L

read only the given list file

-n

dry run (show what would be done)

-u

undo (reverse the functionality and put stuff back into the home directory)

-h, --help

show this help

--version

show the program's version

Examples

Example configuration files can be found at /usr/share/doc/unburden-home-dir/examples/ on Debian-based systems and in the etc/ directory of the source tar ball.

Files

/etc/unburden-home-dir, /etc/unburden-home-dir.list, ~/.unburden-home-dir, ~/.unburden-home-dir.list, ~/.config/unburden-home-dir/config, ~/.config/unburden-home-dir/list, /etc/default/unburden-home-dir, /etc/X11/Xsession.d/95unburden-home-dir

Read the documentation at either /usr/share/doc/unburden-home-dir/html/ on debianoid installations, at https://unburden-home-dir.readthedocs.io/ online, or in the docs/ directory in the source tar ball for an explanation of these files.

Releases

6 releases since Debian 7 (Wheezy); the text changed 5 times.

  1. 7
  2. 8
  3. 9
  4. 10
  5. 11
  6. 12

-C since Debian 8 (Jessie); -L since Debian 8 (Jessie); -b since Debian 8 (Jessie); -c since Debian 8 (Jessie); -l since Debian 8 (Jessie).

Author

Unburden Home Dir is written and maintained by Axel Beckert [email protected].

License

Unburden Home Dir is available under the terms of the GNU General Public License (GPL) version 2 or any later version at your option.

From unburden-home-dir 0.4.2 in Debian 12 (Bookworm). Parsed by carta from the page's man source.