jlockert/tmutils
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update README

Browse Source 
Align README with new directions for each utility.
This commit is contained in:
Lee Ockert
2023-10-23 04:55:00 +00:00
committed by GitHub
parent 8c2384acba
commit 90e61f7094
1 changed files with 28 additions and 24 deletions
Download Patch File Download Diff File Expand all files Collapse all files

52
README.md
View File

@ -4,7 +4,7 @@
**Installation** **Installation**
---------------- ----------------
Simply save the utility in your system path and mark it as executable. Simply save the utilities in your path and mark them as executable.
If you don't know your system path, you can find it with this Terminal command: If you don't know your system path, you can find it with this Terminal command:
@ -13,6 +13,7 @@ If you don't know your system path, you can find it with this Terminal command:
To mark a utility as executable, use the `chmod` command: To mark a utility as executable, use the `chmod` command:
chmod +x tmimport.sh chmod +x tmimport.sh
chmod +x tmbless.sh
chmod +x dirdedupe.sh chmod +x dirdedupe.sh
If you're still lost, do this: If you're still lost, do this:
@ -42,20 +43,20 @@ ______________________________________________________________________________
DESCRIPTION DESCRIPTION
Time Machine Importer modifies the metadata of a backup drive to match the Time Machine Importer attempts to inherit the backup history of a backup
current computer's model and unique identifiers (primary MAC address and drive. If the backup drive is not paired to the current computer, Time
hardware platform UUID/provisioning UDID) and attempts to 'inherit' the Machine Importer will attempt to pair the drive with the current computer
backup history. by modifying the model, MAC address, and UUID/UDID reflected in the
metadata of the backup drive.
The backup drive should be specified by disk or volume name (or path) or The backup drive should be specified by disk or volume name (or path) or
the mount point of the backup drive. If Time Machine Importer cannot find the mount point of the backup drive. For example:
an appropriate disk volume or mount point, it will check to see if the - ./tmimport.sh /dev/disk1s1
specified directory is a valid Backups.backupdb location (or a machine - ./tmimport.sh /Volumes/TMBACKUP
directory under one).
While some additional heuristics may assist in identifying a backup drive
A future version may attempt to detect HFS+ or APFS partitions serving as that is specified in other ways, they are untested and not guaranteed
backup drives, and, if a backup drive is specified as a device path, it to work correctly.
will automagically choose the correct backup path.
______________________________________________________________________________ ______________________________________________________________________________
@ -69,11 +70,14 @@ ______________________________________________________________________________
DESCRIPTION DESCRIPTION
Time Machine Blessing modifies the metadata of a snapshot directory Time Machine Bless marks a snapshot directory as valid and recognizable
(i.e., a datestamped directory inside a Backups.backupdb/machinename/ by Time Machine.
directory) so that the metadata reflects a backup completed on that date
and the metadata of the top-level drive matches that of the current drive. It does this by modifying the metadata of the snapshot directory so that
the it accurately reflects the date the snapshot was created and the
metadata of the 'drive' subdirectory within that snapshot directory
matches the current drive.
These modifications should allow restoration of files within the Time These modifications should allow restoration of files within the Time
Machine restore UI. Machine restore UI.
______________________________________________________________________________ ______________________________________________________________________________
@ -85,13 +89,13 @@ ______________________________________________________________________________
USAGE USAGE
dirdedupe.sh [--execute] masterdir shadowdir dirdedupe.sh [--execute] masterdir subjectdir
DESCRIPTION DESCRIPTION
For each file in shadowdir, replace it with a hard link to the matching file For each file in subjectdir, replace it with a hard link to the matching
(if any) in masterdir. A file will be considered a match if, and only if, file (if any) in masterdir. A file will be considered a match if, and
it shares the same file name, relative path, and contents. only if, it shares the same file name, relative path, and contents.
OPTIONS OPTIONS