add more details and fix some errors.
authorGengbin Zheng <gzheng@illinois.edu>
Fri, 2 Mar 2001 06:17:55 +0000 (06:17 +0000)
committerGengbin Zheng <gzheng@illinois.edu>
Fri, 2 Mar 2001 06:17:55 +0000 (06:17 +0000)
README.cygwin

index 2d5dade013f427e100dbc7828937d7a743e36413..a8d8f2a7a84b08010739da5a35b3563006a87602 100644 (file)
@@ -1,10 +1,14 @@
+                              Charm++ 5.4 (Release 1)
+
+       Copyright (C) 1989-2000 Regents of the University of Illinois
+
 Now you can compile charm++ under Windows9x/2000/NT with Cygwin.
 Note: This version of cygwin is still under testing.
 Check the FAQ at end of this file for more help.
 
 
-Setup and Compilation
-=====================
+                       Setup and Compilation
+                    ===========================
 
 To compile charm on cygwin:
 1. install cygwin from: http://sourceware.cygnus.com/cygwin
@@ -16,14 +20,16 @@ To compile charm on cygwin:
    compile charm++:    ./build charm++ net-cygwin
 
 3. setting up running environment:
-   There are several ways to do this, using rsh or ssh. 
+     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.
-   Starting from Charm++ <version>, you no longer need rshd or sshd to start
-   charm program on local machine. This is for testing purpose though, for 
-   best performance, launch one process per processor with rsh daemons.
+     Starting from Charm++ version 5.4, ++local option is added to start
+   node programs directly ob your desktop machine. You no longer need rshd or 
+   sshd to start charm program on local machine. This is for testing purpose 
+   or small job run though, for best performance, launch one process per 
+   processor with rsh daemons.
 
- ** RSH **
+ ** RSH method **
    setup /etc/inetd.conf and /etc/services to start rshd, 
    Here is an example of /etc/inetd.conf:
 
@@ -38,20 +44,25 @@ shell     514/tcp    cmd
 ###
 
    before running charm program, start 'inetd' first to get rshd running.
-   run 'inetd -d' to see the debug information.
+   Run debug mode 'inetd -d' to see the debug information.
 
- ** SSH **
-   Check /etc/passwd, make sure your home directory is correct. (it may be
+ ** SSH method **
+     Check /etc/passwd, make sure your home directory is correct. (it may be
    empty there!)
    run "/usr/bin/ssh-config" to setup all ssh config files.
-   Setup ~/.shosts, or add your public key to your ~/.ssh/authorized_keys to 
+     Since openssh version 2.5.1p2, you have to run /usr/bin/ssh-host-config
+   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.
 
- ** run only on local machine **
-     This allow a user to run charm program on his desktop machine for testing 
-   purpose without the hassle of setting up any rsh deamons. To launch a 
-   charm++ program on your local machine, use "++local" option via:
+ ** run only on local machine with ++local **
+     This allows a user to run charm program on his/her desktop machine for 
+   testing purpose or running a small job without the hassle of setting up any 
+   rsh deamons. To launch a charm++ program on your local machine, use 
+   "++local" option via:
   
      ./charmrun +p4 ++local ./pgm
 
@@ -61,11 +72,8 @@ shell     514/tcp    cmd
 
 
 
-
-
-
-FAQ
-==============
+                                    FAQ
+                             ==============
 
  * Why would I use net-cygwin version?
 
@@ -82,10 +90,10 @@ FAQ
 
       cvs -d :pserver:checkout@thrift.cs.uiuc.edu:/expand6/cvsroot login
 
-      when CVS passwd is prompted, just type Enter.
+      when CVS passwd is prompted, just type <Enter>.
    2. checkout charm
 
-      cvs co charm
+      cvs co -P charm
 
       You should get latest charm source tree.
    3. logout the cvs server
@@ -98,12 +106,15 @@ FAQ
    This happens when the .ci files have strange characters like '^M' at end
    of each line. Don't use WinCVS to checkout charm because it will append
    '^M' for each line. Use the cvs that comes free from cygwin.
+   After charm++ version 5.4, this bug is fixed.
 
  * Problem: I got a runtime error "CthCreate failed to create fiber!".
 
-   net-cygwin uses Win32 Fiber in its user threads implementation. However, 
+     net-cygwin uses Win32 Fiber in its user threads implementation. However, 
    there is a limit upon the number of Fibers you can create at one time in 
    the w32api of cygwin. The current limit (as I tested) is between 50-52. You 
    have to reduce the number of processors or the number of charm++ threads
-   you create in the program to run it under cygwin.
+   you create in the program to run the program under cygwin.
+
+