posix/apps/posixw32/readme.txt

   1 $Id: readme.txt,v 1.3 2002/10/29 04:45:05 rex Exp $
   2
   3 posixw32 - a Win32 client terminal emulator for the POSIX+ subsystem
   4
   5 SYNOPSYS
   6
   7     posixw32 [program]
   8
   9     program  program to be run in the terminal; if none is given,
  10              the shell for the current user (W32 session's) is
  11              used.
  12
  13 DESCRIPTION
  14
  15     posixw32 emulates a DEC VT-100 terminal (on top of the CSRSS
  16     subsystem, hence the name) which is the controlling terminal
  17     for a process [program] running in the context of the PSX
  18     subsystem. posixw32 is a Win32 console application, not a PSX
  19     application. The process created by the PSX subsystem on behalf
  20     of posixw32 is not the child of the posixw32 instance that
  21     requested it. posixw32 simply performs terminal I/O in the CSRSS
  22     world (the W32 world!) for [program].
  23
  24 NOTES
  25
  26     The role of posixw32 is creating a session in the PSX subsystem
  27     managing any I/O for it. This is how it works:
  28
  29     1. posixw32 creates two well known named objects in the system
  30        name space that will allow the PSX subsystem server to build
  31        the I/O channel for the session. To let the PSX subsystem
  32        process recognize the objects, they contain a numeric suffix
  33        which is the process identifier (n) the system gives to each
  34        instance of posixw32:
  35
  36            \POSIX+\Session\Pn      LPC port (IPC rendez-vous object)
  37            \POSIX+\Session\Dn      section (shared memory object)
  38
  39        posixw32 also creates a new thread to manage the calls though
  40        the LPC port. Port Pn is used by the subsystem to control the
  41        terminal which posixw32 emulates.
  42
  43     2. posixw32 connects to the PSX subsystem session port
  44
  45            \POSIX+\SessionPort
  46
  47        and asks the subsystem to create a new session.
  48
  49     3. The PSX subsystem, if it decides to accept the request, creates
  50        a new session for that calling instance of posixw32 (n), and in
  51        turn connects back to the terminal control port
  52
  53            \POSIX+\Session\Pn
  54
  55     4. When posixw32 makes the PSX subsystem create the new session, it
  56        also tells the subsystem what program should be the session
  57        leader process. The PSX subsystem creates that process (the
  58        image file to start must be marked IMAGE_SUBSYSTEM_POSIX_GUI or
  59        IMAGE_SUBSYSTEM_POSIX_CUI).
  60
  61     5. The requested process [program] runs in the context of the
  62        PSX subsystem and performs any terminal I/O via the channel
  63        posixw32 and the PSX susbstem created.
  64
  65 REVISIONS
  66     2001-05-05 created
  67     2002-03-03 simplified
  68     2002-06-08 renamed to avoid future name clash
  69
  70 AUTHOR
  71
  72     Emanuele Aliberti <ea@iol.it>
  73
  74 CREDITS
  75
  76     John L. Miller (johnmil@cs.cmu.edu, johnmil@jprc.com) code for
  77     a basic VT-100 emulator for Win32 consoles is used to process
  78     tc* calls output.
  79
  80 EOF