VirtualBox

source: vbox/trunk/doc/manual/en_US/dita/topics/network_bridged.dita@ 105145

Last change on this file since 105145 was 105134, checked in by vboxsync, 7 months ago

Docs: bugref:10705. This is a merge commit to introduce doc team's changes in the user manual dita files. The following files
are excluded from this process:

  • Files whose names satrt with "viso", "vboxmanage", "man_", "vboximg", "vboxheadless", or "user_isomakercmd-man".

And general notes about this merge are as follows:

  • For now I leave glossentry-*dita file as they are since we use different enclosing dita elements
  • in hdimagewrites.dita we have <note type="attention"> while doc team's copy has <note type="caution">. Not sure if this is significant.

For now I copy doc team's version over.

  • I have not modified our UserManual.ditamap file. This will be done in a follow up commit.

The list of commits we have merged are as follows:

r3392: 7.1 new features; add comments to some DITA topics
r3730: VBP-283: Update supported platforms; 7.0 and 7.1
r3980: 7.1: reset menu option; add note
r3992: ARM hosts; add draft topic on limitations; add container topic for ARM-based subtopics
r3993: ARM create new VM wizard: add some dummy topics
r4014: ER 34784410 DOCUMENT THE VIRTUAL MACHINE TASKBAR ICONS: port topic and icon graphics from 7.0 tree
r4026: VBP-378: status bar icons; remove any mention of task bar; ported from 7.0
r4034: Cloning a cloud VM; add draft topic
r4035: Cloning a cloud VM;typo
r4036: Cloning a cloud VM;add xref from intro topic
r4050: Reset operation; add instructions
r4051: Amend comment
r4052: Ditaval markup for images
r4056: Add ditaval markup for images
r4057: Add ditaval markup for images
r4058: Add ditaval markup for images
r4073: UI experience level: add dummy topic
r4075: Subtype: option for VM settings General tab and Create VM wizard
r4094: Cloud VM reset; add to relnotes
r4095: Reset VM; use main Machine menu, rather than right-click menu
r4099: ARM hosts; draft revisions to cover different wizard screens
r4134: Cloud VMs: file manager menu option; add comment
r4214: Settings page, Motherboard tab: Chipset option for Arm VMs; add note
r4306: Terminology checker: clear up Errors; Installation chapter
r4307: Terminology checker: clear up Errors; Config settings/GA chapters
r4308: Terminology checker: clear up Errors; Storage, networking, remote VM chapters
r4311: Terminology checker: clear up Errors: various
r4324: Prefences and settings; potential areas for change in 7.1
r4356: r160214: Monitoring cloud VM performance; add new topic
r4358: r160214: Monitoring cloud VM performance; add new topic
r4364: r160214: Monitoring cloud VM performance; redraft topic
r4374: Experience levels; update user manual topic
r4377: Experience levels; Preferences window: add note re. availability of all possible settings
r4378: Experience levels; Preferences window: add note re. availability of all possible settingsLp
r4379: Typos and add remark re. Global menu changes
r4387: Preferences, Display: some settings introduced post-7.0: font scaling and extended features
r4388: Performance monitoring: add cloud VM instances to intro para
r4389: Experience levels: selecting a level, add graphic of icon
r4391: Resource monitoring; add CLI example to show CPU usage for a cloud instance
r4395: Experience levels; apply to menu items only
r4398: Experience levels; add notes
r4401: Experience levels; remove pics of global tools menu/machine tools menu; number of menu items can vary
r4402: Experience levels; remove image files for global tools menu/machine tools menu
r4525: Experience levels: minor redraft
r4528: Typo
r4538: Experience levels: selected level applies throughout VirtualBox Manager GUI
r4543: GUI topics; add notes for required changes
r4544: VISO Creator changes
r4563: r160714: unattended guest install example; now has user-password option
r4569: Terminology: front end, not front-end
r4570: Arm wizard screens; remove, as Create VM Wizard will be very similar regardless of architecture
r4571: Arm wizard screens; remove, as Create VM Wizard will be very similar regardless of architecture
r4623: Cloud VM monitoring: Compute Instance Monitoring plugin must be enabled; add note
r4625: CPU activity icon; update, now has solid bar
r4626: GUI changes; various, from Serkan; includes new pic for soft keyboard
r4629: separate mode: add some draft topics, will need to get technical review at a later stage
r4634: GUI; various notes and updates
r4655: Typo
r4703: Arm host platform limitations; redraft and add topic to host OS section
r4724: VISO creator; add notes re. ISO import
r4725: Separate mode: edits
r4863: r161176; Python 2.x no longer supported for API
r4899: Arm host support: limitations
r4910: Create VM wizard: settings may vary x86 vs. Arm hosts
r4911: Guest OS support; add note re. supported aarch64 OSes
r4973: r161445: Remove mention of parallel port support
r5004: Cloud VM monitoring: detailed data graphs and Activity Overview
r5038: Cloud VM monitoring: export to file
r5214: r161947: Solaris non-Global zone configuration
r5215: r161947: Solaris non-Global zone configuration; typo
r5230: Glossary: fix title for I/O APIC topic
r5341: Experience levels; can be selected from welcome screen in VirtualBox Manager; need replacement pic
r5345: Experience levels; add note on Welcome screen option
r5346: Arm host limitations; unavailable System settings
r5434: r162377: shared folders; symlinks behaviour
r5565: Cloud VM list in VirtualBox Manager; show mixed VM types; screenshot from Klaus
r5627: Obfuscate UUID data in screen shot
r5628: Delete legacy cloudvm pic; use mixed VMs example
r5654: Clean up comments in source files; redraft VM activity section
r5672: 7.1 changes; add comments
r5683: 7.1 changes; add comments for Arm topics
r5687: 7.1 changes; GUI; add comments
r5703: Oracle notices; include up to date versions in preface-* topics for User Guide
r5707: r162904: Windows install directory requirements; redraft
r5781: updated GNU version from 2 to 3 as per r163272
r5812: started removal of screenshots and updating tasks VBP-807
r5818: Further updates to creating a VM VBP-807
r5822: Restructured topics and made task based VBP-807
r5824: Removed files during restructure VBP-807
r5834: Fixed formatting of note and caution VBP-807
r5836: Updated supported host OS list VBP-825
r5837: updated USB topics for VBP-823
r5842: changes as per legal request re supported guests VBP-843
r5853: Updated versions following review. VBP-825


  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 5.4 KB
