| 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 | -------------------------------------------------------------------------------
|
|---|
| 100 | Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008,
|
|---|
| 101 | 2009, 2010 Free Software Foundation, Inc.
|
|---|
| 102 | This file is part of GNU Make.
|
|---|
| 103 |
|
|---|
| 104 | GNU Make is free software; you can redistribute it and/or modify it under the
|
|---|
| 105 | terms of the GNU General Public License as published by the Free Software
|
|---|
| 106 | Foundation; either version 3 of the License, or (at your option) any later
|
|---|
| 107 | version.
|
|---|
| 108 |
|
|---|
| 109 | GNU Make is distributed in the hope that it will be useful, but WITHOUT ANY
|
|---|
| 110 | WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
|
|---|
| 111 | A PARTICULAR PURPOSE. See the GNU General Public License for more details.
|
|---|
| 112 |
|
|---|
| 113 | You should have received a copy of the GNU General Public License along with
|
|---|
| 114 | this program. If not, see <http://www.gnu.org/licenses/>.
|
|---|
