optimize chkp after ldb
[charm.git] / README.cygwin
index 83257cba220e10de0fa62545ceca0f4f5a48ba4e..8d4e24de9410123148ebfd107a955c606e2162c2 100644 (file)
@@ -2,7 +2,11 @@
 
        Copyright (C) 1989-2000 Regents of the University of Illinois
 
-Now you can compile charm++ under Windows9x/2000/NT with Cygwin.
+Now you can compile charm++ under Windows9x/2000/NT/XP with Cygwin using its 
+GNU compiler. The generated executables require cygwin1.dll, and have to run
+under cygwin environment. To build Charm++ program that do not depend on 
+Cygwin DLL and only depend on runtime libraries distributed as part of the 
+OS (Win9x/NT), one needs to compile Charm++ using Mingw.
 Note: This version of cygwin is still under testing.
 Check the FAQ at end of this file for more help.
 
@@ -11,15 +15,16 @@ Check the FAQ at end of this file for more help.
                     ===========================
 
 To compile charm on cygwin:
-1. install cygwin from: http://sourceware.cygnus.com/cygwin
-   with inetutils, openssh, w32api packages and gcc of course. Remember to
+1. install cygwin from: http://www.cygwin.com/mirrors.html
+   download inetutils, openssh, w32api packages and gcc of course. Remember to
    choose default file type as "unix" at the beginning of cygwin installation.
 
 2. before compiling, make sure you have /bin/sh correctly installed, otherwise
    make a link from /bin/bash.exe:  ln -s /bin/bash.exe /bin/sh.exe
-   compile charm++:    ./build charm++ net-cygwin
+   compile charm++:    
+     ./build charm++ net-cygwin
 
-3. setting up running environment:
+3. set up environment:
      There are several ways to do this, using rsh or ssh. 
    Under Windows2000/NT, ssh is recommended, I once had difficulty to have 
    inetd working.
@@ -56,9 +61,13 @@ shell     514/tcp    cmd
    for the first time to generate global config files and server keys; and 
    run /usr/bin/ssh-user-config creates the private and public keys for a user.
    You may need to modify /etc/sshd_config or /etc/ssh_config for your needs.
+   
      Setup ~/.shosts, or add your public key to your ~/.ssh/authorized_keys to 
-   allow you to login without password authentication.
-   now you can start sshd and run charm programs. To tell Charmrun to use ssh
+   allow you to login without password authentication. You can test if your
+   setting works by:   
+       ssh localhost date
+   
+   Now you can start sshd and run charm programs. To tell Charmrun to use ssh
    instead of rsh(default), you need to add ++shell option in ~/.nodelist file:
 
 group main ++shell /bin/ssh
@@ -79,7 +88,7 @@ host localhost
    This will run only one copy of program locally.
 
 4. If you have any problem with it, please check the FAQ below for help.
-   Let me know if it works or not by sending email to (ppl@uiuc.edu).
+   Let me know if it works or not by sending email to (charm@cs.illinois.edu).
 
 
 
@@ -100,7 +109,7 @@ host localhost
    (It may not be the latest stable version though)
    1. login the cvs server:
 
-      cvs -d :pserver:checkout@thrift.cs.uiuc.edu:/expand6/cvsroot login
+      cvs -d :pserver:checkout@thrift.cs.illinois.edu:/expand6/cvsroot login
 
       when CVS passwd is prompted, just type <Enter>.
    2. checkout charm
@@ -112,6 +121,23 @@ host localhost
 
       cvs logout
 
+ * How to compile Charm++ executable using Mingw?
+
+   Make sure mingw-runtime is installed using Cygwin setup program. 
+
+   Download "MinGW API for MS-Windows" from mingw website: 
+      http://www.mingw.org/download.shtml 
+   The downloaded file should be named as w32api-3.11.tar.gz.
+   Install the file under /usr/local/mingw
+
+   Now build charm++ with "mingw" option:
+     ./build charm++ net-cygwin mingw
+
+   One can then compile Charm++ application using mingw support and run 
+   applications outside of Cygwin. However, note that one can not use 
+   ssh mode in charmrun to start a parallel job. Instead, use charmd which 
+   is a daemon process that listen charm command and start processes.
+
  * Problem: Charm++ build script stops when it compile "ckfutures.ci", with 
    error message: "Syntax error at line 1: parse error"