mirror of
https://github.com/darlinghq/darling-gnumake.git
synced 2024-11-23 03:49:58 +00:00
114 lines
4.5 KiB
Plaintext
114 lines
4.5 KiB
Plaintext
-*-indented-text-*-
|
||
|
||
GNU make can utilize the Customs library, distributed with Pmake, to
|
||
provide builds distributed across multiple hosts.
|
||
|
||
In order to utilize this capability, you must first download and build
|
||
the Customs library. It is contained in the Pmake distribution, which
|
||
can be obtained at:
|
||
|
||
ftp://ftp.icsi.berkeley.edu/pub/ai/stolcke/software/
|
||
|
||
This integration was tested (superficially) with Pmake 2.1.33.
|
||
|
||
|
||
BUILDING CUSTOMS
|
||
----------------
|
||
|
||
First, build pmake and Customs. You need to build pmake first, because
|
||
Customs require pmake to build. Unfortunately, this is not trivial;
|
||
please see the pmake and Customs documentation for details. The best
|
||
place to look for instructions is in the pmake-2.1.33/INSTALL file.
|
||
|
||
Note that the 2.1.33 Pmake distribution comes with a set of patches to
|
||
GNU make, distributed in the pmake-2.1.33/etc/gnumake/ directory. These
|
||
patches are based on GNU make 3.75 (there are patches for earlier
|
||
versions of GNU make, also). The parts of this patchfile which relate
|
||
directly to Customs support have already been incorporated into this
|
||
version of GNU make, so you should _NOT_ apply the patch file.
|
||
|
||
However, there are a few non-Customs specific (as far as I could tell)
|
||
changes here which are not incorporated (for example, the modification
|
||
to try expanding -lfoo to libfoo.so). If you rely on these changes
|
||
you'll need to re-apply them by hand.
|
||
|
||
Install the Customs library and header files according to the
|
||
documentation. You should also install the man pages (contrary to
|
||
comments in the documentation, they weren't installed automatically for
|
||
me; I had to cd to the ``pmake-2.1.33/doc'' directory and run ``pmake
|
||
install'' there directly).
|
||
|
||
|
||
BUILDING GNU MAKE
|
||
-----------------
|
||
|
||
Once you've installed Customs, you can build GNU make to use it. When
|
||
configuring GNU make, merely use the ``--with-customs=DIR'' option.
|
||
Provide the directory containing the ``lib'' and ``include/customs''
|
||
subdirectories as DIR. For example, if you installed the customs
|
||
library in /usr/local/lib and the headers in /usr/local/include/customs,
|
||
then you'd pass ``--with-customs=/usr/local'' as an option to configure.
|
||
|
||
Run make (or use build.sh) normally to build GNU make as described in
|
||
the INSTALL file.
|
||
|
||
See the documentation for Customs for information on starting and
|
||
configuring Customs.
|
||
|
||
|
||
INVOKING CUSTOMS-IZED GNU MAKE
|
||
-----------------------------
|
||
|
||
One thing you should be aware of is that the default build environment
|
||
for Customs requires root permissions. Practically, this means that GNU
|
||
make must be installed setuid root to use Customs.
|
||
|
||
If you don't want to do this, you can build Customs such that root
|
||
permissions are not necessary. Andreas Stolcke <stolcke@speech.sri.com>
|
||
writes:
|
||
|
||
> pmake, gnumake or any other customs client program is not required to
|
||
> be suid root if customs was compiled WITHOUT the USE_RESERVED_PORTS
|
||
> option in customs/config.h. Make sure the "customs" service in
|
||
> /etc/services is defined accordingly (port 8231 instead of 1001).
|
||
|
||
> Not using USE_RESERVED_PORTS means that a user with programming
|
||
> skills could impersonate another user by writing a fake customs
|
||
> client that pretends to be someone other than himself. See the
|
||
> discussion in etc/SECURITY.
|
||
|
||
|
||
PROBLEMS
|
||
--------
|
||
|
||
SunOS 4.1.x:
|
||
The customs/sprite.h header file #includes the <malloc.h> header
|
||
files; this conflicts with GNU make's configuration so you'll get a
|
||
compile error if you use GCC (or any other ANSI-capable C compiler).
|
||
|
||
I commented out the #include in sprite.h:107:
|
||
|
||
#if defined(sun) || defined(ultrix) || defined(hpux) || defined(sgi)
|
||
/* #include <malloc.h> */
|
||
#else
|
||
|
||
YMMV.
|
||
|
||
|
||
-------------------------------------------------------------------------------
|
||
Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006
|
||
Free Software Foundation, Inc.
|
||
This file is part of GNU Make.
|
||
|
||
GNU Make is free software; you can redistribute it and/or modify it under the
|
||
terms of the GNU General Public License as published by the Free Software
|
||
Foundation; either version 2, or (at your option) any later version.
|
||
|
||
GNU Make is distributed in the hope that it will be useful, but WITHOUT ANY
|
||
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
|
||
A PARTICULAR PURPOSE. See the GNU General Public License for more details.
|
||
|
||
You should have received a copy of the GNU General Public License along with
|
||
GNU Make; see the file COPYING. If not, write to the Free Software
|
||
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|