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>Development Status</h4>
 135
 136 <p>Project is no longer developed. The key functionality is reached
 137 by the latest released version. All its resources are available
 138 @{[ a_href 'CVS.html.pl#source','here' ]} for download.</p>
 139
 140 <h4>Known Issue</h4>
 141
 142 <p>Captive was written to interface with the Linux kernel via
 143 @{[ a_href 'http://lufs.sourceforge.net/lufs/','LUFS' ]}.
 144 Unfortunately, this project is no longer being maintained by its author.
 145 Mounting of NTFS devices usually works, but is no longer supported by the
 146 author of Captive. Always unmount the device by umount(8) command before shutting
 147 down your GNU/Linux system.</p>
 148
 149 <p>A port of Captive to the newer
 150 @{[ a_href 'http://fuse.sourceforge.net/','FUSE' ]}
 151 interface has not yet been implemented.
 152 There is an experimental LUFS-FUSE bridge called
 153 @{[ a_href 'http://sourceforge.net/project/showfiles.php?group_id=121684','lufis' ]}
 154 that can be used in the meanwhile.
 155 Also, the captive-cmdline(1) interface will get around any kernel compatibility
 156 problems.</p>
 157
 158 @{[ vskip "3ex" ]}
 159
 160 <a name="news"><h2>NEWS</h2></a>
 161
 162 <dl>
 163         <dt>captive-1.1.5 (2004-01-18) [@{[ a_href $W->{"project_viewcvs"}.'/*checkout*/captive/NEWS?rev=HEAD','archive' ]}]</dt>
 164         <dd>
 165                 <ul>
 166                         <li>Fixed ignorance of the file truncate operation via LUFS (Matthias R.)</li>
 167                         <li>Support for reading of HIDDEN SYSTEM NTFS files via LUFS</li>
 168                         <li>Fixed refusal to mount some NT4.0 NTFSes (Nerijus Baliunas, Scott Chevalley)</li>
 169                         <li>Support <code>/dev/ataraid</code> devices (Ivan Tonov)</li>
 170                 </ul>
 171         </dd>
 172         <dt>lufs-0.9.7captive8 (2003-12-06) [@{[ a_href $W->{"project_viewcvs"}.'/*checkout*/lufs/NEWS.captive?rev=1.1.2.11','archive' ]}]</dt>
 173 </dl>
 174
 175 @{[ vskip "3ex" ]}
 176
 177 <a name="testimonials"><h2>Captive NTFS Testimonials</h2></a>
 178
 179 <ul>
 180         <li>Hospital of Castelo Branco - Bruno Santos
 181                 <p>we are preparing the machines to install another system that will allow
 182                 the digitalization of medical images - PACS (picture archive and
 183                 communication system).</p>
 184
 185                 <p>since the computers that are need are about 100 and we need to install
 186                 windows in all of them (even we have an almost automated instalation - but
 187                 requires some administrator interaction). So, we want to install
 188                 windows2000 without pressing a key.</p>
 189
 190                 <p>@{[ a_href 'TestimonialBrunoSantos.html.pl','<span style="font-style: italic;">[ more ]</span>' ]}</p>
 191         </li>
 192         <li>@{[ a_href 'http://www.amunra.co.uk/','Dave &quot;AmunRa&quot; Rigby' ]}
 193                 <p>Ok, I'm impressed (@{[ a_href 'http://www.amunra.co.uk/archives/000028.php','Captive Review' ]})</p>
 194                 <p>Linux software generally has a reputation for having some great, novell
 195                 ideas, but often lacking in the general 'spit and polish' - difficult to
 196                 install, unreliable, and so on. However the latest program I have tried out
 197                 - Captive, is a breath of fresh air - simple to install and set up, and It
 198                 Just WorksTM. And not only that, it's probably one of the most useful and
 199                 technically impressive projects I've seen in a long time ...</p>
 200                 <p><span style="font-style: italic;">[ snip ]</span></p>
 201         </li>
 202         <li>Derek J Witt
 203                 <p>I commend you for this project. I am currently using this on my XP NTFS
 204                 partitions and I am impressed that I can actually move, edit, and remove files
 205                 and directories with no apparent ill effects. This is very nice indeed.</p>
 206                 <p>I initially was skeptical because it uses wine and parts of ReactOS
 207                  (I have messed with this OS a few times), but you have proved me wrong. I have
 208                 noticed no lag on my system.  I do notice the initial mounting process does
 209                 take slightly longer than the Linux-NTFS project. But, once I'm past that, it's
 210                 quite transparent.</p>
 211                 <p><span style="font-style: italic;">[ technical question cut ]</span></p>
 212         </li>
 213         <li>James Van't Slot
 214                 <p>Just wanted to drop you a note and say &quot;Excellent work!&quot;</p>
 215                 <p>I just installed captive and it worked as advertized right out of the
 216                 rpm.  Thanks, I've been holding off recompiling my kernel until NTFS is
 217                 supported out of the box for Redhat.  Now I don't have to bother.</p>
 218                 <p>Thanks again and keep up the great work.</p>
 219         </li>
 220 </ul>
 221
 222 <a name="press"><h2>@{[ a_href 'Press.html.pl','Internet Press' ]}</h2></a>
 223
 224 @{[ vskip "3ex" ]}
 225
 226
 227 <a name="notes"><h1>
 228 HERE
 229         if ($lang eq "") {
 230                 print "Installation Notes";
 231                 }
 232         if ($lang eq "de") {
 233                 print "Installationsanleitung";
 234                 }
 235 print <<"HERE";
 236 </h1></a>
 237 HERE
 238         if ($lang eq "") {
 239                 print <<"EOF";
 240 <p>You should first run <b>captive-install-acquire</b> command to check your
 241 available Microsoft Windows drivers versions. Now you can execute:</p>
 242 EOF
 243                 }
 244         if ($lang eq "de") {
 245                 print <<"EOF";
 246 <p>Sie sollten als erstes den Befehl <b>captive-install-acquire</b>
 247 ausführen um ihre Windows Treiber Version zu überprüfen. Nun können sie folgenden Befehl ausführen:</p>
 248 EOF
 249                 }
 250 print <<"HERE";
 251
 252 <blockquote>
 253         <p class="quote" style="white-space: pre;"
 254 ># captive-cmdline \\
 255                 --load-module=/var/lib/captive/ntoskrnl.exe \\
 256                 --filesystem=/var/lib/captive/ntfs.sys \\
 257                 --sandbox-server=/usr/sbin/captive-sandbox-server \\
 258                 --bug-pathname=/tmp/captive-bug-%FT%T.captivebug.xml.gz \\
 259                 --disk --rw /dev/hda1
 260 # Now you can use ftp(1)-like command-line interface for the NTFS disk access.</p
 261         >
 262         <p>(Backslash end-of-line characters '\\' to be omitted for line continuation.)</p>
 263 </blockquote>
 264
 265
 266 HERE
 267         if ($lang eq "") {
 268                 print <<"EOF";
 269 <h2>Overview</h2>
 270
 271 <p>Any errors from '<b>captive-lufs</b>' are written to '<b>/var/log/messages</b>'.</p>
 272 <p>Needed drivers (at least ntoskrnl.exe+ntfs.sys) must be in '<b>/var/lib/captive</b>'.</p>
 273 <p>'<b>captive</b>' package creates '<b>captive</b>' user and '<b>captive</b>' group on your system.</p>
 274 EOF
 275                 }
 276         if ($lang eq "de") {
 277                 print <<"EOF";
 278 <h2>Übersicht</h2>
 279
 280 <p>Jegliche Fehler des '<b>captive-lufs</b>' werden im Ordner '<b>/var/log/messages</b>' aufgelistet.</p>
 281 <p>Die Dateien ntoskrnl.exe und ntfs.sys müssen in den '<b>/var/lib/captive</b>'-Ordner kopiert werden.
 282 (Empfehlendswert über ein Wechseldatenträger [CD-ROM, Diskette].)</p>
 283 <p>Das '<b>captive</b>' Packet erstellt einen '<b>captive</b>' Benutzer und eine '<b>captive</b>' Gruppe auf Ihrem System.</p>
 284 <p align="right" style="font-size: smaller;">Übersetzung von Botond Beres.</p>
 285 EOF
 286                 }
 287 print <<"HERE";
 288
 289
 290 <h2>LUFS Kernel Driver Module</h2>
 291
 292 <p>@{[ a_href 'http://lufs.sourceforge.net/lufs/','LUFS' ]} (Linux Userland File
 293 System) needs Linux kernel module driver (<i>lufs.o</i>) compatible with your
 294 running Linux kernel. The binary driver is supplied already precompiled for many
 295 Linux kernel versions in the binary packages above (<b>.i386.rpm</b> and
 296 <b>_i386.deb</b> archives).</p>
 297
 298 <p>If you cannot <b>mount</b>(8) your NTFS filesystem you should run <span
 299 class="quote">/usr/share/lufs/prepmod</span> to see the reasons. It is always
 300 recommended to upgrade to the latest stable kernel supplied by your GNU/Linux
 301 distribution vendor. You may need to install package
 302 <b>kernel-source</b> (Red Hat) or <b>kernel-headers</b> (Debian) matching your
 303 Linux kernel version (<b>rpm&nbsp;-q&nbsp;kernel</b>) and re-run <span
 304 class="quote">/usr/share/lufs/prepmod</span>.</p>
 305
 306 <p><b>WARNING:</b> This 'captive' package may modify your Linux kernel
 307 sources matching your currently running kernel version. These minor
 308 modifications may include a dependencies rebuild, compiling build tools, fixes of
 309 several include files, etc. All the modifications are done at the mount(8) time
 310 by the automatically executed <span class="quote">/usr/share/lufs/prepmod</span> script.
 311 This behavior was not present in the original
 312 @{[ a_href 'http://lufs.sourceforge.net/lufs/','LUFS' ]} distribution
 313 by @{[ a_href 'http://www.malinux.net/main/','Florin Malita' ]}.</p>
 314
 315
 316 HERE
 317
 318
 319 print rightimg <<"HERE",'reactos','ReactOS',"a_href"=>'http://www.reactos.com/';
 320         <h2>The First Open Source MS-Windows Kernel API for Free OS</h2>
 321
 322         <p>Compatibility with the existing binary Microsoft Windows file system drivers has been
 323         reached. Microsoft Windows kernel system components required by these drivers
 324         were analyzed and successfully emulated in the GNU/Linux operating system.
 325         The project brings the Microsoft Windows kernel emulation framework to support even
 326         other types of Microsoft Windows drivers in the future.
 327         The <span class="productname">@{[ a_href 'http://www.reactos.com/','ReactOS' ]}</span>
 328         code base proved to be a big asset for this functionality.</p>
 329 HERE
 330
 331
 332 my @lists=qw(captive-announce-list captive-list captive-devel-list);
 333
 334 print <<"HERE";
 335
 336 <a name="lists"><h2>Mailing Lists</h2></a>
 337
 338 <form action="@{[ top_dir("/Mailman.pl") ]}" method="post">
 339         <table border="1" class="mailman" style="border-collapse: collapse; border-style: solid; border-width: 1px;">
 340                 <tr>@{[ map('<th>'.$_.'@jankratochvil.net</th>',@lists) ]}</tr>
 341                 <tr><td>New version announcements<br />
 342                         (low traffic, recommended)</td>
 343                                 <td>User support,<br />bug reports</td>
 344                                 <td>Development</td>
 345                                 </tr>
 346                 <tr>@{[ map({ "<td>".a_href(&{$W->{"mailman_url_sub"}}()."listinfo/$_",'Mailman Infopage')."</td>"; } @lists) ]}</tr>
 347                 <tr>@{[ map({ "<td>".a_href(&{$W->{"pipermail_url_sub"}}()."$_",'Archive')."</td>"; } @lists) ]}</tr>
 348                 <tr>@{[
 349                         map(('<td><input type="checkbox" name="list" value="'.$_.'"'
 350                                         .($_ ne "captive-announce-list" ? '' : ' checked="checked"')
 351                                         .' /> Subscribe?</td>'),@lists)
 352                         ]}</tr>
 353                 <tr><td colspan="3">
 354                         <table border="0" style="text-align: left;">
 355                                 <tr><td>Email address:            </td><td><input type="text"     name="email"   size="30" /></td></tr>
 356                                 <tr><td>Your new Mailman password:</td><td><input type="password" name="pw"      size="15" /></td></tr>
 357                                 <tr><td>Reenter your password:    </td><td><input type="password" name="pw-conf" size="15" /></td></tr>
 358                         </table>
 359                         <p><input type="submit" name="email-button" value="Subscribe me" /></p>
 360                 </td></tr>
 361         </table>
 362 <input type="hidden" name="back" value="/project/captive/#lists" />
 363 </form>
 364
 365
 366 @{[ vskip "3ex" ]}
 367
 368 <a name="seealso"><h1>See Also</h1></a>
 369 <ul>
 370         <li>@{[ a_href 'Preview.html.pl','Technology Preview' ]}</li>
 371         <li>@{[ a_href 'CVS.html.pl','Download Sources, CVS Repository' ]}</li>
 372         <li>@{[ a_href 'doc/','Developer Documentation' ]}; highlights:<ul>
 373                 <li>@{[ a_href 'doc/About.html.pl#versions','Microsoft Windows Versions Compatibility' ]}</li>
 374                 <li>@{[ a_href 'doc/Architecture.html.pl#law','Laws and Licensing Conditions' ]}</li>
 375                 <li>@{[ a_href 'doc/Details.html.pl#sandbox','Sandboxing of W32 Filesystem' ]}</li>
 376                 <li>@{[ a_href 'doc/TODO.html.pl#todo_fsck','TODO: Fsck of NTFS' ]}</li>
 377                 <li>@{[ a_href 'doc/TODO.html.pl#todo_surprise','TODO: NTFS Support for Partition Surprise' ]}</li>
 378                 <li>@{[ a_href 'doc/Related.html.pl#LinuxNTFScompet','Related Projects - Linux NTFS' ]}</li>
 379                 <li>@{[ a_href 'doc/Related.html.pl#vmware','Related Projects - VMware Workstation' ]}</li>
 380                 <li>@{[ a_href 'doc/LinuxNTFS.html.pl',"Re: 7.7 Can't we write a wrapper for Windows' driver?" ]}</li>
 381                 </ul></li>
 382         <li>@{[ a_href $W->{"project_viewcvs"}.'/*checkout*/captive/TODO?rev=HEAD','Known Bugs' ]}</li>
 383         <li>Man Pages<ul>
 384                 @{[
 385                         do {
 386                                 my @mans=(
 387                                                 'captive'=>[7,'Microsoft Windows NT kernel emulation for NTFS disk access'],
 388                                                 'mount.captive'=>[8,'mount(8) interface for NTFS disk access'],
 389                                                 'lufs-captivefs'=>[7,'Linux Userland File System module for NTFS as filesystem'],
 390                                                 'captive-cmdline'=>[1,'Command-line client for captive(7) NTFS disk access'],
 391 ###                                             'captive-sandbox-server'=>[1,'Security+safety wrapper for NTFS disk access'],
 392                                                 'captive-install-acquire'=>[1,'Find MS Windows XP driver files for NTFS'],
 393 ###                                             'captive-install-fstab'=>[1,'Manage captive-ntfs /etc/fstab entries'],
 394                                                 );
 395                                 my @r;
 396                                 while (@mans) {
 397                                         my $file=shift @mans;
 398                                         my($section,$name)=@{shift @mans};
 399                                         push @r,"<li>".a_href("man/$file.pod.html",$file)."($section) - $name</li>\n";
 400                                         }
 401                                 @r;
 402                                 }
 403                         ]}
 404                 </ul></li>
 405         <li>@{[ a_href 'Resources.html.pl','Related Pages' ]}</li>
 406         <li>@{[ a_href 'Thanks.html.pl','Thanks' ]}</li>
 407 </ul>
 408 HERE
 409
 410
 411 My::Web->footer();