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 $lang="";
  35 do { $lang="de" if $_ && /^de/i; } for ($ENV{"HTTP_ACCEPT_LANGUAGE"});
  36
  37
  38 my $W=My::Project->init_project(
  39                 "__PACKAGE__"=>__PACKAGE__,
  40                 "ListItem"=>\@project::captive::ListItem::ListItem,
  41                 "no_project_data"=>1,
  42                 "head_css"=>"
  43 .reqpkg { font-style: italic; }
  44 .stuff  { font-style: italic; font-size: larger; margin-left: 20%; margin-right: 10%; }
  45 .re     { font-style: italic; }
  46 table.mailman > * /* FIXME: What is it? */ > tr > th,
  47 table.mailman > * /* FIXME: What is it? */ > tr > td { padding: 1ex; text-align: center; }
  48 table.download td { padding: 8px; }
  49 table.navigate td { padding-bottom: 1ex; padding-left: 15px; padding-right: 15px; }
  50 ",
  51                 "project_text_after_title"=>""
  52                                 .($lang ne "de" ? "" : "<h1>Captive:"
  53                                                 ." Das erste kostenlose Programm um auf ein NTFS Dateisystem unter GNU/Linux zu lesen und zu schreiben</h1>")
  54                                 .'<table border="0" width="100%"><tr><td align="center">'
  55                                         .'<table border="0" class="navigate"><tr>'
  56                                                 .'<td>&bull;&nbsp;'.a_href('#download','Download').'</td>'
  57                                                 .'<td>&bull;&nbsp;'.a_href('#news','NEWS').'</td>'
  58                                                 .'<td>&bull;&nbsp;'.a_href('#testimonials','Testimonials').'</td>'
  59                                                 .'<td>&bull;&nbsp;'.a_href('#press','Internet Press').'</td>'
  60                                                 .'<td>&bull;&nbsp;'.a_href('#notes','Installation Notes').'</td>'
  61                                                 .'<td>&bull;&nbsp;'.a_href('#lists','Mailing Lists').'</td>'
  62                                                 .'<td>&bull;&nbsp;'.a_href('#seealso','See Also').'</td>'
  63                                         .'</tr></table>'
  64                                 .'</td></tr></table>',
  65                 ($lang eq "" ? () : ("force_charset"=>"utf-8")),
  66                 );
  67
  68
  69 print <<"HERE" if !$WebConfig::WebConfig{"no_job"};
  70 @{[ vskip "3ex" ]}
  71
  72 <table border="0" width="100%"><tr><td align="center">
  73         <table border="0" style="margin: 3ex; padding: 2ex; background: #bb8888;">
  74                 <tr><td style="font-size: larger;">
  75                         Looking for a challenging job: @{[ a_href $W->{"resume_url"},"My resume" ]}
  76                 </td></tr>
  77         </table>
  78 </table>
  79 HERE
  80
  81 my %version=(
  82                 map(($_=>["1.1.5","0"]),qw(captive captive-lufs captive-install)),
  83                 "lufs"=>["0.9.7","1captive8"],
  84                 );
  85
  86 print <<"HERE";
  87 <a name="download"><h2>Download</h2></a>
  88
  89 <h3>Choose the one preferred installation format:</h3>
  90
  91 <table border="0" align="center" width="100%"><tr><td align="center">
  92 <table border="1" frame="border" rules="rows" align="center" style="text-align: center;" class="download">
  93         <tr>
  94                 <td>
  95 HERE
  96         if ($lang eq "") {
  97                 print "RPM i386 binary<br />tested for distributions:";
  98                 }
  99         if ($lang eq "de") {
 100                 print "RPM i386 Binärcode<br />getestet für den Betrieb unter:";
 101                 }
 102 print <<"HERE";
 103                                         <table border="0"><tr><td align="left"><ul>
 104                                                 <li>Red&nbsp;Hat&nbsp;9&nbsp;Shrike</li>
 105                                                 <li>Red&nbsp;Hat&nbsp;8&nbsp;Psyche</li>
 106                                                 <li>SuSE&nbsp;9.0</li>
 107                                                 <li>SuSE&nbsp;9.1</li>
 108                                                 <li>Mandrake&nbsp;9.1&nbsp;Bamboo</li>
 109                                         </ul></td></tr></table>
 110                 </td>
 111                 <td>@{[ a_href 'dist/captive-static-'.$version{"captive"}[0].'-'.$version{"captive"}[1].'.i386.rpm',
 112                                 undef(),"size"=>1,"basename"=>1 ]}</td>
 113         </tr>
 114         <tr>
 115                 <td>
 116 HERE
 117         if ($lang eq "") {
 118                 print ".tar.gz i386 binary<br />(for non-RPM distributions)";
 119                 }
 120         if ($lang eq "de") {
 121                 print ".tar.gz i386 Binärcode<br />(für Linux Versionen ohne RPM z.B. Knoppix)";
 122                 }
 123 print <<"HERE";
 124                                 </td>
 125                 <td>@{[ a_href 'dist/captive-static-'.$version{"captive"}[0].'.tar.gz',undef(),"size"=>1,"basename"=>1 ]}</td>
 126         </tr>
 127         <tr>
 128                 <td>Source archives</td>
 129                 <td>@{[ a_href 'CVS.html.pl#source','download link' ]}</td>
 130         </tr>
 131 </table>
 132 </td></tr></table>
 133
 134 <h4>Known Issue</h4>
 135
 136 <p>Linux kernel interface @{[ a_href 'http://lufs.sourceforge.net/lufs/','LUFS' ]}
 137 being used for Captive is no longer maintained by LUFS author. Mounting of
 138 NTFS devices by Linux kernel usually works but it is no longer supported by the
 139 author of Captive.</p>
 140
 141 <p>Port of the Captive interface to @{[ a_href 'http://sourceforge.net/projects/avf','FUSE' ]}
 142 is not yet implemented - use
 143 @{[ a_href 'man/captive-cmdline.pod.html','captive-cmdline' ]}(1)
 144 interface in the case of any compatibility problems.</p>
 145
 146 @{[ vskip "3ex" ]}
 147
 148 <a name="news"><h2>NEWS</h2></a>
 149
 150 <dl>
 151         <dt>captive-1.1.5 (2004-01-18) [@{[ a_href $W->{"project_viewcvs"}.'/*checkout*/captive/NEWS?rev=HEAD','archive' ]}]</dt>
 152         <dd>
 153                 <ul>
 154                         <li>Fixed ignorance of the file truncate operation via LUFS (Matthias R.)</li>
 155                         <li>Support for reading of HIDDEN SYSTEM NTFS files via LUFS</li>
 156                         <li>Fixed refusal to mount some NT4.0 NTFSes (Nerijus Baliunas, Scott Chevalley)</li>
 157                         <li>Support <code>/dev/ataraid</code> devices (Ivan Tonov)</li>
 158                 </ul>
 159         </dd>
 160         <dt>lufs-0.9.7captive8 (2003-12-06) [@{[ a_href $W->{"project_viewcvs"}.'/*checkout*/lufs/NEWS.captive?rev=1.1.2.11','archive' ]}]</dt>
 161 </dl>
 162
 163 @{[ vskip "3ex" ]}
 164
 165 <a name="testimonials"><h2>Captive NTFS Testimonials</h2></a>
 166
 167 <ul>
 168         <li>Hospital of Castelo Branco - Bruno Santos
 169                 <p>we are preparing the machines to install another system that will allow
 170                 the digitalization of medical images - PACS (picture archive and
 171                 communication system).</p>
 172
 173                 <p>since the computers that are need are about 100 and we need to install
 174                 windows in all of them (even we have an almost automated instalation - but
 175                 requires some administrator interaction). So, we want to install
 176                 windows2000 without pressing a key.</p>
 177
 178                 <p>@{[ a_href 'TestimonialBrunoSantos.html.pl','<span style="font-style: italic;">[ more ]</span>' ]}</p>
 179         </li>
 180         <li>@{[ a_href 'http://www.amunra.co.uk/','Dave &quot;AmunRa&quot; Rigby' ]}
 181                 <p>Ok, I'm impressed (@{[ a_href 'http://www.amunra.co.uk/archives/000028.php','Captive Review' ]})</p>
 182                 <p>Linux software generally has a reputation for having some great, novell
 183                 ideas, but often lacking in the general 'spit and polish' - difficult to
 184                 install, unreliable, and so on. However the latest program I have tried out
 185                 - Captive, is a breath of fresh air - simple to install and set up, and It
 186                 Just WorksTM. And not only that, it's probably one of the most useful and
 187                 technically impressive projects I've seen in a long time ...</p>
 188                 <p><span style="font-style: italic;">[ snip ]</span></p>
 189         </li>
 190         <li>Derek J Witt
 191                 <p>I commend you for this project. I am currently using this on my XP NTFS
 192                 partitions and I am impressed that I can actually move, edit, and remove files
 193                 and directories with no apparent ill effects. This is very nice indeed.</p>
 194                 <p>I initially was skeptical because it uses wine and parts of ReactOS
 195                  (I have messed with this OS a few times), but you have proved me wrong. I have
 196                 noticed no lag on my system.  I do notice the initial mounting process does
 197                 take slightly longer than the Linux-NTFS project. But, once I'm past that, it's
 198                 quite transparent.</p>
 199                 <p><span style="font-style: italic;">[ technical question cut ]</span></p>
 200         </li>
 201         <li>James Van't Slot
 202                 <p>Just wanted to drop you a note and say &quot;Excellent work!&quot;</p>
 203                 <p>I just installed captive and it worked as advertized right out of the
 204                 rpm.  Thanks, I've been holding off recompiling my kernel until NTFS is
 205                 supported out of the box for Redhat.  Now I don't have to bother.</p>
 206                 <p>Thanks again and keep up the great work.</p>
 207         </li>
 208 </ul>
 209
 210 <a name="press"><h2>@{[ a_href 'Press.html.pl','Internet Press' ]}</h2></a>
 211
 212 @{[ vskip "3ex" ]}
 213
 214
 215 <a name="notes"><h1>
 216 HERE
 217         if ($lang eq "") {
 218                 print "Installation Notes";
 219                 }
 220         if ($lang eq "de") {
 221                 print "Installationsanleitung";
 222                 }
 223 print <<"HERE";
 224 </h1></a>
 225 HERE
 226         if ($lang eq "") {
 227                 print <<"EOF";
 228 <p>You should first run <b>captive-install-acquire</b> command to check your
 229 available Microsoft Windows drivers versions. Now you can execute:</p>
 230 EOF
 231                 }
 232         if ($lang eq "de") {
 233                 print <<"EOF";
 234 <p>Sie sollten als erstes den Befehl <b>captive-install-acquire</b>
 235 ausführen um ihre Windows Treiber Version zu überprüfen. Nun können sie folgenden Befehl ausführen:</p>
 236 EOF
 237                 }
 238 print <<"HERE";
 239
 240 <blockquote>
 241         <p class="quote">
 242                 # mkdir /mnt/dosc<br />
 243                 # mount -t captive-ntfs /dev/hda1 /mnt/dosc
 244         </p>
 245 </blockquote>
 246
 247
 248 HERE
 249         if ($lang eq "") {
 250                 print <<"EOF";
 251 <h2>Overview</h2>
 252
 253 <p>Any errors from '<b>captive-lufs</b>' are written to '<b>/var/log/messages</b>'.</p>
 254 <p>Needed drivers (at least ntoskrnl.exe+ntfs.sys) must be in '<b>/var/lib/captive</b>'.</p>
 255 <p>'<b>captive</b>' package creates '<b>captive</b>' user and '<b>captive</b>' group on your system.</p>
 256 EOF
 257                 }
 258         if ($lang eq "de") {
 259                 print <<"EOF";
 260 <h2>Übersicht</h2>
 261
 262 <p>Jegliche Fehler des '<b>captive-lufs</b>' werden im Ordner '<b>/var/log/messages</b>' aufgelistet.</p>
 263 <p>Die Dateien ntoskrnl.exe und ntfs.sys müssen in den '<b>/var/lib/captive</b>'-Ordner kopiert werden.
 264 (Empfehlendswert über ein Wechseldatenträger [CD-ROM, Diskette].)</p>
 265 <p>Das '<b>captive</b>' Packet erstellt einen '<b>captive</b>' Benutzer und eine '<b>captive</b>' Gruppe auf Ihrem System.</p>
 266 <p align="right" style="font-size: smaller;">Übersetzung von Botond Beres.</p>
 267 EOF
 268                 }
 269 print <<"HERE";
 270
 271
 272 <h2>LUFS Kernel Driver Module</h2>
 273
 274 <p>@{[ a_href 'http://lufs.sourceforge.net/lufs/','LUFS' ]} (Linux Userland File
 275 System) needs Linux kernel module driver (<i>lufs.o</i>) compatible with your
 276 running Linux kernel. The binary driver is supplied already precompiled for many
 277 Linux kernel versions in the binary packages above (<b>.i386.rpm</b> and
 278 <b>_i386.deb</b> archives).</p>
 279
 280 <p>If you cannot <b>mount</b>(8) your NTFS filesystem you should run <span
 281 class="quote">/usr/share/lufs/prepmod</span> to see the reasons. It is always
 282 recommended to upgrade to the latest stable kernel supplied by your GNU/Linux
 283 distribution vendor. You may need to install package
 284 <b>kernel-source</b> (Red Hat) or <b>kernel-headers</b> (Debian) matching your
 285 Linux kernel version (<b>rpm&nbsp;-q&nbsp;kernel</b>) and re-run <span
 286 class="quote">/usr/share/lufs/prepmod</span>.</p>
 287
 288 <p><b>WARNING:</b> This 'captive' package may modify your Linux kernel
 289 sources matching your currently running kernel version. These minor
 290 modifications may include a dependencies rebuild, compiling build tools, fixes of
 291 several include files, etc. All the modifications are done at the mount(8) time
 292 by the automatically executed <span class="quote">/usr/share/lufs/prepmod</span> script.
 293 This behavior was not present in the original
 294 @{[ a_href 'http://lufs.sourceforge.net/lufs/','LUFS' ]} distribution
 295 by @{[ a_href 'http://www.malinux.net/main/','Florin Malita' ]}.</p>
 296
 297
 298 HERE
 299
 300
 301 print rightimg <<"HERE",'reactos','ReactOS',"a_href"=>'http://www.reactos.com/';
 302         <h2>The First Open Source MS-Windows Kernel API for Free OS</h2>
 303
 304         <p>Compatibility with the existing binary Microsoft Windows file system drivers has been
 305         reached. Microsoft Windows kernel system components required by these drivers
 306         were analyzed and successfully emulated in the GNU/Linux operating system.
 307         The project brings the Microsoft Windows kernel emulation framework to support even
 308         other types of Microsoft Windows drivers in the future.
 309         The <span class="productname">@{[ a_href 'http://www.reactos.com/','ReactOS' ]}</span>
 310         code base proved to be a big asset for this functionality.</p>
 311 HERE
 312
 313
 314 my @lists=qw(captive-announce-list captive-list captive-devel-list);
 315
 316 print <<"HERE";
 317
 318 <a name="lists"><h2>Mailing Lists</h2></a>
 319
 320 <form action="@{[ top_dir("/Mailman.pl") ]}" method="post">
 321         <table border="1" class="mailman" style="border-collapse: collapse; border-style: solid; border-width: 1px;">
 322                 <tr>@{[ map('<th>'.$_.'@jankratochvil.net</th>',@lists) ]}</tr>
 323                 <tr><td>New version announcements<br />
 324                         (low traffic, recommended)</td>
 325                                 <td>User support,<br />bug reports</td>
 326                                 <td>Development</td>
 327                                 </tr>
 328                 <tr>@{[ map({ "<td>".a_href(&{$W->{"mailman_url_sub"}}()."listinfo/$_",'Mailman Infopage')."</td>"; } @lists) ]}</tr>
 329                 <tr>@{[ map({ "<td>".a_href(&{$W->{"pipermail_url_sub"}}()."$_",'Archive')."</td>"; } @lists) ]}</tr>
 330                 <tr>@{[
 331                         map(('<td><input type="checkbox" name="list" value="'.$_.'"'
 332                                         .($_ ne "captive-announce-list" ? '' : ' checked="checked"')
 333                                         .' /> Subscribe?</td>'),@lists)
 334                         ]}</tr>
 335                 <tr><td colspan="3">
 336                         <table border="0" style="text-align: left;">
 337                                 <tr><td>Email address:            </td><td><input type="text"     name="email"   size="30" /></td></tr>
 338                                 <tr><td>Your new Mailman password:</td><td><input type="password" name="pw"      size="15" /></td></tr>
 339                                 <tr><td>Reenter your password:    </td><td><input type="password" name="pw-conf" size="15" /></td></tr>
 340                         </table>
 341                         <p><input type="submit" name="email-button" value="Subscribe me" /></p>
 342                 </td></tr>
 343         </table>
 344 <input type="hidden" name="back" value="/project/captive/#lists" />
 345 </form>
 346
 347
 348 @{[ vskip "3ex" ]}
 349
 350 <a name="seealso"><h1>See Also</h1></a>
 351 <ul>
 352         <li>@{[ a_href 'Preview.html.pl','Technology Preview' ]}</li>
 353         <li>@{[ a_href 'CVS.html.pl','Download Sources, CVS Repository' ]}</li>
 354         <li>@{[ a_href 'doc/','Developer Documentation' ]}; highlights:<ul>
 355                 <li>@{[ a_href 'doc/About.html.pl#versions','Microsoft Windows Versions Compatibility' ]}</li>
 356                 <li>@{[ a_href 'doc/Architecture.html.pl#law','Laws and Licensing Conditions' ]}</li>
 357                 <li>@{[ a_href 'doc/Details.html.pl#sandbox','Sandboxing of W32 Filesystem' ]}</li>
 358                 <li>@{[ a_href 'doc/TODO.html.pl#todo_fsck','TODO: Fsck of NTFS' ]}</li>
 359                 <li>@{[ a_href 'doc/TODO.html.pl#todo_surprise','TODO: NTFS Support for Partition Surprise' ]}</li>
 360                 <li>@{[ a_href 'doc/Related.html.pl#LinuxNTFScompet','Related Projects - Linux NTFS' ]}</li>
 361                 <li>@{[ a_href 'doc/Related.html.pl#vmware','Related Projects - VMware Workstation' ]}</li>
 362                 <li>@{[ a_href 'doc/LinuxNTFS.html.pl',"Re: 7.7 Can't we write a wrapper for Windows' driver?" ]}</li>
 363                 </ul></li>
 364         <li>@{[ a_href $W->{"project_viewcvs"}.'/*checkout*/captive/TODO?rev=HEAD','Known Bugs' ]}</li>
 365         <li>Man Pages<ul>
 366                 @{[
 367                         do {
 368                                 my @mans=(
 369                                                 'captive'=>[7,'Microsoft Windows NT kernel emulation for NTFS disk access'],
 370                                                 'mount.captive'=>[8,'mount(8) interface for NTFS disk access'],
 371                                                 'lufs-captivefs'=>[7,'Linux Userland File System module for NTFS as filesystem'],
 372                                                 'captive-cmdline'=>[1,'Command-line client for captive(7) NTFS disk access'],
 373 ###                                             'captive-sandbox-server'=>[1,'Security+safety wrapper for NTFS disk access'],
 374                                                 'captive-install-acquire'=>[1,'Find MS Windows XP driver files for NTFS'],
 375 ###                                             'captive-install-fstab'=>[1,'Manage captive-ntfs /etc/fstab entries'],
 376                                                 );
 377                                 my @r;
 378                                 while (@mans) {
 379                                         my $file=shift @mans;
 380                                         my($section,$name)=@{shift @mans};
 381                                         push @r,"<li>".a_href("man/$file.pod.html",$file)."($section) - $name</li>\n";
 382                                         }
 383                                 @r;
 384                                 }
 385                         ]}
 386                 </ul></li>
 387         <li>@{[ a_href 'Resources.html.pl','Related Pages' ]}</li>
 388         <li>@{[ a_href 'Thanks.html.pl','Thanks' ]}</li>
 389 </ul>
 390 HERE
 391
 392
 393 My::Web->footer();