This is an archive of the discontinued LLVM Phabricator instance.

Windows: support `DoLoadImage`
ClosedPublic

Authored by compnerd on Apr 1 2020, 10:06 PM.

Details

Summary

This implements DoLoadImage and UnloadImage in the Windows platform
plugin modelled after the POSIX platform plugin. This was previously
unimplemented and resulted in a difficult to decipher error without any
logging.

This implementation is intended to support enables the use of LLDB's
Swift REPL on Windows.

Paths which are added to the library search path are persistent and
applied to all subsequent loads. This can be adjusted in the future by
storing all the cookies and restoring the path prior to returning from
the helper. However, the dynamic path count makes this a bit more
challenging.

Diff Detail

Event Timeline

compnerd created this revision.Apr 1 2020, 10:06 PM
labath added a subscriber: labath.Apr 2 2020, 2:40 AM

We have some existing tests (functionalities/load_using_paths/TestLoadUsingPaths.py) for this functionality, but they are are all skipped on windows. Can you check if they work now, or create a new test for the subset of functionality which does work?

Ideally, the user input would be converted from UTF-8 to UTF-16.

Would it be possible to do the conversion within lldb (llvm::ConvertUTF8toWide), and pass that as a prebaked string?

compnerd added a comment.EditedApr 2 2020, 9:24 AM

Thanks for the hint about the string conversion, however, I think that it's going to complicate things as the string is going to be a mixture of UTF-8 and UTF-16 content.

As to the testing, functionalities/load_using_paths/TestLoadUsingPaths.py is not applicable to Windows. In fact, I don't really see a good way to really test much of this outside the context of the swift REPL which forces the loading of a DLL which is in fact how I discovered this. If there is an easy way to ensure that the dll that is needed is in the user's PATH, then I suppose creating an empty dll and loading that is theoretically possible, but that too can have a lot of flakiness due to dependencies to build and all.

compnerd updated this revision to Diff 254631.Apr 2 2020, 3:14 PM

Thanks for the hint about the string conversion, however, I think that it's going to complicate things as the string is going to be a mixture of UTF-8 and UTF-16 content.

That's true. Ok, plan B: have clang do the conversion for us. If you form the expression like printf("LoadLibraryW(L\"%s\")", path_in_utf8) then the path will get transformed to utf-16 by the compiler. However the path should also get sanitized/escaped into a form suitable for passing to the C compiler. (godbolt link)

As to the testing, functionalities/load_using_paths/TestLoadUsingPaths.py is not applicable to Windows. In fact, I don't really see a good way to really test much of this outside the context of the swift REPL which forces the loading of a DLL which is in fact how I discovered this. If there is an easy way to ensure that the dll that is needed is in the user's PATH, then I suppose creating an empty dll and loading that is theoretically possible, but that too can have a lot of flakiness due to dependencies to build and all.

Ok, so your patch does not implement that functionality. It does not sound like there's a fundamental limitation there, as you could do the same thing as what the posix code does ( == iterate over the path), but that's fine -- you don't need to implement everything straight away. In that case it would be good to check that the paths argument is empty and return an error instead of attempting to load a random library.

However, I believe you are implementing sufficient functionality for the SBProcess::LoadImage (aka "process load" in CLI) command. So, maybe you could take a look at API/functionalities/load_unload/TestLoadUnload.py and see if anything there can be enabled ? Or (if the test contains too many posix specifics), you could could create a windows version of that test doing something similar.

compnerd added a comment.EditedApr 3 2020, 12:12 PM

Okay, thanks to some help from @JDevlieghere I was able to get a test going for this. I think that the basic test is sufficient for this. I think that the path sanitizing and conversion should be a subsequent change.

compnerd updated this revision to Diff 254883.Apr 3 2020, 12:16 PM
JDevlieghere added inline comments.Apr 3 2020, 12:20 PM
lldb/test/Shell/Process/Windows/process_load.cpp
4

We should probably have a lit.local.cfg in the Windows directory with

if 'system-windows' not in config.available_features:
  config.unsupported = True
compnerd marked an inline comment as done.Apr 3 2020, 12:33 PM
compnerd added inline comments.
lldb/test/Shell/Process/Windows/process_load.cpp
4

