Skip to content

Commit 59e3202

Browse files
author
Kyle Rader
committed
Add sub section for recovering from pre-delete.
1 parent 5a8eeea commit 59e3202

File tree

1 file changed

+29
-7
lines changed

1 file changed

+29
-7
lines changed

docs/troubleshooting.md

+29-7
Original file line numberDiff line numberDiff line change
@@ -4,33 +4,55 @@ Troubleshooting
44
Deleting a VFS for Git repo
55
---------------------------
66

7+
You must follow these steps to delete a VFS for Git repository.
8+
9+
If you have attempted deletion before un-mounting jump to
10+
[Recovering from an attempt to delete without un-mounting](#Recovering-from-an-attempt-to-delete-without-un-mounting).
11+
12+
713
1. Un-mount the repo.
814

915
Since a VFS for Git clone has a running `GVFS.Mount` process to track the
1016
Git index and watch updates from the ProjFS filesystem driver, you must
1117
first run `gvfs unmount` before deleting your repository. This will also
1218
remove the repository from the auto-mount feature of `GVFS.Service`.
1319

14-
Make sure the current working directory of your shell is not in the VFS for Git repo and that no other processes are using files in it. For example:
20+
Make sure the current working directory of your shell is not in the VFS for Git
21+
repo and that no other processes are using files in it. For example:
1522

1623
```
1724
C:\Users\you\big_repo\src\> cd ..\..
1825
C:\Users\you\> gvfs unmount big_repo
1926
```
2027
21-
If you have deleted the enlistment or its `.gvfs` folder, then you will
22-
likely see alerts saying "Failed to auto-mount at path `X`". To manually remove
23-
this repo from the auto-mount feature, remove the appropriate line
24-
from the `C:\ProgramData\GVFS\GVFS.Service\repo-registry` file.
25-
2628
1. Clean up the remaining folder. (Do not try to delete the repo before it is un mounted.)
2729
28-
Once un-mounted you can fully clean up the old repo by deleteing it. Following the example from above:
30+
Once un-mounted you can fully clean up the old repo by deleteing it.
31+
Following the example from above:
2932
3033
```
3134
C:\Users\you\> rmdir /S /Q big_repo
3235
```
3336
37+
### Recovering from an attempt to delete without un-mounting
38+
39+
If you have attempted to delete the repo or its `.gvfs` folder, then you will
40+
likely see alerts saying "Failed to auto-mount at path `X`".
41+
42+
1. Manually remove this repo from the auto-mount feature, remove the appropriate line
43+
from the `C:\ProgramData\GVFS\GVFS.Service\repo-registry` file.
44+
45+
1. Ensure there is no currently running mount process for the repo.
46+
1. Open Task Manager.
47+
1. Go the `Details` tab.
48+
1. Right click in the header row (on `Name` for instance) to choose `Select Columns`.
49+
1. Check the `Command line` column which will show the full command line for each process.
50+
1. Look for a `GVFS.Mount.exe` process that has your repo in question in the command line arguments.
51+
1. If you find said process, right click and choose `End Task` to end it.
52+
53+
1. Proceed with removing the directory as described above to clean up the folder
54+
with `rmdir /S /Q REPO`.
55+
3456
Upgrade
3557
-------
3658

0 commit comments

Comments
 (0)