More updates and format changes
This commit is contained in:
+131
-111
@@ -2,9 +2,9 @@
|
||||
<HTML>
|
||||
README.html
|
||||
<BODY>
|
||||
<CENTER><H1>Installation Instructions</H1>
|
||||
<H2>EPICS base</H2>
|
||||
<H2>Release 3.14.*</H2><BR>
|
||||
<CENTER>
|
||||
<H1>Installation Instructions</H1>
|
||||
<H2>EPICS base Release 3.14.*</H2><BR>
|
||||
</CENTER>
|
||||
<HR>
|
||||
<H3> Table of Contents</H3>
|
||||
@@ -55,7 +55,7 @@ README.html
|
||||
<BLOCKQUOTE>
|
||||
<PRE>aix-ppc
|
||||
aix-ppc-gnu
|
||||
cygwin-x86 (unix style API, links with cygwin1.dll)
|
||||
cygwin-x86 (unix style API, uses cygwin1.dll compatability library)
|
||||
darwin-ppc
|
||||
darwin-x86
|
||||
darwin-ppcx86
|
||||
@@ -74,8 +74,8 @@ solaris-sparc64-gnu
|
||||
solaris-x86
|
||||
solaris-x86-gnu
|
||||
win32-x86
|
||||
win32-x86-mingw (WIN32 API, links with standard MS dlls)
|
||||
win32-x86-cygwin (WIN32 API, links with standard MS dlls)
|
||||
win32-x86-mingw (WIN32 API, uses MS dlls)
|
||||
win32-x86-cygwin (WIN32 API, uses MS dlls)
|
||||
</PRE>
|
||||
</BLOCKQUOTE>
|
||||
<H4> Cross compile target platforms (operating system - architecture)</H4>
|
||||
@@ -189,120 +189,126 @@ http://www.aps.anl.gov/epics</A></BLOCKQUOTE>
|
||||
hosted at APS with a list repeater at BESSY. See the EPICS home page
|
||||
for subscription instructions.</BLOCKQUOTE></BLOCKQUOTE>
|
||||
<H3><A NAME="0_0_10"> Directory Structure</A></H3>
|
||||
<BLOCKQUOTE>Distribution directory structure:</BLOCKQUOTE> <TT>
|
||||
<BLOCKQUOTE><H4>Distribution directory structure:</H4>
|
||||
<BLOCKQUOTE><TT>
|
||||
base Root directory of the base distribution</TT>
|
||||
<BR> <TT> base/config R3.13 compatibility build
|
||||
<BR> <TT>base/config R3.13 compatibility build
|
||||
configuration files</TT>
|
||||
<BR> <TT> base/config/tools Perl and shell scripts used
|
||||
<BR> <TT>base/config/tools Perl and shell scripts used
|
||||
in the R3.13 build</TT>
|
||||
<BR> <TT> base/configure Operating system independent
|
||||
<BR> <TT>base/configure Operating system independent
|
||||
build config files</TT>
|
||||
<BR> <TT> base/configure/os Operating system dependent
|
||||
<BR> <TT>base/configure/os Operating system dependent
|
||||
build config files</TT>
|
||||
<BR> <TT> base/configure/tools Perl and shell scripts used
|
||||
<BR> <TT>base/configure/tools Perl and shell scripts used
|
||||
in the build</TT>
|
||||
<BR> <TT> base/documentation Distributation documentation</TT>
|
||||
<BR> <TT> base/src All epics base source code in
|
||||
<BR> <TT>base/documentation Distributation documentation</TT>
|
||||
<BR> <TT>base/src All epics base source code in
|
||||
subdirectories</TT>
|
||||
<BR> <TT> base/src/RTEMS Code to configure RTEMS for
|
||||
<BR> <TT>base/src/RTEMS Code to configure RTEMS for
|
||||
EPICS</TT>
|
||||
<BR> <TT> base/src/as Access security</TT>
|
||||
<BR> <TT> base/src/bpt Break point table</TT>
|
||||
<BR> <TT> base/src/ca Channel access</TT>
|
||||
<BR> <TT> base/src/cap5 Channel Access client
|
||||
<BR> <TT>base/src/as Access security</TT>
|
||||
<BR> <TT>base/src/bpt Break point table</TT>
|
||||
<BR> <TT>base/src/ca Channel access</TT>
|
||||
<BR> <TT>base/src/cap5 Channel Access client
|
||||
interface for Perl 5</TT>
|
||||
<BR> <TT> base/src/cas Channel access server library
|
||||
<BR> <TT>base/src/cas Channel access server library
|
||||
and examples</TT>
|
||||
<BR> <TT> base/src/catools Channel access tools caget,
|
||||
<BR> <TT>base/src/catools Channel access tools caget,
|
||||
cainfo, camonitor, caput</TT>
|
||||
<BR> <TT> base/src/db Database access</TT>
|
||||
<BR> <TT> base/src/db/test Database access tests</TT>
|
||||
<BR> <TT> base/src/dbStatic Static database access</TT>
|
||||
<BR> <TT> base/src/dbtools Database dbLoadTemplate tools</TT>
|
||||
<BR> <TT> base/src/dev Device support (camacDev,
|
||||
<BR> <TT>base/src/db Database access</TT>
|
||||
<BR> <TT>base/src/db/test Database access tests</TT>
|
||||
<BR> <TT>base/src/dbStatic Static database access</TT>
|
||||
<BR> <TT>base/src/dbtools Database dbLoadTemplate tools</TT>
|
||||
<BR> <TT>base/src/dev Device support (camacDev,
|
||||
softDev, and testDev)</TT>
|
||||
<BR> <TT> base/src/excas Example channel access server</TT>
|
||||
<BR> <TT> base/src/gdd General data descriptor</TT>
|
||||
<BR> <TT> base/src/libCom General purpose library code
|
||||
<BR> <TT>base/src/excas Example channel access server</TT>
|
||||
<BR> <TT>base/src/gdd General data descriptor</TT>
|
||||
<BR> <TT>base/src/libCom General purpose library code
|
||||
in subdirectories</TT>
|
||||
<BR> <TT> base/src/libCom/bucketLib Hash bucket</TT>
|
||||
<BR> <TT> base/src/libCom/calc Algebraic expression
|
||||
<BR> <TT>base/src/libCom/bucketLib Hash bucket</TT>
|
||||
<BR> <TT>base/src/libCom/calc Algebraic expression
|
||||
interpreter</TT>
|
||||
<BR> <TT> base/src/libCom/cppStd Support for C++ standard
|
||||
<BR> <TT>base/src/libCom/cppStd Support for C++ standard
|
||||
template library</TT>
|
||||
<BR> <TT> base/src/libCom/cvtFast Fast number to string
|
||||
<BR> <TT>base/src/libCom/cvtFast Fast number to string
|
||||
conversion</TT>
|
||||
<BR> <TT> base/src/libCom/cxxTemplates C++ templates and templates
|
||||
<BR> <TT>base/src/libCom/cxxTemplates C++ templates and templates
|
||||
tests</TT>
|
||||
<BR> <TT> base/src/libCom/dbmf Memory management for
|
||||
<BR> <TT>base/src/libCom/dbmf Memory management for
|
||||
frequent alloc/free</TT>
|
||||
<BR> <TT> base/src/libCom/ellLib EPICS double linked list</TT>
|
||||
<BR> <TT> base/src/libCom/env Default EPICS environment
|
||||
<BR> <TT>base/src/libCom/ellLib EPICS double linked list</TT>
|
||||
<BR> <TT>base/src/libCom/env Default EPICS environment
|
||||
settings</TT>
|
||||
<BR> <TT> base/src/libCom/error Error handling definitions
|
||||
<BR> <TT>base/src/libCom/error Error handling definitions
|
||||
and routines</TT>
|
||||
<BR> <TT> base/src/libCom/fdmgr File descriptor manager</TT>
|
||||
<BR> <TT> base/src/libCom/freeList Memory management using free
|
||||
<BR> <TT>base/src/libCom/fdmgr File descriptor manager</TT>
|
||||
<BR> <TT>base/src/libCom/freeList Memory management using free
|
||||
lists</TT>
|
||||
<BR> <TT> base/src/libCom/gpHash General purpose hash table</TT>
|
||||
<BR> <TT> base/src/libCom/logClient Logging client</TT>
|
||||
<BR> <TT> base/src/libCom/macLib Macro substitution handler</TT>
|
||||
<BR> <TT> base/src/libCom/misc Miscellaneous utilities</TT>
|
||||
<BR> <TT> base/src/libCom/osi Operating system independent
|
||||
<BR> <TT>base/src/libCom/gpHash General purpose hash table</TT>
|
||||
<BR> <TT>base/src/libCom/logClient Logging client</TT>
|
||||
<BR> <TT>base/src/libCom/macLib Macro substitution handler</TT>
|
||||
<BR> <TT>base/src/libCom/misc Miscellaneous utilities</TT>
|
||||
<BR> <TT>base/src/libCom/osi Operating system independent
|
||||
code</TT>
|
||||
<BR> <TT> base/src/libCom/osi/os Operating system dependant
|
||||
<BR> <TT>base/src/libCom/osi/os Operating system dependant
|
||||
code in subdirectories</TT>
|
||||
<BR> <TT> base/src/libCom/ring Methods for creating and
|
||||
<BR> <TT>base/src/libCom/ring Methods for creating and
|
||||
using ring buffers</TT>
|
||||
<BR> <TT> base/src/libCom/taskwd Task watchdog</TT>
|
||||
<BR> <TT> base/src/libCom/test Test tools (timer, semBinary,
|
||||
<BR> <TT>base/src/libCom/taskwd Task watchdog</TT>
|
||||
<BR> <TT>base/src/libCom/test Test tools (timer, semBinary,
|
||||
semMutex,fdmgr, ...)</TT>
|
||||
<BR> <TT> base/src/libCom/timer Timer</TT>
|
||||
<BR> <TT> base/src/libCom/tsDefs R3.13 time stamp definitions
|
||||
<BR> <TT>base/src/libCom/timer Timer</TT>
|
||||
<BR> <TT>base/src/libCom/tsDefs R3.13 time stamp definitions
|
||||
and routines</TT>
|
||||
<BR> <TT> base/src/makeBaseApp Perl tool+templates to create
|
||||
<BR> <TT>base/src/makeBaseApp Perl tool+templates to create
|
||||
ioc app dvl tree</TT>
|
||||
<BR> <TT> base/src/makeBaseExt Perl tool+templates to create
|
||||
<BR> <TT>base/src/makeBaseExt Perl tool+templates to create
|
||||
extension dvl tree</TT>
|
||||
<BR> <TT> base/src/misc Miscellaneous (coreRelease,
|
||||
<BR> <TT>base/src/misc Miscellaneous (coreRelease,
|
||||
iocInit, asSub*)</TT>
|
||||
<BR> <TT> base/src/rec Record support</TT>
|
||||
<BR> <TT> base/src/registry EPICS support function
|
||||
<BR> <TT>base/src/rec Record support</TT>
|
||||
<BR> <TT>base/src/registry EPICS support function
|
||||
registry</TT>
|
||||
<BR> <TT> base/src/rsrv Channel access ioc resource
|
||||
<BR> <TT>base/src/rsrv Channel access ioc resource
|
||||
server library</TT>
|
||||
<BR> <TT> base/src/softIoc Example softIoc</TT>
|
||||
<BR> <TT> base/src/tools Perl scripts used during the
|
||||
<BR> <TT>base/src/softIoc Example softIoc</TT>
|
||||
<BR> <TT>base/src/tools Perl scripts used during the
|
||||
builds</TT>
|
||||
<BR> <TT> base/src/toolsComm Code for the build tools
|
||||
<BR> <TT>base/src/toolsComm Code for the build tools
|
||||
antelope and e_flex</TT>
|
||||
<BR> <TT> base/src/util Utilities (ca_test,
|
||||
<BR> <TT>base/src/util Utilities (ca_test,
|
||||
iocLogServer, startCArepeater)</TT>
|
||||
<BR> <TT> base/src/vxWorks R3.13 compatibility code
|
||||
<BR> <TT>base/src/vxWorks R3.13 compatibility code
|
||||
specific to vxWorks</TT>
|
||||
<BR> <TT> base/startup Scripts for setting up path
|
||||
<BR> <TT>base/startup Scripts for setting up path
|
||||
and environment</TT>
|
||||
<P><TT> </TT> Install directories created by the build:</P>
|
||||
<P><TT> bin Installed scripts and executables in
|
||||
</BLOCKQUOTE>
|
||||
<H4>Install directories created by the build:</H4>
|
||||
<BLOCKQUOTE>
|
||||
<P><TT>bin Installed scripts and executables in
|
||||
subdirs</TT>
|
||||
<BR> <TT> cfg Installed build configuration
|
||||
<BR> <TT>cfg Installed build configuration
|
||||
files</TT>
|
||||
<BR> <TT> db Installed data bases</TT>
|
||||
<BR> <TT> dbd Installed data base definitions</TT>
|
||||
<BR> <TT> doc Installed documentation files</TT>
|
||||
<BR> <TT> html Installed html documentation</TT>
|
||||
<BR> <TT> include Installed header files</TT>
|
||||
<BR> <TT> include/os Installed os specific header files
|
||||
<BR> <TT>db Installed data bases</TT>
|
||||
<BR> <TT>dbd Installed data base definitions</TT>
|
||||
<BR> <TT>doc Installed documentation files</TT>
|
||||
<BR> <TT>html Installed html documentation</TT>
|
||||
<BR> <TT>include Installed header files</TT>
|
||||
<BR> <TT>include/os Installed os specific header files
|
||||
in subdirs</TT>
|
||||
<BR> <TT> javalib Installed java class and jar files</TT>
|
||||
<BR> <TT> lib Installed libraries in arch
|
||||
<BR> <TT>javalib Installed java class and jar files</TT>
|
||||
<BR> <TT>lib Installed libraries in arch
|
||||
subdirectories</TT>
|
||||
<BR> <TT> lib/perl Installed perl modules</TT>
|
||||
<BR> <TT> templates Installed templates</TT></P>
|
||||
<BR> <TT>lib/perl Installed perl modules</TT>
|
||||
<BR> <TT>templates Installed templates</TT></P>
|
||||
</BLOCKQUOTE>
|
||||
</BLOCKQUOTE>
|
||||
<H3><A NAME="0_0_11"> Build related components</A></H3>
|
||||
<BLOCKQUOTE>
|
||||
<LI> base/documentation/README* files</LI>
|
||||
<BR> <TT>README.1st Instructions for setup and building epics
|
||||
<H4> base/documentation/README* files</H4>
|
||||
<BLOCKQUOTE>
|
||||
<TT>README.1st Instructions for setup and building epics
|
||||
base</TT>
|
||||
<BR> <TT>README.html html version of README.1st</TT>
|
||||
<BR> <TT>README.WIN32 Microsoft WIN32 specific instructions</TT>
|
||||
@@ -314,10 +320,10 @@ http://www.aps.anl.gov/epics</A></BLOCKQUOTE>
|
||||
<BR> <TT>KnownProblems.html List of known problems and workarounds</TT>
|
||||
<BR> <TT>Converting*To*.html Release specific conversion instructions</TT>
|
||||
<BR> <TT>Building*With*.html Release specific build instructions</TT>
|
||||
<BR>
|
||||
<LI> base/startup directory - contains scripts to set environment and
|
||||
path</LI>
|
||||
<BR> <TT>EpicsHostArch c shell script to set EPICS_HOST_ARCH env
|
||||
</BLOCKQUOTE>
|
||||
<H4> base/startup directory - contains scripts to set environment and path</H4>
|
||||
<BLOCKQUOTE>
|
||||
<TT>EpicsHostArch c shell script to set EPICS_HOST_ARCH env
|
||||
variable</TT>
|
||||
<BR> <TT>EpicsHostArch.pl perl script to set EPICS_HOST_ARCH env
|
||||
variable</TT>
|
||||
@@ -333,9 +339,10 @@ http://www.aps.anl.gov/epics</A></BLOCKQUOTE>
|
||||
variables</TT>
|
||||
<BR> <TT>win32-debug.bat WIN32 debug bat file to set debug path and
|
||||
env variables</TT>
|
||||
<BR>
|
||||
<LI> base/configure directory - contains build definitions and rules</LI>
|
||||
<BR> <TT>CONFIG Includes configure files and allows
|
||||
</BLOCKQUOTE>
|
||||
<H4> base/configure directory - contains build definitions and rules</H4>
|
||||
<BLOCKQUOTE>
|
||||
<TT>CONFIG Includes configure files and allows
|
||||
variable overrides</TT>
|
||||
<BR> <TT>CONFIG.CrossCommon Cross build definitions</TT>
|
||||
<BR> <TT>CONFIG.gnuCommon Gnu compiler build definitions for all
|
||||
@@ -370,8 +377,10 @@ http://www.aps.anl.gov/epics</A></BLOCKQUOTE>
|
||||
and tar)</TT>
|
||||
<BR> <TT>Sample.Makefile Sample makefile with comments</TT>
|
||||
<BR>
|
||||
<LI> base/configure/os directory - contains os-arch specific definitions</LI>
|
||||
<BR> <TT>CONFIG.<host>.<target> Specific host-target build
|
||||
</BLOCKQUOTE>
|
||||
<H4> base/configure/os directory - contains os-arch specific definitions</H4>
|
||||
<BLOCKQUOTE>
|
||||
<TT>CONFIG.<host>.<target> Specific host-target build
|
||||
definitions</TT>
|
||||
<BR> <TT>CONFIG.Common.<target> Specific target definitions for all
|
||||
hosts</TT>
|
||||
@@ -392,15 +401,15 @@ http://www.aps.anl.gov/epics</A></BLOCKQUOTE>
|
||||
<BR> <TT>CONFIG_SITE.<host>.Common Site specific host defs for all
|
||||
targets</TT>
|
||||
<BR>
|
||||
<LI> base/configure/tools directory - contains Perl scripts used for the
|
||||
build</LI>
|
||||
<BR> <TT>convertRelease.pl Performs consistancy checks on RELEASE
|
||||
</BLOCKQUOTE>
|
||||
<H4> base/src/tools directory - contains Perl scripts used for the build</H4>
|
||||
<BLOCKQUOTE>
|
||||
<TT>Makefile Makefile for installing the scripts into cfg dir</TT><BR>
|
||||
<TT>convertRelease.pl Performs consistancy checks on RELEASE
|
||||
files</TT>
|
||||
<BR> <TT>cp.pl This Perl script copies an existing
|
||||
file</TT>
|
||||
<BR> <TT>cvsclean.pl Remove all .#* files in directory tree</TT>
|
||||
<BR> <TT>dos2unix.pl Converts text file from DOS CR/LF to
|
||||
unix ISO</TT>
|
||||
<BR> <TT>dos2unix.pl Converts text file from DOS CR/LF to unix ISO</TT>
|
||||
<BR> <TT>expandvars.pl Tool to expand @VAR@ variables while copying a file</TT>
|
||||
<BR> <TT>filterWarnings.pl Filters warning messages during HP
|
||||
builds</TT>
|
||||
<BR> <TT>fullpathName.pl Returns fullpath name of directory arg</TT>
|
||||
@@ -409,16 +418,15 @@ http://www.aps.anl.gov/epics</A></BLOCKQUOTE>
|
||||
<BR> <TT>makeIncludeDbd.pl Creates *Include.dbd file from filename
|
||||
args</TT> files
|
||||
<BR> <TT>makeMakefile.pl Creates a Makefile in O.<arch> dirs</TT>
|
||||
<BR> <TT>makeMakefileInclude.pl Creates file to be included by Makefile</TT>
|
||||
<BR> <TT>mkdir.pl Creates a directory (like Unix mkdir)</TT>
|
||||
<BR> <TT>makeTestfile.pl Generates a test harness $target.t file</TT>
|
||||
<BR> <TT>mkmf.pl Generates dependencies from include
|
||||
stmnts</TT>
|
||||
<BR> <TT>munch.pl Creates a ctdt.c file for vxWorks
|
||||
targets</TT>
|
||||
<BR> <TT>mv.pl Renames an existing file.</TT>
|
||||
<BR> <TT>replaceVAR.pl Changes CapFast VAR(xxx) to $(xxx)
|
||||
notation</TT>
|
||||
<BR> <TT>rm.pl Quietly removes an existing file</TT></BLOCKQUOTE>
|
||||
<BR> <TT>replaceVAR.pl Changes CapFast VAR(xxx) to $(xxx) notation</TT>
|
||||
<BR> <TT>useManifestTool.pl Use MS VC++ version to set usage of Manifest Tool</TT>
|
||||
</BLOCKQUOTE>
|
||||
</BLOCKQUOTE>
|
||||
<H3><A NAME="0_0_12"> Building EPICS base (Unix and Win32)</A></H3>
|
||||
<BLOCKQUOTE>
|
||||
<H4> Unpack file</H4>
|
||||
@@ -474,26 +482,38 @@ Files in the base/startup directory have been provided to
|
||||
<BLOCKQUOTE>
|
||||
<B>Site configuration</B>
|
||||
<BR> To configure EPICS, you may want to modify the default definitions
|
||||
in the following files:<BLOCKQUOTE> <TT>configure/CONFIG_SITE </TT>
|
||||
Build choices. Specify target archs. <TT>configure/CONFIG_SITE_ENV</TT>
|
||||
Environment variable defaults <TT>configure/RELEASE </TT>
|
||||
TORNADO 2 full path location</BLOCKQUOTE><B> Host configuration</B>
|
||||
in the following files:
|
||||
<BLOCKQUOTE>
|
||||
<TT>configure/CONFIG_SITE
|
||||
Build choices. Specify target archs.<br></TT>
|
||||
<TT>configure/CONFIG_SITE_ENV
|
||||
Environment variable defaults</TT><br>
|
||||
<TT>configure/RELEASE
|
||||
TORNADO2 full path location</TT>
|
||||
</BLOCKQUOTE><B> Host configuration</B>
|
||||
<BR> To configure each host system, you may override the default
|
||||
definitions by adding a new file in the configure/os directory with
|
||||
override definitions. The new file should have the same name as the
|
||||
distribution file to be overridden except with CONFIG in the name
|
||||
changed to CONFIG_SITE.<BLOCKQUOTE><TT>
|
||||
configure/os/CONFIG.<host>.<host></TT> Host build settings
|
||||
<BR> <TT>configure/os/CONFIG.<host>.Common</TT> Host common build
|
||||
settings</BLOCKQUOTE><B> Target configuration</B>
|
||||
changed to CONFIG_SITE.<BLOCKQUOTE>
|
||||
<TT>configure/os/CONFIG.<host>.<host>
|
||||
|
||||
Host build settings</TT><BR>
|
||||
<TT>configure/os/CONFIG.<host>.Common
|
||||
|
||||
Host common build settings</TT>
|
||||
</BLOCKQUOTE><B> Target configuration</B>
|
||||
<BR> To configure each target system, you may override the default
|
||||
definitions by adding a new file in the configure/os directory with
|
||||
override definitions. The new file should have the same name as the
|
||||
distribution file to be overridden except with CONFIG in the name
|
||||
replaced by CONFIG_SITE. This step is necessary even if the host system
|
||||
is the only target system.<BLOCKQUOTE><TT>
|
||||
configure/os/CONFIG.Common.<target></TT> Target common settings
|
||||
<BR> <TT>configure/os/CONFIG.<host>.<target> </TT> Host-target settings</BLOCKQUOTE><B>
|
||||
is the only target system.<BLOCKQUOTE>
|
||||
<TT>configure/os/CONFIG.Common.<target>
|
||||
Target common settings</TT><BR>
|
||||
<TT>configure/os/CONFIG.<host>.<target>
|
||||
Host-target settings</TT>
|
||||
</BLOCKQUOTE><B>
|
||||
R3.13 compatibility configuration</B>
|
||||
<BR> To configure EPICS base for building with R3.13 extensions and ioc
|
||||
applications , you must modify the default definitions in the
|
||||
|
||||
Reference in New Issue
Block a user