Client and Server Broadcast Addresses Dont
+
Verify that the broadcast addresses are identical on the server's host and
@@ -1873,10 +1873,10 @@ EPICS_CA_MAX_SEARCH_PERIOD to find that newly introduced server. Also,
starting with EPICS R3.14.7 the client library does not suspend
searching for a channel after 100 unsuccessful attempts until a beacon anomaly
is seen. Therefore, if the client library is from before version R3.14.7 of
-EPICS and it timed out attempting to find a server whoose beacon cant be seen
+EPICS and it timed out attempting to find a server whose beacon can't be seen
by the client library then the client application might need to be restarted in
order to connect to this new beacon-out-of-range server. The typical situation
-where a client would not see the server's beacon might be when the client isnt
+where a client would not see the server's beacon might be when the client isn't
on the same IP subnet as the server, and the client's EPICS_CA_ADDR_LIST was
modified to include a destination address for the server, but the server's
beacon address list was not modified so that its beacons are received by the
@@ -1891,7 +1891,7 @@ disconnected until TCP/IP's internal, typically long duration, keep alive timer
expires. The disconnected channels remain attached to the beleaguered circuit
and no attempt is made to search for, or to reestablish, a new circuit. If, at
some time in the future, the circuit becomes responsive again, then the
-attached channels enter a connected state again and reconnect call back
+attached channels enter a connected state again and reconnect callback
handlers are called. Any monitor subscriptions that received an update message
while the channel was disconnected are also refreshed. If at any time the
library receives an indication from the operating system that a beleaguered
@@ -2287,7 +2287,7 @@ int main ( int argc, char ** argv )
SEVCHK ( status, "ca_array_get()" );
status = ca_pend_io ( 15.0 );
if ( status != ECA_NORMAL ) {
- fprintf ( stderr, "\"%s\" didnt return a value.\n", argv[1] );
+ fprintf ( stderr, "\"%s\" didn't return a value.\n", argv[1] );
return -1;
}
@@ -2313,7 +2313,7 @@ int main ( int argc, char ** argv )
Certain CA client initiated requests asynchronously execute an application
-supplied call back in the client process when a response arrives. The functions
+supplied callback in the client process when a response arrives. The functions
ca_put_callback, ca_get_callback, and ca_create_subscription all request notification of
asynchronous completion via this mechanism. The event_handler_args
structure is passed by value to the application supplied
@@ -2321,8 +2321,8 @@ callback. In this structure the dbr field is a void pointer to any
data that might be returned. The status field will be
set to one of the CA error codes in caerr.h and will indicate the status of the
operation performed in the IOC. If the status field isn't set to ECA_NORMAL or
-data isn't normally returned from the operation (i.e. put call back) then you
-should expect that the dbr field will be set to a nill pointer
+data isn't normally returned from the operation (i.e. put callback) then you
+should expect that the dbr field will be set to a null pointer
(zero). The fields usr, chid, and type
are set to the values specified when the request was made by the application.
The "dbr" pointer, and any data that it points to, are valid only when
@@ -2348,7 +2348,7 @@ void myCallback ( struct event_handler_args args )
-When the server detects a failure, and there is no client call back function
+
When the server detects a failure, and there is no client callback function
attached to the request, an exception handler is executed in the client. The
default exception handler prints a message on the console and exits if the
exception condition is severe. Certain internal exceptions within the CA client
@@ -2405,7 +2405,7 @@ method is best suited to toolkit components with long runtime duration. Use of
ca_state is appropriate only in programs
that prefer to poll for connection state changes instead of opting for
asynchronous notification. The ca_pend_io function blocks only for
-channels created specifying a nill connection handler callback function. The
+channels created specifying a null connection handler callback function. The
user's connection state change function will be run immediately from within
ca_create_channel if the CA
client and CA server are both hosted within the same address space (within the
@@ -2481,11 +2481,11 @@ both part of the same context.
-If preemptive call back is not enabled, then for proper operation CA must
+
If preemptive callback is not enabled, then for proper operation CA must
periodically be polled to take care of background activity. This requires that
your application must either wait in one of ca_pend_event(), ca_pend_io(), or
ca_sg_block() or alternatively it must call ca_poll() at least every 100
-milli-seconds. In single threaded applications a file descriptor manager like
+milliseconds. In single threaded applications a file descriptor manager like
Xt or the interface described in fdManager.h can be used to monitor both mouse
clicks and also CA's file descriptors so that ca_poll() can be called
immediately when CA server messages arrives over the network.
@@ -2551,8 +2551,8 @@ questionable practice for the following reasons.
-As you might expect, it isnt safe to call the CA client library from a POSIX
-signal handler. Likewise, it isnt safe to call the CA client library from
+
As you might expect, it isn't safe to call the CA client library from a POSIX
+signal handler. Likewise, it isn't safe to call the CA client library from
interrupt context.
@@ -2683,7 +2683,7 @@ a connected state.
- The first and simplest method requires that you call ca_pend_io(), and
wait for successful completion, prior to using a channel that was created
- specifying a nill connection call back function pointer.
+ specifying a null connection callback function pointer.
- The second method requires that you register a connection handler by
supplying a valid connection callback function pointer. This connection
handler is called whenever the connection state of the channel changes. If
@@ -2696,7 +2696,7 @@ channel. Valid connections may be isolated from invalid ones with this function
if ca_pend_io() times out.
Due to the inherently transient nature of network connections the order of
-connection call backs relative to the order that ca_create_channel() calls are
+connection callbacks relative to the order that ca_create_channel() calls are
made by the application can't be guaranteed, and application programs may need
to be prepared for a connected channel to enter a disconnected state at any
time.
@@ -2717,9 +2717,9 @@ time.
USERFUNC- Optional address of the user's call back function to be run when the
+
- Optional address of the user's callback function to be run when the
connection state changes. Casual users of channel access may decide to
- set this field to nill or 0 if they do not need to have a call back
+ set this field to null or 0 if they do not need to have a callback
function run in response to each connection state change event.
The following structure is passed by value to the user's
connection callback function. The op field will
@@ -2739,7 +2739,7 @@ time.
- The value of this void pointer argument is retained in
storage associated with the specified channel. See the MACROS manual page
for reading and writing this field. Casual users of channel access may
- wish to set this field to nill or 0.
+ wish to set this field to null or 0.
PRIORITYWhen ca_put_callback or ca_array_put_callback are invoked the user supplied
-asynchronous call back is called only after the initiated write operation, and
+asynchronous callback is called only after the initiated write operation, and
all actions resulting from the initiating write operation, complete.
-If unsuccessful the call back function is invoked indicating failure status.
+
If unsuccessful the callback function is invoked indicating failure status.
If the channel disconnects before a put callback request can be completed,
-then the client's call back function is called with failure status, but this
+then the client's callback function is called with failure status, but this
does not guarantee that the server did not receive and process the request
before the disconnect. If a connection is lost and then resumed outstanding ca
put requests are not automatically reissued following reconnect.
@@ -2954,7 +2954,7 @@ requests are not automatically reissued following reconnect.
from the channel and then the user's callback is invoked with a pointer to the
retrieved value. Note that ca_pend_io will not block for the delivery of values
requested by ca_get_callback. If the channel disconnects before a ca get
-callback request can be completed, then the clients call back function is
+callback request can be completed, then the clients callback function is
called with failure status.
All of these functions return ECA_DISCONN if the channel is currently
@@ -3006,7 +3006,7 @@ when a CA get request is initiated.
USERARG- Pointer sized variable retained and then passed back to user supplied
- call back function above.
+ callback function above.
Returns
@@ -3045,7 +3045,7 @@ int ca_create_subscription ( chtype TYPE, unsigned long COUNT,
Description
-Register a state change subscription and specify a call back function to be
+
Register a state change subscription and specify a callback function to be
invoked whenever the process variable undergoes significant state changes. A
significant change can be a change in the process variable's value, alarm
status, or alarm severity. In the process control function block database the
@@ -3073,7 +3073,7 @@ or ca_sg_pend are called. This allows several requests to be efficiently sent
over the network in one message.
If at any time after subscribing, read access to the specified process
-variable is lost, then the call back will be invoked immediately indicating
+variable is lost, then the callback will be invoked immediately indicating
that read access was lost via the status argument. When read access is restored
normal event processing will resume starting always with at least one update
indicating the current state of the channel.
@@ -3087,7 +3087,7 @@ indicating the current state of the channel.
Arguments
TYPE- The type of value presented to the call back funstion. Conversion will
+
- The type of value presented to the callback function. Conversion will
occur if it does not match native type. Specify one from the set of
DBR_XXXX in db_access.h
@@ -3118,7 +3118,7 @@ indicating the current state of the channel.
PEVID- This is a pointer to user supplied event id which is overwritten if
successful. This event id can later be used to clear a specific event.
- This option may be omitted by passing a nill pointer.
+ This option may be omitted by passing a null pointer.
MASKThis function flushes the send buffer and then blocks until outstanding ca_get requests complete, and until channels created
-specifying nill connection handler function pointers connect for the first
+specifying null connection handler function pointers connect for the first
time.
- If ECA_NORMAL is returned then it can be safely assumed that all
outstanding ca_get requests have completed
- successfully and channels created specifying nill connection handler
+ successfully and channels created specifying null connection handler
function pointers have connected for the first time.
- If ECA_TIMEOUT is returned then it must be assumed for all previous ca_get requests and properly qualified first time
@@ -3210,7 +3210,7 @@ time.
If ECA_TIMEOUT is returned then get requests may be reissued followed by a
subsequent call to ca_pend_io(). Specifically, the function will block only for
outstanding ca_get requests issued, and also any channels
-created specifying a nill connection handler function pointer, after the last
+created specifying a null connection handler function pointer, after the last
call to ca_pend_io() or ca client context creation whichever is later. Note
that ca_create_channel requests generally
should not be reissued for the same process variable unless
ECA_NORMAL - Normal successful completion
-ECA_TIMEOUT - Selected IO requests didnt complete before specified
+
ECA_TIMEOUT - Selected IO requests didn't complete before specified
timeout
ECA_EVDISALLOW - Function inappropriate for use within an event handler
@@ -3260,10 +3260,10 @@ int ca_test_io();
Description
This function tests to see if all ca_get requests are
-complete and channels created specifying a nill connection callback function
+complete and channels created specifying a null connection callback function
pointer are connected. It will report the status of outstanding ca_get requests issued, and channels created specifying a
-nill connection callback function pointer, after the last call to ca_pend_io()
+null connection callback function pointer, after the last call to ca_pend_io()
or CA context initialization whichever is later.
Returns
@@ -3313,7 +3313,7 @@ Code.
ECA_TIMEOUT - The operation timed out
-ECA_EVDISALLOW - Function inappropriate for use within a call back
+
ECA_EVDISALLOW - Function inappropriate for use within a callback
handler
@@ -3382,8 +3382,7 @@ int ca_add_exception_event ( pCallback USERFUNC, void *USERARG );
Description
-Replace the currently installed CA context global exception handler call
-back.
+Replace the currently installed CA context global exception handler callback.
When an error occurs in the server asynchronous to the clients thread then
information about this type of error is passed from the server to the client in
@@ -3402,14 +3401,14 @@ field should not be used.
USERFUNC- Address of user callback function to be executed when an exceptions
- occur. Passing a nill value causes the default exception handler to be
+ occur. Passing a null value causes the default exception handler to be
reinstalled. The following structure is passed by value to the user's
callback function. Currently, the
op field can be one of
CA_OP_GET, CA_OP_PUT, CA_OP_CREATE_CHANNEL, CA_OP_ADD_EVENT,
CA_OP_CLEAR_EVENT, or CA_OP_OTHER.
struct exception_handler_args {
void *usr; /* user argument supplied when installed */
- chanId chid; /* channel id (may be nill) */
+ chanId chid; /* channel id (may be null) */
long type; /* type requested */
long count; /* count requested */
void *addr; /* user's address to write results of CA_OP_GET */
@@ -3536,9 +3535,9 @@ default handler uses fprintf to send messages to 'stderr'.
Arguments
PFUNC- The address of a user supplied call back handler to be invoked when CA
- prints diagnostic messages. Installing a nill pointer will cause the
- default call back handler to be reinstalled.
+ - The address of a user supplied callback handler to be invoked when CA
+ prints diagnostic messages. Installing a null pointer will cause the
+ default callback handler to be reinstalled.
Examples
@@ -3570,7 +3569,7 @@ specified channel.
- whenever CA connects the channel immediately before the channel's
connection handler is called
- whenever CA disconnects the channel immediately after the channel's
- disconnect call back is called
+ disconnect callback is called
- once immediately after installation if the channel is connected.
- whenever the access rights state of a connected channel changes
@@ -3584,7 +3583,7 @@ specified channel.
PFUNC- Address of user supplied call back function. A nill pointer uninstalls
+
- Address of user supplied callback function. A null pointer uninstalls
the current handler. The following arguments are passed by value
to the supplied callback handler.
typedef struct ca_access_rights {
@@ -3922,7 +3921,7 @@ type.
Description
void ca_test_event ( struct event_handler_args );
-A built-in subscription update call back handler for debugging purposes that
+
A built-in subscription update callback handler for debugging purposes that
prints diagnostics to standard out.
Examples
@@ -4278,7 +4277,7 @@ ca_client_status() prints information about the calling threads CA context.
Description
-Returns a pointer to the current thread's CA context. If none then nill is
+
Returns a pointer to the current thread's CA context. If none then null is
returned.
See Also