I think that's a good idea, but, should be a separate change - it isn't related to the load/unload functionality.

labath added a comment.Apr 6 2020, 1:50 AM

I think that the basic test is sufficient for this.

That test does not seem to be exercising the "unload" part of this patch. It would also be nice to run some basic command like "image list" to verify that the loaded binary is indeed listed.

(I don't really have a hard objection to this being a lit test, but it does sound to me like at that point, this will be reimplementing TestLoadUnload.py)

I think that the path sanitizing and conversion should be a subsequent change.

Why is that? The need for sanitation is a direct consequence of how you've chosen to implement this patch -- the posix version of this function does not do sanitation, but it does not need to, as it does not embed the library name into the compiled expression. I can see how the support for wide strings might be considered a separate feature, but given that supporting that is a matter of adding a single L to the compiled expression, I don't see a problem with including that here.

This comment was removed by compnerd.

I think that the basic test is sufficient for this.

That test does not seem to be exercising the "unload" part of this patch. It would also be nice to run some basic command like "image list" to verify that the loaded binary is indeed listed.

(I don't really have a hard objection to this being a lit test, but it does sound to me like at that point, this will be reimplementing TestLoadUnload.py)

I think that the path sanitizing and conversion should be a subsequent change.

Why is that? The need for sanitation is a direct consequence of how you've chosen to implement this patch -- the posix version of this function does not do sanitation, but it does not need to, as it does not embed the library name into the compiled expression. I can see how the support for wide strings might be considered a separate feature, but given that supporting that is a matter of adding a single L to the compiled expression, I don't see a problem with including that here.

Actually, it changes the APIs used and the path that this goes down on the Windows side, so it has a much broader impact than it appears.

compnerd updated this revision to Diff 255580.Apr 6 2020, 9:09 PM
compnerd updated this revision to Diff 255581.Apr 6 2020, 9:18 PM
compnerd updated this revision to Diff 390245.Nov 28 2021, 8:10 PM
compnerd retitled this revision from Windows: add very basic support for `DoLoadImage` to Windows: support `DoLoadImage`.
compnerd edited the summary of this revision. (Show Details)

This is a more complete implementation that allows for error reporting and use of UCS-2 as that is needed for the search path alteration.

compnerd marked an inline comment as done.Nov 28 2021, 8:11 PM
compnerd updated this revision to Diff 390246.Nov 28 2021, 8:20 PM

Fix build rules

compnerd updated this revision to Diff 390249.Nov 28 2021, 9:43 PM

Add missing null-terminators.

I can't speak to the correctness of the Windows parts, but all the utility function stuff looks sane to me. LGTM if Pavel has no outstanding objections.

lldb/source/Plugins/Platform/Windows/PlatformWindows.h
47–51

I know it's an override, but what a horrible interface...

lldb/test/Shell/Process/Windows/process_load.cpp
4

Fair enough

compnerd marked an inline comment as done.Nov 29 2021, 9:59 AM
compnerd added inline comments.
lldb/source/Plugins/Platform/Windows/PlatformWindows.h
47–51

I completely agree.

lldb/test/Shell/Process/Windows/process_load.cpp
4

I already pushed that change, so it's already taken care of, but it is not part of the set of changes :)

JDevlieghere accepted this revision.Dec 1 2021, 9:26 AM
This revision is now accepted and ready to land.Dec 1 2021, 9:26 AM
This revision was automatically updated to reflect the committed changes.
compnerd marked an inline comment as done.
thakis added a subscriber: thakis.Dec 4 2021, 7:28 PM
thakis added inline comments.
lldb/source/Plugins/Platform/Windows/PlatformWindows.cpp
396
../../lldb/source/Plugins/Platform/Windows/PlatformWindows.cpp:397:62: warning: format specifies type 'unsigned long' but the argument has type 'uint64_t' (aka 'unsigned long long') [-Wformat]
    error.SetErrorStringWithFormat("LoadLibrary Error: %lu", error_code);
                                                       ~~~   ^~~~~~~~~~
                                                       %llu

Thanks @thakis - 906e60b9f923464cba0f71a9205846550752162f should have addressed that from a few days ago (sorry about not mentioning that here)