Axel Dörfler ae58716024 Fixed another bad bug caused by calling get_vnode() on a node currently
being constructed: bfs_read_node() created an Inode object independent from
the one set in new_vnode().
As a work-around (the new VFS layer will introduce some better methods here)
we are now using the bfs_inode.etc field as a pointer to our object - just
like BFS has thought to use this field. If bfs_read_vnode() has to wait for
the inode (because it is being constructed), it will use the "etc" pointer
and don't create it's own Inode object.
Almost all changes made change the API to take this case into account:
- new Inode constructor to be able to be created from a CachedBlock
- CachedBlock now has a Keep() method which suppresses the release_block()
  call when the object is destructed.
- a CachedBlock can now be constructed from the contents of another one (by
  calling the source's Keep() method).
- Inode::InitCheck() no longer checks the integrity of the bfs_inode - this
  is now done by bfs_inode::InitCheck() which is optionally called by the
  former (default).
- moved the inline CachedBlock methods out of the class definition (was
  too crowded to be readable).
- new Inode::Initialize() which is called by all Inode constructors
- an Inode object now sets a better name for its read/write lock.


git-svn-id: file:///srv/svn/repos/haiku/trunk/current@3364 a95241bf-73f2-0310-859d-f6bbb57e9c96
2003-05-28 01:27:27 +00:00
2003-05-23 23:48:44 +00:00
2003-05-26 12:58:06 +00:00
2002-11-20 00:43:42 +00:00
2003-05-19 23:49:30 +00:00

Building
--------

The build system uses Jam/MR (http://www.perforce.com/jam/jam.html).
A BeOS executable of Jam 2.4 is available at:

  http://open-beos.sf.net/misc/jam.zip

Unzip the executable and copy it to /boot/home/config/bin.
The Jam source code is also included in the source tree. You can as well cd
into "src/tools/jam" and run "make" to obtain an executable.

To build the whole source tree, launch a Terminal, cd into the openbeos root
directory and just type:

  $ ./configure
  $ jam

The configure script generates a file named BuildConfig. As long as configure
is not modified (!), there is no need to call it again. That is for
re-building you only need to invoke Jam. If you don't update the source tree
very frequently, you may want to execute configure after each update just to
be on the safe side.

NOTE: If you have checked out the latest CVS version, it is not unlikely that
some parts of the tree won't build.


Running
-------

If the build went fine, a file named floppy.x86 had been created in the
target specific objects directory (objects/x86.R1 for x86 machines).
What you want to do now, is to boot from this floppy image. Therefore you
either write the image onto a real floppy disk and restart you computer, or
you write it onto a "virtual floppy disk" emulated by a x86 PC emulator and
just start this emulator.

1. Real Floppy

Put in the disk and type in the source tree's root dir:

  $ dd if=objects/x86.R1/floppy.x86  of=/dev/disk/floppy/raw bs=18k


2. Emulated Floppy (Bochs)

Type:

  $ dd if=objects/x86.R1/floppy.x86  of=<floppy image> bs=18k

where <floppy image> has to be replaced with the filename of the floppy
image Bochs has been told to use (e.g. /tmp/obos.img).

For both cases there is also an simpler way:

  $ jam installfloppy

This builds the floppy image, if it is not up to date, and writes it to a
previously specified location. Therefore you must tell configure where this
location is:

  $ ./configure --floppy /dev/disk/floppy/raw

Ananlogously for the emulated floppy.


Bochs
-----

Version 1.4 of Bochs for BeOS (BeBochs) can be downloaded from BeBits:

  http://www.bebits.com/app/2902

The package installs to: /boot/apps/BeBochs1.4

You have to set up a configuration for Bochs. A relatively short and
painless procedure follows:

Lauch a Terminal:

  $ cd /tmp
  $ /boot/apps/BeBochs1.4/bximage

Answer with "fd", RETURN (for 1.44) and "obos.img", and a floppy image
/tmp/obos.img will be created.
Open folder /boot/apps/BeBochs1.4 and backup .bochsrc. Open .bochsrc with
your favorite text editor, remove the complete contents and paste the
following instead (you may as well take the original file and insert/replace/
keep the respective lines):

romimage: file=bios/BIOS-bochs-latest, address=0xf0000
megs: 32
vgaromimage: bios/VGABIOS-elpin-2.40
floppya: 1_44=/tmp/obos.img, status=inserted
boot: a
log: /var/log/bochs-obos.log
panic: action=ask
error: action=report
info: action=report
debug: action=ignore
vga_update_interval: 300000
keyboard_serial_delay: 250
keyboard_paste_delay: 100000
floppy_command_delay: 500
ips: 2000000

Now put the OBOS boot image onto you "virtual" floppy and start Bochs:

  $ cd <OBOS sources directory>
  $ jam installfloppy
  $ cd /boot/apps/BeBochs1.4
  $ ./bochs

Answer three times with RETURN and with some patience you will see OBOS
booting.

Description
The Haiku operating system
Readme 554 MiB
Languages
C++ 52.2%
C 46.6%
Assembly 0.4%
HTML 0.3%
Python 0.1%