ppumove is a program to make shared or static libraries from multiple units. It can be compared
with the tpumove program that comes with Turbo Pascal.
It is distributed in binary form along with the compiler.
Its usage is very simple:
ppumove [options] unit1.ppu unit2.ppu ... unitn.ppu
where options is a combination of:
- Generate a batch file that will contain the external linking and archiving commands
that must be executed. The name of this batch file is pmove.sh on linux (and Unix
like OSes), and pmove.bat on Windows and dos.
- Set the directory in which to place the output files to xxx.
- Set the extension of the moved unit files to xxx. By default, this is .ppl. You don’t
have to specify the dot.
- Set the name of the output file, i.e. the name of the file containing all the units. This
parameter is mandatory when you use multiple files. On linux, ppumove will prepend
this name with lib if it isn’t already there, and will add an extension appropriate to
the type of library.
- Operate silently.
- Make a static library instead of a dynamic one; By default a dynamic library is made
- Tell ppumove that it is working under Windows NT. This will change the names of
the linker and archiving program to ldw and arw, respectively.
-h or -?:
- Display a short help.
The action of the ppumove program is as follows: It takes each of the unit files, and modifies it so
that the compiler will know that it should look for the unit code in the library. The new unit files
will have an extension .ppu; this can be changed with the -e option. It will then put together all
the object files of the units into one library, static or dynamic, depending on the presence of the -s
The name of this library must be set with the -o option. If needed, the prefix lib will be prepended
under linux. The extension will be set to .a for static libraries, for shared libraries, the extensions
are .so on linux, and .dll under Windows NT and os/2.
As an example, the following command
./ppumove -o both -e ppl ppu.ppu timer.ppu
will generate the following output under linux:
PPU-Mover Version 2.1.1
Copyright (c) 1998-2007 by the Free Pascal Development Team
Processing ppu.ppu... Done.
Processing timer.ppu... Done.
Linking timer.o ppu.o
And it will produce the following files:
- libboth.so : The shared library containing the code from ppu.o and timer.o. Under
Windows NT, this file would be called both.dll.
- timer.ppl : The unit file that tells the Free Pascal compiler to look for the timer code
in the library.
- ppu.ppl : The unit file that tells the Free Pascal compiler to look for the ppu code in
You could then use or distribute the files libboth.so, timer.ppl and ppu.ppl.