Linux Manuals session 3

bson_oid_init_sequence() – Generates a new ObjectID using the 64-bit sequence. Synopsisvoid bson_oid_init_sequence (bson_oid_t *oid, bson_context_t *context);Parametersoid A bson_oid_t \&.context An optional bson_context_t \&.DescriptionGenerates a new ObjectID using the 64-bit sequence. NOTE This form of ObjectID is generally used by MongoDB replica peers only.ColophonThis page is part of libbson. Please report any bugs at https://jira.mongodb.org/browse/CDRIVER.

bson_oid_init_from_string() – Parses the string containing hex encoded oid and initialize the bytes in oid. Synopsisvoid bson_oid_init_from_string (bson_oid_t *oid, const char *str);Parametersoid A bson_oid_t \&.str A string containing a hex encoded version of the oid.DescriptionParses the string containing hex encoded oid and initialize the bytes in oid \&. Examplebson_oid_init_from_string (&oid, "012345678901234567890123");ColophonThis page is part of…

bson_oid_init_from_data() – Initializes a bson_oid_t using the raw buffer provided. Synopsisvoid bson_oid_init_from_data (bson_oid_t *oid, const uint8_t *data);Parametersoid A bson_oid_t \&.data A buffer containing 12 bytes for the oid.DescriptionInitializes a bson_oid_t using the raw buffer provided. ColophonThis page is part of libbson. Please report any bugs at https://jira.mongodb.org/browse/CDRIVER.

bson_oid_init() – Generates a new bson_oid_t using either context or the default bson_context_t. Synopsisvoid bson_oid_init (bson_oid_t *oid, bson_context_t *context);Parametersoid A bson_oid_t \&.context An optional bson_context_t or NULL.DescriptionGenerates a new bson_oid_t using either context or the default bson_context_t \&. ColophonThis page is part of libbson. Please report any bugs at https://jira.mongodb.org/browse/CDRIVER.

bson_oid_hash() – Generates a hash code for oid suitable for a hashtable. Synopsisuint32_t bson_oid_hash (const bson_oid_t *oid);Parametersoid A bson_oid_t \&.DescriptionGenerates a hash code for oid suitable for a hashtable. ReturnsA 32-bit hash code. ColophonThis page is part of libbson. Please report any bugs at https://jira.mongodb.org/browse/CDRIVER.

bson_oid_get_time_t() – Fetches the generation time in seconds since the UNIX Epoch of oid. Synopsistime_t bson_oid_get_time_t (const bson_oid_t *oid);Parametersoid A bson_oid_t \&.DescriptionFetches the generation time in seconds since the UNIX Epoch of oid \&. ReturnsA time_t containing the seconds since the UNIX epoch of oid \&. ColophonThis page is part of libbson. Please report any…

bson_oid_equal() – Checks if two bson_oid_t contain the same bytes. Synopsisbool bson_oid_equal (const bson_oid_t *oid1, const bson_oid_t *oid2);Parametersoid1 A bson_oid_t \&.oid2 A bson_oid_t \&.DescriptionChecks if two bson_oid_t contain the same bytes. Returnstrue if they are equal, otherwise false. ColophonThis page is part of libbson. Please report any bugs at https://jira.mongodb.org/browse/CDRIVER.

bson_oid_copy() – Copies the contents of src into dst. Synopsisvoid bson_oid_copy (const bson_oid_t *src, bson_oid_t *dst);Parameterssrc A bson_oid_t \&.dst A bson_oid_t \&.DescriptionCopies the contents of src into dst. ColophonThis page is part of libbson. Please report any bugs at https://jira.mongodb.org/browse/CDRIVER.

bson_oid_compare() – The bson_oid_compare() function shall return a qsort() style value of a lexicographical sort of _oid1_ and _oid2_. Synopsisint bson_oid_compare (const bson_oid_t *oid1, const bson_oid_t *oid2);Parametersoid1 A bson_oid_t \&.oid2 A bson_oid_t \&.DescriptionThe bson_oid_compare(3) function shall return a qsort() style value of a lexicographical sort of _oid1_ and _oid2_. Returnsless than 0, 0, or greater…

