1[
2{ type: install
3  message: <<EOM
4FreeBSD host notes
5==================
6
7- Needs to set net.link.tap.user_open sysctl in order to use /dev/tap*
8  networking as non-root.  Don't forget to adjust device node permissions in
9  /etc/devfs.rules.
10
11- Expect timer problems when guest kernel HZ is > hosts.  The linux 2.6
12  kernel uses 1000 by default btw.  (changed to 250 later, and recent linux
13  kernels now no longer have a fixed HZ, aka `tickless kernel'...)
14  Enabling /dev/rtc doesn't seem to help either (not included since it needs
15  a patch to emulators/rtc.)
16
17- The -smb option (smb-export local dir to guest using the default
18  slirp networking) needs the samba port/package installed
19  in addition to qemu. (SAMBA knob.)
20
21- If you want to use usb devices connected to the host in the guest
22  yot can use usbredir over the network (see below); also unless you are
23  running qemu as root you then need to fix permissions for /dev/ugen*
24  device nodes: if you are on 5.x or later (devfs) put a rule in
25  /etc/devfs.rules, activate it in /etc/rc.conf and run /etc/rc.d/devfs
26  restart.  Example devfs.rules:
27
28	[ugen_ruleset=20]
29	add path 'ugen*' mode 660 group operator
30
31  corresponding rc.conf line:
32
33	devfs_system_ruleset="ugen_ruleset"
34
35- Still usb: since the hub is no longer attached to the uchi controller and
36  the wakeup mechanism, resume interrupt is not implemented yet linux guests
37  will suspend the bus, i.e. they wont see devices usb_add'ed after its
38  (linux') uhci module got loaded.  Workaround: either add devices before
39  linux loads the module or rmmod and modprobe it afterwards.  [Not sure
40  if this still applies to the new libusb host code used on recent
41  10-current.]
42
43- If you get repeated `atapi_poll called!' console messages with FreeBSD
44  guests or other weird cdrom problems then thats probably because the guest
45  has atapicam loaded, which for reasons still to be determined has problems
46  with qemu's now by default enabled cdrom dma. You can build the port with
47  CDROM_DMA disabled to disable it.  [Looks like this is fixed in recent
48  FreeBSD guest versions.]
49
50- If you build qemu wihout SDL and then get crashes running it try passing it
51  -nographic.  This should probably be default in that case...
52
53- qemu's network boot roms (-boot n) have a bug when bootfiles sizes are a
54  multiple of blksize, if this affects you (like with FreeBSD's /boot/pxeboot)
55  you can do like
56
57	cp /boot/pxeboot pxeboot-qemu && chmod +w pxeboot-qemu && echo >>pxeboot-qemu
58
59  and then use pxeboot-qemu.  Actually you need recent btx code
60  (from after 7.0 was released) because of the real mode boot
61  problem, so use at least pxeboot from there.  And I just did that
62  for the pxeboot extracted out of
63
64	ftp://ftp.freebsd.org/pub/FreeBSD/snapshots/200805/7.0-STABLE-200805-i386-bootonly.iso
65
66  and placed it here:
67
68	http://people.freebsd.org/~nox/qemu/pxeboot-qemu
69
70- If you use slirp (usernet, the default) and want to mount nfs into the guest
71  and you are not running qemu as root, then mountd(8) on the exporting box
72  needs to be run with -n in order to accept requests from ports >= 1024.
73
74EOM
75}
76]
77