2015-09-08 10:09:26 -07:00
|
|
|
// Copyright 2015 The Crashpad Authors. All rights reserved.
|
|
|
|
//
|
|
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
// you may not use this file except in compliance with the License.
|
|
|
|
// You may obtain a copy of the License at
|
|
|
|
//
|
|
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
//
|
|
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
// See the License for the specific language governing permissions and
|
|
|
|
// limitations under the License.
|
|
|
|
|
|
|
|
#include "util/win/scoped_process_suspend.h"
|
|
|
|
|
2017-03-22 21:44:05 -04:00
|
|
|
#include <stddef.h>
|
2015-09-08 10:09:26 -07:00
|
|
|
#include <tlhelp32.h>
|
|
|
|
|
|
|
|
#include <algorithm>
|
|
|
|
#include <vector>
|
|
|
|
|
|
|
|
#include "gtest/gtest.h"
|
2015-09-11 16:45:44 -07:00
|
|
|
#include "test/errors.h"
|
2015-09-08 10:09:26 -07:00
|
|
|
#include "test/win/win_child_process.h"
|
2015-09-11 16:45:44 -07:00
|
|
|
#include "util/win/xp_compat.h"
|
2015-09-08 10:09:26 -07:00
|
|
|
|
|
|
|
namespace crashpad {
|
|
|
|
namespace test {
|
|
|
|
namespace {
|
|
|
|
|
|
|
|
// There is no per-process suspend count on Windows, only a per-thread suspend
|
|
|
|
// count. NtSuspendProcess just suspends all threads of a given process. So,
|
|
|
|
// verify that all thread's suspend counts match the desired suspend count.
|
|
|
|
bool SuspendCountMatches(HANDLE process, DWORD desired_suspend_count) {
|
|
|
|
DWORD process_id = GetProcessId(process);
|
|
|
|
|
|
|
|
ScopedKernelHANDLE snapshot(CreateToolhelp32Snapshot(TH32CS_SNAPTHREAD, 0));
|
2015-09-11 16:45:44 -07:00
|
|
|
if (!snapshot.is_valid()) {
|
|
|
|
ADD_FAILURE() << ErrorMessage("CreateToolhelp32Snapshot");
|
2015-09-08 10:09:26 -07:00
|
|
|
return false;
|
2015-09-11 16:45:44 -07:00
|
|
|
}
|
2015-09-08 10:09:26 -07:00
|
|
|
|
|
|
|
THREADENTRY32 te;
|
|
|
|
te.dwSize = sizeof(te);
|
2015-09-11 16:45:44 -07:00
|
|
|
|
|
|
|
BOOL ret = Thread32First(snapshot.get(), &te);
|
|
|
|
if (!ret) {
|
|
|
|
ADD_FAILURE() << ErrorMessage("Thread32First");
|
2015-09-08 10:09:26 -07:00
|
|
|
return false;
|
2015-09-11 16:45:44 -07:00
|
|
|
}
|
2015-09-08 10:09:26 -07:00
|
|
|
do {
|
|
|
|
if (te.dwSize >= offsetof(THREADENTRY32, th32OwnerProcessID) +
|
|
|
|
sizeof(te.th32OwnerProcessID) &&
|
|
|
|
te.th32OwnerProcessID == process_id) {
|
|
|
|
ScopedKernelHANDLE thread(
|
2015-09-11 16:45:44 -07:00
|
|
|
OpenThread(kXPThreadAllAccess, false, te.th32ThreadID));
|
|
|
|
EXPECT_TRUE(thread.is_valid()) << ErrorMessage("OpenThread");
|
2015-09-08 10:09:26 -07:00
|
|
|
DWORD result = SuspendThread(thread.get());
|
2015-09-11 16:45:44 -07:00
|
|
|
EXPECT_NE(result, static_cast<DWORD>(-1))
|
|
|
|
<< ErrorMessage("SuspendThread");
|
|
|
|
if (result != static_cast<DWORD>(-1)) {
|
|
|
|
EXPECT_NE(ResumeThread(thread.get()), static_cast<DWORD>(-1))
|
|
|
|
<< ErrorMessage("ResumeThread");
|
|
|
|
}
|
2015-09-08 10:09:26 -07:00
|
|
|
if (result != desired_suspend_count)
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
te.dwSize = sizeof(te);
|
|
|
|
} while (Thread32Next(snapshot.get(), &te));
|
|
|
|
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
|
|
|
class ScopedProcessSuspendTest final : public WinChildProcess {
|
|
|
|
public:
|
|
|
|
ScopedProcessSuspendTest() : WinChildProcess() {}
|
|
|
|
~ScopedProcessSuspendTest() {}
|
|
|
|
|
|
|
|
private:
|
|
|
|
int Run() override {
|
|
|
|
char c;
|
|
|
|
// Wait for notification from parent.
|
Make file_io reads more rational and predictable
ReadFile() attempted to continue reading after a short read. In most
cases, this is fine. However, ReadFile() would keep trying to fill a
partially-filled buffer until experiencing a 0-length read(), signaling
end-of-file. For certain weird file descriptors like terminal input, EOF
is an ephemeral condition, and attempting to read beyond EOF doesn’t
actually return 0 (EOF) provided that they remain open, it will block
waiting for more input. Consequently, ReadFile() and anything based on
ReadFile() had an undocumented and quirky interface, which was that any
short read that it returned (not an underlying short read) actually
indicated EOF.
This facet of ReadFile() was unexpected, so it’s being removed. The new
behavior is that ReadFile() will return an underlying short read. The
behavior of FileReaderInterface::Read() is updated in accordance with
this change.
Upon experiencing a short read, the caller can determine the best
action. Most callers were already prepared for this behavior. Outside of
util/file, only crashpad_database_util properly implemented EOF
detection according to previous semantics, and adapting it to new
semantics is trivial.
Callers who require an exact-length read can use the new
ReadFileExactly(), or the newly renamed LoggingReadFileExactly() or
CheckedReadFileExactly(). These functions will retry following a short
read. The renamed functions were previously called LoggingReadFile() and
CheckedReadFile(), but those names implied that they were simply
wrapping ReadFile(), which is not the case. They wrapped ReadFile() and
further, insisted on a full read. Since ReadFile()’s semantics are now
changing but these functions’ are not, they’re now even more distinct
from ReadFile(), and must be renamed to avoid confusion.
Test: *
Change-Id: I06b77e0d6ad8719bd2eb67dab93a8740542dd908
Reviewed-on: https://chromium-review.googlesource.com/456676
Reviewed-by: Robert Sesek <rsesek@chromium.org>
2017-03-16 13:36:38 -04:00
|
|
|
EXPECT_TRUE(LoggingReadFileExactly(ReadPipeHandle(), &c, sizeof(c)));
|
test: Use (actual, [un]expected) in gtest {ASSERT,EXPECT}_{EQ,NE}
gtest used to require (expected, actual) ordering for arguments to
EXPECT_EQ and ASSERT_EQ, and in failed test assertions would identify
each side as “expected” or “actual.” Tests in Crashpad adhered to this
traditional ordering. After a gtest change in February 2016, it is now
agnostic with respect to the order of these arguments.
This change mechanically updates all uses of these macros to (actual,
expected) by reversing them. This provides consistency with our use of
the logging CHECK_EQ and DCHECK_EQ macros, and makes for better
readability by ordinary native speakers. The rough (but working!)
conversion tool is
https://chromium-review.googlesource.com/c/466727/1/rewrite_expectassert_eq.py,
and “git cl format” cleaned up its output.
EXPECT_NE and ASSERT_NE never had a preferred ordering. gtest never made
a judgment that one side or the other needed to provide an “unexpected”
value. Consequently, some code used (unexpected, actual) while other
code used (actual, unexpected). For consistency with the new EXPECT_EQ
and ASSERT_EQ usage, as well as consistency with CHECK_NE and DCHECK_NE,
this change also updates these use sites to (actual, unexpected) where
one side can be called “unexpected” as, for example, std::string::npos
can be. Unfortunately, this portion was a manual conversion.
References:
https://github.com/google/googletest/blob/master/googletest/docs/Primer.md#binary-comparison
https://github.com/google/googletest/commit/77d6b173380332b1c1bc540532641f410ec82d65
https://github.com/google/googletest/pull/713
Change-Id: I978fef7c94183b8b1ef63f12f5ab4d6693626be3
Reviewed-on: https://chromium-review.googlesource.com/466727
Reviewed-by: Scott Graham <scottmg@chromium.org>
2017-04-04 00:35:21 -04:00
|
|
|
EXPECT_EQ(c, ' ');
|
2015-09-08 10:09:26 -07:00
|
|
|
return EXIT_SUCCESS;
|
|
|
|
}
|
|
|
|
|
|
|
|
DISALLOW_COPY_AND_ASSIGN(ScopedProcessSuspendTest);
|
|
|
|
};
|
|
|
|
|
Un-disable WinMultiprocess-based tests in Chromium
As of
https://chromium.googlesource.com/chromium/src/+/00a0654929787f70b0cd81f30aa14e81c5e11b2f,
crashpad_util_test is able to run in Chromium. It uses Chromium’s own
base::TestLauncher rather than gtest’s RUN_ALL_TESTS() for proper
integration with Swarming.
Launching WinMultiprocess test children out of the same test executable
via WinChildProcess is not compatible with Chromium’s parallel, shardy,
Swarmy test launcher. When running these children, the standard gtest
RUN_ALL_TESTS() launcher will now be used, even in Chromium.
Two tests disabled in Chromium are now enabled:
ExceptionHandlerServerTest.MultipleConnections and
ScopedProcessSuspend.ScopedProcessSuspend.
As part of this work, I discovered that disabled tests chosen to run via
--gtest_also_run_disabled_tests did not actually work for
WinMultiprocess-based tests, because gtest’s test launcher would refuse
to run the child side of the test, believing it was disabled. This is
fixed by always supplying --gtest_also_run_disabled_tests to
WinChildProcess children, on the basis that if the parent is managing to
run and it’s disabled, disabled tests must actually be enabled.
Bug: crashpad:205
Change-Id: Ied22f16b9329ee13b6b07fd29de704f6fe2a058e
Reviewed-on: https://chromium-review.googlesource.com/742462
Reviewed-by: Scott Graham <scottmg@chromium.org>
2017-10-27 17:41:32 -04:00
|
|
|
TEST(ScopedProcessSuspend, ScopedProcessSuspend) {
|
2015-09-08 10:09:26 -07:00
|
|
|
WinChildProcess::EntryPoint<ScopedProcessSuspendTest>();
|
2016-04-25 12:13:07 -07:00
|
|
|
std::unique_ptr<WinChildProcess::Handles> handles = WinChildProcess::Launch();
|
2015-09-08 10:09:26 -07:00
|
|
|
|
|
|
|
EXPECT_TRUE(SuspendCountMatches(handles->process.get(), 0));
|
|
|
|
|
|
|
|
{
|
2015-09-21 10:51:15 -07:00
|
|
|
ScopedProcessSuspend suspend0(handles->process.get());
|
2015-09-08 10:09:26 -07:00
|
|
|
EXPECT_TRUE(SuspendCountMatches(handles->process.get(), 1));
|
|
|
|
|
|
|
|
{
|
2015-09-21 10:51:15 -07:00
|
|
|
ScopedProcessSuspend suspend1(handles->process.get());
|
2015-09-08 10:09:26 -07:00
|
|
|
EXPECT_TRUE(SuspendCountMatches(handles->process.get(), 2));
|
|
|
|
}
|
|
|
|
|
|
|
|
EXPECT_TRUE(SuspendCountMatches(handles->process.get(), 1));
|
|
|
|
}
|
|
|
|
|
|
|
|
EXPECT_TRUE(SuspendCountMatches(handles->process.get(), 0));
|
|
|
|
|
|
|
|
// Tell the child it's OK to terminate.
|
|
|
|
char c = ' ';
|
|
|
|
EXPECT_TRUE(WriteFile(handles->write.get(), &c, sizeof(c)));
|
|
|
|
}
|
|
|
|
|
|
|
|
} // namespace
|
|
|
|
} // namespace test
|
|
|
|
} // namespace crashpad
|