diff --git a/configure/CONFIG_ENV b/configure/CONFIG_ENV index 4fad13bcf..2fae58374 100644 --- a/configure/CONFIG_ENV +++ b/configure/CONFIG_ENV @@ -24,22 +24,32 @@ # Augment beacon/search dest ip addr list # from white space separated ip addresses in this # environment variable. "Quote" if more than one addr. +# # EPICS_CA_AUTO_ADDR_LIST # YES = augment beacon/search dest ip # addr list from network interfaces found; NO = only use # EPICS_CA_ADDR_LIST to create this list. +# # EPICS_CA_CONN_TMO # after not seeing a server beacon for this number # of seconds the clients will send an echo request over # tcp/ip to verify the connection. +# # EPICS_CA_REPEATER_PORT CA repeater port number. +# # EPICS_CA_SERVER_PORT CA server port number. +# +# EPICS_CA_MAX_ARRAY_BYTES +# This parameter specifies the size (in bytes) of the largest array +# that the CA server will transport. +# EPICS_CA_ADDR_LIST="" EPICS_CA_AUTO_ADDR_LIST=YES EPICS_CA_CONN_TMO=30.0 EPICS_CA_REPEATER_PORT=5065 EPICS_CA_SERVER_PORT=5064 +EPICS_CA_MAX_ARRAY_BYTES=16384 # # These parameters are only used by the CA server library @@ -111,40 +121,39 @@ EPICS_CA_SERVER_PORT=5064 # -------------------------------------------------- # # o Make sure that the broadcast addresses are identical on the -# server's host and on the client's host. This can be checked with -# "netstat -i" or "ifconfig -a". +# server's host and on the client's host. This can be checked +# on UNIX with "netstat -i" or "ifconfig -a"; on vxWorks with +# ifShow; and on windows with ipconfig. # # o Make sure that the client and server are using the same UDP # port. Check the server's port by running "netstat -a | grep nnn" # where nnn is the port number involved. If you do not set -# EPICS_CA_SERVER_PORT or EPICS_CAS_SERVER_PORT -# then the default port will be 5064. +# EPICS_CA_SERVER_PORT or EPICS_CAS_SERVER_PORT then the default port +# will be 5064. # # o Two servers can run on the same host with the same server port number # if the following restrictions are understood (good luck). If the host has a # modern IP kernel it is possible to have two servers on the same UDP port. # It is not possible for two servers to run on the same host using the same -# TCP IP server port. If the CA server library detects that a 2nd server is attempting -# to start on the same port as an existing CA server then both servers will use the -# same UDP port if it is a modern IP kernel, and the 2nd server will -# be allocated a new TCP port. In this situation the clients will still be -# configured to use the same port number for both servers. The clients -# will find the 2nd server via the shared UDP port, and transparently -# connect to the 2nd server's allocated TCP port. Be aware that If there are -# two server's running on the same host on the same UDP port then they will -# both receive all UDP search requests sent as broadcasts, but will unfortunately (due to -# what I consider to be a real weakness of most IP kernel implementations) only one -# of the servers will typically receive UDP search requests sent to unicast addresses (i.e. -# a specific host's ip address). +# TCP IP server port. If the CA server library detects that a 2nd server is +# attempting to start on the same port as an existing CA server then both +# servers will use the same UDP port if it is a modern IP kernel, and the 2nd +# server will be allocated a new TCP port. In this situation the clients will +# still be configured to use the same port number for both servers. The clients +# will find the 2nd server via the shared UDP port, and transparently connect +# to the 2nd server's allocated TCP port. Be aware that If there are two server's +# running on the same host on the same UDP port then they will both receive all +# UDP search requests sent as broadcasts, but will unfortunately (due to a common +# weakness of most IP kernel implementations) only one of the servers will +# typically receive UDP search requests sent to unicast addresses (i.e. a specific +# host's ip address). # - EPICS_CA_BEACON_PERIOD=15.0 EPICS_CAS_INTF_ADDR_LIST="" EPICS_CAS_BEACON_ADDR_LIST="" EPICS_CAS_SERVER_PORT= - # Log Server: # EPICS_IOC_LOG_PORT Log server port number etc. EPICS_IOC_LOG_PORT=7004 diff --git a/src/libCom/env/envDefs.h b/src/libCom/env/envDefs.h index d3c013c4e..b260ec54a 100644 --- a/src/libCom/env/envDefs.h +++ b/src/libCom/env/envDefs.h @@ -80,6 +80,7 @@ epicsShareExtern READONLY ENV_PARAM EPICS_CA_BEACON_PERIOD; epicsShareExtern READONLY ENV_PARAM EPICS_CA_AUTO_ADDR_LIST; epicsShareExtern READONLY ENV_PARAM EPICS_CA_REPEATER_PORT; epicsShareExtern READONLY ENV_PARAM EPICS_CA_SERVER_PORT; +epicsShareExtern READONLY ENV_PARAM EPICS_CA_MAX_ARRAY_BYTES; epicsShareExtern READONLY ENV_PARAM EPICS_CAS_INTF_ADDR_LIST; epicsShareExtern READONLY ENV_PARAM EPICS_CAS_BEACON_ADDR_LIST; epicsShareExtern READONLY ENV_PARAM EPICS_CAS_SERVER_PORT; @@ -92,12 +93,9 @@ epicsShareExtern READONLY ENV_PARAM EPICS_IOC_LOG_FILE_NAME; epicsShareExtern READONLY ENV_PARAM EPICS_IOC_LOG_FILE_COMMAND; epicsShareExtern READONLY ENV_PARAM EPICS_CMD_PROTO_PORT; epicsShareExtern READONLY ENV_PARAM EPICS_AR_PORT; -#define EPICS_ENV_VARIABLE_COUNT 18 +#define EPICS_ENV_VARIABLE_COUNT 19 /* - * N elements added here to satisfy microsoft development tools - * (includes room for nill termination) - * * bldEnvData looks for "epicsShareExtern ENV_PARAM" so * this always needs to be divided into two lines */