#include <FlomHandle.hh>
This class provides C++ abstraction to C flom_handle_t type
Definition at line 78 of file FlomHandle.hh.
|
inline |
Definition at line 86 of file FlomHandle.hh.
References FLOM_RC_OK, and flom_strerror().
|
inline |
Definition at line 95 of file FlomHandle.hh.
References FLOM_RC_OK, and flom_strerror().
|
inline |
Get the maximum number of attempts that will be tryed during auto-discovery phase using UDP/IP multicast (see getMulticastAddress, getMulticastPort). The current value can be altered using method setDiscoveryAttempts
Definition at line 169 of file FlomHandle.hh.
|
inline |
Get the number of milliseconds between two consecutive attempts that will be tryed during auto-discovery phase using UDP/IP multicast (see getMulticastAddress, getMulticastPort). The current value can be altered using method setDiscoveryTimeout
Definition at line 193 of file FlomHandle.hh.
|
inline |
Get the UDP/IP multicast TTL parameter used during auto-discovery phase; for a definition of the parameter, see http://www.tldp.org/HOWTO/Multicast-HOWTO-2.html . The current value can be altered using method setDiscoveryTtl
Definition at line 216 of file FlomHandle.hh.
|
inline |
Get the name of the locked element if the resource is of type set.
Note 1: this method can be used only after lock and before unlock Note 2: this method can be used only when locking a resource of type "resource set"
Note 3: the return string must copied as soon as possible to a different place because it's a dynamic string removed by unlock
Definition at line 157 of file FlomHandle.hh.
|
inline |
Get the name of the locked element if the resource is of type set.
Note 1: this method can be used only after lock and before unlock Note 2: this method can be used only when locking a resource of type "resource set"
Note 3: the return string must copied as soon as possible to a different place because it's a dynamic string removed by unlock
Definition at line 142 of file FlomHandle.hh.
|
inline |
Get lock mode property: how a simple or hierarchical resource will be locked when method lock is called; FLoM supports the same lock mode semantic proposed by DLM, see http://en.wikipedia.org/wiki/Distributed_lock_manager#Lock_modes for a detailed explanation . The current value can be altered using method setLockMode
Definition at line 240 of file FlomHandle.hh.
|
inline |
Get the multicast address: the IP address (or a network name that the system can resolve) of the IP multicast group that must be contacted to reach FLoM daemon (server) using UDP/IP; see also getMulticastPort. The current value can be altered using method setMulticastAddress.
Definition at line 276 of file FlomHandle.hh.
|
inline |
Get the multicast address: the IP address (or a network name that the system can resolve) of the IP multicast group that must be contacted to reach FLoM daemon (server) using UDP/IP; see also getMulticastPort. The current value can be altered using method setMulticastAddress.
Definition at line 265 of file FlomHandle.hh.
|
inline |
Get the UDP/IP multicast port that must be used to contact the FLoM daemon (server) using UDP/IP; see also getMulticastAddress. The current value can be altered using method setMulticastPort.
Definition at line 311 of file FlomHandle.hh.
|
inline |
Get the network interface that must be used for IPv6 link local addresses The current value can be altered using method setNetworkInterface.
Definition at line 341 of file FlomHandle.hh.
|
inline |
Get the network interface that must be used for IPv6 link local addresses The current value can be altered using method setNetworkInterface.
Definition at line 332 of file FlomHandle.hh.
|
inline |
Get "resource create" boolean property: it specifies if method lock can create a new resource when the specified one is not defined; the default value is TRUE. The current value can be altered using method setResourceCreate.
Definition at line 374 of file FlomHandle.hh.
|
inline |
Get "resource idle lifespan" property: it specifies how many milliseconds a resource will be kept after the last locker released it; the expiration is necessary to avoid useless resource allocation. The current value can be altered using method setResourceIdleLifespan.
Definition at line 398 of file FlomHandle.hh.
|
inline |
Get the resource name: the name of the resource that can be locked and unlocked using lock and unlock methods. The current value can be altered using method setResourceName.
Definition at line 428 of file FlomHandle.hh.
|
inline |
Get the resource name: the name of the resource that can be locked and unlocked using lock and unlock methods. The current value can be altered using method setResourceName.
Definition at line 420 of file FlomHandle.hh.
|
inline |
Get "resource quantity" property: the number of units that will be locked and unlocked using lock and unlock methods. The current value can be altered using method setResourceQuantity. NOTE: this property applies to "numeric resources" only.
Definition at line 468 of file FlomHandle.hh.
|
inline |
Get "resource timeout" property: how long a lock operation (see lock) will wait if the resource is locked by another requester. The current value can be altered using method setResourceTimeout.
Definition at line 494 of file FlomHandle.hh.
|
inline |
Get the socket name: the AF_LOCAL/AF_UNIX socket name that must be used to contact a local FLoM daemon (server). The current value can be altered using method setSocketName.
Definition at line 526 of file FlomHandle.hh.
|
inline |
Get the socket name: the AF_LOCAL/AF_UNIX socket name that must be used to contact a local FLoM daemon (server). The current value can be altered using method setSocketName.
Definition at line 518 of file FlomHandle.hh.
|
inline |
Get the TLS CA certificate file name. The current value can be altered using method setTlsCaCertificate.
Definition at line 744 of file FlomHandle.hh.
|
inline |
Get the TLS CA certificate file name. The current value can be altered using method setTlsCaCertificate.
Definition at line 736 of file FlomHandle.hh.
|
inline |
Get the TLS certificate file name. The current value can be altered using method setTlsCertificate.
Definition at line 670 of file FlomHandle.hh.
|
inline |
Get the TLS certificate file name. The current value can be altered using method setTlsCertificate.
Definition at line 662 of file FlomHandle.hh.
|
inline |
Get "TLS check peer ID" boolean property The current value can be altered using method setTlsCheckPeerId.
Definition at line 774 of file FlomHandle.hh.
|
inline |
Get the TLS private key file name. The current value can be altered using method setTlsPrivateKey.
Definition at line 707 of file FlomHandle.hh.
|
inline |
Get the TLS private key file name. The current value can be altered using method setTlsPrivateKey.
Definition at line 699 of file FlomHandle.hh.
|
inline |
Get the trace filename: the name (absolute or relative path) used by libflom (FLoM client library) to record trace messages. The current value can be altered using method setTraceFilename.
Definition at line 563 of file FlomHandle.hh.
|
inline |
Get the trace filename: the name (absolute or relative path) used by libflom (FLoM client library) to record trace messages. The current value can be altered using method setTraceFilename.
Definition at line 555 of file FlomHandle.hh.
|
inline |
Get the unicast address: the IP address (or a network name that the system can resolve) of the host that must be contacted to reach FLoM daemon (server) using TCP/IP; see also getUnicastPort. The current value can be altered using method setUnicastAddress.
Definition at line 608 of file FlomHandle.hh.
|
inline |
Get the unicast address: the IP address (or a network name that the system can resolve) of the host that must be contacted to reach FLoM daemon (server) using TCP/IP; see also getUnicastPort. The current value can be altered using method setUnicastAddress.
Definition at line 597 of file FlomHandle.hh.
|
inline |
Get the TCP/IP unicast port that must be used to contact the FLoM daemon (server) using TCP/IP; see also getUnicastAddress. The current value can be altered using method setUnicastPort.
Definition at line 643 of file FlomHandle.hh.
|
inline |
Locks the (logical) resource linked to this handle; the resource MUST be unlocked using method unlock when the lock condition is no more necessary.
Definition at line 111 of file FlomHandle.hh.
|
inline |
Set the maximum number of attempts that will be tryed during auto-discovery phase using UDP/IP multicast (see setMulticastAddress, setMulticastPort). The current value can be inspected using method getDiscoveryAttempts
value | (Input): the new value |
Definition at line 181 of file FlomHandle.hh.
|
inline |
Set the number of milliseconds between two consecutive attempts that will be tryed during auto-discovery phase using UDP/IP multicast (see setMulticastAddress, setMulticastPort). The current value can be inspected using method getDiscoveryTimeout.
value | (Input): the new value |
Definition at line 206 of file FlomHandle.hh.
|
inline |
Set the UDP/IP multicast TTL parameter used during auto-discovery phase; for a definition of the parameter, see http://www.tldp.org/HOWTO/Multicast-HOWTO-2.html . The current value can be inspected using method getDiscoveryTtl.
value | (Input): the new value |
Definition at line 228 of file FlomHandle.hh.
|
inline |
Set lock mode property: how a simple or hierarchical resource will be locked when method lock is called; FLoM supports the same lock mode semantic proposed by DLM, see http://en.wikipedia.org/wiki/Distributed_lock_manager#Lock_modes for a detailed explanation . The current value can be inspected using method getLockMode
value | (Input): the new value |
Definition at line 253 of file FlomHandle.hh.
|
inline |
Set the multicast address: the IP address (or a network name that the system can resolve) of the IP multicast group that must be contacted to reach FLoM daemon (server) using UDP/IP; see also setMulticastPort. The current value can be inspected using method getMulticastAddress.
value | (Input): the new value (C null terminated string) |
Definition at line 290 of file FlomHandle.hh.
|
inline |
Set the multicast address: the IP address (or a network name that the system can resolve) of the IP multicast group that must be contacted to reach FLoM daemon (server) using UDP/IP; see also setMulticastPort. The current value can be inspected using method getMulticastAddress.
value | (Input): the new value (C++ standard string) |
Definition at line 302 of file FlomHandle.hh.
|
inline |
Set the UDP/IP multicast port that must be used to contact the FLoM daemon (server) using UDP/IP; see also setMulticastAddress. The current value can be inspected using method getMulticastPort.
value | (Input): the new value |
Definition at line 322 of file FlomHandle.hh.
|
inline |
Set the network interface that must be used for IPv6 link local addresses The current value can be inspected using method getNetworkInterface.
value | (Input): the new value (C null terminted string) |
Definition at line 353 of file FlomHandle.hh.
|
inline |
Set the network interface that must be used for IPv6 link local addresses The current value can be inspected using method getNetworkInterface.
value | (Input): the new value (C++ standard string) |
Definition at line 363 of file FlomHandle.hh.
|
inline |
Set "resource create" boolean property: it specifies if method lock can create a new resource when the specified one is not defined. The current value can be inspected using method getResourceCreate.
value | (Input): the new value |
Definition at line 386 of file FlomHandle.hh.
|
inline |
Set "resource idle lifespan" property: it specifies how many milliseconds a resource will be kept after the last locker released it; the expiration is necessary to avoid useless resource allocation. The current value can be inspected using method getResourceIdleLifespan.
value | (Input): the new value |
Definition at line 411 of file FlomHandle.hh.
|
inline |
Set the resource name: the name of the resource that can be locked and unlocked using lock and unlock methods. The current value can be inspected using method getResourceName. NOTE: the resource type is determined by its name; take a look to flom command man page (-r, –resource-name option) for an explanation of the resource name grammar.
value | (Input): the new value (C null terminated string) |
Definition at line 443 of file FlomHandle.hh.
|
inline |
Set the resource name: the name of the resource that can be locked and unlocked using lock and unlock methods. The current value can be inspected using method getResourceName. NOTE: the resource type is determined by its name; take a look to flom command man page (-r, –resource-name option) for an explanation of the resource name grammar.
value | (Input): the new value (C++ standard string) |
Definition at line 457 of file FlomHandle.hh.
|
inline |
Set "resource quantity" property: the number of units that will be locked and unlocked using lock and unlock methods. The current value can be inspected using method getResourceQuantity. NOTE: this property applies to "numeric resources" only.
value | (Input): the new value |
Definition at line 480 of file FlomHandle.hh.
|
inline |
Set "resource timeout" property: how long a lock operation (see lock) will wait if the resource is locked by another requester. The current value can be inspected using method getResourceTimeout.
value | (Input): the new value: 0: no wait >0: maximum number of milliseconds to wait <0: unlimited wait |
Definition at line 509 of file FlomHandle.hh.
|
inline |
Set the socket name: the AF_LOCAL/AF_UNIX socket name that must be used to contact a local FLoM daemon (server). The current value can be inspected using method getSocketName.
value | (Input): the new value (C null terminated string) |
Definition at line 537 of file FlomHandle.hh.
|
inline |
Set the socket name: the AF_LOCAL/AF_UNIX socket name that must be used to contact a local FLoM daemon (server). The current value can be inspected using method getSocketName.
value | (Input): the new value (C++ standard string) |
Definition at line 546 of file FlomHandle.hh.
|
inline |
Set the TLS CA certificate name. The current value can be inspected using method getTlsCaCertificate.
value | (Input): the new value (C null terminted string) |
Definition at line 755 of file FlomHandle.hh.
|
inline |
Set the TLS CA certificate name. The current value can be inspected using method getTlsCaCertificate.
value | (Input): the new value (C++ standard string) |
Definition at line 764 of file FlomHandle.hh.
|
inline |
Set the TLS certificate name. The current value can be inspected using method getTlsCertificate.
value | (Input): the new value (C null terminted string) |
Definition at line 681 of file FlomHandle.hh.
|
inline |
Set the TLS certificate name. The current value can be inspected using method getTlsCertificate.
value | (Input): the new value (C++ standard string) |
Definition at line 690 of file FlomHandle.hh.
|
inline |
Set "TLS check peer ID" boolean property The current value can be inspected using method getTlsCheckPeerId.
value | (Input): the new value |
Definition at line 784 of file FlomHandle.hh.
|
inline |
Set the TLS private key name. The current value can be inspected using method getTlsPrivateKey.
value | (Input): the new value (C null terminted string) |
Definition at line 718 of file FlomHandle.hh.
|
inline |
Set the TLS private key name. The current value can be inspected using method getTlsPrivateKey.
value | (Input): the new value (C++ standard string) |
Definition at line 727 of file FlomHandle.hh.
|
inline |
Set the trace filename: the name (absolute or relative path) used by libflom (FLoM client library) to record trace messages. The current value can be inspected using method getTraceFilename.
value | (Input): the new value (C null terminated string) |
Definition at line 575 of file FlomHandle.hh.
|
inline |
Set the trace filename: the name (absolute or relative path) used by libflom (FLoM client library) to record trace messages. The current value can be inspected using method getTraceFilename.
value | (Input): the new value (C++ standard string) |
Definition at line 585 of file FlomHandle.hh.
|
inline |
Set the unicast address: the IP address (or a network name that the system can resolve) of the host that must be contacted to reach FLoM daemon (server) using TCP/IP; see also setUnicastPort. The current value can be inspected using method getUnicastAddress.
value | (Input): the new value (C null terminted string) |
Definition at line 622 of file FlomHandle.hh.
|
inline |
Set the unicast address: the IP address (or a network name that the system can resolve) of the host that must be contacted to reach FLoM daemon (server) using TCP/IP; see also setUnicastPort. The current value can be inspected using method getUnicastAddress.
value | (Input): the new value (C++ standard string) |
Definition at line 634 of file FlomHandle.hh.
|
inline |
Set the TCP/IP unicast port that must be used to contact the FLoM daemon (server) using TCP/IP; see also setUnicastAddress. The current value can be inspected using method getUnicastPort.
value | (Input): the new value |
Definition at line 653 of file FlomHandle.hh.
|
inline |
Unlocks the (logical) resource linked to this handle; the resource MUST be previously locked using method lock
Definition at line 118 of file FlomHandle.hh.
|
inline |
Unlocks the (logical) resource linked to this handle and rollback the transactional resource state; the resource MUST be previously locked using method lock . This method should be used only with transactional resources, for example: transactional unique sequences
Definition at line 128 of file FlomHandle.hh.