@@ -29,30 +29,25 @@ the user who started the WSL environment. In practice, *if you allow someone els
29
29
log in to your WSL environment remotely, they may be able to access the SSH keys stored in
30
30
your Pageant with ` weasel-pageant ` .* This is a fundamental feature of WSL; if you
31
31
are not sure of what you're doing, do not allow remote access to your WSL environment
32
- (i.e . by starting an SSH server).
32
+ (e.g . by starting an SSH server).
33
33
34
- ** COMPATIBILITY NOTICE:** ` weasel-pageant ` does not, and will never work on
35
- a version of Windows 10 older than 1703 ("Creators Update"), because
36
- it requires the new [ Windows/Ubuntu interoperability support] ( https://blogs.msdn.microsoft.com/wsl/2016/10/19/windows-and-ubuntu-interoperability/ )
37
- feature shipped with version 1703. It has been verified to work with versions
38
- up to and including 1709 ("Fall Creators Update").
39
-
40
- Non-Ubuntu distributions (available since 1709) have not been tested, but
41
- they should work as well. Please open a GitHub issue if something is broken.
42
-
43
- If you are still using Anniversary Update, you may be able to use the (unrelated)
44
- [ wsl-ssh-pageant] ( https://github.com/benpye/wsl-ssh-pageant ) .
34
+ ` weasel-pageant ` does not work on a version of Windows 10 older
35
+ than 1703 ("Creators Update"), because it requires the
36
+ [ Windows/Ubuntu interoperability support] ( https://blogs.msdn.microsoft.com/wsl/2016/10/19/windows-and-ubuntu-interoperability/ )
37
+ feature shipped with that version. It has been verified to work with versions
38
+ up to and including 1809 ("October 2018 Update").
45
39
46
40
## Installation
47
41
48
42
### From binaries
49
43
50
44
Download the zip file from the [ releases page] ( https://github.com/vuori/weasel-pageant/releases )
51
45
and unpack it in a convenient location * on the Windows part of your drive* .
46
+
52
47
Because WSL can only execute Win32 binaries from ` drvfs ` locations, ` weasel-pageant `
53
48
* will not work* if unpacked inside the WSL filesystem (onto an ` lxfs ` mount).
54
- ( Advanced users may place only ` helper.exe ` on ` drvfs ` , but in general it is easier
55
- to keep the pieces together.)
49
+ Advanced users may place only ` helper.exe ` on ` drvfs ` , but in general it is easier
50
+ to keep the pieces together.
56
51
57
52
### From source
58
53
@@ -66,7 +61,7 @@ A VS2017 project is included. You will need the "Desktop development with C++" a
66
61
` /usr/include ` into ` linux/include ` under the project directory.
67
62
This is not required for the build, but will make Intellisense more useful.
68
63
69
- 3 . Hit Build Solution and both the Linux executable and the Win32 helper will be built.
64
+ 3 . Hit Build Solution. Both the Linux executable and the Win32 helper will be built.
70
65
71
66
If you want to create a binary package, you can use the ` create_pkg.py ` script
72
67
at the root of the project. This should work with Python 3.4 or newer on either
@@ -77,7 +72,7 @@ Visual Studio for the Win32 helper (no Makefile or similar is supplied at the mo
77
72
In theory the helper should be buildable with MinGW-w64 for a fully Linux-based
78
73
build, but this has not been tested.
79
74
80
- The release binaries have been built with VS2017 15.6.0 Preview 5 .0.
75
+ The release binaries have been built with VS2017 15.9.4 Preview 1 .0.
81
76
82
77
## Usage
83
78
@@ -164,7 +159,7 @@ to your shell initialization files (e.g. `.bashrc`).
164
159
* 2018-03-30: 1.1 - Fixed console/agent connection hangs and enabled restarting of the helper.
165
160
** Upgrade note:** remove the ` -a ` flag from the ` weasel-pageant ` command line unless you
166
161
know you need it.
167
- * 2018-12-28 : 1.2b1 (test release) - Probably fixed unexpected exits due to signal handling bug .
162
+ * 2019-01-06 : 1.2 - Fixed unexpected daemon exits caused by a signal handling issue .
168
163
169
164
## Bug reports and contributions
170
165
@@ -179,10 +174,23 @@ Please do not send bug reports by e-mail.
179
174
Pull requests are also welcome, though if you intend to do major changes it's recommended to open an
180
175
issue first.
181
176
177
+ ## Related projects
178
+
179
+ There are several projects that provide similar functionality (I have not tested all
180
+ of these):
181
+
182
+ * [ ssh-pageant] ( https://github.com/cuviper/ssh-pageant ) : the Cygwin program on
183
+ which ` weasel-pageant ` is based on.
184
+ * [ wsl-ssh-pageant] ( https://github.com/benpye/wsl-ssh-pageant ) : a Win32 app that
185
+ uses the Unix domain socket support introduced in Windows 10 1803 to provide
186
+ agent connectivity.
187
+ * [ ssh-agent-wsl] ( https://github.com/rupor-github/ssh-agent-wsl ) : a fork of
188
+ ` weasel-pageant ` that includes support for using keys held by Microsoft's
189
+ SSH Agent service.
182
190
183
191
184
192
------------------------------------------------------------------------------
185
- Copyright 2017, 2018 Valtteri Vuorikoski
193
+ Copyright 2017-2019 Valtteri Vuorikoski
186
194
187
195
Based on ` ssh-pageant ` , copyright (C) 2009-2014 Josh Stone
188
196
0 commit comments