HTTP Basic (the default)
◆ kC4AuthTypeClientCert #define kC4AuthTypeClientCert "Client Cert"TLS client cert.
◆ kC4AuthTypeFacebook #define kC4AuthTypeFacebook "Facebook"Facebook auth token.
◆ kC4AuthTypeOpenIDConnect #define kC4AuthTypeOpenIDConnect "OpenID Connect"OpenID Connect token.
◆ kC4AuthTypeSession #define kC4AuthTypeSession "Session"SG session cookie.
◆ kC4ProxyTypeHTTP #define kC4ProxyTypeHTTP "HTTP"HTTP proxy (using CONNECT method)
◆ kC4ProxyTypeHTTPS #define kC4ProxyTypeHTTPS "HTTPS"HTTPS proxy (using CONNECT method)
◆ kC4ProxyTypeNone #define kC4ProxyTypeNone "none"Use no proxy (overrides system setting)
◆ kC4ProxyTypeSOCKS #define kC4ProxyTypeSOCKS "SOCKS"SOCKS proxy.
◆ kC4Replicator2Scheme #define kC4Replicator2Scheme C4STR("ws") ◆ kC4Replicator2TLSScheme #define kC4Replicator2TLSScheme C4STR("wss") ◆ kC4ReplicatorAuthClientCert #define kC4ReplicatorAuthClientCert "clientCert"TLS client certificate (value platform-dependent)
◆ kC4ReplicatorAuthClientCertKey #define kC4ReplicatorAuthClientCertKey "clientCertKey"Client cert's private key (data)
◆ kC4ReplicatorAuthEnableChallengeAuth #define kC4ReplicatorAuthEnableChallengeAuth "challengeAuth"Use challenge auth instead of preemptive auth for basic auth, default is false (bool); \ Implemented by BuiltInWebSocket.
◆ kC4ReplicatorAuthPassword #define kC4ReplicatorAuthPassword "password"Password for basic auth (string)
◆ kC4ReplicatorAuthToken #define kC4ReplicatorAuthToken "token"Session cookie or auth token (string)
◆ kC4ReplicatorAuthType #define kC4ReplicatorAuthType "type"Auth type; see [2] (string)
◆ kC4ReplicatorAuthUserName #define kC4ReplicatorAuthUserName "username"User name for basic auth (string)
◆ kC4ReplicatorCheckpointInterval #define kC4ReplicatorCheckpointInterval "checkpointInterval"How often to checkpoint, in seconds (number)
◆ kC4ReplicatorCompressionLevel #define kC4ReplicatorCompressionLevel "BLIPCompressionLevel"Data compression level, 0..9.
◆ kC4ReplicatorHeartbeatInterval #define kC4ReplicatorHeartbeatInterval "heartbeat"Interval in secs to send a keepalive ping.
◆ kC4ReplicatorOptionAcceptParentDomainCookies #define kC4ReplicatorOptionAcceptParentDomainCookies "acceptParentDomainCookies" ◆ kC4ReplicatorOptionAuthentication #define kC4ReplicatorOptionAuthentication "auth"Auth settings (Dict); see [1].
◆ kC4ReplicatorOptionAutoPurge #define kC4ReplicatorOptionAutoPurge "autoPurge"Enables auto purge; default is true (bool)
◆ kC4ReplicatorOptionChannels #define kC4ReplicatorOptionChannels "channels"SG channel names (string[])
◆ kC4ReplicatorOptionCookies #define kC4ReplicatorOptionCookies "cookies"HTTP Cookie header value (string)
◆ kC4ReplicatorOptionDisableDeltas #define kC4ReplicatorOptionDisableDeltas "noDeltas"Disables delta sync (bool)
◆ kC4ReplicatorOptionDisablePropertyDecryption #define kC4ReplicatorOptionDisablePropertyDecryption "noDecryption"Disables property decryption (bool)
◆ kC4ReplicatorOptionDocIDs #define kC4ReplicatorOptionDocIDs "docIDs"Docs to replicate (string[])
◆ kC4ReplicatorOptionExtraHeaders #define kC4ReplicatorOptionExtraHeaders "headers"Extra HTTP headers (string[])
◆ kC4ReplicatorOptionFilter #define kC4ReplicatorOptionFilter "filter"Pull filter name (string)
◆ kC4ReplicatorOptionFilterParams #define kC4ReplicatorOptionFilterParams "filterParams"Pull filter params (Dict[string])
◆ kC4ReplicatorOptionMaxRetries #define kC4ReplicatorOptionMaxRetries "maxRetries"Max number of retry attempts (int)
◆ kC4ReplicatorOptionMaxRetryInterval #define kC4ReplicatorOptionMaxRetryInterval "maxRetryInterval"Max delay betw retries (secs)
◆ kC4ReplicatorOptionNoIncomingConflicts #define kC4ReplicatorOptionNoIncomingConflicts "noIncomingConflicts"Reject incoming conflicts (bool)
◆ kC4ReplicatorOptionOnlySelfSignedServerCert #define kC4ReplicatorOptionOnlySelfSignedServerCert "onlySelfSignedServer"Only accept self signed server certs (for P2P, bool)
◆ kC4ReplicatorOptionPinnedServerCert #define kC4ReplicatorOptionPinnedServerCert "pinnedCert"Cert or public key (data)
◆ kC4ReplicatorOptionProxyServer #define kC4ReplicatorOptionProxyServer "proxy"Proxy settings (Dict); see [3]].
◆ kC4ReplicatorOptionRemoteDBUniqueID #define kC4ReplicatorOptionRemoteDBUniqueID "remoteDBUniqueID"Stable ID for remote db with unstable URL (string)
◆ kC4ReplicatorOptionRootCerts #define kC4ReplicatorOptionRootCerts "rootCerts"Trusted root certs (data)
◆ kC4ReplicatorOptionSkipDeleted #define kC4ReplicatorOptionSkipDeleted "skipDeleted"Don't push/pull tombstones (bool)
◆ kC4ReplicatorProxyAuth #define kC4ReplicatorProxyAuth "auth"Proxy auth (Dict); see above.
◆ kC4ReplicatorProxyHost #define kC4ReplicatorProxyHost "host"Proxy hostname (string)
◆ kC4ReplicatorProxyPort #define kC4ReplicatorProxyPort "port"Proxy port number (integer)
◆ kC4ReplicatorProxyType #define kC4ReplicatorProxyType "type"Proxy type; see [4] (string)
◆ kC4SocketOptionNetworkInterface #define kC4SocketOptionNetworkInterface "networkInterface"Specific network interface (name or IP address) used for connecting to the remote server.
◆ kC4SocketOptionWSProtocols #define kC4SocketOptionWSProtocols "WS-Protocols"Sec-WebSocket-Protocol header value.
◆ C4ReplicatorBlobProgressCallbackCallback a client can register, to hear about the status of blobs.
◆ C4ReplicatorDocumentsEndedCallback typedef void(* C4ReplicatorDocumentsEndedCallback) (C4Replicator *, bool pushing, size_t numDocs, const C4DocumentEnded *docs[], void *context)Callback a client can register, to hear about the replication status of documents.
By default, only errors will be reported via this callback. To also receive callbacks for successfully completed documents, set the kC4ReplicatorOptionProgressLevel option to a value greater than zero.
◆ C4ReplicatorPropertyDecryptionCallback ◆ C4ReplicatorPropertyEncryptionCallback ◆ C4ReplicatorStatusChangedCallbackCallback a client can register, to get progress information.
This will be called on arbitrary background threads, and should not block.
◆ C4ReplicatorValidationFunctionCallback that can choose to reject an incoming pulled revision, or stop a local revision from being pushed, by returning false.
(Note: In the case of an incoming revision, no flags other than 'deletion' and 'hasAttachments' will be set.)
◆ C4ReplicatorActivityLevel Enumerator kC4StoppedFinished, or got a fatal error.
kC4OfflineConnection failed, but waiting to retry. */.
kC4ConnectingConnection is in progress.
kC4IdleContinuous replicator has caught up and is waiting for changes.
kC4BusyConnected and actively working.
kC4StoppingStopping or going offline.
◆ C4ReplicatorMode Enumerator kC4Disabled kC4Passive kC4OneShot kC4Continuous ◆ C4ReplicatorProgressLevel Enumerator kC4ReplProgressOverallCallback about completion and estimated total (C4ReplicatorStatusChangedCallback)
kC4ReplProgressPerDocumentCallback for every document replicated (C4ReplicatorDocumentsEndedCallback)
kC4ReplProgressPerAttachmentCallback for every document and attachment replicated (C4ReplicatorBlobProgressCallback)
◆ C4ReplicatorStatusFlags Enumerator kC4WillRetryIf true, will automatically reconnect when offline.
kC4HostReachableIf false, it's not possible to connect to the host.
kC4SuspendedIf true, will not connect until unsuspended.
◆ c4address_fromURL()A simple URL parser that populates a C4Address from a URL string.
The fields of the address will point inside the url string.
url
. dbName If non-NULL, then on success this slice will point to the last path component of url
; address->path
will not include this component.
Removes all cookies from the database's cookie store.
Locates any saved HTTP cookies relevant to the given request, and returns them as a string that can be used as the value of a "Cookie:" header.
Takes the value of a "Set-Cookie:" header, received from the given host, from an HTTP request with the given path, and saves the cookie into the database's cookie store.
(Persistent cookies are saved as metadata in the database file until they expire. Session cookies are kept in memory, until the last C4Database handle to the given database is closed.)
Gets the TLS certificate, if any, that was sent from the remote server (NOTE: Only functions when using BuiltInWebSocket)
Gets a fleece encoded list of IDs of documents who have revisions pending push.
This API is a snapshot and results may change between the time the call was made and the time the call returns.
Returns the HTTP response headers as a Fleece-encoded dictionary.
Returns the current state of a replicator.
Checks if the document with the given ID has revisions pending push.
This API is a snapshot and results may change between the time the call was made and the time the call returns.
Checks whether a database name is valid, for purposes of appearing in a replication URL.
◆ c4repl_isValidRemote()Checks whether the destination of a replication is valid.
(c4repl_new makes the same checks; this function is exposed so CBL can fail sooner.)
◆ c4repl_new()Creates a new networked replicator.
Creates a new replicator from an already-open C4Socket.
This is for use by listeners that accept incoming connections, wrap them by calling c4socket_fromNative()
, then start a passive replication to service them.
Tells a replicator that's in the offline state to reconnect immediately.
Informs the replicator whether it's considered possible to reach the remote host with the current network configuration.
The default value is true. This only affects the replicator's behavior while it's in the Offline state: Setting it to false will cancel any pending retry and prevent future automatic retries. Setting it back to true will initiate an immediate retry.
Sets the replicator's options dictionary.
The changes will take effect next time the replicator connects.
Sets the progress level of the replicator, indicating what information should be provided via callback.
Puts the replicator in or out of "suspended" state.
Setting suspended=true causes the replicator to disconnect and enter Offline state; it will not attempt to reconnect while it's suspended. Setting suspended=false causes the replicator to attempt to reconnect, if it was connected when suspended, and is still in Offline state.
Tells a replicator to start.
Ignored if it's not in the Stopped state.
repl
tries to acquire the database.
Tells a replicator to stop.
Ignored if in the Stopped state.
For convenience, an array of C strings naming the C4ReplicatorActivityLevel values.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4