starred/terminal
1
0
Fork 0
mirror of https://github.com/microsoft/terminal.git synced 2026-02-04 05:35:20 +00:00
Code Issues 19.0k Packages Projects Releases 20 Wiki Activity

ConPTY Version probing #23414

New Issue
Open
opened 2026-01-31 08:41:31 +00:00 by claunia · 0 comments
claunia commented 2026-01-31 08:41:31 +00:00
Owner
Copy Link

Originally created by @patrickbkr on GitHub (Jul 7, 2025).

This is more of a question than a feature request.

I'm currently working on adding PTY support to libuv. Bundling ConPTY is not an option, so I have to work with the version kernel32.dll gives me. There are some relevant developments in the last few years/months.

  • Support for Overlapped IO (#17510)
  • ConptyReleasePseudoConsole (#14544)
  • Probably a few more

How do I know which features are available in the ConPTY version bundled with Windows? Is there some version number I can retrieve? Is there a Matrix of Windows version and ConPTY version?

Also: Is there any documentation on how to use these older ConPTY versions? I find it pretty difficult to find any in-depth information on this. For example, here are some of the questions I've stumbled over:

  • Do I have to use synchronous pipes for in and out? (I think: Yes in older versions, no in recent versions.)
  • Can I use the same (bidirectional) pipe for PTY in and out? (I think: Yes.)
  • Do I have to perform stdin writing and stdout reading each on their own thread? (I think: No.)
  • What's happening when I close the pty write handle? (I think: ConPTY sends a CTRL-C to the process.)
  • How do I properly shut down a ConPTY session? (According to this comment and this remark, it's a pretty delicate dance I have to perform.)
Originally created by @patrickbkr on GitHub (Jul 7, 2025). This is more of a question than a feature request. I'm currently working on adding [PTY support to libuv](https://github.com/libuv/libuv/pull/4802). Bundling ConPTY is not an option, so I have to work with the version kernel32.dll gives me. There are some relevant developments in the last few years/months. - Support for Overlapped IO ([#17510](https://github.com/microsoft/terminal/pull/17510)) - `ConptyReleasePseudoConsole` ([#14544](https://github.com/microsoft/terminal/pull/14544)) - Probably a few more How do I know which features are available in the ConPTY version bundled with Windows? Is there some version number I can retrieve? Is there a Matrix of Windows version and ConPTY version? Also: Is there any documentation on how to use these older ConPTY versions? I find it pretty difficult to find any in-depth information on this. For example, here are some of the questions I've stumbled over: - Do I have to use synchronous pipes for in and out? (I think: [Yes](https://learn.microsoft.com/en-us/windows/console/createpseudoconsole#parameters) in older versions, no in recent versions.) - Can I use the same (bidirectional) pipe for PTY in and out? (I think: Yes.) - Do I have to perform stdin writing and stdout reading each on their own thread? (I think: No.) - What's happening when I close the pty write handle? (I think: ConPTY sends a `CTRL-C` to the process.) - How do I properly shut down a ConPTY session? (According to [this comment](https://github.com/microsoft/terminal/discussions/15006#discussioncomment-5339341) and [this remark](https://learn.microsoft.com/en-us/windows/console/closepseudoconsole#remarks), it's a pretty delicate dance I have to perform.)
claunia added the Needs-TriageNeeds-Tag-Fix labels 2026-01-31 08:41:32 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
⛺ Reserved
A11yCO
A11yMAS
A11ySev1
A11ySev2
A11ySev3
A11yTTValidated
A11yUsable
A11yVoiceAccess
A11yWCAG
Area-Accessibility
Area-AtlasEngine
Area-AzureShell
Area-Build
Area-Build
Area-Chat
Area-CmdPal
Area-CodeHealth
Area-Commandline
Area-CookedRead
Area-DefApp
Area-Extensibility
Area-Fonts
Area-GroupPolicy
Area-i18n
Area-Input
Area-Interaction
Area-Interop
Area-Localization
Area-Output
Area-Performance
Area-Portable
Area-Quality
Area-Remoting
Area-Rendering
Area-Schema
Area-Server
Area-Settings
Area-SettingsUI
Area-ShellExtension
Area-ShellExtension
Area-ShellExtension
Area-Suggestions
Area-Suggestions
Area-TerminalConnection
Area-TerminalControl
Area-Theming
Area-UserInterface
Area-VT
Area-Windowing
Area-WPFControl
AutoMerge
Blocking-Ingestion
Culprit-Centennial
Culprit-WinUI
Disability-All
Disability-Blind
Disability-LowVision
Disability-Mobility
External-Blocked-WinUI3
Fixed
Gathering-Data
good first issue
HCL-E+D
HCL-WindowsTerminal
Help Wanted
Impact-Compatibility
Impact-Compliance
Impact-Correctness
Impact-Visual
In-PR
InclusionBacklog
InclusionBacklog-Windows TerminalWin32
InclusionCommitted-202206
Issue-Bug
Issue-Docs
Issue-Feature
Issue-Feature
Issue-Question
Issue-Samples
Issue-Scenario
Issue-Task
Needs-Attention
Needs-Author-Feedback
Needs-Bisect
Needs-Discussion
Needs-Repro
Needs-Tag-Fix
Needs-Tag-Fix
Needs-Triage
No-Recent-Activity
Priority-0
Priority-1
Priority-2
Priority-3
Product-Cmd.exe
Product-Colortool
Product-Colortool
Product-Colortool
Product-Conhost
Product-Conpty
Product-Meta
Product-Powershell
Product-Terminal
Product-WSL
pull-request
Mirrored from GitHub Pull Request
 Resolution-Answered
Resolution-By-Design
Resolution-Duplicate
Resolution-External
Resolution-Fix-Available
Resolution-Fix-Committed
Resolution-No-Repro
Resolution-Won't-Fix
Severity-Blocking
Severity-Crash
Severity-DataLoss
spam
this-will-be-a-breaking-change
Tracking-External
WindowsTerminal_Win32
Work-Item
zAskModeBug
zInbox-Bug
No Label Needs-Tag-Fix Needs-Triage
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
claunia
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/terminal#23414
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?