mirror of
https://gitlab.com/freepascal.org/fpc/source.git
synced 2025-08-27 21:30:23 +02:00
* Practically rewritten in first update in 2 years or so.
This commit is contained in:
marco
parent
7f2dd379a6
commit
925ae63afb
@ -1,200 +1,213 @@
|
|||||||
$Id$
|
$Id$
|
||||||
|
|
||||||
|
The Free Pascal *BSD port.
|
||||||
|
|
||||||
Comments, mistakes and suggestions to Marco@freepascal.org
|
Comments, mistakes and suggestions to Marco@freepascal.org
|
||||||
|
|
||||||
1 FreeBSD status and notes. (kept on CVS because I work on several places)
|
Since the last update to this document, I added the Net and OpenBSD ports,
|
||||||
|
so now it is a *BSD port. I don't own BSDi or a Mac OS X, or even accounts
|
||||||
|
on an intel system so that'll have to wait. (the Mac OS X/Darwin port
|
||||||
|
will definitely take off if the PPC codegenerator is fully working)
|
||||||
|
|
||||||
|
In 1.1.x branch, the tree RTLs will be merged into one, for easier
|
||||||
|
maintaining, this will hopefully increase the Open and NetBSD ports
|
||||||
|
somewhat.
|
||||||
|
|
||||||
|
I'm actively searching for test accounts on Open and NetBSD/i386 (and
|
||||||
|
in the future also for other processors).
|
||||||
|
Requirements: minimal: some MBs account, permanent connection, 100 MHz+
|
||||||
|
(speed not that important)
|
||||||
|
cool : 100 MB + 100MB tempspace, low latency connection
|
||||||
|
fast machine that allows swift cycling.
|
||||||
|
|
||||||
|
1 *BSD status and notes. (kept on CVS because I work on several places)
|
||||||
-----------------------------------------------------------------------------
|
-----------------------------------------------------------------------------
|
||||||
|
|
||||||
Please read these before running a FreeBSD snapshot.
|
Please read these before running a *BSD snapshot/release
|
||||||
|
|
||||||
- Supported are FreeBSD 3.x (3.2, 3.4 and 4.0-release (quickly) tested. I never
|
1.1 Supported OS versions.
|
||||||
tested on 3.0). NON-ELF (2.x) versions are not supported.
|
---
|
||||||
|
|
||||||
- This is alpha software. I didn't have data-loss using it, but you
|
FREEBSD
|
||||||
use this on your own responsability. Use a scratch, or well backup'ed
|
4.x : Used to develop and maintain port. Should work, all
|
||||||
system.
|
versions. Best *BSD platform.
|
||||||
|
|
||||||
- The FreeBSD/FPC port is now in its second stage. Some more stuff then what
|
3.x : _not_ supported, (3.2, 3.4, 3.6 would probably work
|
||||||
is required to recompile is now implemented (Clone, Sockets, Signals).
|
with some very minor changes to the signalhandling. The
|
||||||
Plans to create an (Alpha) release distribution are being made.
|
syscall numbers changed)
|
||||||
(linking to external libs worked in the 16 april version already, even
|
|
||||||
though the bsdport.txt of that date said it didn't)
|
(NON-ELF) 2.x : _not_ supported, but it might be doable. (the
|
||||||
|
OpenBSD port works on a.out)
|
||||||
|
|
||||||
|
5.0DP1 : simple testing seemed to work without changes. Nearly
|
||||||
|
no package tests tried though.
|
||||||
|
|
||||||
|
NetBSD 1.5.x : Most stuff should work.
|
||||||
|
Rest : status unknown, though some NetBSD developper said
|
||||||
|
he didn't expect problems for 1.6.x
|
||||||
|
|
||||||
|
OpenBSD 3.1 : This version should work somewhat. Needs an assembler
|
||||||
|
from the ports tree (devel/binutils) to function
|
||||||
|
properly. Linker of the ports tree is easier,
|
||||||
|
but that one doesn't want to make shared files.
|
||||||
|
|
||||||
|
The IDE also is starting to work quite nicely on FreeBSD, so it is included
|
||||||
|
in the releases since 1.0.6. I didn't check the fixes for *BSD on the other
|
||||||
|
two OSes yet.
|
||||||
|
|
||||||
|
1.2 Known bugs
|
||||||
|
---
|
||||||
|
|
||||||
|
The FreeBSD/FPC port is now more or less a tested distro. There are several
|
||||||
|
known bugs, but I can now only remember one:
|
||||||
|
|
||||||
|
- Recover from Delphi exceptions that originate as processor exceptions
|
||||||
|
will go wrong. (see texception4 in the test suite)
|
||||||
|
|
||||||
|
(recovering from several processor
|
||||||
|
exceptions in one proc will have unpredictable results (breakable hang
|
||||||
|
probably))
|
||||||
|
|
||||||
|
1.3 Possible issues.
|
||||||
|
|
||||||
|
Some things are not really bugs, but status is unknown, or there is
|
||||||
|
something dodgy about the implementation:
|
||||||
|
|
||||||
|
- The NetBSD and OpenBSD ports are barely tested, they build on the stable
|
||||||
|
FreeBSD base though. Most packages (and the FCL) have been tested with
|
||||||
|
FreeBSD, quite some with NetBSD, nearly none with OpenBSD.
|
||||||
|
|
||||||
- IMPORTANT:
|
- IMPORTANT:
|
||||||
!!! An explicite warning: Not all procedures and structures in Linux are
|
!!! An explicite warning: Not all procedures and structures in Linux are
|
||||||
checked, so even if they are not commented out, they can be not implemented!!!
|
checked, so even if they are not commented out, they can be not implemented!!!
|
||||||
This specially applies to linux specific stuff. In case of doubt, use a
|
This specially applies to linux specific stuff. In case of doubt, use a
|
||||||
scratch system, view the source, or mail the maintainer.
|
scratch system, view the source, or mail the maintainer.
|
||||||
|
I fixed a bug in truncate just a few months ago, that had gone unnoticed
|
||||||
|
for the near two years that the port works now.!!!
|
||||||
|
|
||||||
- The pre alpha version's READDIR problem is fixed with a "hack", which
|
- The absence of kernel READDIR support has been fixed with a "hack", which
|
||||||
means that searchpath (-Fx) and FindFirst/FindNext are more or less
|
means that searchpath (-Fx) and FindFirst/FindNext are more or less
|
||||||
working.
|
working. This "hacked" readdir implementation is now 1/2 year
|
||||||
I don't know how good that hack is,I hope to replace it later this week
|
bugfree now (and no anomolies detected), and works on the other two BSDs
|
||||||
by a port of freebsd's libc opendir/readdir/closedir/telldir/seekdir code,
|
too. Be careful with usage on "special" filesystems and files though.
|
||||||
just to make sure.( Libc does some complex scanning and sorting for
|
(devfs, tmpfs hardlinks)
|
||||||
duplicate names, but I don't know if that is something archaic or not.
|
Together with Sebastian I developped a port of the libc routines, but
|
||||||
Probably related to hardlinks, so don't use findfirst in /dev for now)
|
they don't work yet (NOTE to self: retest, am a lot better with debugger
|
||||||
|
now)
|
||||||
|
|
||||||
These packages have more or less been tested with ncurses:
|
3 How to build a *BSD compiler/RTL ?
|
||||||
- RTL, (NOT the Crt unit. Use ncrt for now!)
|
|
||||||
- compiler can rebuild (see below)
|
|
||||||
- packages/inet,
|
|
||||||
- packages/zlib
|
|
||||||
- packages/x11
|
|
||||||
- fcl/
|
|
||||||
- ncurses/panel.
|
|
||||||
- (reported by somebody else) XForms.
|
|
||||||
- fpgui's "hello world" demo (the other ones needed a FPC 1.1 compiler, I
|
|
||||||
only tested 1.0.1 with FreeBSD)
|
|
||||||
|
|
||||||
2 Syscalls.
|
|
||||||
-----------
|
|
||||||
|
|
||||||
The bulk of the linux syscalls are implemented.
|
|
||||||
|
|
||||||
Some that aren't implemented:
|
|
||||||
|
|
||||||
NI = not implemented yet
|
|
||||||
req = required for compiler
|
|
||||||
noreq? = not required, but not checked.
|
|
||||||
Ever? (y/n)
|
|
||||||
|
|
||||||
syscall status Ever? comment
|
|
||||||
------------------------------------------------------------------------
|
|
||||||
Readdir I req implemented from scratch, working. (this
|
|
||||||
call doesn't exist on FreeBSD and FindFirst is
|
|
||||||
based on it)
|
|
||||||
|
|
||||||
ioperm NI noreq n IO via port access impossible under FreeBSD
|
|
||||||
(so: no ports unit, port[] support)
|
|
||||||
(got some reports that port access is possible under
|
|
||||||
FreeBSD. Probably the same way it slipped into Linux;
|
|
||||||
dos emulation)
|
|
||||||
|
|
||||||
ipc NI ? The IPC is System V thingy, and only supported
|
|
||||||
under FreeBSD with certain kernel parameters.
|
|
||||||
|
|
||||||
Clone() I noreq Not implemented as syscall, based on linuxthread
|
|
||||||
assembler routine. Untested. Somebody has a good
|
|
||||||
test program? Or that tests the FCL threading
|
|
||||||
routines based on it?
|
|
||||||
|
|
||||||
sysinfo NI noreq Not supported under BSD, not even by emulator
|
|
||||||
uname NI noreq " " " " " " " "
|
|
||||||
(procedures based on this call are also commented
|
|
||||||
(get* procs))
|
|
||||||
|
|
||||||
signal I noreq A *lot* of emulation code.
|
|
||||||
alarm NI noreq? Could be possible to port. (crt.delay?)
|
|
||||||
pause NI noreq? Also possible I think. Uses process information
|
|
||||||
in linux-emu, that is why I didn't port directly.
|
|
||||||
|
|
||||||
3 How to build a FreeBSD compiler/RTL ?
|
|
||||||
-----------------------------------------------------------------------------
|
-----------------------------------------------------------------------------
|
||||||
|
|
||||||
(You'll probably need CVS sources dated after April 16th for basic support, or
|
To rebuild the compiler, you need a starting compiler which is either the
|
||||||
after the major updates on 10 september for signals and sockets.)
|
last releaseversion, or the release you are building itself (but e.g. on
|
||||||
|
other OS)
|
||||||
|
|
||||||
To rebuild the compiler, you need a starting compiler.
|
Preparation:
|
||||||
- Start compiler on other OS? (tested is Linux) -> check 3a
|
- make sure your tree is up to date and cleaned of stale object and unit files.
|
||||||
- Already a 1.0.x startcompiler on FreeBSD (e.g. from a snapshot) -> 3b is much
|
- I assume ppc386 is the name of your compiler. Append PP=<compilername> and
|
||||||
|
replace ppc386 with your compilername if it is different on your system.
|
||||||
|
- I'll assume we are building openbsd on one of the other systems.
|
||||||
|
|
||||||
|
- Start compiler on other OS? (tested is Linux) -> check 3.1
|
||||||
|
(crosscompiling)
|
||||||
|
- Already a suitable 1.0.x startcompiler on *BSD -> 3.2 is much
|
||||||
easier.
|
easier.
|
||||||
|
|
||||||
3a How to build a FreeBSD system starting on Linux or using the Linux emu of
|
Trying to build with snapshot compiler binaries is no problem mosttimes, but
|
||||||
FreeBSD? (Bootstrapping)
|
release compilers _ought_ to work.
|
||||||
|
|
||||||
The FreeBSD port is experimental atm, though valid native binaries can be
|
3.1 How to build a *BSD system starting on (another *BSD, Linux, or Linux
|
||||||
obtained.
|
emu on any of them).
|
||||||
|
---
|
||||||
|
|
||||||
The procedure here is verbose, and for the most akward case.
|
The procedure here is verbose, and for the most akward case. If you have
|
||||||
If you have linux support on on your FreeBSD machine, or operate on NFS or Samba
|
linux support on on your FreeBSD machine, or operate on NFS or Samba share
|
||||||
share (so that copying and using the sources in two systems is easier)
|
(so that copying and using the sources in two systems is easier) some steps
|
||||||
some steps can be omitted or simplified. Just play with it.
|
can be omitted or simplified. Just play with it.
|
||||||
|
|
||||||
STEP A: create the RTL assembler files.
|
create the RTL:
|
||||||
|
|
||||||
1. Copy all linux files to a new directory. (here called BSDBUILD), and
|
1. go to the target RTL directory. (if you want to build for OpenBSD, to
|
||||||
2. Copy all bsd files over them.
|
rtl/openbsd).
|
||||||
2b. Run fpcmake if you can. This will eliminate problems with Makefile being
|
2. If your binary format is the same (both are ELF), simply run
|
||||||
out of sync or containing dos lfns.
|
(g)make OS_TARGET=openbsd
|
||||||
3. Execute make OPT='-Tlinux -dBSD -a -s -OG3p3' (with any i386 FPC
|
|
||||||
compiler) in directory BSDBUILD. This failed with some go32v2 versions
|
|
||||||
(which wanted to assemble anyway), but worked with several win32 and
|
|
||||||
linux' snapshots. On go32v2 you can try to add -Aas.
|
|
||||||
|
|
||||||
You now have .ppu's and .s 's for the RTL hopefully. Don't forget
|
this will be called "case A" from now on.
|
||||||
i386/prt0.as (which is in fact a .s file)!
|
Otherwise we need to build via assembler files; (CASE B) and you'll
|
||||||
|
need to execute:
|
||||||
|
|
||||||
STEP B: Create the compiler assembler (.s) sources;
|
(g)make OS_TARGET=openbsd OPT='-a'
|
||||||
|
|
||||||
4. Compile with
|
compile the compiler:
|
||||||
./bsdcompile -Fu/full_path_to_BSDBUILD -a -s
|
|
||||||
|
|
||||||
(steps 5 and 6 are only needed for the very first FreeBSD snapshot, which
|
3. Go to the compiler/ directory
|
||||||
is no longer available)
|
Case A:
|
||||||
|
|
||||||
STEP C: Building the binary
|
make OS_TARGET=openbsd OPT='-Fu../rtl/openbsd -kdontlink'
|
||||||
|
|
||||||
7. Copy all necessary files
|
Case B:
|
||||||
(- all *.s *.ppu files, both from compiler and BSDBUILD dir,
|
|
||||||
|
make OS_TARGET=openbsd OPT='-Fu../rtl/openbsd -kdontlink -a'
|
||||||
|
|
||||||
|
4 Collect all necessary files, put them in one directory on the target
|
||||||
|
computer.
|
||||||
|
|
||||||
|
Case A: - all *.o and *.ppu files in compiler/ and rtl/openbsd/
|
||||||
- compiler/link.res and
|
- compiler/link.res and
|
||||||
- compiler/ppas.sh
|
- compiler/ppas.sh
|
||||||
- Cut and paste of the DO_S script at the end of this document to file
|
|
||||||
- rtl/bsd/i386/*.as files.
|
|
||||||
)
|
|
||||||
to a directory on the BSD machine.
|
|
||||||
8a. Change to the directory on the BSD machine, and run the script DO_S to
|
|
||||||
assemble all .s files to .o files.
|
|
||||||
8b. Assemble the stub with as prt0.as -o prt0.o
|
|
||||||
9. Adapt link.res so that all paths are right.
|
|
||||||
(remove all paths in front of all .o files, remove the -l lines and their
|
|
||||||
parentheses)
|
|
||||||
10a. Edit ppas.sh, and keep only #!/bin/sh and the line starting with ld.
|
|
||||||
b Remove any -l=ld-linux.so.1 (or similar) option from the ld line.
|
|
||||||
c run ppas.sh to build the compiler
|
|
||||||
|
|
||||||
11. Have fun :-) The compiler is called "pp"
|
Case B: - All *.s and *.ppu files in compiler/ and rtl/openbsd/
|
||||||
|
- the prt0.as file in rtl/openbsd/i386, rename this file to prt0.s
|
||||||
|
- compiler/link.res and compiler/ppas.sh
|
||||||
|
|
||||||
12. If you have a heavy machine (pentium 100 and 32MB+) execute 3b to make
|
Creating the final compiler:
|
||||||
sure everything is up to date.
|
|
||||||
|
|
||||||
------------
|
5 edit link.res, and fix all paths (it will include ../rtl/openbsd, simply
|
||||||
|
remove all paths in the INPUT() section, so filenames only)
|
||||||
|
Remove "dontlink" from the commandline of the linker in the ppas.sh file,
|
||||||
|
and make the ppas.sh file executable with chmod.
|
||||||
|
|
||||||
3b How to update FPC compiler on FreeBSD from fresh CVS sources with a snapshot
|
6 Make sure you are in the right dir.
|
||||||
installed.
|
Case A: run ppas.sh
|
||||||
|
Case B: run the do_s script in the appendix (which will assembler all *.s
|
||||||
|
files to *.o on the target system), THEN run ppas.sh
|
||||||
|
|
||||||
(To create a compiler for the 1.0 branch, you need a 1.0.x compiler, and to
|
7 Test your compiler with pp -?, brandelf if necessary. (NetBSD ident code is
|
||||||
create a 1.1 (development branch) compiler you need a 1.1.x snapshot.
|
already in the prt0.s file. Will be for ELF OpenBSD too)
|
||||||
You can check the version of your snapshot with ppc386 -i)
|
|
||||||
|
|
||||||
(assuming ppc386 in the PATH, and a rtl/ and compiler/ directory obtained
|
Rebuild everything (compiler+RTL+FCL+pkgs) on the host system:
|
||||||
from snapshot zips, with non mangled makefiles)
|
|
||||||
|
|
||||||
1a Rename the rtl/linux to something else. (here: rtl/linuxorg)
|
8 Go to the toplevel directory fpc/
|
||||||
1b create a new rtl/linux dir
|
|
||||||
1c copy rtl/linuxorg/* to rtl/linux
|
|
||||||
1d copy rtl/bsd/* to rtl/linux RECURSIVELY
|
|
||||||
1e (optionally) Run fpcmake if you have it installed. This is a good
|
|
||||||
habit!
|
|
||||||
2 switch to compiler/
|
|
||||||
3 gmake cycle OPT='-OG3p3 -dBSD' will generate a new compiler.
|
|
||||||
|
|
||||||
Be patient! FreeBSD has slower disk-io than Linux :-)
|
9 Enter:
|
||||||
|
gmake all
|
||||||
|
|
||||||
Rest is like Linux, except that I strongly advise to create the fpc
|
Install the system
|
||||||
directory always in /usr/local/lib/ instead of /usr/lib.
|
|
||||||
This habit is still fashionable on FreeBSD.
|
|
||||||
|
|
||||||
The same with other packages. Like Linux :-)
|
10 gmake install
|
||||||
|
(will install into $PREFIX=/usr/local)
|
||||||
|
|
||||||
4 Linking to external libraries
|
|
||||||
-----------------------------------------------------------------------------
|
|
||||||
|
|
||||||
Same as on Linux, except use the
|
|
||||||
|
3.2 How to build a *BSD system if you have a suitable compiler on the
|
||||||
|
targetsystem.
|
||||||
|
---
|
||||||
|
|
||||||
|
Rebuild everything (compiler+RTL+FCL+pkgs) on the host system:
|
||||||
|
|
||||||
|
1 Go to the toplevel directory fpc/
|
||||||
|
|
||||||
|
2 Enter:
|
||||||
|
gmake all
|
||||||
|
|
||||||
|
Install the system
|
||||||
|
|
||||||
|
3 gmake install
|
||||||
|
(will install into $PREFIX=/usr/local)
|
||||||
|
|
||||||
|
|
||||||
------------------
|
------------------
|
||||||
The DO_S script. (C) El Znorro
|
Appendix A: The DO_S script. (C) El Znorro
|
||||||
------------------
|
------------------
|
||||||
#!/bin/sh
|
#!/bin/sh
|
||||||
|
|
||||||
@ -207,7 +220,10 @@ for i in *.s; do
|
|||||||
|
|
||||||
{
|
{
|
||||||
$Log$
|
$Log$
|
||||||
Revision 1.2 2000-09-18 13:42:35 marco
|
Revision 1.3 2002-08-08 20:39:26 marco
|
||||||
|
* Practically rewritten in first update in 2 years or so.
|
||||||
|
|
||||||
|
Revision 1.2 2000/09/18 13:42:35 marco
|
||||||
* FreeBSD support into 1.1
|
* FreeBSD support into 1.1
|
||||||
|
|
||||||
Revision 1.3 2000/09/11 14:38:09 marco
|
Revision 1.3 2000/09/11 14:38:09 marco
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user