| 1 |
-*-indented-text-*- |
| 2 |
|
| 3 |
GNU Make can utilize the Customs library, distributed with Pmake, to |
| 4 |
provide builds distributed across multiple hosts. |
| 5 |
|
| 6 |
In order to utilize this capability, you must first download and build |
| 7 |
the Customs library. It is contained in the Pmake distribution, which |
| 8 |
can be obtained at: |
| 9 |
|
| 10 |
ftp://ftp.icsi.berkeley.edu/pub/ai/stolcke/software/ |
| 11 |
|
| 12 |
This integration was tested (superficially) with Pmake 2.1.33. |
| 13 |
|
| 14 |
|
| 15 |
BUILDING CUSTOMS |
| 16 |
---------------- |
| 17 |
|
| 18 |
First, build pmake and Customs. You need to build pmake first, because |
| 19 |
Customs require pmake to build. Unfortunately, this is not trivial; |
| 20 |
please see the pmake and Customs documentation for details. The best |
| 21 |
place to look for instructions is in the pmake-2.1.33/INSTALL file. |
| 22 |
|
| 23 |
Note that the 2.1.33 Pmake distribution comes with a set of patches to |
| 24 |
GNU Make, distributed in the pmake-2.1.33/etc/gnumake/ directory. These |
| 25 |
patches are based on GNU Make 3.75 (there are patches for earlier |
| 26 |
versions of GNU Make, also). The parts of this patchfile which relate |
| 27 |
directly to Customs support have already been incorporated into this |
| 28 |
version of GNU Make, so you should _NOT_ apply the patch file. |
| 29 |
|
| 30 |
However, there are a few non-Customs specific (as far as I could tell) |
| 31 |
changes here which are not incorporated (for example, the modification |
| 32 |
to try expanding -lfoo to libfoo.so). If you rely on these changes |
| 33 |
you'll need to re-apply them by hand. |
| 34 |
|
| 35 |
Install the Customs library and header files according to the |
| 36 |
documentation. You should also install the man pages (contrary to |
| 37 |
comments in the documentation, they weren't installed automatically for |
| 38 |
me; I had to cd to the 'pmake-2.1.33/doc' directory and run 'pmake |
| 39 |
install' there directly). |
| 40 |
|
| 41 |
|
| 42 |
BUILDING GNU MAKE |
| 43 |
----------------- |
| 44 |
|
| 45 |
Once you've installed Customs, you can build GNU Make to use it. When |
| 46 |
configuring GNU Make, merely use the '--with-customs=DIR' option. |
| 47 |
Provide the directory containing the 'lib' and 'include/customs' |
| 48 |
subdirectories as DIR. For example, if you installed the customs |
| 49 |
library in /usr/local/lib and the headers in /usr/local/include/customs, |
| 50 |
then you'd pass '--with-customs=/usr/local' as an option to configure. |
| 51 |
|
| 52 |
Run make (or use build.sh) normally to build GNU Make as described in |
| 53 |
the INSTALL file. |
| 54 |
|
| 55 |
See the documentation for Customs for information on starting and |
| 56 |
configuring Customs. |
| 57 |
|
| 58 |
|
| 59 |
INVOKING CUSTOMS-IZED GNU MAKE |
| 60 |
----------------------------- |
| 61 |
|
| 62 |
One thing you should be aware of is that the default build environment |
| 63 |
for Customs requires root permissions. Practically, this means that GNU |
| 64 |
make must be installed setuid root to use Customs. |
| 65 |
|
| 66 |
If you don't want to do this, you can build Customs such that root |
| 67 |
permissions are not necessary. Andreas Stolcke <[email protected]> |
| 68 |
writes: |
| 69 |
|
| 70 |
> pmake, gnumake or any other customs client program is not required to |
| 71 |
> be suid root if customs was compiled WITHOUT the USE_RESERVED_PORTS |
| 72 |
> option in customs/config.h. Make sure the "customs" service in |
| 73 |
> /etc/services is defined accordingly (port 8231 instead of 1001). |
| 74 |
|
| 75 |
> Not using USE_RESERVED_PORTS means that a user with programming |
| 76 |
> skills could impersonate another user by writing a fake customs |
| 77 |
> client that pretends to be someone other than himself. See the |
| 78 |
> discussion in etc/SECURITY. |
| 79 |
|
| 80 |
|
| 81 |
PROBLEMS |
| 82 |
-------- |
| 83 |
|
| 84 |
SunOS 4.1.x: |
| 85 |
The customs/sprite.h header file #includes the <malloc.h> header |
| 86 |
files; this conflicts with GNU Make's configuration so you'll get a |
| 87 |
compile error if you use GCC (or any other ANSI-capable C compiler). |
| 88 |
|
| 89 |
I commented out the #include in sprite.h:107: |
| 90 |
|
| 91 |
#if defined(sun) || defined(ultrix) || defined(hpux) || defined(sgi) |
| 92 |
/* #include <malloc.h> */ |
| 93 |
#else |
| 94 |
|
| 95 |
YMMV. |
| 96 |
|
| 97 |
|
| 98 |
------------------------------------------------------------------------------- |
| 99 |
Copyright (C) 1998-2023 Free Software Foundation, Inc. |
| 100 |
This file is part of GNU Make. |
| 101 |
|
| 102 |
GNU Make is free software; you can redistribute it and/or modify it under the |
| 103 |
terms of the GNU General Public License as published by the Free Software |
| 104 |
Foundation; either version 3 of the License, or (at your option) any later |
| 105 |
version. |
| 106 |
|
| 107 |
GNU Make is distributed in the hope that it will be useful, but WITHOUT ANY |
| 108 |
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR |
| 109 |
A PARTICULAR PURPOSE. See the GNU General Public License for more details. |
| 110 |
|
| 111 |
You should have received a copy of the GNU General Public License along with |
| 112 |
this program. If not, see <https://www.gnu.org/licenses/>. |