#! /usr/bin/perl
# 
# $Id$
# perlpod(1) source for captive-install-acquire(1) man page
# Copyright (C) 2003 Jan Kratochvil <project-captive@jankratochvil.net>
# 
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; exactly version 2 of June 1991 is required
# 
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
# 
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA


use vars qw($VERSION);
$VERSION=do { my @r=(q$Revision$=~/\d+/g); sprintf "%d.".("%03d"x$#r),@r; };
use strict;
use warnings;


my $vardir='@localstatedir@/lib/@PACKAGE@';
$vardir=~s#\$\Q{prefix}\E#'@prefix@';#ge;
$vardir="/var/lib/@PACKAGE@" if $vardir=~/^@/;
my $sysconfdir='@sysconfdir@';
$sysconfdir=~s#\$\Q{prefix}\E#'@prefix@';#ge;
$sysconfdir="/etc" if $sysconfdir=~/^@/;

print <<'POD_EOF';
=head1 NAME

@PACKAGE@-install-acquire - Find MS Windows XP driver files for B<NTFS>


=head1 SYNOPSIS

=for man
\fB@PACKAGE@-install-acquire\fP [\fB--text]
[\fB-v\fP|\fB--verbose\fP] [\fB-n\fP|\fB--dry\fP]
.br
		[\fB--modid-path\fP=\fBpath\fP] [\fB--scan-disks\fP] [\fB--scan-disks-quick\fP]
.br
		[\fB--scan-path\fP=\fBpath/URI\fP] [\fB--microsoft-com\fP]


=head1 DESCRIPTION

Program acquires the needed I<Microsoft Windows XP> driver files. Multiple
methods of getting the driver files are supported. All the driver files are
stored to the directory
POD_EOF
print "B<$vardir/>\n";
print <<'POD_EOF';
where they are
expected by B<mount.@PACKAGE@>(8).


=head1 OPTIONS

Program will run interactively if no action options (B<--scan-disks>,
B<--scan-disks-quick>, B<--scan-path> or B<--microsoft-com>) are specified.
Otherwise the requested action(s) is proceeded in silent batch mode.

=over

=item B<--text>

Disable I<Gnome> user interface even if I<X Window System> is available.
You must specify this option as the first one. This option has effect only for
interactive mode (no action options specified).


=item B<-v>|B<--verbose>

Display additional information during disks scanning.


=item B<-n>|B<--dry>

Perform all the operations but do not modify anything (no drivers are
stored to
POD_EOF
print "B<$vardir/>\n";
print <<'POD_EOF';
directory).


=item B<--modid-path>=B<path>

Path to B<.captivemodid.xml> database (default:
POD_EOF
print "B<$sysconfdir/w32-mod-id.captivemodid.xml>";
print <<'POD_EOF';
). This file contains
identifications (B<md5sum>(1)) of known compatible I<Microsoft Windows XP>
driver files. B<@PACKAGE@-install-acquire>(1) will ignore any files not
identified by this file although you may try to copy them to
POD_EOF
print "B<$vardir/>\n";
print <<'POD_EOF';
manually for B<@PACKAGE@>(7) clients.


=item B<--scan-disks>

Scan all files on any local hard drive (mounted or unmounted) B<NTFS> or
(mounted) B<FAT> partitions. This scanning includes I<cabinet> (B<.cab>)
archives. This scanning can last for very long time.


=item B<--scan-disks-quick>

Reduced version of B<--scan-disks>. Only B<windows/system32> subdirectory in
the root of any local hard drive (mounted or unmounted) B<NTFS> or (mounted)
B<FAT> partition is investigated. This scan should find existing driver files
in already existing I<Microsoft Windows XP> installations.


=item B<--scan-path>=B<path/URI>

Scan the specified B<path/URI> for device driver files. You may use either
filename (B</tmp/ntoskrnl.ex_>), directory (B</tmp/servicepack.cab>), B<NTFS>
disk file/directory (B<file:///dev/hda1#libntfs:/windows/system32>) or remote
I<URI> filename (B<http://server/path/to/ntfs.sys>). Remote I<URI> directory
(such as B<http://server/subdir/>) is not supported.

Possibly specified directory is always scanned recursively.


=item B<--microsoft-com>

You can download the best available version of needed drivers from
I<Microsoft>.  They can be found in I<Microsoft Windows XP Service Pack 2
Checked Build> (URL
B<http://msdn.microsoft.com/security/productinfo/xpsp2>)

Legal: In some countries you need to have valid I<Microsoft Windows XP> license
to use it.

Program will need to download approx 61MB of data (the cabinet file is 307MB;
1MB=1e6B here).


=back


=head1 SEE ALSO

B<@PACKAGE@-install-fstab>(1), B<@PACKAGE@>(7), B<lufs-@PACKAGE@fs>(7)


=head1 AUTHOR

Jan Kratochvil <B<project-@PACKAGE@@jankratochvil.net>>,
		I<http://www.jankratochvil.net/>
POD_EOF
1;