user.callback

Because Back In Time can’t be a swiss knife with all the functionalities for everyone needs, I decided to add a callback. This callback is “$XDG_CONFIG_HOME/backintime/user.callback” (by default $XDG_CONFIG_HOME is ~/.config). It can be anything your shell can execute.

If this callback exists it is called at different steps of “take snapshot” process and receive several arguments. The first argument is the reason:

  • 1 – Backup process begins.
  • 2 – Backup process ends.
  • 3 – A new snapshot was taken. The extra arguments are snapshot ID and snapshot path.
  • 4 – There was an error. The second argument is the error code:
    • 1 – The application is not configured
    • 2 – A “take snapshot” process is already running.
    • 3 – Can’t find snapshots directory (is it on a removable drive ?).
    • 4 – A snapshot for “now” already exist.