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