W2000 issue is no longer valid.
[www.jankratochvil.net.git] / project / captive / Index.html.pl
1 #! /usr/bin/perl
2
3 # $Id$
4 # Main page of 'My::Project::captive'
5 # Copyright (C) 2003 Jan Kratochvil <project-www.jankratochvil.net@jankratochvil.net>
6
7 # This program is free software; you can redistribute it and/or modify
8 # it under the terms of the GNU General Public License as published by
9 # the Free Software Foundation; exactly version 2 of June 1991 is required
10
11 # This program is distributed in the hope that it will be useful,
12 # but WITHOUT ANY WARRANTY; without even the implied warranty of
13 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14 # GNU General Public License for more details.
15
16 # You should have received a copy of the GNU General Public License
17 # along with this program; if not, write to the Free Software
18 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
19
20
21 package project::captive::Index;
22 require 5.6.0;  # at least 'use warnings;' but we need some 5.6.0+ modules anyway
23 our $VERSION=do { my @r=(q$Revision$=~/\d+/g); sprintf "%d.".("%03d"x$#r),@r; };
24 our $CVS_ID=q$Id$;
25 use strict;
26 use warnings;
27
28 BEGIN{ open F,"Makefile"; our $top_dir=pop @{[split /\s/,(grep /^top_srcdir/,<F>)[0]]}; eval "use lib '$top_dir'"; close F; }
29 use My::Web;
30 Wuse 'My::Project';
31 Wuse 'project::captive::ListItem';
32
33
34 my $W=My::Project->init_project(
35                 "__PACKAGE__"=>__PACKAGE__,
36                 "ListItem"=>\@project::captive::ListItem::ListItem,
37                 "no_project_data"=>1,
38                 "head_css"=>"
39 .reqpkg { font-style: italic; }
40 .stuff  { font-style: italic; font-size: larger; margin-left: 20%; margin-right: 10%; }
41 .re     { font-style: italic; }
42 table.mailman > * /* FIXME: What is it? */ > tr > th,
43 table.mailman > * /* FIXME: What is it? */ > tr > td { padding: 1ex; text-align: center; }
44 table.download td { padding: 8px; }
45 table.navigate td { padding-bottom: 1ex; padding-left: 15px; padding-right: 15px; }
46 ",
47                 "project_text_after_title"=>""
48                                 .'<table border="0" width="100%"><tr><td align="center">'
49                                         .'<table border="0" class="navigate"><tr>'
50                                                 .'<td>&bull;&nbsp;'.a_href('#download','Download').'</td>'
51                                                 .'<td>&bull;&nbsp;'.a_href('#news','NEWS').'</td>'
52                                                 .'<td>&bull;&nbsp;'.a_href('#testimonials','Testimonials').'</td>'
53                                                 .'<td>&bull;&nbsp;'.a_href('#notes','Installation Notes').'</td>'
54                                                 .'<td>&bull;&nbsp;'.a_href('#lists','Mailing Lists').'</td>'
55                                                 .'<td>&bull;&nbsp;'.a_href('#seealso','See Also').'</td>'
56                                         .'</tr></table>'
57                                 .'</td></tr></table>'
58                 );
59
60
61 print <<"HERE"; # if !$WebConfig::WebConfig{"no_job"};
62 @{[ vskip "3ex" ]}
63
64 <table border="0" width="100%"><tr><td align="center">
65         <table border="0" style="margin: 3ex; padding: 2ex; background: #bb8888;">
66                 <tr><td style="font-size: larger;">
67                         Looking for a challenging job: @{[ a_href $W->{"resume_url"},"My resume" ]}
68                 </td></tr>
69         </table>
70 </table>
71 HERE
72
73 my %version=(
74                 map(($_=>["1.1.3.2","0"]),qw(captive captive-lufs captive-install)),
75                 "lufs"=>["0.9.7","1captive8"],
76                 );
77
78 print <<"HERE";
79 <a name="download"><h2>Download</h2></a>
80
81 <h3>Choose the one preferred installation format:</h3>
82
83 <table border="0" align="center" width="100%"><tr><td align="center">
84 <table border="1" frame="border" rules="rows" align="center" style="text-align: center;" class="download">
85         <tr>
86                 <td>
87                         RPM i386 binary<br />
88                         tested for distributions:
89                                         <table border="0"><tr><td align="left"><ul>
90                                                 <li>Red&nbsp;Hat&nbsp;9&nbsp;Shrike</li>
91                                                 <li>Red&nbsp;Hat&nbsp;8&nbsp;Psyche</li>
92                                                 <li>Mandrake&nbsp;9.1&nbsp;Bamboo</li>
93                                         </ul></td></tr></table>
94                 </td>
95                 <td>@{[ a_href 'dist/captive-static-'.$version{"captive"}[0].'-'.$version{"captive"}[1].'.i386.rpm',
96                                 undef(),"size"=>1,"basename"=>1 ]}</td>
97         </tr>
98         <tr>
99                 <td>.tar.gz i386 binary<br />(for non-RPM distributions)</td>
100                 <td>@{[ a_href 'dist/captive-static-'.$version{"captive"}[0].'.tar.gz',undef(),"size"=>1,"basename"=>1 ]}</td>
101         </tr>
102         <tr>
103                 <td>Debian .deb binaries</td>
104                 <td>@{[ a_href 'CVS.html.pl#debian','download link' ]}</td>
105         </tr>
106         <tr>
107                 <td>Source archives</td>
108                 <td>@{[ a_href 'CVS.html.pl#source','download link' ]}</td>
109         </tr>
110 </table>
111 </td></tr></table>
112
113 @{[ vskip "3ex" ]}
114
115 <a name="news"><h2>NEWS</h2></a>
116
117 <dl>
118         <dt>captive-1.1.3.2 (2003-12-07) [@{[ a_href $W->{"project_viewcvs"}.'/*checkout*/captive/NEWS?rev=HEAD','archive' ]}]</dt>
119         <dd>
120                 <ul>
121                         <li>Proper unmount: no auto-chkdsk and no W2K BSOD (Geoff Talvola/Marek Koch)</li>
122                         <li>Prevent &quot;mv dir dir/subdir&quot; (Ulrich Mueller)</li>
123                         <li>Workaround Linux kernel bug wrt update of NTFS last sector superblock-backup</li>
124                         <li>Fixed directory listings of files with invalid timestamps (Graeme/Unit3)</li>
125                         <li>Fixed refusal of filesystem ops related to NTFS security (Tonda Nebuzelsky)</li>
126                         <li>Fixed refusal of mounting some NTFS drives</li>
127                         <li>Identify German W32 XP (No Service Pack) Free Build (Moritz Moeller-Herrmann)</li>
128                 </ul>
129         </dd>
130         <dt>lufs-0.9.7captive8 (2003-12-06) [@{[ a_href $W->{"project_viewcvs"}.'/*checkout*/lufs/NEWS.captive?rev=1.1.2.11','archive' ]}]</dt>
131         <dd>
132                 <ul>
133                         <li>Cope with the installed Linux kernel sources not matching the current kernel.</li>
134                 </ul>
135         </dd>
136 </dl>
137
138 @{[ vskip "3ex" ]}
139
140 <a name="testimonials"><h2>Captive NTFS Testimonials</h2></a>
141
142 <ul>
143         <li>Derek J Witt
144                 <p>I commend you for this project. I am currently using this on my XP NTFS
145                 partitions and I am impressed that I can actually move, edit, and remove files
146                 and directories with no apparent ill effects. This is very nice indeed.</p>
147                 <p>I initially was skeptical because it uses wine and parts of ReactOS
148                  (I have messed with this OS a few times), but you have proved me wrong. I have
149                 noticed no lag on my system.  I do notice the initial mounting process does
150                 take slightly longer than the Linux-NTFS project. But, once I'm past that, it's
151                 quite transparent.</p>
152                 <p><span style="font-style: italic;">[ technical question cut ]</span></p>
153         </li>
154         <li>James Van't Slot
155                 <p>Just wanted to drop you a note and say &quot;Excellent work!&quot;</p>
156                 <p>I just installed captive and it worked as advertized right out of the
157                 rpm.  Thanks, I've been holding off recompiling my kernel until NTFS is
158                 supported out of the box for Redhat.  Now I don't have to bother.</p>
159                 <p>Thanks again and keep up the great work.</p>
160         </li>
161 </ul>
162
163 @{[ vskip "3ex" ]}
164
165
166 <a name="notes"><h1>Installation Notes</h1></a>
167
168 <p>You should first run <b>captive-install-acquire</b> command to check your
169 available Microsoft Windows drivers versions. Now you can execute:</p>
170
171 <blockquote>
172         <p class="quote">
173                 # mkdir /mnt/dosc<br />
174                 # mount -t captive-ntfs /dev/hda1 /mnt/dosc
175         </p>
176 </blockquote>
177
178
179 <h2>Overview</h2>
180
181 <p>Any errors from '<b>captive-lufs</b>' are written to '<b>/var/log/messages</b>'.</p>
182
183 <p>Needed drivers (at least ntoskrnl.exe+ntfs.sys) must be in '<b>/var/lib/captive</b>'.</p>
184
185 <p>'<b>captive</b>' package creates '<b>captive</b>' user and '<b>captive</b>' group on your system.</p>
186
187
188 <h2>LUFS Kernel Driver Module</h2>
189
190 <p>@{[ a_href 'http://lufs.sourceforge.net/lufs/','LUFS' ]} (Linux Userland File
191 System) needs Linux kernel module driver (<i>lufs.o</i>) compatible with your
192 running Linux kernel. The binary driver is supplied already precompiled for many
193 Linux kernel versions in the binary packages above (<b>.i386.rpm</b> and
194 <b>_i386.deb</b> archives).</p>
195
196 <p>If you cannot <b>mount</b>(8) your NTFS filesystem you should run <span
197 class="quote">/usr/share/lufs/prepmod</span> to see the reasons. It is always
198 recommended to upgrade to the latest stable kernel supplied by your GNU/Linux
199 distribution vendor. You may need to install package
200 <b>kernel-source</b> (Red Hat) or <b>kernel-headers</b> (Debian) matching your
201 Linux kernel version (<b>rpm&nbsp;-q&nbsp;kernel</b>) and re-run <span
202 class="quote">/usr/share/lufs/prepmod</span>.</p>
203
204 <p><b>WARNING:</b> This 'captive' package may modify your Linux kernel
205 sources matching your currently running kernel version. These minor
206 modifications may include a dependencies rebuild, compiling build tools, fixes of
207 several include files, etc. All the modifications are done at the mount(8) time
208 by the automatically executed <span class="quote">/usr/share/lufs/prepmod</span> script.
209 This behavior was not present in the original
210 @{[ a_href 'http://lufs.sourceforge.net/lufs/','LUFS' ]} distribution
211 by @{[ a_href 'http://www.malinux.net/main/','Florin Malita' ]}.</p>
212
213
214 HERE
215
216
217 print rightimg <<"HERE",'reactos','ReactOS',"a_href"=>'http://www.reactos.com/';
218         <h2>The First Open Source MS-Windows Kernel API for Free OS</h2>
219
220         <p>Compatibility with the existing binary Microsoft Windows file system drivers has been
221         reached. Microsoft Windows kernel system components required by these drivers
222         were analyzed and successfully emulated in the GNU/Linux operating system.
223         The project brings the Microsoft Windows kernel emulation framework to support even
224         other types of Microsoft Windows drivers in the future.
225         The <span class="productname">@{[ a_href 'http://www.reactos.com/','ReactOS' ]}</span>
226         code base proved to be a big asset for this functionality.</p>
227 HERE
228
229
230 my @lists=qw(captive-announce-list captive-list captive-devel-list);
231
232 print <<"HERE";
233
234 <a name="lists"><h2>Mailing Lists</h2></a>
235
236 <form action="@{[ top_dir("/Mailman.pl") ]}" method="post">
237         <table border="1" class="mailman" style="border-collapse: collapse; border-style: solid; border-width: 1px;">
238                 <tr>@{[ map('<th>'.$_.'@jankratochvil.net</th>',@lists) ]}</tr>
239                 <tr><td>New version announcements<br />
240                         (low traffic, recommended)</td>
241                                 <td>User support,<br />bug reports</td>
242                                 <td>Development</td>
243                                 </tr>
244                 <tr>@{[ map({ "<td>".a_href(&{$W->{"mailman_url_sub"}}()."listinfo/$_",'Mailman Infopage')."</td>"; } @lists) ]}</tr>
245                 <tr>@{[ map({ "<td>".a_href(&{$W->{"pipermail_url_sub"}}()."$_",'Archive')."</td>"; } @lists) ]}</tr>
246                 <tr>@{[
247                         map(('<td><input type="checkbox" name="list" value="'.$_.'"'
248                                         .($_ ne "captive-announce-list" ? '' : ' checked="checked"')
249                                         .' /> Subscribe?</td>'),@lists)
250                         ]}</tr>
251                 <tr><td colspan="3">
252                         <table border="0" style="text-align: left;">
253                                 <tr><td>Email address:            </td><td><input type="text"     name="email"   size="30" /></td></tr>
254                                 <tr><td>Your new Mailman password:</td><td><input type="password" name="pw"      size="15" /></td></tr>
255                                 <tr><td>Reenter your password:    </td><td><input type="password" name="pw-conf" size="15" /></td></tr>
256                         </table>
257                         <p><input type="submit" name="email-button" value="Subscribe me" /></p>
258                 </td></tr>
259         </table>
260 <input type="hidden" name="back" value="/project/captive/#lists" />
261 </form>
262
263
264 @{[ vskip "3ex" ]}
265
266 <a name="seealso"><h1>See Also</h1></a>
267 <ul>
268         <li>@{[ a_href 'Preview.html.pl','Technology Preview' ]}</li>
269         <li>@{[ a_href 'CVS.html.pl','Download Sources, CVS Repository' ]}</li>
270         <li>@{[ a_href 'doc/','Developer Documentation' ]}; highlights:<ul>
271                 <li>@{[ a_href 'doc/About.html.pl#versions','Microsoft Windows Versions Compatibility' ]}</li>
272                 <li>@{[ a_href 'doc/Architecture.html.pl#law','Laws and Licensing Conditions' ]}</li>
273                 <li>@{[ a_href 'doc/Details.html.pl#sandbox','Sandboxing of W32 Filesystem' ]}</li>
274                 <li>@{[ a_href 'doc/TODO.html.pl#todo_fsck','TODO: Fsck of NTFS' ]}</li>
275                 <li>@{[ a_href 'doc/TODO.html.pl#todo_surprise','TODO: NTFS Support for Partition Surprise' ]}</li>
276                 <li>@{[ a_href 'doc/Related.html.pl#LinuxNTFScompet','Related Projects - Linux NTFS' ]}</li>
277                 <li>@{[ a_href 'doc/Related.html.pl#vmware','Related Projects - VMware Workstation' ]}</li>
278                 <li>@{[ a_href 'doc/LinuxNTFS.html.pl',"Re: 7.7 Can't we write a wrapper for Windows' driver?" ]}</li>
279                 </ul></li>
280         <li>@{[ a_href $W->{"project_viewcvs"}.'/*checkout*/captive/TODO?rev=HEAD','Known Bugs' ]}</li>
281         <li>Man Pages<ul>
282                 @{[
283                         do {
284                                 my @mans=(
285                                                 'captive'=>[7,'Microsoft Windows NT kernel emulation for NTFS disk access'],
286                                                 'mount.captive'=>[8,'mount(8) interface for NTFS disk access'],
287                                                 'lufs-captivefs'=>[7,'Linux Userland File System module for NTFS as filesystem'],
288                                                 'captive-cmdline'=>[1,'Command-line client for captive(7) NTFS disk access'],
289 ###                                             'captive-sandbox-server'=>[1,'Security+safety wrapper for NTFS disk access'],
290                                                 'captive-install-acquire'=>[1,'Find MS Windows XP driver files for NTFS'],
291 ###                                             'captive-install-fstab'=>[1,'Manage captive-ntfs /etc/fstab entries'],
292                                                 );
293                                 my @r;
294                                 while (@mans) {
295                                         my $file=shift @mans;
296                                         my($section,$name)=@{shift @mans};
297                                         push @r,"<li>".a_href("man/$file.pod.html",$file)."($section) - $name</li>\n";
298                                         }
299                                 @r;
300                                 }
301                         ]}
302                 </ul></li>
303         <li>@{[ a_href 'Resources.html.pl','Related Pages' ]}</li>
304         <li>@{[ a_href 'Thanks.html.pl','Thanks' ]}</li>
305 </ul>
306 HERE
307
308
309 My::Web->footer();