Changeset 55366 in vbox for trunk/doc

Timestamp:

Apr 22, 2015 9:50:17 AM (10 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

99702

Message:

doc/manual: some improvements for documenting NAT network commands with VBoxManage

File:

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

trunk/doc/manual/en_US/user_Networking.xml

@@ -432 +432 @@
     example command to create a NAT network is:
     </para>
-    <para><screen>VBoxManage natnetwork add -t nat-int-network -n "192.168.15.0/24" -e</screen></para>
+    <para><screen>VBoxManage natnetwork add --netname natnet1 --network "192.168.15.0/24" --enable</screen></para>
     <para>
-    Here, "nat-int-network" is the name of the internal network to be used and
+    Here, "natnet1" is the name of the internal network to be used and
     "192.168.15.0/24" is the network address and mask of the NAT service
     interface.  By default in this static configuration the gateway will be
@@ -440 +440 @@
     address), though this is subject to change.  To attach a DHCP server to the
     internal network, we modify the example as follows:</para>
-    <para><screen>VBoxManage natnetwork add -t nat-int-network -n "192.168.15.0/24" -e -h on</screen></para>
+    <para><screen>VBoxManage natnetwork add --netname natnet1 --network "192.168.15.0/24" --enable --dhcp on</screen></para>
     <para> or to add a DHCP server to the network after creation:</para>
-    <para><screen>VBoxManage natnetwork modify -t nat-int-network -h on</screen></para>
+    <para><screen>VBoxManage natnetwork modify --netname natnet1 --dhcp on</screen></para>
     <para>To disable it again, use:</para>
-    <para><screen>VBoxManage natnetwork modify -t nat-int-network -h off</screen></para>
+    <para><screen>VBoxManage natnetwork modify --netname natnet1 --dhcp off</screen></para>
     <para>DHCP server provides list of registered nameservers, but doesn't map 
     servers from 127/8 network.</para>
     <para>To start the NAT service, use the following command:</para>
-    <para><screen>VBoxManage natnetwork start -t nat-int-network</screen></para>
+    <para><screen>VBoxManage natnetwork start --netname natnet1</screen></para>
     <para>If the network has a DHCP server attached then it will start together
     with the NAT network service.</para>
-    <para><screen>VBoxManage natnetwork stop -t nat-int-network</screen> stops
+    <para><screen>VBoxManage natnetwork stop --netname natnet1</screen> stops
     the NAT network service, together with DHCP server if any.</para>
     <para>To delete the NAT network service use:</para>
-    <para><screen>VBoxManage natnetwork remove -t nat-int-network</screen></para>
+    <para><screen>VBoxManage natnetwork remove --netname natnet1</screen></para>
     <para>This command does not remove the DHCP server if one is enabled on the
     internal network.</para>
-    <para>Port-forwarding is supported (using the "-p" switch for IPv4 and "-P"
+    <para>Port-forwarding is supported (using the "--port-forward-4" switch for IPv4 and "--port-forward-6"
     for IPv6):</para>
-    <para><screen>VBoxManage natnetwork modify -t nat-int-network -p "ssh:tcp:[]:10022:[192.168.15.15]:22"</screen></para>
-    <para>This adds a port-forwarding rule from the host's TCP 10022 port to
-    the port 22 on the guest with IP address 192.168.15.15.  To delete the rule,
-    use:</para>
-    <para><screen>VBoxManage natnetwork modify -t nat-int-network -p delete ssh</screen></para>
+    <para><screen>VBoxManage natnetwork modify --netname natnet1 --port-forward-4 "ssh:tcp:[]:1022:[192.168.15.5]:22"</screen></para>
+    <para>This adds a port-forwarding rule from the host's TCP 1022 port to
+    the port 22 on the guest with IP address 192.168.15.5. Host port, guest port and guest IP
+    are mandatory. To delete the rule, use:</para>
+    <para><screen>VBoxManage natnetwork modify --netname natnet1 --port-forward-4 delete ssh</screen></para>
     <para>It's possible to bind NAT service to specified interface:</para>
     <screen>VBoxManage setextradata global "NAT/win-nat-test-0/SourceIp4" 192.168.1.185</screen>