Changeset 40441 in vbox for trunk/doc

Timestamp:

Mar 13, 2012 11:37:19 AM (13 years ago)

Author:

vboxsync

Message:

doc: improved r76791

File:

• trunk/doc/manual/en_US/user_AdvancedTopics.xml (modified) (2 diffs)

trunk/doc/manual/en_US/user_AdvancedTopics.xml

@@ -1267 +1267 @@
       the resolver mode will interpret the DNS requests and use the host's DNS
       API to query the information and return it to the guest.</para>
+
         <sect3 id="nat_host_resolver_name_intercepting">
-            <title>User-defined host name resolving</title>
-            <para>In some cases it might be useful to intercept name resolving mechanism,
-            providing user-defined IP address on particular DNS request. Intercepting mechanism
-            lets user to map not only single host, but domains and more complex namings conventions if
-            required.
-            This command set rule for mapping name to specified IP.
-            <screen>
-                VBoxManage setextradata &lt;your-vm&gt; \
-                    "VBoxInternal/Devices/{pcnet,e1000}/0/LUN#0/Config/HostResolverMappings/\
-                     &lt;uniq name of interception rule&gt;/HostIP" &lt;IPv4&gt;
-                VBoxManage setextradata &lt;your-vm&gt; \
-                    "VBoxInternal/Devices/{pcnet,e1000}/0/LUN#0/Config/HostResolverMappings/\
-                    &lt;uniq name of interception rule&gt;/HostName" &lt;name of host&gt;
-            </screen>
-            This command set rule for mapping pattern name to specified IP.
-            <screen>
-                VBoxManage setextradata &lt;your-vm&gt; \
-                    "VBoxInternal/Devices/{pcnet,e1000}/0/LUN#0/Config/HostResolverMappings/\
-                    &lt;uniq name of interception rule&gt;/HostIP" &lt;IPv4&gt;
-                VBoxManage setextradata &lt;your-vm&gt; \
-                    "VBoxInternal/Devices/{pcnet,e1000}/0/LUN#0/Config/HostResolverMappings/\
-                    &lt;uniq name of interception rule&gt;/HostNamePattern" &lt;pattern of host "|","?","*" are allowed&gt;
-            </screen>
-            This example demonstrates how to instruct host-resolver mechanism to resolve all domain
-            and probably some mirrors of www.forbiden-palace.info site with IP 127.0.0.1.
-            <screen>
-                VBoxManage setextradata &lt;your-vm&gt; \
-                    "VBoxInternal/Devices/e1000/0/LUN#0/Config/HostResolverMappings/\
-                    all_forbiden_palace/HostIP" 127.0.0.1
-                VBoxManage setextradata &lt;your-vm&gt; \
-                    "VBoxInternal/Devices/e1000/0/LUN#0/Config/HostResolverMappings/\
-                    all_forbiden_palace/HostNamePattern" "*.forbinden-palace.*|*.fb.org"
-            </screen>
-            Note: host resolver mechanism should be on to use defined by user mapping rules (please see
-            <xref linkend="nat_host_resolver_proxy" /> for more details).
-            </para>
+          <title>User-defined host name resolving</title>
+          <para>In some cases it might be useful to intercept the name resolving mechanism,
+            providing a user-defined IP address on a particular DNS request. The intercepting
+            mechanism allows the user to map not only a single host but domains and even more
+            complex namings conventions if required.</para>
+            <para>
+              The following command sets a rule for mapping a name to a specified IP:</para>
+            <screen>VBoxManage setextradata "VM name" \
+      "VBoxInternal/Devices/{pcnet,e1000}/0/LUN#0/Config/HostResolverMappings/ \
+      &lt;uniq name of interception rule&gt;/HostIP" &lt;IPv4&gt;
+VBoxManage setextradata "VM name" \
+      "VBoxInternal/Devices/{pcnet,e1000}/0/LUN#0/Config/HostResolverMappings/ \
+      &lt;uniq name of interception rule&gt;/HostName" &lt;name of host&gt;</screen>
+    <para>The following command sets a rule for mapping a pattern name to a specified IP:</para>
+            <screen>VBoxManage setextradata "VM name" \
+      "VBoxInternal/Devices/{pcnet,e1000}/0/LUN#0/Config/HostResolverMappings/ \
+      &lt;uniq name of interception rule&gt;/HostIP" &lt;IPv4&gt;
+VBoxManage setextradata "VM name" \
+      "VBoxInternal/Devices/{pcnet,e1000}/0/LUN#0/Config/HostResolverMappings/ \
+      &lt;uniq name of interception rule&gt;/HostNamePattern" &lt;hostpattern&gt;</screen>
+    <para>The host pattern may include <computeroutput>"|", "?" and "*"</computeroutput>.</para>
+    <para>This example demonstrates how to instruct the host-resolver mechanism to resolve
+      all domain and probably some mirrors of www.blocked-site.info site with IP 127.0.0.1:</para>
+            <screen>VBoxManage setextradata "VM name" \
+      "VBoxInternal/Devices/e1000/0/LUN#0/Config/HostResolverMappings/ \
+      all_blocked_site/HostIP" 127.0.0.1
+VBoxManage setextradata "VM name" \
+      "VBoxInternal/Devices/e1000/0/LUN#0/Config/HostResolverMappings/ \
+      all_blocked_site/HostNamePattern" "*.blocked-site.*|*.fb.org"</screen>
+           <note><para>The host resolver mechanism should be enabled to use user-defined
+             mapping rules (please see
+             <xref linkend="nat_host_resolver_proxy" /> for more details).</para></note>
         </sect3>
     </sect2>
@@ -1462 +1459 @@
       following command:</para>
 
-      <screen>VBoxManage guestproperty set VM_NAME "/VirtualBox/GuestAdd/VBoxService/PARAMETER" VALUE</screen>
+      <screen>VBoxManage guestproperty set "VM name" "/VirtualBox/GuestAdd/VBoxService/PARAMETER" VALUE</screen>
 
       <para>where <computeroutput>PARAMETER</computeroutput> is one of the