diff --git a/src/ca/CAref.html b/src/ca/CAref.html index 4432eaaca..1857ea734 100644 --- a/src/ca/CAref.html +++ b/src/ca/CAref.html @@ -209,6 +209,7 @@ $Date$

  • ca_poll
  • ca_puser
  • ca_put
  • +
  • ca_put_callback
  • ca_set_puser
  • ca_signal
  • ca_sg_block
  • @@ -223,7 +224,7 @@ $Date$

  • ca_test_io
  • ca_write_access
  • channel_state
  • -
  • dbr_size[]
  • +
  • dbr_size[]
  • dbr_size_n
  • dbr_value_size[]
  • dbr_type_to_text
  • @@ -3824,7 +3825,7 @@ specified channel and boolean false otherwise.

    channel and boolean false otherwise -

    dbr_size[]

    +

    dbr_size[]

    #include <db_access.h>
     extern unsigned dbr_size[/* TYPE */];
    @@ -3946,11 +3947,12 @@ int ca_sg_create ( CA_SYNC_GID *PGID );

    A synchronous group can be used to guarantee that a set of channel access requests have completed. Once a synchronous group has been created then channel -access get and put requests may be issued within it using ca_sg_get() and -ca_sg_put() respectively. The routines ca_sg_block() and ca_sg_test() can be +access get and put requests may be issued within it using +ca_sg_array_get() and ca_sg_array_put() respectively. +The routines ca_sg_block() and ca_sg_test() can be used to block for and test for completion respectively. The routine -ca_sg_reset() is used to discard knowledge of old requests which have timed out -and in all likelihood will never be satisfied.

    +ca_sg_reset() is used to discard knowledge of old requests which +have timed out and in all likelihood will never be satisfied.

    Any number of asynchronous groups can have application requested operations outstanding within them at any given time.

    @@ -4124,16 +4126,20 @@ status = ca_sg_reset(gid);

    ca_sg_array_put()

    #include <cadef.h>
    +int ca_sg_put ( CA_SYNC_GID GID, chtype TYPE,
    +        chid CHID, void *PVALUE );
     int ca_sg_array_put ( CA_SYNC_GID GID, chtype TYPE, 
             unsigned long COUNT, chid CHID, void *PVALUE );
    -

    Write a value, or array of values, to a channel and increment the -outstanding request count of a synchronous group. The ca_sg_array_put() -functionality is implemented using ca_array_put_callback().

    +

    Write a value, or array of values, to a channel and increment the outstanding +request count of a synchronous group. The ca_sg_put() and +ca_sg_array_put() functionality is implemented using +ca_array_put_callback().

    All remote operation requests such as the above are accumulated (buffered) -and not forwarded to the server until one of ca_flush_io(), ca_pend_io(), -ca_pend_event(), or ca_sg_block() are called. This allows several requests to be +and not forwarded to the server until one of ca_flush_io(), +ca_pend_io(), ca_pend_event(), or +ca_sg_block() are called. This allows several requests to be efficiently sent in one message.

    If a connection is lost and then resumed outstanding puts are not @@ -4186,6 +4192,8 @@ reissued.

    ca_sg_array_get()

    #include <cadef.h>
    +int ca_sg_get ( CA_SYNC_GID GID, chtype TYPE,
    +        chid CHID, void *PVALUE );
     int ca_sg_array_get ( CA_SYNC_GID GID,
             chtype TYPE, unsigned long COUNT,
             chid CHID, void *PVALUE );
    @@ -4193,16 +4201,19 @@ int ca_sg_array_get ( CA_SYNC_GID GID,

    Description

    Read a value from a channel and increment the outstanding request count of a -synchronous group. The ca_sg_array_get() functionality is implemented using +synchronous group. The ca_sg_get() and +ca_sg_array_get() functionality is implemented using ca_array_get_callback().

    -

    The values written into your program's variables by ca_sg_get() should not be -referenced by your program until ECA_NORMAL has been received from ca_sg_block(), -or until ca_sg_test() returns ECA_IODONE.

    +

    The values written into your program's variables by ca_sg_get() +or ca_sg_array_get() should not be referenced by your program until +ECA_NORMAL has been received from ca_sg_block(), or until +ca_sg_test() returns ECA_IODONE.

    All remote operation requests such as the above are accumulated (buffered) -and not forwarded to the server until one of ca_flush_io(), ca_pend_io(), -ca_pend_event(), or ca_sg_block() are called. This allows several requests to be +and not forwarded to the server until one of ca_flush_io(), +ca_pend_io(), ca_pend_event(), or +ca_sg_block() are called. This allows several requests to be efficiently sent in one message.

    If a connection is lost and then resumed outstanding gets are not