Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/k-takata/ptycheck
A sample to check if a program running on mintty
https://github.com/k-takata/ptycheck
cygwin mintty
Last synced: 3 months ago
JSON representation
A sample to check if a program running on mintty
- Host: GitHub
- URL: https://github.com/k-takata/ptycheck
- Owner: k-takata
- License: mit
- Created: 2015-08-16T01:26:36.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2023-10-20T23:49:43.000Z (about 1 year ago)
- Last Synced: 2023-10-21T15:25:25.806Z (about 1 year ago)
- Topics: cygwin, mintty
- Language: C
- Size: 19.5 KB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ptycheck
A sample to check if a program running on mintty (or some other terminal) on Cygwin/MSYS.
## How to compile
You can use VC6 or later to compile this sample.
If you want to execute the sample on WinXP or if you use VC8 (VC2005) or earlier, you need [Win32 FileID API Library](http://www.microsoft.com/en-us/download/details.aspx?id=22599) (404 now).
You need to specify the directory of Win32 FileID API Library with `FILEIDAPIDIR`:
```
nmake FILEIDAPIDIR=..\FileIDAPI
```
If you want to execute the sample on Vista or later and if you use VC9 (VC2008) or later, you don't need Win32 FileID API Library. Just run `nmake`:
```
nmake
```
### Configurations of iscygpty.c
iscygpty.c has some configurations:
* `USE_FILEEXTD`: If this is defined, Win32 FileID API Library is linked. This is mandatory if you want to detect Cygwin pty on WinXP. If you want to use this, `_WIN32_WINNT` should be 0x0501 or lower, otherwise `_WIN32_WINNT` should be 0x0600 or higher.
* `USE_DYNFILEID`: If this is defined, `GetFileInformationByHandleEx` is loaded dynamically (more precisely, explicitly). You can run a program even on WinXP or earlier, but Cygwin pty is not detected on the old OSes when `USE_FILEEXTD` is not defined.
* `ENABLE_STUB_IMPL`: If this is defined and `USE_FILEEXTD` is not defined and when VC2005 or earlier is used, `is_cygpty()` becomes stub implementation; it always returns 0.
If both `USE_FILEEXTD` and `USE_DYNFILEID` are not defined, the program can run only on Vista or later.
## ConPTY
Recent versions of Windows support [ConPTY](https://learn.microsoft.com/en-us/windows/console/creating-a-pseudoconsole-session) and Cygwin/MSYS2 can use it.
This allows an application to run as it is in a normal console window.
ptycheck doesn't detect when it is run in ConPTY, which is the expected behavior.
To enable or disable ConPTY, you can set the `CYGWIN` or `MSYS` environment variable to `enable_pcon` or `disable_pcon` before starting mintty.
mintty also supports the `-P [on|off]` or `--pcon [on|off]` option.
## License
[The MIT License](LICENSE). (You can also choose the Vim license.)