From owner-freebsd-doc@FreeBSD.ORG Thu Dec 1 19:53:58 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 485EF1065672 for ; Thu, 1 Dec 2011 19:53:58 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id 0066F8FC12 for ; Thu, 1 Dec 2011 19:53:57 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.5/8.14.5) with ESMTP id pB1JrvYV013211; Thu, 1 Dec 2011 12:53:57 -0700 (MST) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id pB1Jrvxo013208; Thu, 1 Dec 2011 12:53:57 -0700 (MST) (envelope-from wblock@wonkity.com) Date: Thu, 1 Dec 2011 12:53:57 -0700 (MST) From: Warren Block To: Manolis Kiagias In-Reply-To: <4ED7BECE.2060000@gmail.com> Message-ID: References: <201111302220.pAUMK8Gt078242@freefall.freebsd.org> <4ED7BECE.2060000@gmail.com> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: MULTIPART/MIXED; BOUNDARY="-902635197-1461172185-1322769237=:12893" X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7 (wonkity.com [127.0.0.1]); Thu, 01 Dec 2011 12:53:57 -0700 (MST) Cc: freebsd-doc@freebsd.org, bug-followup@freebsd.org Subject: Re: docs/162961: [PATCH] Update VirtualBox section in handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 01 Dec 2011 19:53:58 -0000 This message is in MIME format. The first part should be readable text, while the remaining parts are likely unreadable without MIME-aware tools. ---902635197-1461172185-1322769237=:12893 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed On Thu, 1 Dec 2011, Manolis Kiagias wrote: > Here is the latest version of the patch, with few more minor fixes and a > complete whitespace overhaul: > > http://people.freebsd.org/~manolis/patches/virtualization-virtualbox-chapter-patch-new.txt > > A test build is here: > > http://www.freebsdgr.org/all/en_US.ISO8859-1/books/handbook/virtualization-guest.html > > If there are no objections / fixes, this goes in tomorrow :) A few quick suggestions: --- virtualization-virtualbox-chapter-patch-new.txt.orig 2011-12-01 12:41:46.000000000 -0700 +++ virtualization-virtualbox-chapter-patch-new.txt 2011-12-01 12:52:28.000000000 -0700 @@ -7,7 +7,7 @@ + + -+ &virtualbox; Guest Additions on &os; Guest ++ &virtualbox; Guest Additions on a &os; Guest + + The &virtualbox; guest additions + provide support for: @@ -44,7 +44,7 @@ + + &prompt.root; cd /usr/ports/emulators/virtualbox-ose-additions && make install clean + -+ Add the following lines to /etc/rc.conf: ++ Add these lines to /etc/rc.conf: + + vboxguest_enable="YES" +vboxservice_enable="YES" @@ -55,8 +55,8 @@ + vboxservice_flags="--disable-timesync" + + The vboxvideo_drv should be recognized by -+ Xorg -configure. If not, use something like this -+ in your xorg.conf file for the ++ Xorg -configure. If not, modify ++ xorg.conf for the + &virtualbox; video card: + + Section "Device" @@ -71,8 +71,8 @@ + BusID "PCI:0:2:0" +EndSection + -+ To use vboxmouse_drv please adjust the mouse -+ section in your xorg.conf like this: ++ To use vboxmouse_drv, adjust the mouse ++ section in xorg.conf: + + Section "InputDevice" + Identifier "Mouse0" @@ -127,7 +127,7 @@ - may be installed using the following commands: + in emulators/virtualbox-ose. + As &virtualbox; is very actively developed, make sure your ports -+ tree is up to date before installing. Install using the following ++ tree is up to date before installing. Install using these + commands: &prompt.root; cd /usr/ports/emulators/virtualbox-ose @@ -142,7 +142,7 @@ - the functions provided by the &man.sysctl.3; library. + To use the kernel modules that allow bridged or host-only + networking, add the following to /etc/rc.conf -+ and reboot your computer: ++ and reboot the computer: - When using an older version of the port, follow the instructions - below to make sure proc is @@ -170,28 +170,28 @@ + vboxnet_enable="YES" The vboxusers group is created during - the installation of &virtualbox;. + installation of &virtualbox;. @@ -1066,6 +1156,21 @@ &prompt.root; pw groupmod vboxusers -m yourusername + The default permissions for /dev/vboxnetctl are restrictive and -+ will need to be changed for bridged networking. ++ need to be changed for bridged networking. + + To test it temporarily: + + &prompt.root; chown root:vboxusers /dev/vboxnetctl +&prompt.root; chmod 0660 /dev/vboxnetctl + -+ To make the permissions change permanent, add the following ++ To make the permissions change permanent, add these + lines to /etc/devfs.conf: + + own vboxnetctl root:vboxusers +perm vboxnetctl 0660 + To launch &virtualbox;, either select - the Sun VirtualBox item from your + the Sun VirtualBox item from the graphic environment's menu, or type the following in a @@ -1081,6 +1186,71 @@ visit the relevant page in the &os; wiki, at Content-Description: Content-Disposition: attachment; filename=patch-vb-chapter.diff.txt LS0tIHZpcnR1YWxpemF0aW9uLXZpcnR1YWxib3gtY2hhcHRlci1wYXRjaC1u ZXcudHh0Lm9yaWcJMjAxMS0xMi0wMSAxMjo0MTo0Ni4wMDAwMDAwMDAgLTA3 MDANCisrKyB2aXJ0dWFsaXphdGlvbi12aXJ0dWFsYm94LWNoYXB0ZXItcGF0 Y2gtbmV3LnR4dAkyMDExLTEyLTAxIDEyOjUyOjI4LjAwMDAwMDAwMCAtMDcw MA0KQEAgLTcsNyArNyw3IEBADQogICAgICA8L3NlY3QyPg0KICsNCiArICAg IDxzZWN0MiBpZD0idmlydHVhbGl6YXRpb24tZ3Vlc3QtdmlydHVhbGJveC1n dWVzdC1hZGRpdGlvbnMiPg0KLSsgICAgICA8dGl0bGU+JnZpcnR1YWxib3g7 IEd1ZXN0IEFkZGl0aW9ucyBvbiAmb3M7IEd1ZXN0PC90aXRsZT4NCisrICAg ICAgPHRpdGxlPiZ2aXJ0dWFsYm94OyBHdWVzdCBBZGRpdGlvbnMgb24gYSAm b3M7IEd1ZXN0PC90aXRsZT4NCiArDQogKyAgICAgIDxwYXJhPlRoZSA8YXBw bGljYXRpb24+JnZpcnR1YWxib3g7PC9hcHBsaWNhdGlvbj4gZ3Vlc3QgYWRk aXRpb25zDQogKwlwcm92aWRlIHN1cHBvcnQgZm9yOjwvcGFyYT4NCkBAIC00 NCw3ICs0NCw3IEBADQogKw0KICsgICAgICA8c2NyZWVuPiZwcm9tcHQucm9v dDsgPHVzZXJpbnB1dD5jZCAvdXNyL3BvcnRzL2VtdWxhdG9ycy92aXJ0dWFs Ym94LW9zZS1hZGRpdGlvbnMgJiYgbWFrZSBpbnN0YWxsIGNsZWFuPC91c2Vy aW5wdXQ+PC9zY3JlZW4+DQogKw0KLSsgICAgICA8cGFyYT5BZGQgdGhlIGZv bGxvd2luZyBsaW5lcyB0byA8ZmlsZW5hbWU+L2V0Yy9yYy5jb25mPC9maWxl bmFtZT46PC9wYXJhPg0KKysgICAgICA8cGFyYT5BZGQgdGhlc2UgbGluZXMg dG8gPGZpbGVuYW1lPi9ldGMvcmMuY29uZjwvZmlsZW5hbWU+OjwvcGFyYT4N CiArDQogKyAgICAgIDxwcm9ncmFtbGlzdGluZz52Ym94Z3Vlc3RfZW5hYmxl PSJZRVMiDQogK3Zib3hzZXJ2aWNlX2VuYWJsZT0iWUVTIjwvcHJvZ3JhbWxp c3Rpbmc+DQpAQCAtNTUsOCArNTUsOCBAQA0KICsgICAgICA8cHJvZ3JhbWxp c3Rpbmc+dmJveHNlcnZpY2VfZmxhZ3M9Ii0tZGlzYWJsZS10aW1lc3luYyI8 L3Byb2dyYW1saXN0aW5nPg0KICsNCiArICAgICAgPHBhcmE+VGhlIDxsaXRl cmFsPnZib3h2aWRlb19kcnY8L2xpdGVyYWw+IHNob3VsZCBiZSByZWNvZ25p emVkIGJ5DQotKwk8Y29tbWFuZD5Yb3JnIC1jb25maWd1cmU8L2NvbW1hbmQ+ LiAgSWYgbm90LCB1c2Ugc29tZXRoaW5nIGxpa2UgdGhpcw0KLSsJaW4geW91 ciA8ZmlsZW5hbWU+eG9yZy5jb25mPC9maWxlbmFtZT4gZmlsZSBmb3IgdGhl DQorKwk8Y29tbWFuZD5Yb3JnIC1jb25maWd1cmU8L2NvbW1hbmQ+LiAgSWYg bm90LCBtb2RpZnkNCisrCTxmaWxlbmFtZT54b3JnLmNvbmY8L2ZpbGVuYW1l PiBmb3IgdGhlDQogKwk8YXBwbGljYXRpb24+JnZpcnR1YWxib3g7PC9hcHBs aWNhdGlvbj4gdmlkZW8gY2FyZDo8L3BhcmE+DQogKw0KICsgICAgICA8cHJv Z3JhbWxpc3Rpbmc+U2VjdGlvbiAiRGV2aWNlIg0KQEAgLTcxLDggKzcxLDgg QEANCiArCUJ1c0lEICJQQ0k6MDoyOjAiDQogK0VuZFNlY3Rpb248L3Byb2dy YW1saXN0aW5nPg0KICsNCi0rICAgICAgPHBhcmE+VG8gdXNlIDxsaXRlcmFs PnZib3htb3VzZV9kcnY8L2xpdGVyYWw+IHBsZWFzZSBhZGp1c3QgdGhlIG1v dXNlDQotKwlzZWN0aW9uIGluIHlvdXIgPGZpbGVuYW1lPnhvcmcuY29uZjwv ZmlsZW5hbWU+IGxpa2UgdGhpczo8L3BhcmE+DQorKyAgICAgIDxwYXJhPlRv IHVzZSA8bGl0ZXJhbD52Ym94bW91c2VfZHJ2PC9saXRlcmFsPiwgYWRqdXN0 IHRoZSBtb3VzZQ0KKysJc2VjdGlvbiBpbiA8ZmlsZW5hbWU+eG9yZy5jb25m PC9maWxlbmFtZT46PC9wYXJhPg0KICsNCiArICAgICAgPHByb2dyYW1saXN0 aW5nPlNlY3Rpb24gIklucHV0RGV2aWNlIg0KICsJSWRlbnRpZmllciAiTW91 c2UwIg0KQEAgLTEyNyw3ICsxMjcsNyBAQA0KIC0JbWF5IGJlIGluc3RhbGxl ZCB1c2luZyB0aGUgZm9sbG93aW5nIGNvbW1hbmRzOjwvcGFyYT4NCiArCWlu IDxmaWxlbmFtZSByb2xlPSJwYWNrYWdlIj5lbXVsYXRvcnMvdmlydHVhbGJv eC1vc2U8L2ZpbGVuYW1lPi4NCiArCUFzICZ2aXJ0dWFsYm94OyBpcyB2ZXJ5 IGFjdGl2ZWx5IGRldmVsb3BlZCwgbWFrZSBzdXJlIHlvdXIgcG9ydHMNCi0r CXRyZWUgaXMgdXAgdG8gZGF0ZSBiZWZvcmUgaW5zdGFsbGluZy4gIEluc3Rh bGwgdXNpbmcgdGhlIGZvbGxvd2luZw0KKysJdHJlZSBpcyB1cCB0byBkYXRl IGJlZm9yZSBpbnN0YWxsaW5nLiAgSW5zdGFsbCB1c2luZyB0aGVzZQ0KICsJ Y29tbWFuZHM6PC9wYXJhPg0KICANCiAgICAgICAgPHNjcmVlbj4mcHJvbXB0 LnJvb3Q7IDx1c2VyaW5wdXQ+Y2QgL3Vzci9wb3J0cy9lbXVsYXRvcnMvdmly dHVhbGJveC1vc2U8L3VzZXJpbnB1dD4NCkBAIC0xNDIsNyArMTQyLDcgQEAN CiAtCXRoZSBmdW5jdGlvbnMgcHJvdmlkZWQgYnkgdGhlICZtYW4uc3lzY3Rs LjM7IGxpYnJhcnkuPC9wYXJhPg0KICsgICAgICA8cGFyYT5UbyB1c2UgdGhl IGtlcm5lbCBtb2R1bGVzIHRoYXQgYWxsb3cgYnJpZGdlZCBvciBob3N0LW9u bHkNCiArCW5ldHdvcmtpbmcsIGFkZCB0aGUgZm9sbG93aW5nIHRvIDxmaWxl bmFtZT4vZXRjL3JjLmNvbmY8L2ZpbGVuYW1lPg0KLSsJYW5kIHJlYm9vdCB5 b3VyIGNvbXB1dGVyOjwvcGFyYT4NCisrCWFuZCByZWJvb3QgdGhlIGNvbXB1 dGVyOjwvcGFyYT4NCiAgDQogLSAgICAgIDxwYXJhPldoZW4gdXNpbmcgYW4g b2xkZXIgdmVyc2lvbiBvZiB0aGUgcG9ydCwgZm9sbG93IHRoZSBpbnN0cnVj dGlvbnMNCiAtCWJlbG93IHRvIG1ha2Ugc3VyZSA8ZmlsZW5hbWUgY2xhc3M9 ImRpcmVjdG9yeSI+cHJvYzwvZmlsZW5hbWU+IGlzDQpAQCAtMTcwLDI4ICsx NzAsMjggQEANCiArICAgICAgPHByb2dyYW1saXN0aW5nPnZib3huZXRfZW5h YmxlPSJZRVMiPC9wcm9ncmFtbGlzdGluZz4NCiAgDQogICAgICAgIDxwYXJh PlRoZSA8Z3JvdXBuYW1lPnZib3h1c2VyczwvZ3JvdXBuYW1lPiBncm91cCBp cyBjcmVhdGVkIGR1cmluZw0KLSAJdGhlIGluc3RhbGxhdGlvbiBvZiA8YXBw bGljYXRpb24+JnZpcnR1YWxib3g7PC9hcHBsaWNhdGlvbj4uDQorIAlpbnN0 YWxsYXRpb24gb2YgPGFwcGxpY2F0aW9uPiZ2aXJ0dWFsYm94OzwvYXBwbGlj YXRpb24+Lg0KIEBAIC0xMDY2LDYgKzExNTYsMjEgQEANCiAgDQogICAgICAg IDxzY3JlZW4+JnByb21wdC5yb290OyA8dXNlcmlucHV0PnB3IGdyb3VwbW9k IHZib3h1c2VycyAtbSA8cmVwbGFjZWFibGU+eW91cnVzZXJuYW1lPC9yZXBs YWNlYWJsZT48L3VzZXJpbnB1dD48L3NjcmVlbj4NCiAgDQogKyAgICAgIDxw YXJhPlRoZSBkZWZhdWx0IHBlcm1pc3Npb25zIGZvciA8ZmlsZW5hbWUNCiAr CSAgY2xhc3M9ImRldmljZWZpbGUiPi9kZXYvdmJveG5ldGN0bDwvZmlsZW5h bWU+IGFyZSByZXN0cmljdGl2ZSBhbmQNCi0rCXdpbGwgbmVlZCB0byBiZSBj aGFuZ2VkIGZvciBicmlkZ2VkIG5ldHdvcmtpbmcuPC9wYXJhPg0KKysJbmVl ZCB0byBiZSBjaGFuZ2VkIGZvciBicmlkZ2VkIG5ldHdvcmtpbmcuPC9wYXJh Pg0KICsNCiArICAgICAgPHBhcmE+VG8gdGVzdCBpdCB0ZW1wb3JhcmlseTo8 L3BhcmE+DQogKw0KICsgICAgICA8c2NyZWVuPiZwcm9tcHQucm9vdDsgPHVz ZXJpbnB1dD5jaG93biByb290OnZib3h1c2VycyAvZGV2L3Zib3huZXRjdGw8 L3VzZXJpbnB1dD4NCiArJnByb21wdC5yb290OyA8dXNlcmlucHV0PmNobW9k IDA2NjAgL2Rldi92Ym94bmV0Y3RsPC91c2VyaW5wdXQ+PC9zY3JlZW4+DQog Kw0KLSsgICAgICA8cGFyYT5UbyBtYWtlIHRoZSBwZXJtaXNzaW9ucyBjaGFu Z2UgcGVybWFuZW50LCBhZGQgdGhlIGZvbGxvd2luZw0KKysgICAgICA8cGFy YT5UbyBtYWtlIHRoZSBwZXJtaXNzaW9ucyBjaGFuZ2UgcGVybWFuZW50LCBh ZGQgdGhlc2UNCiArCWxpbmVzIHRvIDxmaWxlbmFtZT4vZXRjL2RldmZzLmNv bmY8L2ZpbGVuYW1lPjoNCiArDQogKyAgICAgIDxwcm9ncmFtbGlzdGluZz5v d24gICAgIHZib3huZXRjdGwgcm9vdDp2Ym94dXNlcnMNCiArcGVybSAgICB2 Ym94bmV0Y3RsIDA2NjA8L3Byb2dyYW1saXN0aW5nPg0KICsNCiAgICAgICAg PHBhcmE+VG8gbGF1bmNoIDxhcHBsaWNhdGlvbj4mdmlydHVhbGJveDs8L2Fw cGxpY2F0aW9uPiwgZWl0aGVyIHNlbGVjdA0KLSAJdGhlIDxndWltZW51aXRl bT5TdW4gVmlydHVhbEJveDwvZ3VpbWVudWl0ZW0+IGl0ZW0gZnJvbSB5b3Vy DQorIAl0aGUgPGd1aW1lbnVpdGVtPlN1biBWaXJ0dWFsQm94PC9ndWltZW51 aXRlbT4gaXRlbSBmcm9tIHRoZQ0KICAJZ3JhcGhpYyBlbnZpcm9ubWVudCdz IG1lbnUsIG9yIHR5cGUgdGhlIGZvbGxvd2luZyBpbiBhDQogQEAgLTEwODEs NiArMTE4Niw3MSBAQA0KICAJdmlzaXQgdGhlIHJlbGV2YW50IHBhZ2UgaW4g dGhlICZvczsgd2lraSwgYXQgPHVsaW5rDQo= ---902635197-1461172185-1322769237=:12893--