bson_new_from_json() – The bson_new_from_json() function allocates and initialize a new bson_t by parsing the JSON found in data. Only a single JSON object may exist in data or an error will be set and NULL returned. Synopsisbson_t * bson_new_from_json (const uint8_t *data, ssize_t len, bson_error_t *error);Parametersdata A UTF-8 encoded string containing valid JSON.len The length…

bson_new_from_data() – The bson_new_from_data() function shall create a new bson_t on the heap and copy the contents of data. This may be helpful when working with language bindings but is generally expected to be slower. Synopsisbson_t * bson_new_from_data (const uint8_t *data, size_t length);Parametersdata A BSON encoded document buffer.length The length of data in bytes.DescriptionThe bson_new_from_data(3)…

bson_new_from_buffer() – TODO: Synopsisbson_t * bson_new_from_buffer (uint8_t **buf, size_t *buf_len, bson_realloc_func realloc_func, void *realloc_func_ctx);Parametersbuf A uint8_t.buf_len A size_t.realloc_func A bson_realloc_func.realloc_func_ctx A (null).DescriptionTODO: ReturnsTODO: ColophonThis page is part of libbson. Please report any bugs at https://jira.mongodb.org/browse/CDRIVER.

bson_new() – The bson_new() function shall create a new bson_t structure on the heap. It should be freed with bson_destroy() when it is no longer in use. Synopsisbson_t * bson_new (void);DescriptionThe bson_new(3) function shall create a new bson_t structure on the heap. It should be freed with bson_destroy(3) when it is no longer in use….

bson_mem_set_table() – This function shall install a new memory allocator to be used by Libbson. Synopsistypedef struct _bson_mem_vtable_t { void *(*malloc) (size_t num_bytes); void *(*calloc) (size_t n_members, size_t num_bytes); void *(*realloc) (void *mem, size_t num_bytes); void (*free) (void *mem); void *padding [4]; } bson_mem_vtable_t; void bson_mem_set_vtable (const bson_mem_vtable_t *vtable);Parametersvtable A bson_mem_vtable_t with every non-padding field…

bson_mem_restore_vtable() – This function shall restore the default memory allocator to be used by Libbson. Synopsisvoid bson_mem_restore_vtable (void);DescriptionThis function shall restore the default memory allocator to be used by Libbson. NOTE This function MUST be called at the end of the process. Failure to do so will result in memory being freed by the wrong…

bson_md5_t – BSON MD5 Abstraction Synopsistypedef struct { uint32_t count[2]; /* message length in bits, lsw first */ uint32_t abcd[4]; /* digest buffer */ uint8_t buf[64]; /* accumulate block */ } bson_md5_t;Descriptionbson_md5_t encapsulates an implementation of the MD5 algorithm. This is used in OID generation for the MD5(hostname) bytes. It is also used by some…

bson_md5_init() – Initialize a new instance of the MD5 algorithm. Synopsisvoid bson_md5_init (bson_md5_t *pms);Parameterspms A bson_md5_t \&.DescriptionInitialize a new instance of the MD5 algorithm. ColophonThis page is part of libbson. Please report any bugs at https://jira.mongodb.org/browse/CDRIVER.

bson_md5_finish() – Completes the MD5 algorithm and stores the digest in digest. Synopsisvoid bson_md5_finish (bson_md5_t *pms, uint8_t digest[16]);Parameterspms A bson_md5_t \&.digest A location for the digest.DescriptionCompletes the MD5 algorithm and stores the digest in digest \&. ColophonThis page is part of libbson. Please report any bugs at https://jira.mongodb.org/browse/CDRIVER.

bson_md5_append() – Feeds more data into the MD5 algorithm. Synopsisvoid bson_md5_append (bson_md5_t *pms, const uint8_t *data, uint32_t nbytes);Parameterspms A bson_md5_t \&.data A memory region to feed to the md5 algorithm.nbytes The length of data in bytes.DescriptionFeeds more data into the MD5 algorithm. ColophonThis page is part of libbson. Please report any bugs at https://jira.mongodb.org/browse/CDRIVER.

bson_malloc0() – This is a portable malloc() wrapper that also sets the memory to zero. Similar to calloc(). Synopsisvoid * bson_malloc0 (size_t num_bytes);Parametersnum_bytes A size_t.DescriptionThis is a portable malloc(3) wrapper that also sets the memory to zero. Similar to calloc(3) \&. In general, this function will return an allocation at least sizeof(void*) bytes or bigger….