Get rid of sites without the latest packages.
[rsync-web.git] / win95.txt
1 Compiling rsync for MS Windows 95
2 =================================
3
4 Caveat: 
5 There are no doubt other ways to do this, but I have not tried them.
6
7 This will produce an rsync binary which runs under win95/NT which can _send_
8 data to a UNIX rsync host but not receive. This is suitable for my requirements
9 as I am backing up a bunch of win95 machines to a linux server, but it may
10 not be what _you_ require.
11
12 NOTE: I am now told (by patl@curl.com) that receiving as well as
13 sending works with the current cygwin32 toolkit.
14
15
16 Step 1. Get the Cygnus development kit
17 --------------------------------------
18
19 If you do not already know about this wonderful project undertaken by cygnus,
20 grab the latest copy of the gnu-win32 runtime system from 
21
22     http://www.cygnus.com/misc/gnu-win32/
23
24 You will want the CDK-B19.EXE self-installing binary (be warned - it's 12M
25 in size) which contains gcc+binutils+DLLs required by the system. Read the
26 instructions about this and install it. You will then have something which 
27 looks _very_ close to a UNIX box as far as any UNIX software ic concerned.
28
29 Also grab the updated version (B19.1) of the DLL as this fixes some problems
30 (it's pretty small at ~190k).
31
32 Take a bit of time to play with this stuff - have a look at the registry
33 entries that define mount points etc so you know where/how your windows
34 directories are mapped.
35
36 Step 2. Compile rsync
37 ---------------------
38
39 Once the magic BASH$ prompt appears in your cygnus dos box, you can download
40 and compile rsync right out of the box. You might want to do this:
41
42     tar xvzf rsync-2.0.17.tar.gz  (or whatever version...)
43     cd rsync-2.0.17
44     chmod +x configure          (exec is not set automatically)
45     ./configure
46     make
47
48 and you will have a working RSYNC.EXE
49
50 Before you can do a "make install" you must edit the Makefile so that
51 it knows about "rsync.exe" rather than "rsync".
52
53 Step 3 (optional) - compile and install SSH
54 -------------------------------------------
55
56 If you want to use ssh as the transport then you better grab a copy and compile
57 it - again, no surprises. It compiles ok under gnuwin32, and you can generate
58 keys etc in the normal way.
59
60 Problems
61 --------
62
63 Well, it _almost_ works seamlessly. Here are a couple of problems I have
64 encountered so far - I do not know why these symptoms occur, and they are
65 probably nothing to do with rsync, but if you follow this course then you
66 will probably run into these things also...
67
68 1. rsync will not _receive_ data onto a windows box. It seems to do everything
69    ok, but then hangs at the last step and no files actually appear. When
70    transferring via my modem, I can see data being received, but it never 
71    appears in my directory.
72
73 NOTE: This now appears to be fixed.
74
75 2. rsync, ssh and other gnuwin32-compiled programs can be called directly from
76    a DOS prompt, but argument passing seems to be broken. This means that
77    starting SSH directly is difficult.
78
79    After a bit of experimenting I found a workaround, which is not pretty
80    but worked for me :-)
81
82    Lets say you want to call ssh from a normal DOS prompt. Set up a batch
83    file called "SSH.BAT" which sets up the cygnus environment and calls bash
84    with the argument "ssh.sh %1 %2 %3 %4 %5 %6 %7 %8 %9". You can copy the
85    cygnus.bat file and use it as a template if you like. here is my ssh.bat:
86
87
88     @ECHO OFF
89     SET TERM=ansi
90     SET MAKE_MODE=unix
91     SET CYGFS=e:/apps/cygnus
92     SET GCC_EXEC_PREFIX=/lib\gcc-lib\
93     SET TCL_LIBRARY=%CYGROOT%\share\tcl8.0\
94     SET HOME=/home/awesley
95     SET GDBTK_LIBRARY=%CYGFS%/share/gdbtcl
96     bash /scripts/ssh.sh %1 %2 %3 %4 %5 %6 %7 %8 %9
97
98
99    Create a shell script called ssh.sh containing:
100
101     /usr/local/bin/ssh $*
102
103    which is then run by bash and calls the ssh binary (wherever you have
104    installed it).
105
106    I suspect that there is a better way, but I have not yet had time to 
107    look for it.
108
109
110 Cheers, Anthony Wesley