terminal/src/server/sources.inc
Mike Griese 7612044363
Implement a pair of shims for cls, Clear-Host in conpty mode (#5627)
## Summary of the Pull Request

This PR implements a pair of shims for `cmd` and `powershell`, so that their `cls` and `Clear-Host` functions will clear the entire terminal buffer (like they do in conhost), instead of just the viewport. With the conpty viewport and buffer being the same size, there's effectively no way to know if an application is calling these API's in this way with the intention of clearing the buffer or the viewport. We absolutely have to guess. 

Each of these shims checks to see if the way that the API is being called exactly matches the way `cmd` or `powershell` would call these APIs. If it does, we manually write a `^[[3J` to the connected terminal, to get he Terminal to clear it's own scrollback.

~~_⚠️ If another application were trying to clear the **viewport** with an exactly similar API call, this would also cause the terminal scrollback to get cleared ⚠️_~~

* [x] Should these shims be restricted to when the process that's calling them is actually `cmd.exe` or `powershell.exe`? Can I even do this? I think we've done such a good job of isolating the client process information from the rest of the host code that I can't figure out how to do this.
  - YES, this can be done, and I did it.
* [ ] **TODO**: _While I'm here_, should I have `DoSrvPrivateEraseAll` (the implementation for `^[[2J`, in `getset.cpp`) also manually trigger a EraseAll in the terminal in conpty mode?

## PR Checklist
* [x] Closes #3126
* [x] Actually closes #1305 too, which is really the same thing, but probably deserves a callout
* [x] I work here
* [x] Tests added/passed
* [n/a] Requires documentation to be updated

## Validation Steps Performed
* ran tests
* checked `cls` in the Terminal
* checked `Clear-Host` in the Terminal
* Checked running `powershell clear-host` from `cmd.exe`
2020-04-30 21:53:31 +00:00

58 lines
1.6 KiB
PHP

!include ..\..\project.inc
# -------------------------------------
# Windows Console
# - Console Server Communications Layer
# -------------------------------------
# This module encapsulates the communication layer between the console driver
# and the console server application.
# All IOCTL driver communications are handled in this layer as well as management
# activities like process and handle tracking.
# -------------------------------------
# Compiler Settings
# -------------------------------------
# Warning 4201: nonstandard extension used: nameless struct/union
# Warning 4702: unreachable code
MSC_WARNING_LEVEL = $(MSC_WARNING_LEVEL) /wd4201 /wd4702
# -------------------------------------
# Build System Settings
# -------------------------------------
# Code in the OneCore depot automatically excludes default Win32 libraries.
# -------------------------------------
# Sources, Headers, and Libraries
# -------------------------------------
PRECOMPILED_CXX = 1
PRECOMPILED_INCLUDE = ..\precomp.h
SOURCES= \
..\ApiDispatchers.cpp \
..\ApiDispatchersInternal.cpp \
..\ApiMessage.cpp \
..\ApiMessageState.cpp \
..\ApiSorter.cpp \
..\DeviceComm.cpp \
..\DeviceHandle.cpp \
..\ConsoleShimPolicy.cpp \
..\Entrypoints.cpp \
..\IoDispatchers.cpp \
..\IoSorter.cpp \
..\ObjectHandle.cpp \
..\ObjectHeader.cpp \
..\ProcessHandle.cpp \
..\ProcessList.cpp \
..\ProcessPolicy.cpp \
..\WaitBlock.cpp \
..\WaitQueue.cpp \
..\WinNTControl.cpp \
INCLUDES= \
$(INCLUDES); \
..; \