pub struct OrbOptions {Show 22 fields
pub max_giop_version: Version,
pub byte_order: ByteOrder,
pub connect_timeout: Option<Duration>,
pub request_timeout: Option<Duration>,
pub max_message_size: usize,
pub max_forwards: u32,
pub init_refs: HashMap<String, String>,
pub default_init_ref: Option<String>,
pub io_threads: usize,
pub endpoints: Vec<EndpointAddr>,
pub endpoint_publish: Option<EndpointAddr>,
pub min_server_threads: usize,
pub max_server_threads: usize,
pub server_thread_idle_timeout: Duration,
pub follow_linger: Duration,
pub follow_limit: usize,
pub max_requests_per_connection: usize,
pub socket_send_buffer: Option<usize>,
pub socket_receive_buffer: Option<usize>,
pub tls_endpoints: Vec<EndpointAddr>,
pub tls_endpoint_publish: Option<EndpointAddr>,
pub tls: TlsOptions,
}Expand description
Settings of an Orb.
Fields§
§max_giop_version: VersionThe highest GIOP version used for requests. A request uses the lower of this and the version of the target’s IIOP profile.
byte_order: ByteOrderByte order of the messages rustorb sends.
connect_timeout: Option<Duration>How long to wait for a TCP connection; None waits until the call
timeout expires, or as long as the operating system does. Expiry
raises TIMEOUT, completed no. The initial value of
Orb::set_connect_timeout.
request_timeout: Option<Duration>How long to wait for a reply; None waits forever. Expiry raises
TIMEOUT, completed maybe. The initial value of
Orb::set_call_timeout; see there for the timeouts that override
it.
max_message_size: usizeLargest message accepted from a server, fragments joined.
max_forwards: u32How many LOCATION_FORWARD replies one invocation follows before
it gives up with TRANSIENT.
init_refs: HashMap<String, String>Initial references by name (-ORBInitRef Name=URL).
default_init_ref: Option<String>Base URL for initial references not in init_refs
(-ORBDefaultInitRef URL); the name is appended after a /.
io_threads: usizeNumber of tokio worker threads for network I/O.
endpoints: Vec<EndpointAddr>Addresses to listen on for requests (-ORBendPoint giop:tcp:HOST:PORT).
Empty means one endpoint on every interface with a port the
operating system chooses. The server side starts listening when the
RootPOA is first used.
endpoint_publish: Option<EndpointAddr>Address published in IORs instead of the listening one
(-ORBendPointPublish giop:tcp:HOST:PORT); a port of 0 keeps the
listening port.
min_server_threads: usizeUpcall threads kept running even when idle.
max_server_threads: usizeMost upcall threads running at once (-ORBmaxServerThreadPoolSize).
Requests beyond that wait in a queue.
server_thread_idle_timeout: DurationHow long an upcall thread beyond min_server_threads waits for work
before it ends.
follow_linger: DurationHow long an upcall thread that answered a request waits for the
next request of the same connection, to read and run it itself
(-ORBfollowLinger US, in microseconds; docs/read-ownership.md).
Zero turns this off: the I/O task reads every request.
follow_limit: usizeHow many requests of one connection an upcall thread reads in a
row before it lets the I/O task read again (-ORBfollowLimit N).
Zero turns this off.
max_requests_per_connection: usizeRequests of one connection that may wait or run at once. Beyond that the connection is not read until one completes.
socket_send_buffer: Option<usize>The socket send buffer of each connection (SO_SNDBUF), client and
server; None leaves the operating system’s default (which on
Linux grows as needed).
socket_receive_buffer: Option<usize>The socket receive buffer of each connection (SO_RCVBUF); None
leaves the operating system’s default.
tls_endpoints: Vec<EndpointAddr>Addresses to listen on for requests over TLS (SSLIOP,
-ORBendPoint giop:ssl:HOST:PORT). Published in the
TAG_SSL_SEC_TRANS component of IORs; with TLS endpoints and none
in endpoints, the ORB has no unprotected
endpoint. Needs tls with a key file.
tls_endpoint_publish: Option<EndpointAddr>Address published for the first TLS endpoint instead of the
listening one (-ORBendPointPublish giop:ssl:HOST:PORT).
tls: TlsOptionsCertificates, key and checks of TLS connections, client and server.
Implementations§
Source§impl OrbOptions
impl OrbOptions
Sourcepub fn parse_args(
&mut self,
args: &mut Vec<String>,
) -> Result<(), SystemException>
pub fn parse_args( &mut self, args: &mut Vec<String>, ) -> Result<(), SystemException>
Reads ORB options from command line arguments and removes them,
like CORBA::ORB_init. Other arguments are left in place.
| Option | Setting |
|---|---|
-ORBInitRef Name=URL | init_refs |
-ORBDefaultInitRef URL | default_init_ref |
-ORBmaxGIOPVersion 1.1 | max_giop_version |
-ORBclientConnectTimeOutPeriod MS | connect_timeout (0 for none) |
-ORBclientCallTimeOutPeriod MS | request_timeout (0 for none) |
-ORBsupportPerThreadTimeOut 0|1 | accepted and ignored: per-thread timeouts always work |
-ORBendPoint giop:tcp:HOST:PORT | endpoints (repeatable) |
-ORBendPointPublish giop:tcp:HOST:PORT | endpoint_publish (all(addr) for the default) |
-ORBmaxServerThreadPoolSize N | max_server_threads |
-ORBfollowLinger US | follow_linger, in microseconds |
-ORBfollowLimit N | follow_limit |
-ORBendPoint giop:ssl:HOST:PORT | tls_endpoints (repeatable) |
-ORBendPointPublish giop:ssl:HOST:PORT | tls_endpoint_publish |
-ORBsslCAFile PATH | TlsOptions::ca_file |
-ORBsslCertFile PATH | TlsOptions::cert_file |
-ORBsslKeyFile PATH | TlsOptions::key_file |
-ORBsslVerifyClient none|optional|required | TlsOptions::client_auth |
-ORBsslVerifyHost 0|1 | TlsOptions::verify_host |
The value may also follow the option name after =, as in
-ORBmaxGIOPVersion=1.1.