project/captive/man/captive-install-acquire.pod.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   2 <html xmlns="http://www.w3.org/1999/xhtml">
   3 <head>
   4 <title>captive-install-acquire - Find MS Windows XP driver files for B&lt;NTFS&gt;</title>
   5 <link rev="made" href="mailto:root@localhost" />
   6 </head>
   7
   8 <body style="background-color: white">
   9
  10 <p><a name="__index__"></a></p>
  11 <!-- INDEX BEGIN -->
  12
  13 <ul>
  14
  15         <li><a href="#name">NAME</a></li>
  16         <li><a href="#synopsis">SYNOPSIS</a></li>
  17         <li><a href="#description">DESCRIPTION</a></li>
  18         <li><a href="#options">OPTIONS</a></li>
  19         <li><a href="#see_also">SEE ALSO</a></li>
  20         <li><a href="#author">AUTHOR</a></li>
  21 </ul>
  22 <!-- INDEX END -->
  23
  24 <hr />
  25 <p>
  26 </p>
  27 <h1><a name="name">NAME</a></h1>
  28 <p>captive-install-acquire - Find MS Windows XP driver files for <strong>NTFS</strong></p>
  29 <p>
  30 </p>
  31 <hr />
  32 <h1><a name="synopsis">SYNOPSIS</a></h1>
  33 <p>
  34 </p>
  35 <hr />
  36 <h1><a name="description">DESCRIPTION</a></h1>
  37 <p>Program acquires the needed <em>Microsoft Windows XP</em> driver files. Multiple
  38 methods of getting the driver files are supported. All the driver files are
  39 stored to the directory
  40 <strong>/var/lib/captive/</strong>
  41 where they are
  42 expected by <strong>mount.captive</strong>(8).</p>
  43 <p>
  44 </p>
  45 <hr />
  46 <h1><a name="options">OPTIONS</a></h1>
  47 <p>Program will run interactively if no action options (<strong>--scan-disks</strong>,
  48 <strong>--scan-disks-quick</strong>, <strong>--scan-path</strong> or <strong>--microsoft-com</strong>) are specified.
  49 Otherwise the requested <code>action(s)</code> is proceeded in silent batch mode.</p>
  50 <dl>
  51 <dt><strong><a name="item_%2d%2dtext"><strong>--text</strong></a></strong><br />
  52 </dt>
  53 <dd>
  54 Disable <em>Gnome</em> user interface even if <em>X Window System</em> is available.
  55 You must specify this option as the first one. This option has effect only for
  56 interactive mode (no action options specified).
  57 </dd>
  58 <p></p>
  59 <dt><strong><a name="item_%2dv%7c%2d%2dverbose"><strong>-v</strong>|<strong>--verbose</strong></a></strong><br />
  60 </dt>
  61 <dd>
  62 Display additional information during disks scanning.
  63 </dd>
  64 <p></p>
  65 <dt><strong><a name="item_%2dn%7c%2d%2ddry"><strong>-n</strong>|<strong>--dry</strong></a></strong><br />
  66 </dt>
  67 <dd>
  68 Perform all the operations but do not modify anything (no drivers are
  69 stored to
  70 <strong>/var/lib/captive/</strong>
  71 directory).
  72 </dd>
  73 <p></p>
  74 <dt><strong><a name="item_%2d%2dmodid%2dpath%3dpath"><strong>--modid-path</strong>=<strong>path</strong></a></strong><br />
  75 </dt>
  76 <dd>
  77 Path to <strong>.captivemodid.xml</strong> database (default:
  78 <strong>/etc/w32-mod-id.captivemodid.xml</strong>). This file contains
  79 identifications (<strong>md5sum</strong>(1)) of known compatible <em>Microsoft Windows XP</em>
  80 driver files. <strong>captive-install-acquire</strong>(1) will ignore any files not
  81 identified by this file although you may try to copy them to
  82 <strong>/var/lib/captive/</strong>
  83 manually for <strong>captive</strong>(7) clients.
  84 </dd>
  85 <p></p>
  86 <dt><strong><a name="item_%2d%2dscan%2ddisks"><strong>--scan-disks</strong></a></strong><br />
  87 </dt>
  88 <dd>
  89 Scan all files on any local hard drive (mounted or unmounted) <strong>NTFS</strong> or
  90 (mounted) <strong>FAT</strong> partitions. This scanning includes <em>cabinet</em> (<strong>.cab</strong>)
  91 archives. This scanning can last for very long time.
  92 </dd>
  93 <p></p>
  94 <dt><strong><a name="item_%2d%2dscan%2ddisks%2dquick"><strong>--scan-disks-quick</strong></a></strong><br />
  95 </dt>
  96 <dd>
  97 Reduced version of <strong>--scan-disks</strong>. Only <strong>windows/system32</strong> subdirectory in
  98 the root of any local hard drive (mounted or unmounted) <strong>NTFS</strong> or (mounted)
  99 <strong>FAT</strong> partition is investigated. This scan should find existing driver files
 100 in already existing <em>Microsoft Windows XP</em> installations.
 101 </dd>
 102 <p></p>
 103 <dt><strong><a name="item_%2d%2dscan%2dpath%3dpath%2furi"><strong>--scan-path</strong>=<strong>path/URI</strong></a></strong><br />
 104 </dt>
 105 <dd>
 106 Scan the specified <strong>path/URI</strong> for device driver files. You may use either
 107 filename (<strong>/tmp/ntoskrnl.ex_</strong>), directory (<strong>/tmp/servicepack.cab</strong>), <strong>NTFS</strong>
 108 disk file/directory (<strong>file:///dev/hda1#libntfs:/windows/system32</strong>) or remote
 109 <em>URI</em> filename (<strong><a href="http://server/path/to/ntfs.sys">http://server/path/to/ntfs.sys</a></strong>). Remote <em>URI</em> directory
 110 (such as <strong><a href="http://server/subdir/">http://server/subdir/</a></strong>) is not supported.
 111 </dd>
 112 <dd>
 113 <p>Possibly specified directory is always scanned recursively.</p>
 114 </dd>
 115 <p></p>
 116 <dt><strong><a name="item_%2d%2dmicrosoft%2dcom"><strong>--microsoft-com</strong></a></strong><br />
 117 </dt>
 118 <dd>
 119 You can download the best available version of needed drivers from
 120 <em>Microsoft</em>.  They can be found in <em>Microsoft Windows XP Service Pack 1
 121 Checked Build</em> (URL
 122 <strong><a href="http://www.microsoft.com/WindowsXP/pro/downloads/servicepacks/sp1/checkedbuild.asp">http://www.microsoft.com/WindowsXP/pro/downloads/servicepacks/sp1/checkedbuild.asp</a></strong>)
 123 </dd>
 124 <dd>
 125 <p>Legal: In some countries you need to have valid <em>Microsoft Windows XP</em> license
 126 to use it.</p>
 127 </dd>
 128 <dd>
 129 <p>Program will need to download approx 29MB of data (the cabinet file is 151MB;
 130 1MB=1e6B here).</p>
 131 </dd>
 132 <p></p></dl>
 133 <p>
 134 </p>
 135 <hr />
 136 <h1><a name="see_also">SEE ALSO</a></h1>
 137 <p><strong>captive-install-fstab</strong>(1), <strong>captive</strong>(7), <strong>lufs-captivefs</strong>(7)</p>
 138 <p>
 139 </p>
 140 <hr />
 141 <h1><a name="author">AUTHOR</a></h1>
 142 <p><table cellspacing="0" cellpadding="0"><tr><td>Jan Kratochvil &lt;<strong><a href="mailto:project-captive@jankratochvil.net">project-captive@jankratochvil.net</a></strong>&gt;,
 143 <tr><td><td><em><a href="http://www.jankratochvil.net/">http://www.jankratochvil.net/</a></em></table></p>
 144
 145 </body>
 146
 147 </html>