mt-libcouchbase 1.4.0

data/ext/libcouchbase/example/fts/build-queries.rb

@@ -0,0 +1,33 @@
+#!/usr/bin/ruby
+
+#    Copyright 2018 Couchbase, Inc.
+#
+#  Licensed under the Apache License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+require 'json'
+
+paths = Dir[File.join(__dir__, 'queries', '*.json')].sort
+File.open(File.join(__dir__, 'queries.h'), 'w+') do |out|
+  out.puts("// This file was generated by queries.rb")
+  out.puts("typedef struct fts_query_str { const char *comment; size_t query_len; const char *query; } fts_query_str;")
+  out.puts("size_t num_queries = #{paths.size};")
+  out.puts("fts_query_str queries[#{paths.size + 1}] = {")
+  paths.each do |path|
+    lines = File.readlines(path)
+    comment = lines[1].gsub(%r{^//\s*}, '').strip
+    query = lines.reject { |line| line.start_with?('//') }.join
+    query_str = JSON.generate(JSON.parse(query))
+    out.puts("{#{comment.inspect},\n #{query_str.size},\n #{query_str.inspect}},\n\n")
+  end
+  out.puts("{NULL, 0, NULL}};")
+end

data/ext/libcouchbase/example/fts/fts.c

@@ -0,0 +1,142 @@
+/* -*- Mode: C; tab-width: 4; c-basic-offset: 4; indent-tabs-mode: nil -*- */
+/*
+ *     Copyright 2018 Couchbase, Inc.
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+
+/**
+
+   CFLAGS="-I$(realpath ../../include) -I$(realpath ../../build/generated)"
+   LDFLAGS="-L$(realpath ../../build/lib) -lcouchbase -Wl,-rpath=$(realpath ../../build/lib)"
+   make fts
+
+   The example assumes the existence of "travel-sample" bucket and three
+   specific Full Text Indexes, defined for it. These are:
+
+   - "travel-sample-index-unstored": Uses only the default settings.
+
+   - "travel-sample-index-stored": Uses default settings, with one exception:
+     dynamic fields are stored, for the whole index.
+
+   - "travel-sample-index-hotel-description": Indexes only the description
+     fields of hotel documents, and disables the default type mapping. The index
+     has a custom analyzer named myUnicodeAnalyzer defined on it: the analyzer's
+     main characteristic is that it uses the unicode tokenizer.
+ */
+
+#include <unistd.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+
+#include <libcouchbase/couchbase.h>
+#include <libcouchbase/cbft.h>
+
+#include "queries.h"
+
+static void fail(const char *msg)
+{
+    printf("[\x1b[31mERROR\x1b[0m] %s\n", msg);
+    exit(EXIT_FAILURE);
+}
+
+static void check(lcb_error_t err, const char *msg)
+{
+    if (err != LCB_SUCCESS) {
+        char buf[1024] = {0};
+        snprintf(buf, sizeof(buf), "%s: %s\n", msg, lcb_strerror_short(err));
+        fail(buf);
+    }
+}
+
+static int err2color(lcb_error_t err)
+{
+    switch (err) {
+        case LCB_SUCCESS:
+            return 49;
+        default:
+            return 31;
+    }
+}
+
+static void ln2space(const void *buf, size_t nbuf)
+{
+    size_t ii;
+    char *str = (char *)buf;
+    for (ii = 0; ii < nbuf; ii++) {
+        if (str[ii] == '\n') {
+            str[ii] = ' ';
+        }
+    }
+}
+
+static void row_callback(lcb_t instance, int type, const lcb_RESPFTS *resp)
+{
+    ln2space(resp->row, resp->nrow);
+    if (resp->rc != LCB_SUCCESS) {
+        printf("\x1b[31m%s\x1b[0m: ", lcb_strerror_short(resp->rc));
+    }
+    printf("%.*s\n", (int)resp->nrow, (char *)resp->row);
+    if (resp->rflags & LCB_RESP_F_FINAL) {
+        printf("\n");
+    }
+}
+
+int main(int argc, char *argv[])
+{
+    lcb_error_t err;
+    lcb_t instance;
+    char *bucket = NULL;
+    size_t ii;
+
+    if (argc < 2) {
+        printf("Usage: %s couchbase://host/bucket [ password [ username ] ]\n", argv[0]);
+        exit(EXIT_FAILURE);
+    }
+
+    {
+        struct lcb_create_st create_options = {0};
+        create_options.version = 3;
+        create_options.v.v3.connstr = argv[1];
+        if (argc > 2) {
+            create_options.v.v3.passwd = argv[2];
+        }
+        if (argc > 3) {
+            create_options.v.v3.username = argv[3];
+        }
+        check(lcb_create(&instance, &create_options), "create couchbase handle");
+        check(lcb_connect(instance), "schedule connection");
+        lcb_wait(instance);
+        check(lcb_get_bootstrap_status(instance), "bootstrap from cluster");
+        check(lcb_cntl(instance, LCB_CNTL_GET, LCB_CNTL_BUCKETNAME, &bucket), "get bucket name");
+        if (strcmp(bucket, "travel-sample") != 0) {
+            fail("expected bucket to be \"travel-sample\"");
+        }
+    }
+
+    for (ii = 0; ii < num_queries; ii++) {
+        lcb_CMDFTS cmd = {0};
+        cmd.callback = row_callback;
+        cmd.query = queries[ii].query;
+        cmd.nquery = queries[ii].query_len;
+        check(lcb_fts_query(instance, NULL, &cmd), "schedule FTS index creation operation");
+        printf("----> \x1b[1m%s\x1b[0m\n", queries[ii].comment);
+        printf("----> \x1b[32m%.*s\x1b[0m\n", (int)queries[ii].query_len, queries[ii].query);
+        lcb_wait(instance);
+    }
+
+    /* Now that we're all done, close down the connection handle */
+    lcb_destroy(instance);
+    return 0;
+}

data/ext/libcouchbase/example/fts/queries/00-simple-text-query.json

@@ -0,0 +1,12 @@
+// -*- mode: js; -*-
+// Simple Text Query on a single word, targeting an index with dynamic fields not stored.
+{
+    "indexName": "travel-sample-index-unstored",
+    "size": 10,
+    "highlight": {
+        "style": "html"
+    },
+    "query": {
+        "match": "swanky"
+    }
+}

data/ext/libcouchbase/example/fts/queries/01-simple-text-query-on-non-default-index.json

@@ -0,0 +1,9 @@
+// -*- mode: js; -*-
+// Simple Text Query on Non-Default Index, specifying an index that consists only of content derived from a specific field from a specific document-type.
+{
+    "indexName": "travel-sample-index-hotel-description",
+    "size": 10,
+    "query": {
+        "match": "swanky"
+    }
+}

data/ext/libcouchbase/example/fts/queries/02-simple-text-query-on-stored-field.json

@@ -0,0 +1,13 @@
+// -*- mode: js; -*-
+// Simple Text Query on Stored Field, specifying the field to be searched; targeting an index with dynamic fields stored, to ensure that field-content is included in the return object.
+{
+    "indexName": "travel-sample-index-stored",
+    "size": 10,
+    "highlight": {
+        "style": "html"
+    },
+    "query": {
+        "field": "destinationairport",
+        "match": "MDG"
+    }
+}

data/ext/libcouchbase/example/fts/queries/03-match-query-with-facet.json

@@ -0,0 +1,19 @@
+// -*- mode: js; -*-
+// Match Query with Facet, showing how query-results can be displayed either by row or by hits; and demonstrating use of a facet, which provides aggregation-data.
+{
+    "indexName": "travel-sample-index-stored",
+    "highlight": {
+        "style": "html"
+    },
+    "size": 10,
+    "query": {
+        "field": "reviews.content",
+        "match": "La Rue Saint Denis!!"
+    },
+    "facets": {
+        "Countries Referenced": {
+            "size": 5,
+            "field": "country"
+        }
+    }
+}

data/ext/libcouchbase/example/fts/queries/04-docid-query.json

@@ -0,0 +1,11 @@
+// -*- mode: js; -*-
+// DocId Query, showing results of a query on two document IDs.
+{
+    "indexName": "travel-sample-index-unstored",
+    "query": {
+        "ids": [
+            "hotel_26223",
+            "hotel_28960"
+        ]
+    }
+}

data/ext/libcouchbase/example/fts/queries/05-unanalyzed-term-query-with-fuzziness-level-of-0.json

@@ -0,0 +1,13 @@
+// -*- mode: js; -*-
+// Unanalyzed Term Query with Fuzziness Level of 0, demonstrating how to query on a term with no analysis. Zero fuzziness is specified, to ensure that matches are exact.
+{
+    "indexName": "travel-sample-index-stored",
+    "size": 50,
+    "highlight": {
+        "style": "html"
+    },
+    "query": {
+        "field": "reviews.content",
+        "term": "sushi"
+    }
+}

data/ext/libcouchbase/example/fts/queries/06-unanalyzed-term-query-with-fuzziness-level-of-2.json

@@ -0,0 +1,14 @@
+// -*- mode: js; -*-
+// Unanalyzed Term Query with Fuzziness Level of 2, which is almost identical to the immediately preceding query; but which this time specifies a fuzziness factor of 2, allowing partial matches to be made. The output from this query can be compared to that of the one immediately preceding.
+{
+    "indexName": "travel-sample-index-stored",
+    "size": 50,
+    "highlight": {
+        "style": "html"
+    },
+    "query": {
+        "field": "reviews.content",
+        "fuzziness": 2,
+        "term": "sushi"
+    }
+}

data/ext/libcouchbase/example/fts/queries/07-match-phrase-query.json

@@ -0,0 +1,13 @@
+// -*- mode: js; -*-
+// Match Phrase Query, using Analysis, for searching on a phrase.
+{
+    "indexName": "travel-sample-index-stored",
+    "size": 10,
+    "highlight": {
+        "style": "html"
+    },
+    "query": {
+        "field": "description",
+        "match_phrase": "Eiffel Tower"
+    }
+}

data/ext/libcouchbase/example/fts/queries/08-phrase-query.json

@@ -0,0 +1,16 @@
+// -*- mode: js; -*-
+// Phrase Query, without Analysis, for searching on a phrase without analysis supported.
+{
+    "indexName": "travel-sample-index-stored",
+    "size": 10,
+    "highlight": {
+        "style": "html"
+    },
+    "query": {
+        "field": "description",
+        "terms": [
+            "dorm",
+            "rooms"
+        ]
+    }
+}

data/ext/libcouchbase/example/fts/queries/09-query-string-query.json

@@ -0,0 +1,9 @@
+// -*- mode: js; -*-
+// Query String Query, showing how a query string is specified as search-input.
+{
+    "indexName": "travel-sample-index-unstored",
+    "size": 10,
+    "query": {
+        "query": "description: Imperial"
+    }
+}

data/ext/libcouchbase/example/fts/queries/10-conjunction-query.json

@@ -0,0 +1,21 @@
+// -*- mode: js; -*-
+// Conjunction Query, whereby two separate queries are defined and then run as part of the search, with only the matches returned by both included in the result-object.
+{
+    "indexName": "travel-sample-index-stored",
+    "size": 10,
+    "highlight": {
+        "style": "html"
+    },
+    "query": {
+        "conjuncts": [
+            {
+                "field": "reviews.content",
+                "match": "La Rue Saint Denis!!"
+            },
+            {
+                "field": "description",
+                "match": "boutique"
+            }
+        ]
+    }
+}

data/ext/libcouchbase/example/fts/queries/11-wild-card-query.json

@@ -0,0 +1,13 @@
+// -*- mode: js; -*-
+// Wild Card Query, whereby a wildcard is used in the string submitted for the search.
+{
+    "indexName": "travel-sample-index-stored",
+    "size": 10,
+    "highlight": {
+        "style": "html"
+    },
+    "query": {
+        "field": "description",
+        "wildcard": "bouti*ue"
+    }
+}

data/ext/libcouchbase/example/fts/queries/12-numeric-range-query.json

@@ -0,0 +1,11 @@
+// -*- mode: js; -*-
+// Numeric Range Query, whereby minimum and maximum numbers are specified, and matches within the range returned.
+{
+    "indexName": "travel-sample-index-unstored",
+    "size": 10,
+    "query": {
+        "field": "id",
+        "max": 10200.0,
+        "min": 10100.0
+    }
+}

data/ext/libcouchbase/example/fts/queries/13-regexp-query.json

@@ -0,0 +1,13 @@
+// -*- mode: js; -*-
+// Regexp Query, whereby a regular expression is submitted, to generate the conditions for successful matches.
+{
+    "indexName": "travel-sample-index-stored",
+    "size": 10,
+    "highlight": {
+        "style": "html"
+    },
+    "query": {
+        "field": "description",
+        "regexp": "[a-z]"
+    }
+}

data/ext/libcouchbase/example/fts/queries.h

@@ -0,0 +1,61 @@
+// This file was generated by queries.rb
+typedef struct fts_query_str { const char *comment; size_t query_len; const char *query; } fts_query_str;
+size_t num_queries = 14;
+fts_query_str queries[15] = {
+{"Simple Text Query on a single word, targeting an index with dynamic fields not stored.",
+ 110,
+ "{\"indexName\":\"travel-sample-index-unstored\",\"size\":10,\"highlight\":{\"style\":\"html\"},\"query\":{\"match\":\"swanky\"}}"},
+
+{"Simple Text Query on Non-Default Index, specifying an index that consists only of content derived from a specific field from a specific document-type.",
+ 90,
+ "{\"indexName\":\"travel-sample-index-hotel-description\",\"size\":10,\"query\":{\"match\":\"swanky\"}}"},
+
+{"Simple Text Query on Stored Field, specifying the field to be searched; targeting an index with dynamic fields stored, to ensure that field-content is included in the return object.",
+ 134,
+ "{\"indexName\":\"travel-sample-index-stored\",\"size\":10,\"highlight\":{\"style\":\"html\"},\"query\":{\"field\":\"destinationairport\",\"match\":\"MDG\"}}"},
+
+{"Match Query with Facet, showing how query-results can be displayed either by row or by hits; and demonstrating use of a facet, which provides aggregation-data.",
+ 211,
+ "{\"indexName\":\"travel-sample-index-stored\",\"highlight\":{\"style\":\"html\"},\"size\":10,\"query\":{\"field\":\"reviews.content\",\"match\":\"La Rue Saint Denis!!\"},\"facets\":{\"Countries Referenced\":{\"size\":5,\"field\":\"country\"}}}"},
+
+{"DocId Query, showing results of a query on two document IDs.",
+ 90,
+ "{\"indexName\":\"travel-sample-index-unstored\",\"query\":{\"ids\":[\"hotel_26223\",\"hotel_28960\"]}}"},
+
+{"Unanalyzed Term Query with Fuzziness Level of 0, demonstrating how to query on a term with no analysis. Zero fuzziness is specified, to ensure that matches are exact.",
+ 132,
+ "{\"indexName\":\"travel-sample-index-stored\",\"size\":50,\"highlight\":{\"style\":\"html\"},\"query\":{\"field\":\"reviews.content\",\"term\":\"sushi\"}}"},
+
+{"Unanalyzed Term Query with Fuzziness Level of 2, which is almost identical to the immediately preceding query; but which this time specifies a fuzziness factor of 2, allowing partial matches to be made. The output from this query can be compared to that of the one immediately preceding.",
+ 146,
+ "{\"indexName\":\"travel-sample-index-stored\",\"size\":50,\"highlight\":{\"style\":\"html\"},\"query\":{\"field\":\"reviews.content\",\"fuzziness\":2,\"term\":\"sushi\"}}"},
+
+{"Match Phrase Query, using Analysis, for searching on a phrase.",
+ 143,
+ "{\"indexName\":\"travel-sample-index-stored\",\"size\":10,\"highlight\":{\"style\":\"html\"},\"query\":{\"field\":\"description\",\"match_phrase\":\"Eiffel Tower\"}}"},
+
+{"Phrase Query, without Analysis, for searching on a phrase without analysis supported.",
+ 138,
+ "{\"indexName\":\"travel-sample-index-stored\",\"size\":10,\"highlight\":{\"style\":\"html\"},\"query\":{\"field\":\"description\",\"terms\":[\"dorm\",\"rooms\"]}}"},
+
+{"Query String Query, showing how a query string is specified as search-input.",
+ 96,
+ "{\"indexName\":\"travel-sample-index-unstored\",\"size\":10,\"query\":{\"query\":\"description: Imperial\"}}"},
+
+{"Conjunction Query, whereby two separate queries are defined and then run as part of the search, with only the matches returned by both included in the result-object.",
+ 207,
+ "{\"indexName\":\"travel-sample-index-stored\",\"size\":10,\"highlight\":{\"style\":\"html\"},\"query\":{\"conjuncts\":[{\"field\":\"reviews.content\",\"match\":\"La Rue Saint Denis!!\"},{\"field\":\"description\",\"match\":\"boutique\"}]}}"},
+
+{"Wild Card Query, whereby a wildcard is used in the string submitted for the search.",
+ 135,
+ "{\"indexName\":\"travel-sample-index-stored\",\"size\":10,\"highlight\":{\"style\":\"html\"},\"query\":{\"field\":\"description\",\"wildcard\":\"bouti*ue\"}}"},
+
+{"Numeric Range Query, whereby minimum and maximum numbers are specified, and matches within the range returned.",
+ 105,
+ "{\"indexName\":\"travel-sample-index-unstored\",\"size\":10,\"query\":{\"field\":\"id\",\"max\":10200.0,\"min\":10100.0}}"},
+
+{"Regexp Query, whereby a regular expression is submitted, to generate the conditions for successful matches.",
+ 130,
+ "{\"indexName\":\"travel-sample-index-stored\",\"size\":10,\"highlight\":{\"style\":\"html\"},\"query\":{\"field\":\"description\",\"regexp\":\"[a-z]\"}}"},
+
+{NULL, 0, NULL}};

data/ext/libcouchbase/example/instancepool/main.cc

@@ -0,0 +1,112 @@
+/* -*- Mode: C; tab-width: 4; c-basic-offset: 4; indent-tabs-mode: nil -*- */
+/*
+ *     Copyright 2013 Couchbase, Inc.
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+
+#include "pool.h"
+#include <stdio.h>
+#include <vector>
+
+using namespace lcb;
+
+extern "C" {
+static void get_callback(lcb_t instance, int, const lcb_RESPBASE *rb)
+{
+    const lcb_RESPGET *rg = reinterpret_cast<const lcb_RESPGET*>(rb);
+    if (rb->rc != LCB_SUCCESS) {
+        fprintf(stderr, "%p: Couldn't get key", instance);
+    } else {
+        fprintf(stderr, "%p: Got key %.*s with value %.*s\n", instance,
+            (int)rg->nkey, rg->key, (int)rg->nvalue, rg->value);
+    }
+}
+}
+
+class MyPool : public Pool {
+public:
+    MyPool(const lcb_create_st& opts, size_t items) : Pool(opts, items) {}
+protected:
+    void initialize(lcb_t instance) {
+        // We override the initialize function to set the proper callback we
+        // care about
+        fprintf(stderr, "Initializing %p\n", instance);
+        lcb_install_callback3(instance, LCB_CALLBACK_GET, get_callback);
+    }
+};
+
+extern "C" {
+static void *
+pthr_func(void *arg) {
+    Pool *pool = reinterpret_cast<Pool*>(arg);
+    lcb_CMDGET gcmd = { 0 };
+    LCB_CMD_SET_KEY(&gcmd, "foo", 3);
+
+    // Get an instance to use
+    lcb_t instance = pool->pop();
+
+    // Issue the command
+    lcb_get3(instance, NULL, &gcmd);
+
+    // Wait for the command to complete
+    lcb_wait(instance);
+
+    // Release back to pool
+    pool->push(instance);
+
+    return NULL;
+}
+}
+
+#define NUM_WORKERS 20
+int main(int argc, char *argv[]) {
+    lcb_create_st options;
+    pthread_t workers[NUM_WORKERS];
+    Pool *pool;
+    lcb_error_t err;
+
+    // set up the options to represent your cluster (hostname etc)
+    memset(&options, 0, sizeof options);
+    options.version = 3;
+    options.v.v3.connstr = "couchbase://localhost";
+    if (argc > 1) {
+        options.v.v3.connstr = argv[1];
+    }
+    if (argc > 2) {
+        options.v.v3.passwd = argv[2];
+    }
+    if (argc > 3) {
+        options.v.v3.username = argv[3];
+    }
+
+    pool = new MyPool(options, 5);
+
+    err = pool->connect();
+    if (err != LCB_SUCCESS) {
+        fprintf(stderr, "Couldn't connect all instances: %s\n", lcb_strerror(NULL, err));
+        exit(EXIT_FAILURE);
+    }
+
+    for (size_t ii = 0; ii < NUM_WORKERS; ii++) {
+        pthread_create(&workers[ii], NULL, pthr_func, pool);
+    }
+
+    for (size_t ii = 0; ii < NUM_WORKERS; ii++) {
+        void *unused;
+        pthread_join(workers[ii], &unused);
+    }
+
+    delete pool;
+    return 0;
+}

data/ext/libcouchbase/example/instancepool/pool.cc

@@ -0,0 +1,102 @@
+/* -*- Mode: C; tab-width: 4; c-basic-offset: 4; indent-tabs-mode: nil -*- */
+/*
+ *     Copyright 2013 Couchbase, Inc.
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+
+#include "pool.h"
+
+using namespace lcb;
+using std::queue;
+using std::vector;
+
+Pool::Pool(const lcb_create_st& options, size_t nitems) : initial_size(0)
+{
+    pthread_mutex_init(&mutex, NULL);
+    pthread_cond_init(&cond, NULL);
+    for (size_t ii = 0; ii < nitems; ii++) {
+        lcb_t cur;
+        lcb_error_t err = lcb_create(&cur, &options);
+        if (err != LCB_SUCCESS) {
+            throw err;
+        }
+
+        instances.push(cur);
+        all_instances.push_back(cur);
+        initial_size++;
+    }
+}
+
+lcb_error_t
+Pool::connect()
+{
+    vector<lcb_t>::const_iterator ii = all_instances.begin();
+    for (;  ii != all_instances.end(); ii++) {
+        lcb_error_t err;
+        initialize(*ii);
+        if ((err = lcb_connect(*ii)) != LCB_SUCCESS) {
+            return err;
+        }
+        lcb_wait(*ii);
+        if ((err = lcb_get_bootstrap_status(*ii)) != LCB_SUCCESS) {
+            return err;
+        }
+    }
+    return LCB_SUCCESS;
+}
+
+Pool::~Pool()
+{
+    pthread_mutex_lock(&mutex);
+    while (instances.size() < initial_size) {
+        pthread_cond_wait(&cond, &mutex);
+    }
+    vector<lcb_t>::const_iterator ii = all_instances.begin();
+    for (; ii != all_instances.end(); ii++) {
+        lcb_destroy(*ii);
+    }
+    pthread_mutex_unlock(&mutex);
+    pthread_mutex_destroy(&mutex);
+    pthread_cond_destroy(&cond);
+}
+
+lcb_t
+Pool::pop()
+{
+    lcb_t ret = NULL;
+
+    // Need to lock the mutex to the pool structure itself
+    pthread_mutex_lock(&mutex);
+
+    while (instances.empty()) {
+        pthread_cond_wait(&cond, &mutex);
+    }
+
+    ret = instances.front();
+    instances.pop();
+    pthread_mutex_unlock(&mutex);
+
+    // Note that the instance itself does not need a mutex as long as it is not
+    // used between multiple threads concurrently.
+    return ret;
+}
+
+void
+Pool::push(lcb_t instance)
+{
+    pthread_mutex_lock(&mutex);
+    instances.push(instance);
+    pthread_cond_signal(&cond);
+    pthread_mutex_unlock(&mutex);
+}