solarwinds_apm 6.1.2 → 7.0.0.prev1

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: solarwinds_apm
 version: !ruby/object:Gem::Version
-  version: 6.1.2
+  version: 7.0.0.prev1
 platform: ruby
 authors:
 - Maia Engeli
@@ -11,8 +11,36 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-02-28 00:00:00.000000000 Z
+date: 2025-06-10 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: opentelemetry-exporter-otlp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.29.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.29.1
+- !ruby/object:Gem::Dependency
+  name: opentelemetry-exporter-otlp-metrics
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.3.0
 - !ruby/object:Gem::Dependency
   name: opentelemetry-instrumentation-all
   requirement: !ruby/object:Gem::Requirement
@@ -27,6 +55,48 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 0.31.0
+- !ruby/object:Gem::Dependency
+  name: opentelemetry-metrics-sdk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+- !ruby/object:Gem::Dependency
+  name: opentelemetry-resource-detector-azure
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+- !ruby/object:Gem::Dependency
+  name: opentelemetry-resource-detector-container
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
 - !ruby/object:Gem::Dependency
   name: opentelemetry-sdk
   requirement: !ruby/object:Gem::Requirement
@@ -44,31 +114,13 @@ dependencies:
 description: Automatic tracing and metrics for Ruby applications. Get started at cloud.solarwinds.com
 email: technicalsupport@solarwinds.com
 executables: []
-extensions:
-- ext/oboe_metal/extconf.rb
+extensions: []
 extra_rdoc_files:
 - LICENSE
 files:
 - ".yardopts"
 - LICENSE
 - README.md
-- ext/oboe_metal/extconf.rb
-- ext/oboe_metal/lib/liboboe-1.0-aarch64.so.sha256
-- ext/oboe_metal/lib/liboboe-1.0-alpine-aarch64.so.sha256
-- ext/oboe_metal/lib/liboboe-1.0-alpine-x86_64.so.sha256
-- ext/oboe_metal/lib/liboboe-1.0-lambda-aarch64.so.sha256
-- ext/oboe_metal/lib/liboboe-1.0-lambda-x86_64.so.sha256
-- ext/oboe_metal/lib/liboboe-1.0-x86_64.so.sha256
-- ext/oboe_metal/src/VERSION
-- ext/oboe_metal/src/bson/bson.h
-- ext/oboe_metal/src/bson/platform_hacks.h
-- ext/oboe_metal/src/init_solarwinds_apm.cc
-- ext/oboe_metal/src/oboe.h
-- ext/oboe_metal/src/oboe_api.cpp
-- ext/oboe_metal/src/oboe_api.h
-- ext/oboe_metal/src/oboe_debug.h
-- ext/oboe_metal/src/oboe_swig_wrap.cc
-- lib/oboe_metal.rb
 - lib/rails/generators/solarwinds_apm/install_generator.rb
 - lib/rails/generators/solarwinds_apm/templates/solarwinds_apm_initializer.rb
 - lib/solarwinds_apm.rb
@@ -79,44 +131,51 @@ files:
 - lib/solarwinds_apm/api/opentelemetry.rb
 - lib/solarwinds_apm/api/tracing.rb
 - lib/solarwinds_apm/api/transaction_name.rb
-- lib/solarwinds_apm/cert/star.appoptics.com.issuer.crt
 - lib/solarwinds_apm/config.rb
 - lib/solarwinds_apm/constants.rb
 - lib/solarwinds_apm/logger.rb
 - lib/solarwinds_apm/noop.rb
 - lib/solarwinds_apm/noop/README.md
 - lib/solarwinds_apm/noop/api.rb
-- lib/solarwinds_apm/noop/context.rb
-- lib/solarwinds_apm/noop/metadata.rb
-- lib/solarwinds_apm/noop/span.rb
-- lib/solarwinds_apm/oboe_init_options.rb
 - lib/solarwinds_apm/opentelemetry.rb
 - lib/solarwinds_apm/opentelemetry/otlp_processor.rb
