$Id: BUILDNOTES,v 1.4 2000/12/11 03:19:53 jon Exp $ # $NCDId: @(#)BUILDNOTES,v 1.7 1995/11/28 23:25:57 greg Exp $ BUILDING: 1. Make sure you have imake. (See the BUILDNOTES file if you want to try building with X11R4). 2. Do "xmkmf" to create the initial Makefile. For Unixware 7, use "imake -DUseInstalled -I/usr/lib/X11/config" 3. Do "make World" (note the uppercase World) to build the distribution. If you'd like to enable the option of having the audio library automatically start up an NAS server on the local host when necessary, use the following command to build the distribution: make WORLDOPTS='-k CDEBUGFLAGS="$(CDEBUGFLAGS) -DSTARTSERVER"' World 4. If everything built successfully, you can install it using "make install"; to temporarily stage it under some directory, use "make install DESTDIR=/usr/tmp/nas" or some such. 5. To install the manual pages, use "make install.man" or "make install.man DESTDIR=/usr/tmp/nas" as above. ######################################################################## [ Note: The following contains building information on 1.2p5 and earlier releases. It hasn't been updated recently, and will probably not provide any useful information on modern OS's. -JET ] This following contains information on the following topics: 1. Solaris 2.3 OpenWindows notes 2. System V Release 4.0 notes 3. X11R4 notes 4. SunOS 4.1.3 OpenWindows notes 5. SS5 notes 6. AIX notes 7. DEC Alpha (OSF1 V3.2) notes ============================== Solaris 2.3 OpenWindows notes ----------------------------- The imake configuration files in /usr/openwin/lib/config are slightly broken and require the following patches to work effectively. Firstly, symlink the following: # cd /usr/openwin/lib/X11 # ln -s ../app-defaults ../config . # cd config # patch < patch-below -------------- diff -c ORIG.5.3/Imake.tmpl ./Imake.tmpl *** ORIG.5.3/Imake.tmpl Tue Sep 7 08:12:34 1993 --- ./Imake.tmpl Fri Jan 28 16:34:58 1994 *************** *** 885,896 **** CCFLAGS = $(CDEBUGFLAGS) $(CCCOPTIONS) $(ALLDEFINES) LINTFLAGS = $(LINTOPTS) -DLINT $(ALLDEFINES) #if AlternateUsrLibDir && !defined(UseInstalled) ! LDLIBS = -L$(USRLIBDIR) $(SYS_LIBRARIES) $(EXTRA_LIBRARIES) #else LDLIBS = $(SYS_LIBRARIES) $(EXTRA_LIBRARIES) #endif #if AlternateUsrLibDir && defined(UseInstalled) ! LDOPTIONS = $(CDEBUGFLAGS) $(CCOPTIONS) $(EXTRA_LDOPTIONS) $(LOCAL_LDFLAGS) -L$(USRLIBDIR) #else LDOPTIONS = $(CDEBUGFLAGS) $(CCOPTIONS) $(EXTRA_LDOPTIONS) $(LOCAL_LDFLAGS) #endif --- 885,896 ---- CCFLAGS = $(CDEBUGFLAGS) $(CCCOPTIONS) $(ALLDEFINES) LINTFLAGS = $(LINTOPTS) -DLINT $(ALLDEFINES) #if AlternateUsrLibDir && !defined(UseInstalled) ! LDLIBS = -L$(USRLIBDIR) -R$(USRLIBDIR) $(SYS_LIBRARIES) $(EXTRA_LIBRARIES) #else LDLIBS = $(SYS_LIBRARIES) $(EXTRA_LIBRARIES) #endif #if AlternateUsrLibDir && defined(UseInstalled) ! LDOPTIONS = $(CDEBUGFLAGS) $(CCOPTIONS) $(EXTRA_LDOPTIONS) $(LOCAL_LDFLAGS) -L$(USRLIBDIR) -R$(USRLIBDIR) #else LDOPTIONS = $(CDEBUGFLAGS) $(CCOPTIONS) $(EXTRA_LDOPTIONS) $(LOCAL_LDFLAGS) #endif Only in .: ORIG.5.3 diff -c ORIG.5.3/site.def ./site.def *** ORIG.5.3/site.def Tue Sep 7 08:12:36 1993 --- ./site.def Fri Jan 28 15:21:10 1994 *************** *** 27,32 **** --- 27,33 ---- /* #define HasGcc YES */ + #undef UseInstalled #define UseInstalled YES #endif /* BeforeVendorCF */ -------------- ============================== System V Release 4.0 notes -------------------------- The audio library has been ported to use the STREAMSCONN transport if enabled. Currently auscope(1) doesn't have STREAMSCONN support, but works ok with TCPCONN on our system. A side effect of the aulib STREAMSCONN implimentation is that /etc/services must contain lines of the form to satisfy netdir_getbyname(3): -------------- # # defacto standard for X11, required by SVR4 XLIB STREAMSCONN code # (for X11 clients and server) # xserver0 6000/tcp xserver1 6001/tcp xserver2 6002/tcp # audio service required by SVR4 AULIB STREAMSCONN code # (for audio clients and server) auserver8000 8000/tcp auserver8001 8001/tcp auserver8002 8002/tcp -------------- One day this might be fixed. ============================== X11R4 notes ----------- This code has been ported back to X11R4 on two platforms SVR3.2/386 with Lachman TCP/IP, using STREAMSCONN (except for auscope which still uses TCPCONN) IBM AIX 3.2 The only significant change required to support X11R4 is that the definition of the new-to-X11R5 "XCOMM" symbol needs to be added to Imake.tmpl so that XCOMM style comments get translated back into has comments. Add these lines to the top of /usr/lib/X11/config/Imake.tmpl (or wherever you keep it): #ifndef XCOMM #define XCOMM # #endif If your C compiler has a limit on the number of -L options supplied (some SVR3.2 cc's have a limit of 6), you may need to put this wrapper version of "cc" in your path ahead of the system one. ---------------- #! /bin/sh # Reduce the number of -L options so cc(1) can cope ARGS="/bin/cc" LASTL="" for a in "$@" do case "$a" in "$LASTL") # ignore ;; -L*) LASTL="$a" ARGS="$ARGS $a" ;; *) ARGS="$ARGS $a" ;; esac done echo + $ARGS exec $ARGS ---------------- ============================== SunOS 4.1.3 OpenWindows notes ----------------------------- Date: Tue, 14 Nov 95 12:22:08 EST From: cschroed@hercii.lasc.lockheed.com (Curt Schroeder) The following information is distilled from my notes regarding building NAS on my SPARCstation LX using SunOS 4.1.3_U1 and Openwindows. I have successfully used the executables on IPX, LX, SS5, and SS10 workstations. It does not work on SS5 workstations without some modifications and an operating system patch (see below). The easiest place I have found to build NAS is as a subdirectory of /usr/openwin/lib (i.e. /usr/openwin/lib/nas-1.2p1). - Had to put the following in the sysetm Imake.tmpl: #ifndef XCOMM #define XCOMM # #endif - Added the "ForceSubdirs" rule to the system Imake.rules: /* * ForceSubdirs - force make to build subdirectories */ #ifndef ForceSubdirs #define ForceSubdirs(dirs) @@\ dirs: FRC @@\ @cd $@ ; echo "making all in $(CURRENT_DIR)/$@..."; \ @@\ $(MAKE) $(MFLAGS) PassCDebugFlags all @@\ @@\ FRC: #endif /* ForceSubdirs */ - Added definition 'BINDIR = $OPENWINHOME/bin' to NetAudio.tmpl; I am not absolutely certain this is needed. - Change MKDIRHIER definition to execute '$(BINDIR)/mkdirhier' in system Project.tmpl (both instances). - Created symbolic link: ln -s /usr/openwin/lib/config /usr/lib/X11/config - Created symbolic link: ln -s /usr/openwin/include/X11 /usr/include/X11 - Makedepend could not find the following files: Xosdefs.h Xfuncs.h Made the following replacements in the server/include/misc.h file: =>