85 lines
3.1 KiB
Markdown
85 lines
3.1 KiB
Markdown
The following steps are tested on Windows 10 21h1 with Ubuntu 20 and are designed to allow use of the annexed files through both WSL and Windows.
|
|
|
|
** Limitations **
|
|
|
|
* The repository must be created with `annex.tune.objecthashlower=true`.
|
|
* `git annex adjust --unlock` will not work. Unlocked files will work most of the time. Avoid `annex.addunlocked=true` because it is likely to not work.
|
|
|
|
**Setup**
|
|
|
|
* Enable Developer mode in Windows settings so that symlinks can be created without elevated privileges.
|
|
* Mount the NTFS drive with metadata option. [`/etc/wsl.conf`](https://docs.microsoft.com/en-us/windows/wsl/wsl-config) can be used or a line such as `C: /mnt/c drvfs metadata` can be added in `/etc/fstab`.
|
|
* Initialize the repo.
|
|
* If the repository is created by cloning, create local git-annex branch from the remote branch and remove the origin remote before `git annex init`.
|
|
* Set `git config annex.crippledfilesystem true` immediately after `git annex init`.
|
|
* Add the origin remote back if it was previously removed.
|
|
* Safety of locked files will require these settings and scripts
|
|
* `git config annex.thawcontent-command 'wsl-thawcontent %path'`
|
|
|
|
#!/usr/bin/env bash
|
|
|
|
if [ -f "$1" ]; then
|
|
PERM='(DE,WD,AD)'
|
|
elif [ -d "$1" ]; then
|
|
PERM='(DE,DC,WD,AD)'
|
|
else
|
|
exit 0
|
|
fi
|
|
|
|
OUTPUT="$(icacls.exe "$(wslpath -w "$1")" /grant "Authenticated Users:$PERM")"
|
|
|
|
if [ "$?" -ne 0 ]; then
|
|
echo "$OUTPUT"
|
|
exit 1
|
|
fi
|
|
|
|
* `git config annex.freezecontent-command 'wsl-freezecontent %path'`
|
|
|
|
#!/usr/bin/env bash
|
|
|
|
if [ -f "$1" ]; then
|
|
if \[[ "$1" == *.git/annex/objects/* ]]; then
|
|
PERM='(DE,WD,AD)'
|
|
else
|
|
PERM='(WD,AD)'
|
|
fi
|
|
elif [ -d "$1" ]; then
|
|
PERM='(DE,DC,WD,AD)'
|
|
else
|
|
exit 0
|
|
fi
|
|
|
|
OUTPUT="$(icacls.exe "$(wslpath -w "$1")" /deny "Authenticated Users:$PERM")"
|
|
|
|
if [ "$?" -ne 0 ]; then
|
|
echo "$OUTPUT"
|
|
exit 1
|
|
fi
|
|
|
|
** Usage tips **
|
|
|
|
* Symlinks are invalid in Windows if created before the target file exists, such as after `git annex add` or `git annex get`. This can be fixed by recreating them with any method, such as delete them and `git checkout`. Below is a sample script.
|
|
|
|
#!/usr/bin/env python3
|
|
|
|
import pathlib
|
|
import os
|
|
|
|
def do(p):
|
|
for c in list(p.iterdir()):
|
|
if c.is_symlink() and c.resolve().exists():
|
|
target = os.readlink(c) # use readlink here to get the relative link path
|
|
c.unlink()
|
|
c.symlink_to(target)
|
|
elif c.is_dir() and c.name != '.git':
|
|
do(c)
|
|
|
|
do(pathlib.Path('.'))
|
|
|
|
* Sometimes there will SQLite errors using multiple jobs but retrying will work most of the time.
|
|
|
|
** Related bugs **
|
|
|
|
* [[bugs/WSL_adjusted_braches__58___smudge_fails_with_sqlite_thread_crashed_-_locking_protocol]]
|
|
* [[bugs/WSL1__58___git-annex-add_fails_in_DrvFs_filesystem]]
|
|
* [[bugs/problems_with_SSH_and_relative_paths]]
|