mirror of
https://github.com/reactos/reactos.git
synced 2024-10-31 11:56:26 +00:00
81 lines
2.8 KiB
Plaintext
81 lines
2.8 KiB
Plaintext
|
$Id: readme.txt,v 1.3 2002/10/29 04:45:05 rex Exp $
|
||
|
|
|
||
|
|
posixw32 - a Win32 client terminal emulator for the POSIX+ subsystem
|
||
|
|
|
||
|
|
SYNOPSYS
|
||
|
|
|
||
|
|
posixw32 [program]
|
||
|
|
|
||
|
|
program program to be run in the terminal; if none is given,
|
||
|
|
the shell for the current user (W32 session's) is
|
||
|
|
used.
|
||
|
|
|
||
|
|
DESCRIPTION
|
||
|
|
|
||
|
|
posixw32 emulates a DEC VT-100 terminal (on top of the CSRSS
|
||
|
|
subsystem, hence the name) which is the controlling terminal
|
||
|
|
for a process [program] running in the context of the PSX
|
||
|
|
subsystem. posixw32 is a Win32 console application, not a PSX
|
||
|
|
application. The process created by the PSX subsystem on behalf
|
||
|
|
of posixw32 is not the child of the posixw32 instance that
|
||
|
|
requested it. posixw32 simply performs terminal I/O in the CSRSS
|
||
|
|
world (the W32 world!) for [program].
|
||
|
|
|
||
|
|
NOTES
|
||
|
|
|
||
|
|
The role of posixw32 is creating a session in the PSX subsystem
|
||
|
|
managing any I/O for it. This is how it works:
|
||
|
|
|
||
|
|
1. posixw32 creates two well known named objects in the system
|
||
|
|
name space that will allow the PSX subsystem server to build
|
||
|
|
the I/O channel for the session. To let the PSX subsystem
|
||
|
|
process recognize the objects, they contain a numeric suffix
|
||
|
|
which is the process identifier (n) the system gives to each
|
||
|
|
instance of posixw32:
|
||
|
|
|
||
|
|
\POSIX+\Session\Pn LPC port (IPC rendez-vous object)
|
||
|
|
\POSIX+\Session\Dn section (shared memory object)
|
||
|
|
|
||
|
|
posixw32 also creates a new thread to manage the calls though
|
||
|
|
the LPC port. Port Pn is used by the subsystem to control the
|
||
|
|
terminal which posixw32 emulates.
|
||
|
|
|
||
|
|
2. posixw32 connects to the PSX subsystem session port
|
||
|
|
|
||
|
|
\POSIX+\SessionPort
|
||
|
|
|
||
|
|
and asks the subsystem to create a new session.
|
||
|
|
|
||
|
|
3. The PSX subsystem, if it decides to accept the request, creates
|
||
|
|
a new session for that calling instance of posixw32 (n), and in
|
||
|
|
turn connects back to the terminal control port
|
||
|
|
|
||
|
|
\POSIX+\Session\Pn
|
||
|
|
|
||
|
|
4. When posixw32 makes the PSX subsystem create the new session, it
|
||
|
|
also tells the subsystem what program should be the session
|
||
|
|
leader process. The PSX subsystem creates that process (the
|
||
|
|
image file to start must be marked IMAGE_SUBSYSTEM_POSIX_GUI or
|
||
|
|
IMAGE_SUBSYSTEM_POSIX_CUI).
|
||
|
|
|
||
|
|
5. The requested process [program] runs in the context of the
|
||
|
|
PSX subsystem and performs any terminal I/O via the channel
|
||
|
|
posixw32 and the PSX susbstem created.
|
||
|
|
|
||
|
|
REVISIONS
|
||
|
|
2001-05-05 created
|
||
|
|
2002-03-03 simplified
|
||
|
|
2002-06-08 renamed to avoid future name clash
|
||
|
|
|
||
|
|
AUTHOR
|
||
|
|
|
||
|
|
Emanuele Aliberti <ea@iol.it>
|
||
|
|
|
||
|
|
CREDITS
|
||
|
|
|
||
|
|
John L. Miller (johnmil@cs.cmu.edu, johnmil@jprc.com) code for
|
||
|
|
a basic VT-100 emulator for Win32 consoles is used to process
|
||
|
|
tc* calls output.
|
||
|
|
|
||
|
|
EOF
|