'\" t
.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "MONGOC_URI_T" "3" "Feb 25, 2024" "1.26.0" "libmongoc"
.SH SYNOPSIS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
typedef struct _mongoc_uri_t mongoc_uri_t;
.EE
.UNINDENT
.UNINDENT
.SH DESCRIPTION
.sp
\fBmongoc_uri_t\fP provides an abstraction on top of the MongoDB connection URI format. It provides standardized parsing as well as convenience methods for extracting useful information such as replica hosts or authorization information.
.sp
See \fI\%Connection String URI Reference\fP on the MongoDB website for more information.
.SH FORMAT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
mongodb[+srv]://                             <1>
   [username:password@]                      <2>
   host1                                     <3>
   [:port1]                                  <4>
   [,host2[:port2],...[,hostN[:portN]]]      <5>
   [/[database]                              <6>
   [?options]]                               <7>
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP 1. 3
\(dqmongodb\(dq is the specifier of the MongoDB protocol. Use \(dqmongodb+srv\(dq with a single service name in place of \(dqhost1\(dq to specify the initial list of servers with an SRV record.
.IP 2. 3
An optional username and password.
.IP 3. 3
The only required part of the uri.  This specifies either a hostname, IPv4 address, IPv6 address enclosed in \(dq[\(dq and \(dq]\(dq, or UNIX domain socket.
.IP 4. 3
An optional port number.  Defaults to :27017.
.IP 5. 3
Extra optional hosts and ports.  You would specify multiple hosts, for example, for connections to replica sets.
.IP 6. 3
The name of the database to authenticate if the connection string includes authentication credentials.  If /database is not specified and the connection string includes credentials, defaults to the \(aqadmin\(aq database.
.IP 7. 3
Connection specific options.
.UNINDENT
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
Option names are case\-insensitive. Do not repeat the same option (e.g. \(dqmongodb://localhost/db?opt=value1&OPT=value2\(dq) since this may have unexpected results.
.UNINDENT
.UNINDENT
.sp
The MongoDB C Driver exposes constants for each supported connection option. These constants make it easier to discover connection options, but their string values can be used as well.
.sp
For example, the following calls are equal.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
uri = mongoc_uri_new (\(dqmongodb://localhost/?\(dq MONGOC_URI_APPNAME \(dq=applicationName\(dq);
uri = mongoc_uri_new (\(dqmongodb://localhost/?appname=applicationName\(dq);
uri = mongoc_uri_new (\(dqmongodb://localhost/?appName=applicationName\(dq);
.EE
.UNINDENT
.UNINDENT
.SH REPLICA SET EXAMPLE
.sp
To describe a connection to a replica set named \(aqtest\(aq with the following mongod hosts:
.INDENT 0.0
.IP \(bu 2
\fBdb1.example.com\fP on port \fB27017\fP
.IP \(bu 2
\fBdb2.example.com\fP on port \fB2500\fP
.UNINDENT
.sp
You would use a connection string that resembles the following.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
mongodb://db1.example.com,db2.example.com:2500/?replicaSet=test
.EE
.UNINDENT
.UNINDENT
.SH SRV EXAMPLE
.sp
If you have configured an \fI\%SRV record\fP with a name like \(dq_mongodb._tcp.server.example.com\(dq whose records are a list of one or more MongoDB server hostnames, use a connection string like this:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
uri = mongoc_uri_new (\(dqmongodb+srv://server.example.com/?replicaSet=rs&appName=applicationName\(dq);
.EE
.UNINDENT
.UNINDENT
.sp
The driver prefixes the service name with \(dq_mongodb._tcp.\(dq, then performs a DNS SRV query to resolve the service name to one or more hostnames. If this query succeeds, the driver performs a DNS TXT query on the service name (without the \(dq_mongodb._tcp\(dq prefix) for additional URI options configured as TXT records.
.sp
On Unix, the MongoDB C Driver relies on libresolv to look up SRV and TXT records. If libresolv is unavailable, then using a \(dqmongodb+srv\(dq URI will cause an error. If your libresolv lacks \fBres_nsearch\fP then the driver will fall back to \fBres_search\fP, which is not thread\-safe.
.SH IPV4 AND IPV6
.sp
If connecting to a hostname that has both IPv4 and IPv6 DNS records, the behavior follows \fI\%RFC\-6555\fP\&. A connection to the IPv6 address is attempted first. If IPv6 fails, then a connection is attempted to the IPv4 address. If the connection attempt to IPv6 does not complete within 250ms, then IPv4 is tried in parallel. Whichever succeeds connection first cancels the other. The successful DNS result is cached for 10 minutes.
.sp
As a consequence, attempts to connect to a mongod only listening on IPv4 may be delayed if there are both A (IPv4) and AAAA (IPv6) DNS records associated with the host.
.sp
To avoid a delay, configure hostnames to match the MongoDB configuration. That is, only create an A record if the mongod is only listening on IPv4.
.SH CONNECTION OPTIONS
.TS
center;
|l|l|l|l|.
_
T{
Constant
T}	T{
Key
T}	T{
Default
T}	T{
Description
T}
_
T{
MONGOC_URI_RETRYREADS
T}	T{
retryreads
T}	T{
true
T}	T{
If \(dqtrue\(dq and the server is a MongoDB 3.6+ standalone, replica set, or sharded cluster, the driver safely retries a read that failed due to a network error or replica set failover.
T}
_
T{
MONGOC_URI_RETRYWRITES
T}	T{
retrywrites
T}	T{
true if driver built w/ TLS
T}	T{
If \(dqtrue\(dq and the server is a MongoDB 3.6+ replica set or sharded cluster, the driver safely retries a write that failed due to a network error or replica set failover. Only inserts, updates of single documents, or deletes of single
documents are retried.
T}
_
T{
MONGOC_URI_APPNAME
T}	T{
appname
T}	T{
Empty (no appname)
T}	T{
The client application name. This value is used by MongoDB when it logs connection information and profile information, such as slow queries.
T}
_
T{
MONGOC_URI_TLS
T}	T{
tls
T}	T{
Empty (not set, same as false)
T}	T{
{true|false}, indicating if TLS must be used. (See also \fI\%mongoc_client_set_ssl_opts()\fP and \fI\%mongoc_client_pool_set_ssl_opts()\fP\&.)
T}
_
T{
MONGOC_URI_COMPRESSORS
T}	T{
compressors
T}	T{
Empty (no compressors)
T}	T{
Comma separated list of compressors, if any, to use to compress the wire protocol messages. Snappy, zlib, and zstd are optional build time dependencies, and enable the \(dqsnappy\(dq, \(dqzlib\(dq, and \(dqzstd\(dq values respectively.
T}
_
T{
MONGOC_URI_CONNECTTIMEOUTMS
T}	T{
connecttimeoutms
T}	T{
10,000 ms (10 seconds)
T}	T{
This setting applies to new server connections. It is also used as the socket timeout for server discovery and monitoring operations.
T}
_
T{
MONGOC_URI_SOCKETTIMEOUTMS
T}	T{
sockettimeoutms
T}	T{
300,000 ms (5 minutes)
T}	T{
The time in milliseconds to attempt to send or receive on a socket before the attempt times out.
T}
_
T{
MONGOC_URI_REPLICASET
T}	T{
replicaset
T}	T{
Empty (no replicaset)
T}	T{
The name of the Replica Set that the driver should connect to.
T}
_
T{
MONGOC_URI_ZLIBCOMPRESSIONLEVEL
T}	T{
zlibcompressionlevel
T}	T{
\-1
T}	T{
When the MONGOC_URI_COMPRESSORS includes \(dqzlib\(dq this options configures the zlib compression level, when the zlib compressor is used to compress client data.
T}
_
T{
MONGOC_URI_LOADBALANCED
T}	T{
loadbalanced
T}	T{
false
T}	T{
If true, this indicates the driver is connecting to a MongoDB cluster behind a load balancer.
T}
_
T{
MONGOC_URI_SRVMAXHOSTS
T}	T{
srvmaxhosts
T}	T{
0
T}	T{
If zero, the number of hosts in DNS results is unlimited. If greater than zero, the number of hosts in DNS results is limited to being less than or equal to the given value.
T}
_
.TE
.sp
\fBWARNING:\fP
.INDENT 0.0
.INDENT 3.5
Setting any of the *timeoutMS options above to either \fB0\fP or a negative value is discouraged due to unspecified and inconsistent behavior.
The \(dqdefault value\(dq historically specified as a fallback for \fB0\fP or a negative value is NOT related to the default values for the *timeoutMS options documented above.
The meaning of a timeout of \fB0\fP or a negative value may vary depending on the operation being executed, even when specified by the same URI option.
To specify the documented default value for a *timeoutMS option, use the \fIMONGOC_DEFAULT_*\fP constants defined in \fBmongoc\-client.h\fP instead.
.UNINDENT
.UNINDENT
.SH AUTHENTICATION OPTIONS
.TS
center;
|l|l|l|.
_
T{
Constant
T}	T{
Key
T}	T{
Description
T}
_
T{
MONGOC_URI_AUTHMECHANISM
T}	T{
authmechanism
T}	T{
Specifies the mechanism to use when authenticating as the provided user. See \fI\%Authentication\fP for supported values.
T}
_
T{
MONGOC_URI_AUTHMECHANISMPROPERTIES
T}	T{
authmechanismproperties
T}	T{
Certain authentication mechanisms have additional options that can be configured. These options should be provided as comma separated option_key:option_value pair and provided as authMechanismProperties. Specifying the same option_key multiple times has undefined behavior.
T}
_
T{
MONGOC_URI_AUTHSOURCE
T}	T{
authsource
T}	T{
The authSource defines the database that should be used to authenticate to. It is unnecessary to provide this option the database name is the same as the database used in the URI.
T}
_
.TE
.SS Mechanism Properties
.TS
center;
|l|l|l|.
_
T{
Constant
T}	T{
Key
T}	T{
Description
T}
_
T{
MONGOC_URI_CANONICALIZEHOSTNAME
T}	T{
canonicalizehostname
T}	T{
Use the canonical hostname of the service, rather than its configured alias, when authenticating with Cyrus\-SASL Kerberos.
T}
_
T{
MONGOC_URI_GSSAPISERVICENAME
T}	T{
gssapiservicename
T}	T{
Use alternative service name. The default is \fBmongodb\fP\&.
T}
_
.TE
.SH TLS OPTIONS
.TS
center;
|l|l|l|.
_
T{
Constant
T}	T{
Key
T}	T{
Description
T}
_
T{
MONGOC_URI_TLS
T}	T{
tls
T}	T{
{true|false}, indicating if TLS must be used.
T}
_
T{
MONGOC_URI_TLSCERTIFICATEKEYFILE
T}	T{
tlscertificatekeyfile
T}	T{
Path to PEM formatted Private Key, with its Public Certificate concatenated at the end.
T}
_
T{
MONGOC_URI_TLSCERTIFICATEKEYFILEPASSWORD
T}	T{
tlscertificatekeypassword
T}	T{
The password, if any, to use to unlock encrypted Private Key.
T}
_
T{
MONGOC_URI_TLSCAFILE
T}	T{
tlscafile
T}	T{
One, or a bundle of, Certificate Authorities whom should be considered to be trusted.
T}
_
T{
MONGOC_URI_TLSALLOWINVALIDCERTIFICATES
T}	T{
tlsallowinvalidcertificates
T}	T{
Accept and ignore certificate verification errors (e.g. untrusted issuer, expired, etc.)
T}
_
T{
MONGOC_URI_TLSALLOWINVALIDHOSTNAMES
T}	T{
tlsallowinvalidhostnames
T}	T{
Ignore hostname verification of the certificate (e.g. Man In The Middle, using valid certificate, but issued for another hostname)
T}
_
T{
MONGOC_URI_TLSINSECURE
T}	T{
tlsinsecure
T}	T{
{true|false}, indicating if insecure TLS options should be used. Currently this implies MONGOC_URI_TLSALLOWINVALIDCERTIFICATES and MONGOC_URI_TLSALLOWINVALIDHOSTNAMES.
T}
_
T{
MONGOC_URI_TLSDISABLECERTIFICATEREVOCATIONCHECK
T}	T{
tlsdisablecertificaterevocationcheck
T}	T{
{true|false}, indicates if revocation checking (CRL / OCSP) should be disabled.
T}
_
T{
MONGOC_URI_TLSDISABLEOCSPENDPOINTCHECK
T}	T{
tlsdisableocspendpointcheck
T}	T{
{true|false}, indicates if OCSP responder endpoints should not be requested when an OCSP response is not stapled.
T}
_
.TE
.sp
See \fI\%Configuring TLS\fP for details about these options and about building libmongoc with TLS support.
.SH DEPRECATED SSL OPTIONS
.sp
The following options have been deprecated and may be removed from future releases of libmongoc.
.TS
center;
|l|l|l|l|.
_
T{
Constant
T}	T{
Key
T}	T{
Deprecated For
T}	T{
Key
T}
_
T{
MONGOC_URI_SSL
T}	T{
ssl
T}	T{
MONGOC_URI_TLS
T}	T{
tls
T}
_
T{
MONGOC_URI_SSLCLIENTCERTIFICATEKEYFILE
T}	T{
sslclientcertificatekeyfile
T}	T{
MONGOC_URI_TLSCERTIFICATEKEYFILE
T}	T{
tlscertificatekeyfile
T}
_
T{
MONGOC_URI_SSLCLIENTCERTIFICATEKEYPASSWORD
T}	T{
sslclientcertificatekeypassword
T}	T{
MONGOC_URI_TLSCERTIFICATEKEYFILEPASSWORD
T}	T{
tlscertificatekeypassword
T}
_
T{
MONGOC_URI_SSLCERTIFICATEAUTHORITYFILE
T}	T{
sslcertificateauthorityfile
T}	T{
MONGOC_URI_TLSCAFILE
T}	T{
tlscafile
T}
_
T{
MONGOC_URI_SSLALLOWINVALIDCERTIFICATES
T}	T{
sslallowinvalidcertificates
T}	T{
MONGOC_URI_TLSALLOWINVALIDCERTIFICATES
T}	T{
tlsallowinvalidcertificates
T}
_
T{
MONGOC_URI_SSLALLOWINVALIDHOSTNAMES
T}	T{
sslallowinvalidhostnames
T}	T{
MONGOC_URI_TLSALLOWINVALIDHOSTNAMES
T}	T{
tlsallowinvalidhostnames
T}
_
.TE
.SH SERVER DISCOVERY, MONITORING, AND SELECTION OPTIONS
.sp
Clients in a \fI\%mongoc_client_pool_t\fP share a topology scanner that runs on a background thread. The thread wakes every \fBheartbeatFrequencyMS\fP (default 10 seconds) to scan all MongoDB servers in parallel. Whenever an application operation requires a server that is not known\-\-for example, if there is no known primary and your application attempts an insert\-\-the thread rescans all servers every half\-second. In this situation the pooled client waits up to \fBserverSelectionTimeoutMS\fP (default 30 seconds) for the thread to find a server suitable for the operation, then returns an error with domain \fBMONGOC_ERROR_SERVER_SELECTION\fP\&.
.sp
Technically, the total time an operation may wait while a pooled client scans the topology is controlled both by \fBserverSelectionTimeoutMS\fP and \fBconnectTimeoutMS\fP\&. The longest wait occurs if the last scan begins just at the end of the selection timeout, and a slow or down server requires the full connection timeout before the client gives up.
.sp
A non\-pooled client is single\-threaded. Every \fBheartbeatFrequencyMS\fP, it blocks the next application operation while it does a parallel scan. This scan takes as long as needed to check the slowest server: roughly \fBconnectTimeoutMS\fP\&. Therefore the default \fBheartbeatFrequencyMS\fP for single\-threaded clients is greater than for pooled clients: 60 seconds.
.sp
By default, single\-threaded (non\-pooled) clients scan only once when an operation requires a server that is not known. If you attempt an insert and there is no known primary, the client checks all servers once trying to find it, then succeeds or returns an error with domain \fBMONGOC_ERROR_SERVER_SELECTION\fP\&. But if you set \fBserverSelectionTryOnce\fP to \(dqfalse\(dq, the single\-threaded client loops, checking all servers every half\-second, until \fBserverSelectionTimeoutMS\fP\&.
.sp
The total time an operation may wait for a single\-threaded client to scan the topology is determined by \fBconnectTimeoutMS\fP in the try\-once case, or \fBserverSelectionTimeoutMS\fP and \fBconnectTimeoutMS\fP if \fBserverSelectionTryOnce\fP is set \(dqfalse\(dq.
.TS
center;
|l|l|l|.
_
T{
Constant
T}	T{
Key
T}	T{
Description
T}
_
T{
MONGOC_URI_HEARTBEATFREQUENCYMS
T}	T{
heartbeatfrequencyms
T}	T{
The interval between server monitoring checks. Defaults to 10,000ms (10 seconds) in pooled (multi\-threaded) mode, 60,000ms (60 seconds) in non\-pooled mode (single\-threaded).
T}
_
T{
MONGOC_URI_SERVERSELECTIONTIMEOUTMS
T}	T{
serverselectiontimeoutms
T}	T{
A timeout in milliseconds to block for server selection before throwing an exception. The default is 30,0000ms (30 seconds).
T}
_
T{
MONGOC_URI_SERVERSELECTIONTRYONCE
T}	T{
serverselectiontryonce
T}	T{
If \(dqtrue\(dq, the driver scans the topology exactly once after server selection fails, then either selects a server or returns an error. If it is false, then the driver repeatedly searches for a suitable server for up to \fBserverSelectionTimeoutMS\fP milliseconds (pausing a half second between attempts). The default for \fBserverSelectionTryOnce\fP is \(dqfalse\(dq for pooled clients, otherwise \(dqtrue\(dq. Pooled clients ignore serverSelectionTryOnce; they signal the thread to rescan the topology every half\-second until serverSelectionTimeoutMS expires.
T}
_
T{
MONGOC_URI_SOCKETCHECKINTERVALMS
T}	T{
socketcheckintervalms
T}	T{
Only applies to single threaded clients. If a socket has not been used within this time, its connection is checked with a quick \(dqhello\(dq call before it is used again. Defaults to 5,000ms (5 seconds).
T}
_
T{
MONGOC_URI_DIRECTCONNECTION
T}	T{
directconnection
T}	T{
If \(dqtrue\(dq, the driver connects to a single server directly and will not monitor additional servers.  If \(dqfalse\(dq, the driver connects based on the presence and value of the \fBreplicaSet\fP option.
T}
_
.TE
.sp
Setting any of the *TimeoutMS options above to \fB0\fP will be interpreted as \(dquse the default value\(dq.
.SH CONNECTION POOL OPTIONS
.sp
These options govern the behavior of a \fI\%mongoc_client_pool_t\fP\&. They are ignored by a non\-pooled \fI\%mongoc_client_t\fP\&.
.TS
center;
|l|l|l|.
_
T{
Constant
T}	T{
Key
T}	T{
Description
T}
_
T{
MONGOC_URI_MAXPOOLSIZE
T}	T{
maxpoolsize
T}	T{
The maximum number of clients created by a \fI\%mongoc_client_pool_t\fP total (both in the pool and checked out). The default value is 100. Once it is reached, \fI\%mongoc_client_pool_pop()\fP blocks until another thread pushes a client.
T}
_
T{
MONGOC_URI_MINPOOLSIZE
T}	T{
minpoolsize
T}	T{
Deprecated. This option\(aqs behavior does not match its name, and its actual behavior will likely hurt performance.
T}
_
T{
MONGOC_URI_MAXIDLETIMEMS
T}	T{
maxidletimems
T}	T{
Not implemented.
T}
_
T{
MONGOC_URI_WAITQUEUEMULTIPLE
T}	T{
waitqueuemultiple
T}	T{
Not implemented.
T}
_
T{
MONGOC_URI_WAITQUEUETIMEOUTMS
T}	T{
waitqueuetimeoutms
T}	T{
The maximum time to wait for a client to become available from the pool.
T}
_
.TE
.SH WRITE CONCERN OPTIONS
.TS
center;
|l|l|l|.
_
T{
Constant
T}	T{
Key
T}	T{
Description
T}
_
T{
MONGOC_URI_W
T}	T{
w
T}	T{
Determines the write concern (guarantee). Valid values:
.INDENT 0.0
.IP \(bu 2
0 = The driver will not acknowledge write operations but will pass or handle any network and socket errors that it receives to the client. If you disable write concern but enable the getLastError command’s w option, w overrides the w option.
.IP \(bu 2
1 = Provides basic acknowledgement of write operations. By specifying 1, you require that a standalone mongod instance, or the primary for replica sets, acknowledge all write operations. For drivers released after the default write concern change, this is the default write concern setting.
.IP \(bu 2
majority = For replica sets, if you specify the special majority value to w option, write operations will only return successfully after a majority of the configured replica set members have acknowledged the write operation.
.IP \(bu 2
n = For replica sets, if you specify a number n greater than 1, operations with this write concern return only after n members of the set have acknowledged the write. If you set n to a number that is greater than the number of available set members or members that hold data, MongoDB will wait, potentially indefinitely, for these members to become available.
.IP \(bu 2
tags = For replica sets, you can specify a tag set to require that all members of the set that have these tags configured return confirmation of the write operation.
.UNINDENT
T}
_
T{
MONGOC_URI_WTIMEOUTMS
T}	T{
wtimeoutms
T}	T{
The time in milliseconds to wait for replication to succeed, as specified in the w option, before timing out. When wtimeoutMS is 0, write operations will never time out.
T}
_
T{
MONGOC_URI_JOURNAL
T}	T{
journal
T}	T{
Controls whether write operations will wait until the mongod acknowledges the write operations and commits the data to the on disk journal.
.INDENT 0.0
.IP \(bu 2
true  = Enables journal commit acknowledgement write concern. Equivalent to specifying the getLastError command with the j option enabled.
.IP \(bu 2
false = Does not require that mongod commit write operations to the journal before acknowledging the write operation. This is the default option for the journal parameter.
.UNINDENT
T}
_
.TE
.SH READ CONCERN OPTIONS
.TS
center;
|l|l|l|.
_
T{
Constant
T}	T{
Key
T}	T{
Description
T}
_
T{
MONGOC_URI_READCONCERNLEVEL
T}	T{
readconcernlevel
T}	T{
The level of isolation for read operations. If the level is left unspecified, the server default will be used. See \fI\%readConcern in the MongoDB Manual\fP for details.
T}
_
.TE
.SH READ PREFERENCE OPTIONS
.sp
When connected to a replica set, the driver chooses which member to query using the read preference:
.INDENT 0.0
.IP 1. 3
Choose members whose type matches \(dqreadPreference\(dq.
.IP 2. 3
From these, if there are any tags sets configured, choose members matching the first tag set. If there are none, fall back to the next tag set and so on, until some members are chosen or the tag sets are exhausted.
.IP 3. 3
From the chosen servers, distribute queries randomly among the server with the fastest round\-trip times. These include the server with the fastest time and any whose round\-trip time is no more than \(dqlocalThresholdMS\(dq slower.
.UNINDENT
.TS
center;
|l|l|l|.
_
T{
Constant
T}	T{
Key
T}	T{
Description
T}
_
T{
MONGOC_URI_READPREFERENCE
T}	T{
readpreference
T}	T{
Specifies the replica set read preference for this connection. This setting overrides any secondaryOk value. The read preference values are the following:
.INDENT 0.0
.IP \(bu 2
primary (default)
.IP \(bu 2
primaryPreferred
.IP \(bu 2
secondary
.IP \(bu 2
secondaryPreferred
.IP \(bu 2
nearest
.UNINDENT
T}
_
T{
MONGOC_URI_READPREFERENCETAGS
T}	T{
readpreferencetags
T}	T{
A representation of a tag set. See also \fI\%Tag Sets\fP\&.
T}
_
T{
MONGOC_URI_LOCALTHRESHOLDMS
T}	T{
localthresholdms
T}	T{
How far to distribute queries, beyond the server with the fastest round\-trip time. By default, only servers within 15ms of the fastest round\-trip time receive queries.
T}
_
T{
MONGOC_URI_MAXSTALENESSSECONDS
T}	T{
maxstalenessseconds
T}	T{
The maximum replication lag, in wall clock time, that a secondary can suffer and still be eligible. The smallest allowed value for maxStalenessSeconds is 90 seconds.
T}
_
.TE
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
When connecting to more than one mongos, libmongoc\(aqs localThresholdMS applies only to the selection of mongos servers. The threshold for selecting among replica set members in shards is controlled by the \fI\%mongos\(aqs localThreshold command line option\fP\&.
.UNINDENT
.UNINDENT
.SH LEGACY OPTIONS
.sp
For historical reasons, the following options are available. They should however not be used.
.TS
center;
|l|l|l|.
_
T{
Constant
T}	T{
Key
T}	T{
Description
T}
_
T{
MONGOC_URI_SAFE
T}	T{
safe
T}	T{
{true|false} Same as w={1|0}
T}
_
.TE
.SH AUTHOR
MongoDB, Inc
.SH COPYRIGHT
2017-present, MongoDB, Inc
.\" Generated by docutils manpage writer.
.