2 | | Some links. |
| 2 | |
| 3 | |
| 4 | = Guest Additions Installation/Usage Instructions for Haiku = |
| 5 | --------------------------------------------------------- |
| 6 | |
| 7 | These are temporary instructions for those who want to test the Haiku port |
| 8 | of the guest additions before a proper package or installer has been created. |
| 9 | |
| 10 | |
| 11 | == You will need: == |
| 12 | - The contents of this repository [aka https://github.com/scgtrp/vbox-haiku] |
| 13 | - A GCC4-based Haiku installation with development tools installed |
| 14 | (Partial GCC2/GCC2h support is present but not yet usable.) |
| 15 | |
| 16 | |
| 17 | == To compile the guest additions: == |
| 18 | {{{ |
| 19 | #!div style="font-size: 90%" |
| 20 | {{{#!bash |
| 21 | export PATH=$PATH:/path/to/vbox/source/kBuild/bin/haiku.x86 |
| 22 | ./configure --build-headless --disable-python --disable-java |
| 23 | kmk VBOX_ONLY_ADDITIONS=1 VBOX_WITH_ADDITION_DRIVERS=1 VBOX_USE_GCC4=1 all |
| 24 | }}} |
| 25 | }}} |
| 26 | |
| 27 | |
| 28 | If the build fails complaining about ''ev'' being undefined, edit |
| 29 | out `/haiku.x86/release/revision.kmk` and change ''ev'' to ''9001'' - this is due to |
| 30 | the code for finding the Subversion revision not working with Git repos. |
| 31 | |
| 32 | |
| 33 | == To install: == |
| 34 | |
| 35 | {{{ |
| 36 | #!div style="font-size: 90%" |
| 37 | {{{#!bash |
| 38 | #install core drivers |
| 39 | mkdir -p ~/config/add-ons/kernel/generic/ |
| 40 | cp out/haiku.x86/release/bin/additions/vboxguest ~/config/add-ons/kernel/generic/ |
| 41 | mkdir -p ~/config/add-ons/kernel/drivers/dev/misc/ |
| 42 | cp out/haiku.x86/release/bin/additions/vboxdev ~/config/add-ons/kernel/drivers/bin/ |
| 43 | ln -s ../../bin/vboxdev ~/config/add-ons/kernel/drivers/dev/misc/ |
| 44 | #install video drivers |
| 45 | mkdir -p ~/config/add-ons/accelerants/ ~/config/add-ons/kernel/drivers/dev/graphics/ |
| 46 | cp out/haiku.x86/release/bin/additions/vboxvideo ~/config/add-ons/kernel/drivers/bin/ |
| 47 | ln -s ../../bin/vboxvideo ~/config/add-ons/kernel/drivers/dev/graphics/ |
| 48 | cp out/haiku.x86/release/bin/additions/vboxvideo.accelerant /boot/system/add-ons/accelerants/ |
| 49 | #install vboxsf filesystem driver |
| 50 | mkdir -p ~/config/add-ons/kernel/file_systems/ |
| 51 | cp out/haiku.x86/release/bin/additions/vboxsf ~/config/add-ons/kernel/file_systems/ |
| 52 | #install mouse driver |
| 53 | cp out/haiku.x86/release/bin/additions/VBoxMouse ~/config/add-ons/input_server/devices/ |
| 54 | cp out/haiku.x86/release/bin/additions/VBoxMouseFilter ~/config/add-ons/input_server/filters/ |
| 55 | #install services |
| 56 | mkdir -p /boot/apps/VBoxAdditions/ |
| 57 | cp out/haiku.x86/release/bin/additions/VBoxService /boot/apps/VBoxAdditions/ |
| 58 | cp out/haiku.x86/release/bin/additions/VBoxTray /boot/apps/VBoxAdditions/ |
| 59 | cp out/haiku.x86/release/bin/additions/VBoxControl /boot/apps/VBoxAdditions/ |
| 60 | ln -sf /boot/apps/VBoxAdditions/VBoxService ~/config/boot/launch |
| 61 | }}} |
| 62 | }}} |
| 63 | |
| 64 | == To uninstall: == |
| 65 | {{{ |
| 66 | #!div style="font-size: 90%" |
| 67 | {{{#!bash |
| 68 | rm -f ~/config/add-ons/input_server/devices/VBoxMouse |
| 69 | rm -f ~/config/add-ons/kernel/drivers/bin/vboxdev |
| 70 | rm -f ~/config/add-ons/kernel/drivers/dev/misc/vboxdev |
| 71 | rm -f ~/config/add-ons/kernel/drivers/bin/vboxvideo |
| 72 | rm -f ~/config/add-ons/kernel/drivers/dev/graphics/vboxvideo |
| 73 | rm -f ~/config/add-ons/kernel/file_systems/vboxsf |
| 74 | rm -f ~/config/add-ons/kernel/generic/vboxguest |
| 75 | rm -f ~/config/add-ons/accelerants/vboxvideo.accelerant |
| 76 | rm -rf /boot/apps/VBoxAdditions |
| 77 | }}} |
| 78 | }}} |
| 79 | |
| 80 | == Usage: == |
| 81 | Time synchronization and guest control are handled by VBoxService - you do |
| 82 | not need to do anything special to enable these. See the output of `VBoxManage help guestcontrol exec` on your host system for guest control instructions. |
| 83 | |
| 84 | |
| 85 | Clipboard sharing and automatic screen resizing are handled by VBoxTray; |
| 86 | load the replicant by running `/boot/apps/VBoxAdditions/VBoxTray`. It will |
| 87 | be automatically reloaded whenever Deskbar starts until you quit it by |
| 88 | right-clicking it and choosing ''Quit''. |
| 89 | |
| 90 | |
| 91 | To mount a shared folder, tell Haiku to mount a null filesystem of type |
| 92 | `vboxsf` and pass the share name as a parameter: |
| 93 | |
| 94 | {{{ |
| 95 | #!div style="font-size: 90%" |
| 96 | {{{#!sh |
| 97 | mount -t vboxsf -p SharedFolderFullOfLolcats /mountpoint |
| 98 | }}} |
| 99 | }}} |
| 100 | |
| 101 | == Resources == |
22 | | |
23 | | Guest Additions Installation/Usage Instructions for Haiku |
24 | | --------------------------------------------------------- |
25 | | |
26 | | These are temporary instructions for those who want to test the Haiku port |
27 | | of the guest additions before a proper package or installer has been created. |
28 | | |
29 | | |
30 | | == You will need: == |
31 | | - The contents of this repository [aka https://github.com/scgtrp/vbox-haiku] |
32 | | - A GCC4-based Haiku installation with development tools installed |
33 | | (Partial GCC2/GCC2h support is present but not yet usable.) |
34 | | |
35 | | |
36 | | == To compile the guest additions: == |
37 | | export PATH=$PATH:/path/to/vbox/source/kBuild/bin/haiku.x86 |
38 | | ./configure --build-headless --disable-python --disable-java |
39 | | kmk VBOX_ONLY_ADDITIONS=1 VBOX_WITH_ADDITION_DRIVERS=1 VBOX_USE_GCC4=1 all |
40 | | |
41 | | |
42 | | If the build fails complaining about 'ev' being undefined, edit |
43 | | out/haiku.x86/release/revision.kmk and change 'ev' to 9001 - this is due to |
44 | | the code for finding the Subversion revision not working with Git repos. |
45 | | |
46 | | |
47 | | == To install: == |
48 | | # core drivers |
49 | | mkdir -p ~/config/add-ons/kernel/generic/ |
50 | | cp out/haiku.x86/release/bin/additions/vboxguest ~/config/add-ons/kernel/generic/ |
51 | | mkdir -p ~/config/add-ons/kernel/drivers/dev/misc/ |
52 | | cp out/haiku.x86/release/bin/additions/vboxdev ~/config/add-ons/kernel/drivers/bin/ |
53 | | ln -s ../../bin/vboxdev ~/config/add-ons/kernel/drivers/dev/misc/ |
54 | | |
55 | | |
56 | | # video |
57 | | mkdir -p ~/config/add-ons/accelerants/ ~/config/add-ons/kernel/drivers/dev/graphics/ |
58 | | cp out/haiku.x86/release/bin/additions/vboxvideo ~/config/add-ons/kernel/drivers/bin/ |
59 | | ln -s ../../bin/vboxvideo ~/config/add-ons/kernel/drivers/dev/graphics/ |
60 | | cp out/haiku.x86/release/bin/additions/vboxvideo.accelerant /boot/system/add-ons/accelerants/ |
61 | | |
62 | | |
63 | | # vboxsf |
64 | | mkdir -p ~/config/add-ons/kernel/file_systems/ |
65 | | cp out/haiku.x86/release/bin/additions/vboxsf ~/config/add-ons/kernel/file_systems/ |
66 | | |
67 | | |
68 | | # mouse |
69 | | cp out/haiku.x86/release/bin/additions/VBoxMouse ~/config/add-ons/input_server/devices/ |
70 | | cp out/haiku.x86/release/bin/additions/VBoxMouseFilter ~/config/add-ons/input_server/filters/ |
71 | | |
72 | | |
73 | | # services |
74 | | mkdir -p /boot/apps/VBoxAdditions/ |
75 | | cp out/haiku.x86/release/bin/additions/VBoxService /boot/apps/VBoxAdditions/ |
76 | | cp out/haiku.x86/release/bin/additions/VBoxTray /boot/apps/VBoxAdditions/ |
77 | | cp out/haiku.x86/release/bin/additions/VBoxControl /boot/apps/VBoxAdditions/ |
78 | | ln -sf /boot/apps/VBoxAdditions/VBoxService ~/config/boot/launch |
79 | | |
80 | | |
81 | | == To uninstall: == |
82 | | rm -f ~/config/add-ons/input_server/devices/VBoxMouse |
83 | | rm -f ~/config/add-ons/kernel/drivers/bin/vboxdev |
84 | | rm -f ~/config/add-ons/kernel/drivers/dev/misc/vboxdev |
85 | | rm -f ~/config/add-ons/kernel/drivers/bin/vboxvideo |
86 | | rm -f ~/config/add-ons/kernel/drivers/dev/graphics/vboxvideo |
87 | | rm -f ~/config/add-ons/kernel/file_systems/vboxsf |
88 | | rm -f ~/config/add-ons/kernel/generic/vboxguest |
89 | | rm -f ~/config/add-ons/accelerants/vboxvideo.accelerant |
90 | | rm -rf /boot/apps/VBoxAdditions |
91 | | |
92 | | |
93 | | == Usage: == |
94 | | Time synchronization and guest control are handled by VBoxService - you do |
95 | | not need to do anything special to enable these. See the output of |
96 | | VBoxManage help guestcontrol exec |
97 | | on your host system for guest control instructions. |
98 | | |
99 | | |
100 | | Clipboard sharing and automatic screen resizing are handled by VBoxTray; |
101 | | load the replicant by running /boot/apps/VBoxAdditions/VBoxTray. It will |
102 | | be automatically reloaded whenever Deskbar starts until you quit it by |
103 | | right-clicking it and choosing 'Quit'. |
104 | | |
105 | | |
106 | | To mount a shared folder, tell Haiku to mount a null filesystem of type |
107 | | 'vboxsf' and pass the share name as a parameter: |
108 | | |
109 | | |
110 | | mount -t vboxsf -p SharedFolderFullOfLolcats /mountpoint |
111 | | |