-- lib/solarwinds_apm/opentelemetry/solarwinds_exporter.rb
-- lib/solarwinds_apm/opentelemetry/solarwinds_processor.rb
 - lib/solarwinds_apm/opentelemetry/solarwinds_propagator.rb
 - lib/solarwinds_apm/opentelemetry/solarwinds_response_propagator.rb
-- lib/solarwinds_apm/opentelemetry/solarwinds_sampler.rb
-- lib/solarwinds_apm/otel_config.rb
-- lib/solarwinds_apm/otel_lambda_config.rb
-- lib/solarwinds_apm/patch.rb
-- lib/solarwinds_apm/patch/dummy_patch.rb
+- lib/solarwinds_apm/otel_native_config.rb
+- lib/solarwinds_apm/patch/README.md
 - lib/solarwinds_apm/patch/tag_sql/sw_dbo_utils.rb
 - lib/solarwinds_apm/patch/tag_sql/sw_mysql2_patch.rb
 - lib/solarwinds_apm/patch/tag_sql/sw_pg_patch.rb
 - lib/solarwinds_apm/patch/tag_sql_patch.rb
+- lib/solarwinds_apm/sampling.rb
+- lib/solarwinds_apm/sampling/dice.rb
+- lib/solarwinds_apm/sampling/http_sampler.rb
+- lib/solarwinds_apm/sampling/json_sampler.rb
+- lib/solarwinds_apm/sampling/metrics.rb
+- lib/solarwinds_apm/sampling/oboe_sampler.rb
+- lib/solarwinds_apm/sampling/sampler.rb
+- lib/solarwinds_apm/sampling/sampling_constants.rb
+- lib/solarwinds_apm/sampling/sampling_patch.rb
+- lib/solarwinds_apm/sampling/setting_example.txt
+- lib/solarwinds_apm/sampling/settings.rb
+- lib/solarwinds_apm/sampling/token_bucket.rb
+- lib/solarwinds_apm/sampling/trace_options.rb
 - lib/solarwinds_apm/support.rb
+- lib/solarwinds_apm/support/aws_resource_detector.rb
 - lib/solarwinds_apm/support/logger_formatter.rb
 - lib/solarwinds_apm/support/logging_log_event.rb
 - lib/solarwinds_apm/support/lumberjack_formatter.rb
-- lib/solarwinds_apm/support/oboe_tracing_mode.rb
+- lib/solarwinds_apm/support/otlp_endpoint.rb
+- lib/solarwinds_apm/support/resource_detector.rb
+- lib/solarwinds_apm/support/resource_detector/aws/beanstalk.rb
+- lib/solarwinds_apm/support/resource_detector/aws/ec2.rb
+- lib/solarwinds_apm/support/resource_detector/aws/ecs.rb
+- lib/solarwinds_apm/support/resource_detector/aws/eks.rb
+- lib/solarwinds_apm/support/resource_detector/aws/lambda.rb
 - lib/solarwinds_apm/support/service_key_checker.rb
-- lib/solarwinds_apm/support/support_report.rb
-- lib/solarwinds_apm/support/transaction_cache.rb
 - lib/solarwinds_apm/support/transaction_settings.rb
 - lib/solarwinds_apm/support/txn_name_manager.rb
 - lib/solarwinds_apm/support/utils.rb
-- lib/solarwinds_apm/support/x_trace_options.rb
 - lib/solarwinds_apm/version.rb
 homepage: https://documentation.solarwinds.com/en/success_center/observability/content/intro/landing-page.html
 licenses:
@@ -135,12 +194,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.7.0
+      version: 3.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
 rubygems_version: 3.3.27
 signing_key:

data/ext/oboe_metal/extconf.rb

@@ -1,168 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright (c) 2016 SolarWinds, LLC.
-# All rights reserved.
-
-require 'mkmf'
-require 'rbconfig'
-require 'open-uri'
-
-CONFIG['warnflags'] = CONFIG['warnflags'].gsub('-Wdeclaration-after-statement', '')
-                                         .gsub('-Wimplicit-function-declaration', '')
-                                         .gsub('-Wimplicit-int', '')
-                                         .gsub('-Wno-tautological-compare', '')
-                                         .gsub('-Wno-self-assign', '')
-                                         .gsub('-Wno-parentheses-equality', '')
-                                         .gsub('-Wno-constant-logical-operand', '')
-                                         .gsub('-Wno-cast-function-type', '')
-init_mkmf(CONFIG)
-
-ext_dir = __dir__
-oboe_env = ENV.fetch('OBOE_ENV', nil)
-non_production = %w[dev stg].include? oboe_env.to_s
-
-swo_lib_dir = File.join(ext_dir, 'lib')
-version     = File.read(File.join(ext_dir, 'src', 'VERSION')).strip
-
-case oboe_env
-when 'dev'
-  swo_path = 'https://solarwinds-apm-staging.s3.us-west-2.amazonaws.com/apm/c-lib/nightly'
-  puts 'Fetching c-lib from DEVELOPMENT Build'
-when 'stg'
-  swo_path = File.join('https://agent-binaries.global.st-ssp.solarwinds.com/apm/c-lib/', version)
-  puts 'Fetching c-lib from STAGING Build'
-else
-  swo_path = File.join('https://agent-binaries.cloud.solarwinds.com/apm/c-lib/', version)
-  puts 'Fetching c-lib from PRODUCTION Build'
-end
-
-oboe_debug = ENV['OBOE_DEBUG'].to_s.casecmp('true').zero?
-
-if oboe_debug
-  swo_path = File.join(swo_path, 'relwithdebinfo')
-  puts "Fetching DEBUG Build based on #{oboe_env.to_s.empty? ? 'prod' : oboe_env}"
-end
-
-puts "final swo_path: #{swo_path}"
-
-swo_arch = 'x86_64'
-system_arch = `uname -m` # for mac, the command is `uname` # "Darwin\n"; try `uname -a`
-system_arch.delete!("\n")
-case system_arch
-when 'x86_64'
-  swo_arch = 'x86_64'
-when 'aarch64' || 'arm64'
-  swo_arch = 'aarch64'
-end
-
-if File.exist?('/etc/alpine-release')
-  version = File.read('/etc/alpine-release').strip
-
-  tmp_swo_arch = swo_arch.clone
-  swo_arch =
-    if Gem::Version.new(version) < Gem::Version.new('3.9')
-      "alpine-libressl-#{tmp_swo_arch}"
-    else # openssl
-      "alpine-#{tmp_swo_arch}"
-    end
-end
-
-swo_clib = "liboboe-1.0-#{swo_arch}.so"
-swo_clib = "liboboe-1.0-lambda-#{swo_arch}.so" if ENV['LAMBDA_TASK_ROOT'] || ENV['AWS_LAMBDA_FUNCTION_NAME']
-swo_item = File.join(swo_path, swo_clib)
-swo_checksum_file = File.join(swo_lib_dir, "#{swo_clib}.sha256")
-clib = File.join(swo_lib_dir, swo_clib)
-
-retries = 3
-success = false
-while retries.positive?
-  begin
-    IO.copy_stream(URI.parse(swo_item).open, clib)
-    clib_checksum = Digest::SHA256.file(clib).hexdigest
-    checksum      = File.read(swo_checksum_file).strip
-
-    # sha256 always from prod, so no matching for stg or nightly build or debug mode
-    # so ignore the sha comparsion when fetching from development and staging build
-    checksum = clib_checksum if non_production || oboe_debug
-
-    # unfortunately these messages only show if the install command is run
-    # with the `--verbose` flag
-    if clib_checksum == checksum
-      success = true
-    else
-      puts 'Checksum Verification Fail' # this is mainly for testing
-      warn '== ERROR ================================================================='
-      warn 'Checksum Verification failed for the c-extension of the solarwinds_apm gem'
-      warn 'Installation cannot continue'
-      warn "\nChecksum packaged with gem:   #{checksum}"
-      warn "Checksum calculated from lib: #{clib_checksum}"
-      warn 'Contact technicalsupport@solarwinds.com if the problem persists'
-      warn '=========================================================================='
-    end
-    retries = 0
-  rescue StandardError => e
-    File.write(clib, '')
-    retries -= 1
-    if retries.zero?
-      warn '== ERROR =========================================================='
-      warn 'Download of the c-extension for the solarwinds_apm gem failed.'
-      warn 'solarwinds_apm will not instrument the code. No tracing will occur.'
-      warn 'Contact technicalsupport@solarwinds.com if the problem persists.'
-      warn "error: #{swo_item}\n#{e.message}"
-      warn '==================================================================='
-      create_makefile('oboe_noop', 'noop')
-    end
-    sleep 0.5
-  end
-end
-
-if success
-  # Create relative symlinks for the SolarWindsAPM library
-  Dir.chdir(swo_lib_dir) do
-    File.symlink(swo_clib, 'liboboe.so')
-    File.symlink(swo_clib, 'liboboe-1.0.so.0')
-  end
-
-  dir_config('oboe', 'src', 'lib')
-
-  # create Makefile
-  if have_library('oboe')
-    $libs = append_library($libs, 'oboe')
-    $libs = append_library($libs, 'stdc++')
-
-    $CFLAGS << " #{ENV.fetch('CFLAGS', nil)}"
-
-    # -pg option is used for generating profiling information with gprof
-    $CPPFLAGS << if oboe_debug
-                   " #{ENV.fetch('CPPFLAGS', nil)} -std=c++11  -gdwarf-2 -I$$ORIGIN/../ext/oboe_metal/src"
-                 else
-                   " #{ENV.fetch('CPPFLAGS', nil)} -std=c++11 -I$$ORIGIN/../ext/oboe_metal/src"
-                 end
-
-    $LIBS << " #{ENV.fetch('LIBS', nil)}"
-
-    # -lrt option is used when linking programs with the GNU Compiler Collection (GCC) to
-    # include the POSIX real-time extensions library, librt.
-    $LDFLAGS << " #{ENV.fetch('LDFLAGS', nil)} '-Wl,-rpath=$$ORIGIN/../ext/oboe_metal/lib' -lrt"
-    $CXXFLAGS += ' -std=c++11 '
-
-    # OBOE_DEBUG need to be enabled before downloading and installing the gem
-    if oboe_debug
-      CONFIG['debugflags'] = '-ggdb3 '
-      CONFIG['optflags'] = '-O0'
-    end
-
-    create_makefile('libsolarwinds_apm', 'src')
-  else
-    warn '== ERROR ========================================================='
-    if have_library('oboe')
-      warn "The c-library either needs to be updated or doesn't match the OS."
-      warn 'No tracing will occur.'
-    else
-      warn 'Could not find a matching c-library. No tracing will occur.'
-    end
-    warn 'Contact technicalsupport@solarwinds.com if the problem persists.'
-    warn '=================================================================='
-    create_makefile('oboe_noop', 'noop')
-  end
-end

data/ext/oboe_metal/lib/liboboe-1.0-aarch64.so.sha256

@@ -1 +0,0 @@
-53295ec020a713c5f6fe7c14b150a10ac7db0e5ea692fbd6945ee69f7a581271

data/ext/oboe_metal/lib/liboboe-1.0-alpine-aarch64.so.sha256

@@ -1 +0,0 @@
-37407ece6aafcb662fbce8eb23f98a9b017154c66c8ec02eda835702ba14f446

data/ext/oboe_metal/lib/liboboe-1.0-alpine-x86_64.so.sha256

@@ -1 +0,0 @@
-925d65c2a940a82315525ea2e82eb357793f7db8a2a8ec529e7c03e2478bc965

data/ext/oboe_metal/lib/liboboe-1.0-lambda-aarch64.so.sha256

@@ -1 +0,0 @@
-3d49133827a0b6839744231e3ca49f8c9340380063286b8c3794bde585370001

data/ext/oboe_metal/lib/liboboe-1.0-lambda-x86_64.so.sha256

@@ -1 +0,0 @@
-e2198827ce86309a59def33be14f17d0474477df33a5d75bd415d73a01c790b3

data/ext/oboe_metal/lib/liboboe-1.0-x86_64.so.sha256

@@ -1 +0,0 @@
-798a7c9551c66af743e1d6d2b736bf5667fa97fdc0ac8eec825fe4f63adaa044

data/ext/oboe_metal/src/VERSION

@@ -1 +0,0 @@
-15.0.3

data/ext/oboe_metal/src/bson/bson.h

@@ -1,220 +0,0 @@
-/* bson.h */
-
-/*    Copyright 2009, 2010 10gen 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.
- */
-
-#ifndef _BSON_H_
-#define _BSON_H_
-
-#define MONGO_HAVE_STDINT
-#include "platform_hacks.h"
-#include <time.h>
-
-MONGO_EXTERN_C_START
-
-typedef enum {
-    oboe_bson_error=-1,
-    oboe_bson_eoo=0,
-    oboe_bson_double=1,
-    oboe_bson_string=2,
-    oboe_bson_object=3,
-    oboe_bson_array=4,
-    oboe_bson_bindata=5,
-    oboe_bson_undefined=6,
-    oboe_bson_oid=7,
-    oboe_bson_bool=8,
-    oboe_bson_date=9,
-    oboe_bson_null=10,
-    oboe_bson_regex=11,
-    oboe_bson_dbref=12, /* deprecated */
-    oboe_bson_code=13,
-    oboe_bson_symbol=14,
-    oboe_bson_codewscope=15,
-    oboe_bson_int = 16,
-    oboe_bson_timestamp = 17,
-    oboe_bson_long = 18
-} oboe_bson_type;
-
-typedef int oboe_bson_bool_t;
-
-typedef struct {
-    char * data;
-    oboe_bson_bool_t owned;
-} oboe_bson;
-
-typedef struct {
-    const char * cur;
-    oboe_bson_bool_t first;
-} oboe_bson_iterator;
-
-typedef struct {
-    char * buf;
-    char * cur;
-    int bufSize;
-    oboe_bson_bool_t finished;
-    int stack[32];
-    int stackPos;
-} oboe_bson_buffer;
-
-#pragma pack(1)
-typedef union{
-    char bytes[12];  // Flawfinder: ignore
-    int ints[3];
-} oboe_bson_oid_t;
-#pragma pack()
-
-typedef int64_t oboe_bson_date_t; /* milliseconds since epoch UTC */
-
-/* ----------------------------
-   READING
-   ------------------------------ */
-
-
-oboe_bson * oboe_bson_empty(oboe_bson * obj); /* returns pointer to static empty bson object */
-int oboe_bson_copy(oboe_bson* out, const oboe_bson* in); /* puts data in new buffer. NOOP if out==NULL */
-oboe_bson * oboe_bson_from_buffer(oboe_bson * b, oboe_bson_buffer * buf);
-oboe_bson * oboe_bson_init( oboe_bson * b , char * data , oboe_bson_bool_t mine );
-oboe_bson * oboe_bson_init_safe( oboe_bson * b , char * data , oboe_bson_bool_t mine , size_t buflen);
-int oboe_bson_size(const oboe_bson * b );
-void oboe_bson_destroy( oboe_bson * b );
-
-void oboe_bson_print( oboe_bson * b );
-void oboe_bson_print_raw( const char * bson , int depth );
-
-/* advances iterator to named field */
-/* returns bson_eoo (which is false) if field not found */
-oboe_bson_type oboe_bson_find(oboe_bson_iterator* it, const oboe_bson* obj, const char* name);
-
-void oboe_bson_iterator_init( oboe_bson_iterator * i , const char * bson );
-
-/* more returns true for eoo. best to loop with bson_iterator_next(&it) */
-oboe_bson_bool_t oboe_bson_iterator_more( const oboe_bson_iterator * i );
-oboe_bson_type oboe_bson_iterator_next( oboe_bson_iterator * i );
-
-oboe_bson_type oboe_bson_iterator_type( const oboe_bson_iterator * i );
-const char * oboe_bson_iterator_key( const oboe_bson_iterator * i );
-const char * oboe_bson_iterator_value( const oboe_bson_iterator * i );
-
-/* these convert to the right type (return 0 if non-numeric) */
-double oboe_bson_iterator_double( const oboe_bson_iterator * i );
-int oboe_bson_iterator_int( const oboe_bson_iterator * i );
-int64_t oboe_bson_iterator_long( const oboe_bson_iterator * i );
-
-/* false: boolean false, 0 in any type, or null */
-/* true: anything else (even empty strings and objects) */
-oboe_bson_bool_t oboe_bson_iterator_bool( const oboe_bson_iterator * i );
-
-/* these assume you are using the right type */
-double oboe_bson_iterator_double_raw( const oboe_bson_iterator * i );
-int oboe_bson_iterator_int_raw( const oboe_bson_iterator * i );
-int64_t oboe_bson_iterator_long_raw( const oboe_bson_iterator * i );
-oboe_bson_bool_t oboe_bson_iterator_bool_raw( const oboe_bson_iterator * i );
-oboe_bson_oid_t* oboe_bson_iterator_oid( const oboe_bson_iterator * i );
-
-/* these can also be used with bson_code and bson_symbol*/
-const char * oboe_bson_iterator_string( const oboe_bson_iterator * i );
-int oboe_bson_iterator_string_len( const oboe_bson_iterator * i );
-
-/* works with bson_code, bson_codewscope, and bson_string */
-/* returns NULL for everything else */
-const char * oboe_bson_iterator_code(const oboe_bson_iterator * i);
-
-/* calls bson_empty on scope if not a bson_codewscope */
-void oboe_bson_iterator_code_scope(const oboe_bson_iterator * i, oboe_bson * scope);
-
-/* both of these only work with bson_date */
-oboe_bson_date_t oboe_bson_iterator_date(const oboe_bson_iterator * i);
-time_t oboe_bson_iterator_time_t(const oboe_bson_iterator * i);
-
-int oboe_bson_iterator_bin_len( const oboe_bson_iterator * i );
-char oboe_bson_iterator_bin_type( const oboe_bson_iterator * i );
-const char * oboe_bson_iterator_bin_data( const oboe_bson_iterator * i );
-
-const char * oboe_bson_iterator_regex( const oboe_bson_iterator * i );
-const char * oboe_bson_iterator_regex_opts( const oboe_bson_iterator * i );
-
-/* these work with bson_object and bson_array */
-void oboe_bson_iterator_subobject(const oboe_bson_iterator * i, oboe_bson * sub);
-void oboe_bson_iterator_subiterator(const oboe_bson_iterator * i, oboe_bson_iterator * sub);
-
-/* str must be at least 24 hex chars + null byte */
-void oboe_bson_oid_from_string(oboe_bson_oid_t* oid, const char* str);
-void oboe_bson_oid_to_string(const oboe_bson_oid_t* oid, char* str);
-void oboe_bson_oid_gen(oboe_bson_oid_t* oid);
-
-time_t oboe_bson_oid_generated_time(oboe_bson_oid_t* oid); /* Gives the time the OID was created */
-
-/* ----------------------------
-   BUILDING
-   ------------------------------ */
-
-oboe_bson_buffer * oboe_bson_buffer_init( oboe_bson_buffer * b );
-oboe_bson_buffer * oboe_bson_ensure_space( oboe_bson_buffer * b , const int bytesNeeded );
-
-/**
- * @return the raw data.  you either should free this OR call bson_destroy not both
- */
-char * oboe_bson_buffer_finish( oboe_bson_buffer * b );
-void oboe_bson_buffer_destroy( oboe_bson_buffer * b );
-
-oboe_bson_buffer * oboe_bson_append_oid( oboe_bson_buffer * b , const char * name , const oboe_bson_oid_t* oid );
-oboe_bson_buffer * oboe_bson_append_int( oboe_bson_buffer * b , const char * name , const int i );
-oboe_bson_buffer * oboe_bson_append_long( oboe_bson_buffer * b , const char * name , const int64_t i );
-oboe_bson_buffer * oboe_bson_append_double( oboe_bson_buffer * b , const char * name , const double d );
-oboe_bson_buffer * oboe_bson_append_string( oboe_bson_buffer * b , const char * name , const char * str );
-oboe_bson_buffer * oboe_bson_append_symbol( oboe_bson_buffer * b , const char * name , const char * str );
-oboe_bson_buffer * oboe_bson_append_code( oboe_bson_buffer * b , const char * name , const char * str );
-oboe_bson_buffer * oboe_bson_append_code_w_scope( oboe_bson_buffer * b , const char * name , const char * code , const oboe_bson * scope);
-oboe_bson_buffer * oboe_bson_append_binary( oboe_bson_buffer * b, const char * name, char type, const char * str, int len );
-oboe_bson_buffer * oboe_bson_append_bool( oboe_bson_buffer * b , const char * name , const oboe_bson_bool_t v );
-oboe_bson_buffer * oboe_bson_append_null( oboe_bson_buffer * b , const char * name );
-oboe_bson_buffer * oboe_bson_append_undefined( oboe_bson_buffer * b , const char * name );
-oboe_bson_buffer * oboe_bson_append_regex( oboe_bson_buffer * b , const char * name , const char * pattern, const char * opts );
-oboe_bson_buffer * oboe_bson_append_bson( oboe_bson_buffer * b , const char * name , const oboe_bson* bson);
-oboe_bson_buffer * oboe_bson_append_element( oboe_bson_buffer * b, const char * name_or_null, const oboe_bson_iterator* elem);
-
-/* these both append a bson_date */
-oboe_bson_buffer * oboe_bson_append_date(oboe_bson_buffer * b, const char * name, oboe_bson_date_t millis);
-oboe_bson_buffer * oboe_bson_append_time_t(oboe_bson_buffer * b, const char * name, time_t secs);
-
-oboe_bson_buffer * oboe_bson_append_start_object( oboe_bson_buffer * b , const char * name );
-oboe_bson_buffer * oboe_bson_append_start_array( oboe_bson_buffer * b , const char * name );
-oboe_bson_buffer * oboe_bson_append_finish_object( oboe_bson_buffer * b );
-
-void oboe_bson_numstr(char* str, int i);
-void oboe_bson_incnumstr(char* str);
-
-
-/* ------------------------------
-   ERROR HANDLING - also used in mongo code
-   ------------------------------ */
-
-void * oboe_bson_malloc(int size); /* checks return value */
-
-/* bson_err_handlers shouldn't return!!! */
-typedef void(*ob_bson_err_handler)(const char* errmsg);
-
-/* returns old handler or NULL */
-/* default handler prints error then exits with failure*/
-ob_bson_err_handler oboe_set_bson_err_handler(ob_bson_err_handler func);
-
-
-
-/* does nothing is ok != 0 */
-void oboe_bson_fatal( int ok );
-int oboe_bson_fatal_msg( int ok, const char* msg );
-
-MONGO_EXTERN_C_END
-#endif