File: README

package info (click to toggle)
tmfs 3-2
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, bullseye, buster, jessie, jessie-kfreebsd, stretch
  • size: 116 kB
  • ctags: 12
  • sloc: cpp: 132; makefile: 2
file content (71 lines) | stat: -rw-r--r-- 2,217 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
__/\\\\\\\\\\\\\\\___/\\\\____________/\\\\___/\\\\\\\\\\\\\\\______/\\\\\\\\\\\___
 _\///////\\\/////___\/\\\\\\________/\\\\\\__\/\\\///////////_____/\\\/////////\\\_
  _______\/\\\________\/\\\//\\\____/\\\//\\\__\/\\\_______________\//\\\______\///__
   _______\/\\\________\/\\\\///\\\/\\\/_\/\\\__\/\\\\\\\\\\\________\////\\\_________
    _______\/\\\________\/\\\__\///\\\/___\/\\\__\/\\\///////____________\////\\\______
     _______\/\\\________\/\\\____\///_____\/\\\__\/\\\______________________\////\\\___
      _______\/\\\________\/\\\_____________\/\\\__\/\\\_______________/\\\______\//\\\__
       _______\/\\\________\/\\\_____________\/\\\__\/\\\______________\///\\\\\\\\\\\/___
        _______\///_________\///______________\///___\///_________________\///////////_____



Time Machine File System is a read-only virtual filesystem which helps you to
read your Apple's time machine backup.

This filesystem does not targets performances, it has been written for a friend who
has lost his macbook and wants to recover its data on Linux.

It's actually not perfect, feel free to report bugs or suggestions at
https://github.com/abique/tmfs/issues

Enjoy!


How to use it ?
~~~~~~~~~~~~~~~

First you have to mount your HFS partition, by doing something like:
mount /dev/sdXX /mnt/hfs-root

then do as root:

tmfs /mnt/hfs-root /mnt/tm-root -ouid=$(id -u my_user),gid=$(id -g my_user),allow_other

then as a normal user, go to the directory /mnt/tm-root/ and enjoy your data! :-)


Dependancies
~~~~~~~~~~~~

 - C++
 - cmake >= 2.8
 - boost >= 1.46.0
 - fuse


How to build and install it ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr/local ..
make
DESTDIR=install-test make install
# then if the installation looks ok to you in install-test/ do make install as root
su
make install


Internals
~~~~~~~~~

Time Machine structure :

${hfs_root}/Backups.backupdb/${comp_name}/${date}/${disk_name}/ <- snapshot root
${hfs_root}/Backups.backupdb/${comp_name}/${date}/${disk_name}/.../Folder => hardlink count = dir_id
${hfs_root}/.HFS+ Private Directory Data/dir_${dir_id}/ <- real folder

Our representation :

/${comp_name}/${date}/${disk_name}/${Real root}