Line 
1<?xml version='1.0' encoding='UTF-8'?>
2<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
3<topic xml:lang="en-us" id="network_bridged">
4 <title>Bridged Networking</title>
5
6 <body>
7 <p>
8 With bridged networking, <ph conkeyref="vbox-conkeyref-phrases/product-name"/> uses a device driver on
9 your <i>host</i> system that filters data from your
10 physical network adapter. This driver is therefore called a
11 <i>net filter</i> driver. This enables
12 <ph conkeyref="vbox-conkeyref-phrases/product-name"/> to intercept data from the physical network and
13 inject data into it, effectively creating a new network interface
14 in software. When a guest is using such a new software interface,
15 it looks to the host system as though the guest were physically
16 connected to the interface using a network cable. The host can
17 send data to the guest through that interface and receive data
18 from it. This means that you can set up routing or bridging
19 between the guest and the rest of your network.
20 </p>
21 <note>
22 <p>
23 Even though TAP interfaces are no longer necessary on Linux for
24 bridged networking, you <i>can</i> still use TAP
25 interfaces for certain advanced setups, since you can connect a
26 VM to any host interface.
27 </p>
28 </note>
29 <p>
30 To enable bridged networking, open the
31 <b outputclass="bold">Settings</b> dialog of a virtual
32 machine, go to the <b outputclass="bold">Network</b> page
33 and select <b outputclass="bold">Bridged Network</b> in the
34 drop-down list for the <b outputclass="bold">Attached
35 To</b> field. Select a host interface from the list at the
36 bottom of the page, which contains the physical network interfaces
37 of your systems. On a typical MacBook, for example, this will
38 allow you to select between en1: AirPort, which is the wireless
39 interface, and en0: Ethernet, which represents the interface with
40 a network cable.
41 </p>
42 <note>
43 <p>
44 Bridging to a wireless interface is done differently from
45 bridging to a wired interface, because most wireless adapters do
46 not support promiscuous mode. All traffic has to use the MAC
47 address of the host's wireless adapter, and therefore
48 <ph conkeyref="vbox-conkeyref-phrases/product-name"/> needs to replace the source MAC address in the
49 Ethernet header of an outgoing packet to make sure the reply
50 will be sent to the host interface. When <ph conkeyref="vbox-conkeyref-phrases/product-name"/> sees an
51 incoming packet with a destination IP address that belongs to
52 one of the virtual machine adapters it replaces the destination
53 MAC address in the Ethernet header with the VM adapter's MAC
54 address and passes it on. <ph conkeyref="vbox-conkeyref-phrases/product-name"/> examines ARP and DHCP
55 packets in order to learn the IP addresses of virtual machines.
56 </p>
57 </note>
58 <p>
59 Depending on your host operating system, the following limitations
60 apply:
61 </p>
62 <ul>
63 <li>
64 <p><b outputclass="bold">macOS hosts.</b> Functionality is
65 limited when using AirPort, the Mac's wireless networking
66 system, for bridged networking. Currently, <ph conkeyref="vbox-conkeyref-phrases/product-name"/>
67 supports only IPv4 and IPv6 over AirPort. For other protocols,
68 such as IPX, you must choose a wired interface.
69 </p>
70 </li>
71 <li>
72 <p><b outputclass="bold">Linux hosts.</b> Functionality is
73 limited when using wireless interfaces for bridged networking.
74 Currently, <ph conkeyref="vbox-conkeyref-phrases/product-name"/> supports only IPv4 and IPv6 over
75 wireless. For other protocols, such as IPX, you must choose a
76 wired interface.
77 </p>
78 <p>
79 Also, setting the MTU to less than 1500 bytes on wired
80 interfaces provided by the sky2 driver on the Marvell Yukon II
81 EC Ultra Ethernet NIC is known to cause packet losses under
82 certain conditions.
83 </p>
84 <p> Some adapters strip VLAN tags in hardware. This does not allow you to use VLAN trunking
85 between VM and the external network with Linux kernels before 2.6.27, or with host
86 operating systems other than Linux. </p>
87 </li>
88 <li>
89 <p><b outputclass="bold">Oracle Solaris hosts.</b> There
90 is no support for using wireless interfaces. Filtering guest
91 traffic using IPFilter is also not completely supported due to
92 technical restrictions of the Oracle Solaris networking
93 subsystem. These issues may be addressed in later releases of
94 Oracle Solaris 11.
95 </p>
96 <p>
97 On Oracle Solaris 11 hosts build 159 and above, it is possible
98 to use Oracle Solaris Crossbow Virtual Network Interfaces
99 (VNICs) directly with <ph conkeyref="vbox-conkeyref-phrases/product-name"/> without any additional
100 configuration other than each VNIC must be exclusive for every
101 guest network interface.
102 </p>
103 <p>
104 When using VLAN interfaces with <ph conkeyref="vbox-conkeyref-phrases/product-name"/>, they must be
105 named according to the PPA-hack naming scheme, such as
106 e1000g513001. Otherwise, the guest may receive packets in an
107 unexpected format.
108 </p>
109 </li>
110 </ul>
111 </body>
112
113</topic>
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette