"credential-cache unavailable; no unix socket support"

[hickford]

I tried to run git-credential-cache but got an error:

> git credential-cache
fatal: credential-cache unavailable; no unix socket support

Others have reported the same error https://stackoverflow.com/questions/67951554/error-fatal-credential-cache-unavailable-no-unix-socket-support

A workaround is to install and configure Git Credential Manager git-credential-manager-core --configure. The default credential store Windows Credential Manager works well.

---

Setup

• Which version of Git for Windows are you using? Is it 32-bit or 64-bit?

$ git --version --build-options
git version 2.36.1.windows.1
cpu: x86_64
built from commit: e2ff68a2d1426758c78d023f863bfa1e03cbc768
sizeof-long: 4
sizeof-size_t: 8
shell-path: /bin/sh
feature: fsmonitor--daemon

• Which version of Windows are you running? Vista, 7, 8, 10? Is it 32-bit or 64-bit?

$ cmd.exe /c ver
Microsoft Windows [Version 10.0.19043.1682]

[dscho]

fatal: credential-cache unavailable; no unix socket support

Well, it is true. Windows does not have Unix socket support in general. As per this comment:

echnically, since Git v2.34.0, git-credential-cache.exe can be built and run on Windows. Unix Sockets support has been introduce into Windows. The problem is that you need Windows 10 build 17061 or later, and Git for Windows still supports even Vista (although it has been announced that Git for Windows will drop supporting Vista really soon now).

Now, the question is: how much are you interested in getting Git for Windows to support credential-cache on Windows versions that support Unix sockets @hickford? Interested enough to work on a PullRequest? If so, I will be glad to assist, but I won't be able to justify the time to work on it myself.

[hickford]

How might that work? I don't have much C experience. Is it possible to change an optional compile-time dependency to a conditional runtime dependency? Or would Git for Windows have to compile credential-cache with and without sockets, and install the appropriate copy for the system?

[rimrul]

It is possible to query for unix socket support at runtime and we have ways to load CRT functions at runtime if available, so that approach is theoretically feasible.

[hickford]

ways to load CRT functions at runtime if available

@rimrul Do you have any examples to follow?

The good news is that credential-cache is confirmed to function on Windows if compiled (thanks @carenas).

[rimrul]

Yes, of course. Sorry for not providing you with more actionable info on this.

We have the macros DECLARE_PROC_ADDR() and INIT_PROC_ADDR() defined in compat/win32/lazyload.h.

You can see them in use in t/helper/test-drop-caches.c, compat/winansi.c, compat/win32/trace2_win32_process_info.c and two times in compat/mingw.c.

[hickford]

@rimrul interesting. This seems slightly different. If I understand correctly, the winsock2.h socket function in Ws2_32.dll is available on all versions of Windows. What's missing in older versions is header afunix.h with struct sockaddr_un.

What happens at runtime if you build with sockets on Windows 10 then try to run on Windows 7?

According to the docs above, the socket function should return error INVALID_SOCKET (specific error code WSAGetLastError). But will the application even start?

[dscho]

What happens at runtime if you build with sockets on Windows 10 then try to run on Windows 7?

@hickford It won't work. Likewise if you run on older Windows 10 that lack support for AF_UNIX. Something we need to test specifically, to ensure that the users will see a helpful error message (and not, say, a crash).