epics Invocation Scheme

• Typically most of those files are just links to other places, except for myepicslogin.sh.
  Based on the basic setup (see below) an adminstrator can add / modify / tweak at this recommended place.

. epics [ -Options ] [ <version> ]

general login script, able to call several EPICS installations

1. optional: <before script>

source <before script>

(set by environment variable: EPICS_LOCAL_BEFORE_SCRIPT, or overwritten by option -B <Path><bash script> )

2. <loginScript> "myepicslogin.sh"

source <loginScript>

local, i.e. to the single EPICS installation, login script

default :

"<epicsHome>/<epicsDirPrefix><version>/myepicslogin.sh"

overwritten by environment variable:

EPICS_LOCAL_LOGIN_SCRIPT

overwritten by option :

-L <Path><bash script>

2.1. optional <other local pre scripts> within <loginScript>:

source <other local pre scripts>

2.2. epicslogin.sh :

source <epicsHome>/<epicsDirPrefix><version>/epicslogin.sh

epicslogin.sh :

usually a (soft) link to ${MY_ALL_EPICS_TOP_DIR}/bin

or to ${GSI_EPICS_INSTALLATIONS_TOP_DIR}/bin

2.2.1 source <epicsHome>/<epicsDirPrefix><version>/epicslogin.sh

in case it has been extended/changed to be wrapper this is a symbolic link to

$EPICS_HOME/base-<version>/startup/Site.profile.wrapper calling itself:

2.2.1.1 source $EPICS_HOME/base-<version>/startup/Site.profile.pre

most of the local default definitions before calling the former, but modified Site.profile

2.2.1.2 source $EPICS_HOME/base-<version>/startup/Site.profile.main

former Site.profile modified to be able to be more verbose

2.2.1.3 source $EPICS_HOME/base-<version>/startup/Site.profile.post

post jobs after calling Site.profile.main

2.3. optional: source <other local scripts, e.g. setting of PATHs, init of cross-compilers>

3. optional: source <after script>

(set by environment variable: EPICS_LOCAL_AFTER_SCRIPT, or overwritten by option -A <Path><bash script> )

• Variables:
  • <epicsHome>
    • default: ~epics
      (to become /usr/local/pub/${GSI_OS_FLAVOR}$(echo ${GSI_OS_VERSION?undefined}| sed -e 's/\(.\..\)\../\1/g')/$(uname -m)/${GSI_COMPILER_CC})
    • override by environment variable: EPICS_LOCAL_HOME
    • overwritten by option: -H <Path>
  • <epicsDirPrefix>
    • default: "EPICS-"
    • override by environment variable: EPICS_LOCAL_DIR_PREFIX
    • overwritten by option: -P <Prefix>
  • <version>
    • default: 3.14.9
    • override by environment variable: EPICS_LOCAL_DEFAULT_VERSION
    • overwritten by argument: <Version>
  • <loginScript>
    • default: "./myepicslogin.sh"
    • override by environment variable: EPICS_LOCAL_LOGIN_SCRIPT
    • overwritten by option -L <Path><bash script>
  • <beforeScript>
    • default: [ not set ]
    • override by environment variable: EPICS_LOCAL_BEFORE_SCRIPT
    • overwritten by option -B <Path><bash script>
  • <afterScript>
    • default: [ not set ]
    • override by environment variable: EPICS_LOCAL_AFTER_SCRIPT
    • overwritten by option -A <Path><bash script>