summaryrefslogtreecommitdiff
path: root/bindings/bindings.rs
diff options
context:
space:
mode:
Diffstat (limited to 'bindings/bindings.rs')
-rw-r--r--bindings/bindings.rs4209
1 files changed, 4209 insertions, 0 deletions
diff --git a/bindings/bindings.rs b/bindings/bindings.rs
new file mode 100644
index 00000000..8081114f
--- /dev/null
+++ b/bindings/bindings.rs
@@ -0,0 +1,4209 @@
+pub const GRPC_ARES: u32 = 1;
+pub const GRPC_IF_NAMETOINDEX: u32 = 1;
+pub const GRPC_ALLOW_EXCEPTIONS: u32 = 1;
+pub const GRPC_COMPRESSION_REQUEST_ALGORITHM_MD_KEY: &[u8; 31usize] =
+ b"grpc-internal-encoding-request\0";
+pub const GRPC_COMPRESSION_CHANNEL_DEFAULT_ALGORITHM: &[u8; 35usize] =
+ b"grpc.default_compression_algorithm\0";
+pub const GRPC_COMPRESSION_CHANNEL_DEFAULT_LEVEL: &[u8; 31usize] =
+ b"grpc.default_compression_level\0";
+pub const GRPC_COMPRESSION_CHANNEL_ENABLED_ALGORITHMS_BITSET: &[u8; 43usize] =
+ b"grpc.compression_enabled_algorithms_bitset\0";
+pub const GRPC_ALLOW_GPR_SLICE_FUNCTIONS: u32 = 1;
+pub const GRPC_SLICE_BUFFER_INLINE_ELEMENTS: u32 = 8;
+pub const GRPC_ARG_ENABLE_CENSUS: &[u8; 12usize] = b"grpc.census\0";
+pub const GRPC_ARG_ENABLE_LOAD_REPORTING: &[u8; 19usize] = b"grpc.loadreporting\0";
+pub const GRPC_ARG_MINIMAL_STACK: &[u8; 19usize] = b"grpc.minimal_stack\0";
+pub const GRPC_ARG_MAX_CONCURRENT_STREAMS: &[u8; 28usize] = b"grpc.max_concurrent_streams\0";
+pub const GRPC_ARG_MAX_RECEIVE_MESSAGE_LENGTH: &[u8; 32usize] =
+ b"grpc.max_receive_message_length\0";
+pub const GRPC_ARG_MAX_MESSAGE_LENGTH: &[u8; 32usize] = b"grpc.max_receive_message_length\0";
+pub const GRPC_ARG_MAX_SEND_MESSAGE_LENGTH: &[u8; 29usize] = b"grpc.max_send_message_length\0";
+pub const GRPC_ARG_MAX_CONNECTION_IDLE_MS: &[u8; 28usize] = b"grpc.max_connection_idle_ms\0";
+pub const GRPC_ARG_MAX_CONNECTION_AGE_MS: &[u8; 27usize] = b"grpc.max_connection_age_ms\0";
+pub const GRPC_ARG_MAX_CONNECTION_AGE_GRACE_MS: &[u8; 33usize] =
+ b"grpc.max_connection_age_grace_ms\0";
+pub const GRPC_ARG_CLIENT_IDLE_TIMEOUT_MS: &[u8; 28usize] = b"grpc.client_idle_timeout_ms\0";
+pub const GRPC_ARG_ENABLE_PER_MESSAGE_COMPRESSION: &[u8; 29usize] =
+ b"grpc.per_message_compression\0";
+pub const GRPC_ARG_ENABLE_PER_MESSAGE_DECOMPRESSION: &[u8; 31usize] =
+ b"grpc.per_message_decompression\0";
+pub const GRPC_ARG_ENABLE_DEADLINE_CHECKS: &[u8; 30usize] = b"grpc.enable_deadline_checking\0";
+pub const GRPC_ARG_HTTP2_INITIAL_SEQUENCE_NUMBER: &[u8; 35usize] =
+ b"grpc.http2.initial_sequence_number\0";
+pub const GRPC_ARG_HTTP2_STREAM_LOOKAHEAD_BYTES: &[u8; 27usize] = b"grpc.http2.lookahead_bytes\0";
+pub const GRPC_ARG_HTTP2_HPACK_TABLE_SIZE_DECODER: &[u8; 36usize] =
+ b"grpc.http2.hpack_table_size.decoder\0";
+pub const GRPC_ARG_HTTP2_HPACK_TABLE_SIZE_ENCODER: &[u8; 36usize] =
+ b"grpc.http2.hpack_table_size.encoder\0";
+pub const GRPC_ARG_HTTP2_MAX_FRAME_SIZE: &[u8; 26usize] = b"grpc.http2.max_frame_size\0";
+pub const GRPC_ARG_HTTP2_BDP_PROBE: &[u8; 21usize] = b"grpc.http2.bdp_probe\0";
+pub const GRPC_ARG_HTTP2_MIN_SENT_PING_INTERVAL_WITHOUT_DATA_MS: &[u8; 37usize] =
+ b"grpc.http2.min_time_between_pings_ms\0";
+pub const GRPC_ARG_HTTP2_MIN_RECV_PING_INTERVAL_WITHOUT_DATA_MS: &[u8; 45usize] =
+ b"grpc.http2.min_ping_interval_without_data_ms\0";
+pub const GRPC_ARG_HTTP2_SCHEME: &[u8; 18usize] = b"grpc.http2_scheme\0";
+pub const GRPC_ARG_HTTP2_MAX_PINGS_WITHOUT_DATA: &[u8; 34usize] =
+ b"grpc.http2.max_pings_without_data\0";
+pub const GRPC_ARG_HTTP2_MAX_PING_STRIKES: &[u8; 28usize] = b"grpc.http2.max_ping_strikes\0";
+pub const GRPC_ARG_HTTP2_WRITE_BUFFER_SIZE: &[u8; 29usize] = b"grpc.http2.write_buffer_size\0";
+pub const GRPC_ARG_HTTP2_ENABLE_TRUE_BINARY: &[u8; 23usize] = b"grpc.http2.true_binary\0";
+pub const GRPC_ARG_KEEPALIVE_TIME_MS: &[u8; 23usize] = b"grpc.keepalive_time_ms\0";
+pub const GRPC_ARG_KEEPALIVE_TIMEOUT_MS: &[u8; 26usize] = b"grpc.keepalive_timeout_ms\0";
+pub const GRPC_ARG_KEEPALIVE_PERMIT_WITHOUT_CALLS: &[u8; 36usize] =
+ b"grpc.keepalive_permit_without_calls\0";
+pub const GRPC_ARG_DEFAULT_AUTHORITY: &[u8; 23usize] = b"grpc.default_authority\0";
+pub const GRPC_ARG_PRIMARY_USER_AGENT_STRING: &[u8; 24usize] = b"grpc.primary_user_agent\0";
+pub const GRPC_ARG_SECONDARY_USER_AGENT_STRING: &[u8; 26usize] = b"grpc.secondary_user_agent\0";
+pub const GRPC_ARG_MIN_RECONNECT_BACKOFF_MS: &[u8; 30usize] = b"grpc.min_reconnect_backoff_ms\0";
+pub const GRPC_ARG_MAX_RECONNECT_BACKOFF_MS: &[u8; 30usize] = b"grpc.max_reconnect_backoff_ms\0";
+pub const GRPC_ARG_INITIAL_RECONNECT_BACKOFF_MS: &[u8; 34usize] =
+ b"grpc.initial_reconnect_backoff_ms\0";
+pub const GRPC_ARG_DNS_MIN_TIME_BETWEEN_RESOLUTIONS_MS: &[u8; 41usize] =
+ b"grpc.dns_min_time_between_resolutions_ms\0";
+pub const GRPC_ARG_SERVER_HANDSHAKE_TIMEOUT_MS: &[u8; 33usize] =
+ b"grpc.server_handshake_timeout_ms\0";
+pub const GRPC_SSL_TARGET_NAME_OVERRIDE_ARG: &[u8; 30usize] = b"grpc.ssl_target_name_override\0";
+pub const GRPC_SSL_SESSION_CACHE_ARG: &[u8; 23usize] = b"grpc.ssl_session_cache\0";
+pub const GRPC_ARG_TSI_MAX_FRAME_SIZE: &[u8; 24usize] = b"grpc.tsi.max_frame_size\0";
+pub const GRPC_ARG_MAX_METADATA_SIZE: &[u8; 23usize] = b"grpc.max_metadata_size\0";
+pub const GRPC_ARG_ALLOW_REUSEPORT: &[u8; 18usize] = b"grpc.so_reuseport\0";
+pub const GRPC_ARG_RESOURCE_QUOTA: &[u8; 20usize] = b"grpc.resource_quota\0";
+pub const GRPC_ARG_EXPAND_WILDCARD_ADDRS: &[u8; 27usize] = b"grpc.expand_wildcard_addrs\0";
+pub const GRPC_ARG_SERVICE_CONFIG: &[u8; 20usize] = b"grpc.service_config\0";
+pub const GRPC_ARG_SERVICE_CONFIG_DISABLE_RESOLUTION: &[u8; 39usize] =
+ b"grpc.service_config_disable_resolution\0";
+pub const GRPC_ARG_LB_POLICY_NAME: &[u8; 20usize] = b"grpc.lb_policy_name\0";
+pub const GRPC_ARG_SOCKET_MUTATOR: &[u8; 20usize] = b"grpc.socket_mutator\0";
+pub const GRPC_ARG_SOCKET_FACTORY: &[u8; 20usize] = b"grpc.socket_factory\0";
+pub const GRPC_ARG_GZIP_COMPRESSION_LEVEL: &[u8; 28usize] = b"grpc.gzip_compression_level\0";
+pub const GRPC_ARG_MIN_MESSAGE_SIZE_TO_COMPRESS: &[u8; 39usize] =
+ b"grpc.gprc_min_message_size_to_compress\0";
+pub const GRPC_ARG_MAX_CHANNEL_TRACE_EVENT_MEMORY_PER_NODE: &[u8; 45usize] =
+ b"grpc.max_channel_trace_event_memory_per_node\0";
+pub const GRPC_ARG_ENABLE_CHANNELZ: &[u8; 21usize] = b"grpc.enable_channelz\0";
+pub const GRPC_ARG_USE_CRONET_PACKET_COALESCING: &[u8; 34usize] =
+ b"grpc.use_cronet_packet_coalescing\0";
+pub const GRPC_ARG_TCP_READ_CHUNK_SIZE: &[u8; 38usize] = b"grpc.experimental.tcp_read_chunk_size\0";
+pub const GRPC_TCP_DEFAULT_READ_SLICE_SIZE: u32 = 8192;
+pub const GRPC_ARG_TCP_MIN_READ_CHUNK_SIZE: &[u8; 42usize] =
+ b"grpc.experimental.tcp_min_read_chunk_size\0";
+pub const GRPC_ARG_TCP_MAX_READ_CHUNK_SIZE: &[u8; 42usize] =
+ b"grpc.experimental.tcp_max_read_chunk_size\0";
+pub const GRPC_ARG_TCP_TX_ZEROCOPY_ENABLED: &[u8; 42usize] =
+ b"grpc.experimental.tcp_tx_zerocopy_enabled\0";
+pub const GRPC_ARG_TCP_TX_ZEROCOPY_SEND_BYTES_THRESHOLD: &[u8; 55usize] =
+ b"grpc.experimental.tcp_tx_zerocopy_send_bytes_threshold\0";
+pub const GRPC_ARG_TCP_TX_ZEROCOPY_MAX_SIMULT_SENDS: &[u8; 57usize] =
+ b"grpc.experimental.tcp_tx_zerocopy_max_simultaneous_sends\0";
+pub const GRPC_ARG_GRPCLB_CALL_TIMEOUT_MS: &[u8; 28usize] = b"grpc.grpclb_call_timeout_ms\0";
+pub const GRPC_ARG_TEST_ONLY_DO_NOT_USE_IN_PROD_XDS_BOOTSTRAP_CONFIG: &[u8; 55usize] =
+ b"grpc.TEST_ONLY_DO_NOT_USE_IN_PROD.xds_bootstrap_config\0";
+pub const GRPC_ARG_GRPCLB_FALLBACK_TIMEOUT_MS: &[u8; 32usize] =
+ b"grpc.grpclb_fallback_timeout_ms\0";
+pub const GRPC_ARG_PRIORITY_FAILOVER_TIMEOUT_MS: &[u8; 34usize] =
+ b"grpc.priority_failover_timeout_ms\0";
+pub const GRPC_ARG_WORKAROUND_CRONET_COMPRESSION: &[u8; 35usize] =
+ b"grpc.workaround.cronet_compression\0";
+pub const GRPC_ARG_OPTIMIZATION_TARGET: &[u8; 25usize] = b"grpc.optimization_target\0";
+pub const GRPC_ARG_ENABLE_RETRIES: &[u8; 20usize] = b"grpc.enable_retries\0";
+pub const GRPC_ARG_EXPERIMENTAL_ENABLE_HEDGING: &[u8; 33usize] =
+ b"grpc.experimental.enable_hedging\0";
+pub const GRPC_ARG_PER_RPC_RETRY_BUFFER_SIZE: &[u8; 31usize] = b"grpc.per_rpc_retry_buffer_size\0";
+pub const GRPC_ARG_MOBILE_LOG_CONTEXT: &[u8; 24usize] = b"grpc.mobile_log_context\0";
+pub const GRPC_ARG_DISABLE_CLIENT_AUTHORITY_FILTER: &[u8; 37usize] =
+ b"grpc.disable_client_authority_filter\0";
+pub const GRPC_ARG_ENABLE_HTTP_PROXY: &[u8; 23usize] = b"grpc.enable_http_proxy\0";
+pub const GRPC_ARG_HTTP_PROXY: &[u8; 16usize] = b"grpc.http_proxy\0";
+pub const GRPC_ARG_SURFACE_USER_AGENT: &[u8; 24usize] = b"grpc.surface_user_agent\0";
+pub const GRPC_ARG_INHIBIT_HEALTH_CHECKING: &[u8; 29usize] = b"grpc.inhibit_health_checking\0";
+pub const GRPC_ARG_DNS_ENABLE_SRV_QUERIES: &[u8; 28usize] = b"grpc.dns_enable_srv_queries\0";
+pub const GRPC_ARG_DNS_ARES_QUERY_TIMEOUT_MS: &[u8; 28usize] = b"grpc.dns_ares_query_timeout\0";
+pub const GRPC_ARG_USE_LOCAL_SUBCHANNEL_POOL: &[u8; 31usize] = b"grpc.use_local_subchannel_pool\0";
+pub const GRPC_ARG_CHANNEL_POOL_DOMAIN: &[u8; 28usize] = b"grpc.channel_pooling_domain\0";
+pub const GRPC_ARG_CHANNEL_ID: &[u8; 16usize] = b"grpc.channel_id\0";
+pub const GRPC_ARG_AUTHORIZATION_POLICY_PROVIDER: &[u8; 35usize] =
+ b"grpc.authorization_policy_provider\0";
+pub const GRPC_ARG_SERVER_CONFIG_CHANGE_DRAIN_GRACE_TIME_MS: &[u8; 59usize] =
+ b"grpc.experimental.server_config_change_drain_grace_time_ms\0";
+pub const GRPC_DEFAULT_MAX_SEND_MESSAGE_LENGTH: i32 = -1;
+pub const GRPC_DEFAULT_MAX_RECV_MESSAGE_LENGTH: u32 = 4194304;
+pub const GRPC_WRITE_BUFFER_HINT: u32 = 1;
+pub const GRPC_WRITE_NO_COMPRESS: u32 = 2;
+pub const GRPC_WRITE_THROUGH: u32 = 4;
+pub const GRPC_WRITE_USED_MASK: u32 = 7;
+pub const GRPC_INITIAL_METADATA_WAIT_FOR_READY: u32 = 32;
+pub const GRPC_INITIAL_METADATA_WAIT_FOR_READY_EXPLICITLY_SET: u32 = 128;
+pub const GRPC_INITIAL_METADATA_CORKED: u32 = 256;
+pub const GRPC_INITIAL_METADATA_USED_MASK: u32 = 420;
+pub const GRPC_CQ_CURRENT_VERSION: u32 = 2;
+pub const GRPC_CQ_VERSION_MINIMUM_FOR_CALLBACKABLE: u32 = 2;
+pub const GRPC_MAX_COMPLETION_QUEUE_PLUCKERS: u32 = 6;
+pub const GRPC_TRANSPORT_SECURITY_TYPE_PROPERTY_NAME: &[u8; 24usize] = b"transport_security_type\0";
+pub const GRPC_SSL_TRANSPORT_SECURITY_TYPE: &[u8; 4usize] = b"ssl\0";
+pub const GRPC_TLS_TRANSPORT_SECURITY_TYPE: &[u8; 4usize] = b"tls\0";
+pub const GRPC_X509_CN_PROPERTY_NAME: &[u8; 17usize] = b"x509_common_name\0";
+pub const GRPC_X509_SUBJECT_PROPERTY_NAME: &[u8; 13usize] = b"x509_subject\0";
+pub const GRPC_X509_SAN_PROPERTY_NAME: &[u8; 30usize] = b"x509_subject_alternative_name\0";
+pub const GRPC_X509_PEM_CERT_PROPERTY_NAME: &[u8; 14usize] = b"x509_pem_cert\0";
+pub const GRPC_X509_PEM_CERT_CHAIN_PROPERTY_NAME: &[u8; 20usize] = b"x509_pem_cert_chain\0";
+pub const GRPC_SSL_SESSION_REUSED_PROPERTY: &[u8; 19usize] = b"ssl_session_reused\0";
+pub const GRPC_TRANSPORT_SECURITY_LEVEL_PROPERTY_NAME: &[u8; 15usize] = b"security_level\0";
+pub const GRPC_PEER_DNS_PROPERTY_NAME: &[u8; 9usize] = b"peer_dns\0";
+pub const GRPC_PEER_SPIFFE_ID_PROPERTY_NAME: &[u8; 15usize] = b"peer_spiffe_id\0";
+pub const GRPC_PEER_URI_PROPERTY_NAME: &[u8; 9usize] = b"peer_uri\0";
+pub const GRPC_PEER_EMAIL_PROPERTY_NAME: &[u8; 11usize] = b"peer_email\0";
+pub const GRPC_PEER_IP_PROPERTY_NAME: &[u8; 8usize] = b"peer_ip\0";
+pub const GRPC_DEFAULT_SSL_ROOTS_FILE_PATH_ENV_VAR: &[u8; 33usize] =
+ b"GRPC_DEFAULT_SSL_ROOTS_FILE_PATH\0";
+pub const GRPC_GOOGLE_CREDENTIALS_ENV_VAR: &[u8; 31usize] = b"GOOGLE_APPLICATION_CREDENTIALS\0";
+pub const GRPC_METADATA_CREDENTIALS_PLUGIN_SYNC_MAX: u32 = 4;
+#[repr(u32)]
+#[doc = " The various compression algorithms supported by gRPC (not sorted by"]
+#[doc = " compression level)"]
+#[derive(Debug, Copy, Clone, Hash, PartialEq, Eq)]
+pub enum grpc_compression_algorithm {
+ GRPC_COMPRESS_NONE = 0,
+ GRPC_COMPRESS_DEFLATE = 1,
+ GRPC_COMPRESS_GZIP = 2,
+ GRPC_COMPRESS_ALGORITHMS_COUNT = 3,
+}
+#[repr(u32)]
+#[doc = " Compression levels allow a party with knowledge of its peer's accepted"]
+#[doc = " encodings to request compression in an abstract way. The level-algorithm"]
+#[doc = " mapping is performed internally and depends on the peer's supported"]
+#[doc = " compression algorithms."]
+#[derive(Debug, Copy, Clone, Hash, PartialEq, Eq)]
+pub enum grpc_compression_level {
+ GRPC_COMPRESS_LEVEL_NONE = 0,
+ GRPC_COMPRESS_LEVEL_LOW = 1,
+ GRPC_COMPRESS_LEVEL_MED = 2,
+ GRPC_COMPRESS_LEVEL_HIGH = 3,
+ GRPC_COMPRESS_LEVEL_COUNT = 4,
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_compression_options {
+ #[doc = " All algs are enabled by default. This option corresponds to the channel"]
+ #[doc = " argument key behind \\a GRPC_COMPRESSION_CHANNEL_ENABLED_ALGORITHMS_BITSET"]
+ pub enabled_algorithms_bitset: u32,
+ pub default_level: grpc_compression_options_grpc_compression_options_default_level,
+ pub default_algorithm: grpc_compression_options_grpc_compression_options_default_algorithm,
+}
+#[doc = " The default compression level. It'll be used in the absence of call"]
+#[doc = " specific settings. This option corresponds to the channel"]
+#[doc = " argument key behind \\a GRPC_COMPRESSION_CHANNEL_DEFAULT_LEVEL. If present,"]
+#[doc = " takes precedence over \\a default_algorithm."]
+#[doc = " TODO(dgq): currently only available for server channels."]
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_compression_options_grpc_compression_options_default_level {
+ pub is_set: ::std::os::raw::c_int,
+ pub level: grpc_compression_level,
+}
+#[doc = " The default message compression algorithm. It'll be used in the absence of"]
+#[doc = " call specific settings. This option corresponds to the channel argument key"]
+#[doc = " behind \\a GRPC_COMPRESSION_CHANNEL_DEFAULT_ALGORITHM."]
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_compression_options_grpc_compression_options_default_algorithm {
+ pub is_set: ::std::os::raw::c_int,
+ pub algorithm: grpc_compression_algorithm,
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_slice_refcount {
+ _unused: [u8; 0],
+}
+#[doc = " A grpc_slice s, if initialized, represents the byte range"]
+#[doc = "s.bytes[0..s.length-1]."]
+#[doc = ""]
+#[doc = "It can have an associated ref count which has a destruction routine to be run"]
+#[doc = "when the ref count reaches zero (see grpc_slice_new() and grp_slice_unref())."]
+#[doc = "Multiple grpc_slice values may share a ref count."]
+#[doc = ""]
+#[doc = "If the slice does not have a refcount, it represents an inlined small piece"]
+#[doc = "of data that is copied by value."]
+#[doc = ""]
+#[doc = "As a special case, a slice can be given refcount == uintptr_t(1), meaning"]
+#[doc = "that the slice represents external data that is not refcounted."]
+#[repr(C)]
+#[derive(Copy, Clone)]
+pub struct grpc_slice {
+ pub refcount: *mut grpc_slice_refcount,
+ pub data: grpc_slice_grpc_slice_data,
+}
+#[repr(C)]
+#[derive(Copy, Clone)]
+pub union grpc_slice_grpc_slice_data {
+ pub refcounted: grpc_slice_grpc_slice_data_grpc_slice_refcounted,
+ pub inlined: grpc_slice_grpc_slice_data_grpc_slice_inlined,
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_slice_grpc_slice_data_grpc_slice_refcounted {
+ pub length: usize,
+ pub bytes: *mut u8,
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_slice_grpc_slice_data_grpc_slice_inlined {
+ pub length: u8,
+ pub bytes: [u8; 23usize],
+}
+impl ::std::fmt::Debug for grpc_slice_grpc_slice_data {
+ fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
+ write!(f, "grpc_slice_grpc_slice_data {{ union }}")
+ }
+}
+impl ::std::fmt::Debug for grpc_slice {
+ fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
+ write!(
+ f,
+ "grpc_slice {{ refcount: {:?}, data: {:?} }}",
+ self.refcount, self.data
+ )
+ }
+}
+#[doc = " Represents an expandable array of slices, to be interpreted as a"]
+#[doc = "single item."]
+#[repr(C)]
+#[derive(Copy, Clone)]
+pub struct grpc_slice_buffer {
+ #[doc = " This is for internal use only. External users (i.e any code outside grpc"]
+ #[doc = " core) MUST NOT use this field"]
+ pub base_slices: *mut grpc_slice,
+ #[doc = " slices in the array (Points to the first valid grpc_slice in the array)"]
+ pub slices: *mut grpc_slice,
+ #[doc = " the number of slices in the array"]
+ pub count: usize,
+ #[doc = " the number of slices allocated in the array. External users (i.e any code"]
+ #[doc = " outside grpc core) MUST NOT use this field"]
+ pub capacity: usize,
+ #[doc = " the combined length of all slices in the array"]
+ pub length: usize,
+ #[doc = " inlined elements to avoid allocations"]
+ pub inlined: [grpc_slice; 8usize],
+}
+impl ::std::fmt::Debug for grpc_slice_buffer {
+ fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
+ write!(
+ f,
+ "grpc_slice_buffer {{ base_slices: {:?}, slices: {:?}, inlined: {:?} }}",
+ self.base_slices, self.slices, self.inlined
+ )
+ }
+}
+#[repr(u32)]
+#[doc = " The clocks we support."]
+#[derive(Debug, Copy, Clone, Hash, PartialEq, Eq)]
+pub enum gpr_clock_type {
+ #[doc = " Monotonic clock. Epoch undefined. Always moves forwards."]
+ GPR_CLOCK_MONOTONIC = 0,
+ #[doc = " Realtime clock. May jump forwards or backwards. Settable by"]
+ #[doc = "the system administrator. Has its epoch at 0:00:00 UTC 1 Jan 1970."]
+ GPR_CLOCK_REALTIME = 1,
+ #[doc = " CPU cycle time obtained by rdtsc instruction on x86 platforms. Epoch"]
+ #[doc = "undefined. Degrades to GPR_CLOCK_REALTIME on other platforms."]
+ GPR_CLOCK_PRECISE = 2,
+ #[doc = " Unmeasurable clock type: no base, created by taking the difference"]
+ #[doc = "between two times"]
+ GPR_TIMESPAN = 3,
+}
+#[doc = " Analogous to struct timespec. On some machines, absolute times may be in"]
+#[doc = " local time."]
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct gpr_timespec {
+ pub tv_sec: i64,
+ pub tv_nsec: i32,
+ #[doc = " Against which clock was this time measured? (or GPR_TIMESPAN if"]
+ #[doc = "this is a relative time measure)"]
+ pub clock_type: gpr_clock_type,
+}
+pub type gpr_atm = isize;
+extern "C" {
+ #[doc = " Adds \\a delta to \\a *value, clamping the result to the range specified"]
+ #[doc = "by \\a min and \\a max. Returns the new value."]
+ pub fn gpr_atm_no_barrier_clamped_add(
+ value: *mut gpr_atm,
+ delta: gpr_atm,
+ min: gpr_atm,
+ max: gpr_atm,
+ ) -> gpr_atm;
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct gpr_event {
+ pub state: gpr_atm,
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct gpr_refcount {
+ pub count: gpr_atm,
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct gpr_stats_counter {
+ pub value: gpr_atm,
+}
+extern "C" {
+ #[doc = " Initialize *ev."]
+ pub fn gpr_event_init(ev: *mut gpr_event);
+}
+extern "C" {
+ #[doc = " Set *ev so that gpr_event_get() and gpr_event_wait() will return value."]
+ #[doc = "Requires: *ev initialized; value != NULL; no prior or concurrent calls to"]
+ #[doc = "gpr_event_set(ev, ...) since initialization."]
+ pub fn gpr_event_set(ev: *mut gpr_event, value: *mut ::std::os::raw::c_void);
+}
+extern "C" {
+ #[doc = " Return the value set by gpr_event_set(ev, ...), or NULL if no such call has"]
+ #[doc = "completed. If the result is non-NULL, all operations that occurred prior to"]
+ #[doc = "the gpr_event_set(ev, ...) set will be visible after this call returns."]
+ #[doc = "Requires: *ev initialized. This operation is faster than acquiring a mutex"]
+ #[doc = "on most platforms."]
+ pub fn gpr_event_get(ev: *mut gpr_event) -> *mut ::std::os::raw::c_void;
+}
+extern "C" {
+ #[doc = " Wait until *ev is set by gpr_event_set(ev, ...), or abs_deadline is"]
+ #[doc = "exceeded, then return gpr_event_get(ev). Requires: *ev initialized. Use"]
+ #[doc = "abs_deadline==gpr_inf_future for no deadline. When the event has been"]
+ #[doc = "signalled before the call, this operation is faster than acquiring a mutex"]
+ #[doc = "on most platforms."]
+ pub fn gpr_event_wait(
+ ev: *mut gpr_event,
+ abs_deadline: gpr_timespec,
+ ) -> *mut ::std::os::raw::c_void;
+}
+extern "C" {
+ #[doc = " Initialize *r to value n."]
+ pub fn gpr_ref_init(r: *mut gpr_refcount, n: ::std::os::raw::c_int);
+}
+extern "C" {
+ #[doc = " Increment the reference count *r. Requires *r initialized."]
+ pub fn gpr_ref(r: *mut gpr_refcount);
+}
+extern "C" {
+ #[doc = " Increment the reference count *r. Requires *r initialized."]
+ #[doc = "Crashes if refcount is zero"]
+ pub fn gpr_ref_non_zero(r: *mut gpr_refcount);
+}
+extern "C" {
+ #[doc = " Increment the reference count *r by n. Requires *r initialized, n > 0."]
+ pub fn gpr_refn(r: *mut gpr_refcount, n: ::std::os::raw::c_int);
+}
+extern "C" {
+ #[doc = " Decrement the reference count *r and return non-zero iff it has reached"]
+ #[doc = "zero. . Requires *r initialized."]
+ pub fn gpr_unref(r: *mut gpr_refcount) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " Return non-zero iff the reference count of *r is one, and thus is owned"]
+ #[doc = "by exactly one object."]
+ pub fn gpr_ref_is_unique(r: *mut gpr_refcount) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " Initialize *c to the value n."]
+ pub fn gpr_stats_init(c: *mut gpr_stats_counter, n: isize);
+}
+extern "C" {
+ #[doc = " *c += inc. Requires: *c initialized."]
+ pub fn gpr_stats_inc(c: *mut gpr_stats_counter, inc: isize);
+}
+extern "C" {
+ #[doc = " Return *c. Requires: *c initialized."]
+ pub fn gpr_stats_read(c: *const gpr_stats_counter) -> isize;
+}
+extern "C" {
+ #[doc = " Increment the refcount of s. Requires slice is initialized."]
+ #[doc = "Returns s."]
+ pub fn grpc_slice_ref(s: grpc_slice) -> grpc_slice;
+}
+extern "C" {
+ #[doc = " Decrement the ref count of s. If the ref count of s reaches zero, all"]
+ #[doc = "slices sharing the ref count are destroyed, and considered no longer"]
+ #[doc = "initialized. If s is ultimately derived from a call to grpc_slice_new(start,"]
+ #[doc = "len, dest) where dest!=NULL , then (*dest)(start) is called, else if s is"]
+ #[doc = "ultimately derived from a call to grpc_slice_new_with_len(start, len, dest)"]
+ #[doc = "where dest!=NULL , then (*dest)(start, len). Requires s initialized."]
+ pub fn grpc_slice_unref(s: grpc_slice);
+}
+extern "C" {
+ #[doc = " Copy slice - create a new slice that contains the same data as s"]
+ pub fn grpc_slice_copy(s: grpc_slice) -> grpc_slice;
+}
+extern "C" {
+ #[doc = " Create a slice pointing at some data. Calls malloc to allocate a refcount"]
+ #[doc = "for the object, and arranges that destroy will be called with the pointer"]
+ #[doc = "passed in at destruction."]
+ pub fn grpc_slice_new(
+ p: *mut ::std::os::raw::c_void,
+ len: usize,
+ destroy: ::std::option::Option<unsafe extern "C" fn(arg1: *mut ::std::os::raw::c_void)>,
+ ) -> grpc_slice;
+}
+extern "C" {
+ #[doc = " Equivalent to grpc_slice_new, but with a separate pointer that is"]
+ #[doc = "passed to the destroy function. This function can be useful when"]
+ #[doc = "the data is part of a larger structure that must be destroyed when"]
+ #[doc = "the data is no longer needed."]
+ pub fn grpc_slice_new_with_user_data(
+ p: *mut ::std::os::raw::c_void,
+ len: usize,
+ destroy: ::std::option::Option<unsafe extern "C" fn(arg1: *mut ::std::os::raw::c_void)>,
+ user_data: *mut ::std::os::raw::c_void,
+ ) -> grpc_slice;
+}
+extern "C" {
+ #[doc = " Equivalent to grpc_slice_new, but with a two argument destroy function that"]
+ #[doc = "also takes the slice length."]
+ pub fn grpc_slice_new_with_len(
+ p: *mut ::std::os::raw::c_void,
+ len: usize,
+ destroy: ::std::option::Option<
+ unsafe extern "C" fn(arg1: *mut ::std::os::raw::c_void, arg2: usize),
+ >,
+ ) -> grpc_slice;
+}
+extern "C" {
+ #[doc = " Equivalent to grpc_slice_new(malloc(len), len, free), but saves one malloc()"]
+ #[doc = "call."]
+ #[doc = "Aborts if malloc() fails."]
+ pub fn grpc_slice_malloc(length: usize) -> grpc_slice;
+}
+extern "C" {
+ pub fn grpc_slice_malloc_large(length: usize) -> grpc_slice;
+}
+extern "C" {
+ #[doc = " Create a slice by copying a string."]
+ #[doc = "Does not preserve null terminators."]
+ #[doc = "Equivalent to:"]
+ #[doc = "size_t len = strlen(source);"]
+ #[doc = "grpc_slice slice = grpc_slice_malloc(len);"]
+ #[doc = "memcpy(slice->data, source, len);"]
+ pub fn grpc_slice_from_copied_string(source: *const ::std::os::raw::c_char) -> grpc_slice;
+}
+extern "C" {
+ #[doc = " Create a slice by copying a buffer."]
+ #[doc = "Equivalent to:"]
+ #[doc = "grpc_slice slice = grpc_slice_malloc(len);"]
+ #[doc = "memcpy(slice->data, source, len);"]
+ pub fn grpc_slice_from_copied_buffer(
+ source: *const ::std::os::raw::c_char,
+ len: usize,
+ ) -> grpc_slice;
+}
+extern "C" {
+ #[doc = " Create a slice pointing to constant memory"]
+ pub fn grpc_slice_from_static_string(source: *const ::std::os::raw::c_char) -> grpc_slice;
+}
+extern "C" {
+ #[doc = " Create a slice pointing to constant memory"]
+ pub fn grpc_slice_from_static_buffer(
+ source: *const ::std::os::raw::c_void,
+ len: usize,
+ ) -> grpc_slice;
+}
+extern "C" {
+ #[doc = " Return a result slice derived from s, which shares a ref count with \\a s,"]
+ #[doc = "where result.data==s.data+begin, and result.length==end-begin. The ref count"]
+ #[doc = "of \\a s is increased by one. Do not assign result back to \\a s."]
+ #[doc = "Requires s initialized, begin <= end, begin <= s.length, and"]
+ #[doc = "end <= source->length."]
+ pub fn grpc_slice_sub(s: grpc_slice, begin: usize, end: usize) -> grpc_slice;
+}
+extern "C" {
+ #[doc = " The same as grpc_slice_sub, but without altering the ref count"]
+ pub fn grpc_slice_sub_no_ref(s: grpc_slice, begin: usize, end: usize) -> grpc_slice;
+}
+extern "C" {
+ #[doc = " Splits s into two: modifies s to be s[0:split], and returns a new slice,"]
+ #[doc = "sharing a refcount with s, that contains s[split:s.length]."]
+ #[doc = "Requires s initialized, split <= s.length"]
+ pub fn grpc_slice_split_tail(s: *mut grpc_slice, split: usize) -> grpc_slice;
+}
+#[repr(u32)]
+#[derive(Debug, Copy, Clone, Hash, PartialEq, Eq)]
+pub enum grpc_slice_ref_whom {
+ GRPC_SLICE_REF_TAIL = 1,
+ GRPC_SLICE_REF_HEAD = 2,
+ GRPC_SLICE_REF_BOTH = 3,
+}
+extern "C" {
+ #[doc = " The same as grpc_slice_split_tail, but with an option to skip altering"]
+ #[doc = " refcounts (grpc_slice_split_tail_maybe_ref(..., true) is equivalent to"]
+ #[doc = " grpc_slice_split_tail(...))"]
+ pub fn grpc_slice_split_tail_maybe_ref(
+ s: *mut grpc_slice,
+ split: usize,
+ ref_whom: grpc_slice_ref_whom,
+ ) -> grpc_slice;
+}
+extern "C" {
+ #[doc = " Splits s into two: modifies s to be s[split:s.length], and returns a new"]
+ #[doc = "slice, sharing a refcount with s, that contains s[0:split]."]
+ #[doc = "Requires s initialized, split <= s.length"]
+ pub fn grpc_slice_split_head(s: *mut grpc_slice, split: usize) -> grpc_slice;
+}
+extern "C" {
+ pub fn grpc_empty_slice() -> grpc_slice;
+}
+extern "C" {
+ pub fn grpc_slice_eq(a: grpc_slice, b: grpc_slice) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " Returns <0 if a < b, ==0 if a == b, >0 if a > b"]
+ #[doc = "The order is arbitrary, and is not guaranteed to be stable across different"]
+ #[doc = "versions of the API."]
+ pub fn grpc_slice_cmp(a: grpc_slice, b: grpc_slice) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ pub fn grpc_slice_str_cmp(
+ a: grpc_slice,
+ b: *const ::std::os::raw::c_char,
+ ) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " return non-zero if the first blen bytes of a are equal to b"]
+ pub fn grpc_slice_buf_start_eq(
+ a: grpc_slice,
+ b: *const ::std::os::raw::c_void,
+ blen: usize,
+ ) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " return the index of the last instance of \\a c in \\a s, or -1 if not found"]
+ pub fn grpc_slice_rchr(s: grpc_slice, c: ::std::os::raw::c_char) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ pub fn grpc_slice_chr(s: grpc_slice, c: ::std::os::raw::c_char) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " return the index of the first occurrence of \\a needle in \\a haystack, or -1"]
+ #[doc = "if it's not found"]
+ pub fn grpc_slice_slice(haystack: grpc_slice, needle: grpc_slice) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " Do two slices point at the same memory, with the same length"]
+ #[doc = "If a or b is inlined, actually compares data"]
+ pub fn grpc_slice_is_equivalent(a: grpc_slice, b: grpc_slice) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " Return a slice pointing to newly allocated memory that has the same contents"]
+ #[doc = " as \\a s"]
+ pub fn grpc_slice_dup(a: grpc_slice) -> grpc_slice;
+}
+extern "C" {
+ #[doc = " Return a copy of slice as a C string. Offers no protection against embedded"]
+ #[doc = "NULL's. Returned string must be freed with gpr_free."]
+ pub fn grpc_slice_to_c_string(s: grpc_slice) -> *mut ::std::os::raw::c_char;
+}
+extern "C" {
+ #[doc = " Return if an algorithm is message compression algorithm."]
+ pub fn grpc_compression_algorithm_is_message(
+ algorithm: grpc_compression_algorithm,
+ ) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " Return if an algorithm is stream compression algorithm."]
+ pub fn grpc_compression_algorithm_is_stream(
+ algorithm: grpc_compression_algorithm,
+ ) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " Parses the \\a slice as a grpc_compression_algorithm instance and updating \\a"]
+ #[doc = " algorithm. Returns 1 upon success, 0 otherwise."]
+ pub fn grpc_compression_algorithm_parse(
+ name: grpc_slice,
+ algorithm: *mut grpc_compression_algorithm,
+ ) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " Updates \\a name with the encoding name corresponding to a valid \\a"]
+ #[doc = " algorithm. Note that \\a name is statically allocated and must *not* be freed."]
+ #[doc = " Returns 1 upon success, 0 otherwise."]
+ pub fn grpc_compression_algorithm_name(
+ algorithm: grpc_compression_algorithm,
+ name: *mut *const ::std::os::raw::c_char,
+ ) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " Returns the compression algorithm corresponding to \\a level for the"]
+ #[doc = " compression algorithms encoded in the \\a accepted_encodings bitset."]
+ pub fn grpc_compression_algorithm_for_level(
+ level: grpc_compression_level,
+ accepted_encodings: u32,
+ ) -> grpc_compression_algorithm;
+}
+extern "C" {
+ pub fn grpc_compression_options_init(opts: *mut grpc_compression_options);
+}
+extern "C" {
+ #[doc = " Mark \\a algorithm as enabled in \\a opts."]
+ pub fn grpc_compression_options_enable_algorithm(
+ opts: *mut grpc_compression_options,
+ algorithm: grpc_compression_algorithm,
+ );
+}
+extern "C" {
+ #[doc = " Mark \\a algorithm as disabled in \\a opts."]
+ pub fn grpc_compression_options_disable_algorithm(
+ opts: *mut grpc_compression_options,
+ algorithm: grpc_compression_algorithm,
+ );
+}
+extern "C" {
+ #[doc = " Returns true if \\a algorithm is marked as enabled in \\a opts."]
+ pub fn grpc_compression_options_is_algorithm_enabled(
+ opts: *const grpc_compression_options,
+ algorithm: grpc_compression_algorithm,
+ ) -> ::std::os::raw::c_int;
+}
+pub mod grpc_status_code {
+ pub type Type = ::std::os::raw::c_int;
+ #[doc = " Not an error; returned on success"]
+ pub const GRPC_STATUS_OK: Type = 0;
+ #[doc = " The operation was cancelled (typically by the caller)."]
+ pub const GRPC_STATUS_CANCELLED: Type = 1;
+ #[doc = " Unknown error. An example of where this error may be returned is"]
+ #[doc = "if a Status value received from another address space belongs to"]
+ #[doc = "an error-space that is not known in this address space. Also"]
+ #[doc = "errors raised by APIs that do not return enough error information"]
+ #[doc = "may be converted to this error."]
+ pub const GRPC_STATUS_UNKNOWN: Type = 2;
+ #[doc = " Client specified an invalid argument. Note that this differs"]
+ #[doc = "from FAILED_PRECONDITION. INVALID_ARGUMENT indicates arguments"]
+ #[doc = "that are problematic regardless of the state of the system"]
+ #[doc = "(e.g., a malformed file name)."]
+ pub const GRPC_STATUS_INVALID_ARGUMENT: Type = 3;
+ #[doc = " Deadline expired before operation could complete. For operations"]
+ #[doc = "that change the state of the system, this error may be returned"]
+ #[doc = "even if the operation has completed successfully. For example, a"]
+ #[doc = "successful response from a server could have been delayed long"]
+ #[doc = "enough for the deadline to expire."]
+ pub const GRPC_STATUS_DEADLINE_EXCEEDED: Type = 4;
+ #[doc = " Some requested entity (e.g., file or directory) was not found."]
+ pub const GRPC_STATUS_NOT_FOUND: Type = 5;
+ #[doc = " Some entity that we attempted to create (e.g., file or directory)"]
+ #[doc = "already exists."]
+ pub const GRPC_STATUS_ALREADY_EXISTS: Type = 6;
+ #[doc = " The caller does not have permission to execute the specified"]
+ #[doc = "operation. PERMISSION_DENIED must not be used for rejections"]
+ #[doc = "caused by exhausting some resource (use RESOURCE_EXHAUSTED"]
+ #[doc = "instead for those errors). PERMISSION_DENIED must not be"]
+ #[doc = "used if the caller can not be identified (use UNAUTHENTICATED"]
+ #[doc = "instead for those errors)."]
+ pub const GRPC_STATUS_PERMISSION_DENIED: Type = 7;
+ #[doc = " The request does not have valid authentication credentials for the"]
+ #[doc = "operation."]
+ pub const GRPC_STATUS_UNAUTHENTICATED: Type = 16;
+ #[doc = " Some resource has been exhausted, perhaps a per-user quota, or"]
+ #[doc = "perhaps the entire file system is out of space."]
+ pub const GRPC_STATUS_RESOURCE_EXHAUSTED: Type = 8;
+ #[doc = " Operation was rejected because the system is not in a state"]
+ #[doc = "required for the operation's execution. For example, directory"]
+ #[doc = "to be deleted may be non-empty, an rmdir operation is applied to"]
+ #[doc = "a non-directory, etc."]
+ #[doc = ""]
+ #[doc = "A litmus test that may help a service implementor in deciding"]
+ #[doc = "between FAILED_PRECONDITION, ABORTED, and UNAVAILABLE:"]
+ #[doc = "(a) Use UNAVAILABLE if the client can retry just the failing call."]
+ #[doc = "(b) Use ABORTED if the client should retry at a higher-level"]
+ #[doc = "(e.g., restarting a read-modify-write sequence)."]
+ #[doc = "(c) Use FAILED_PRECONDITION if the client should not retry until"]
+ #[doc = "the system state has been explicitly fixed. E.g., if an \"rmdir\""]
+ #[doc = "fails because the directory is non-empty, FAILED_PRECONDITION"]
+ #[doc = "should be returned since the client should not retry unless"]
+ #[doc = "they have first fixed up the directory by deleting files from it."]
+ #[doc = "(d) Use FAILED_PRECONDITION if the client performs conditional"]
+ #[doc = "REST Get/Update/Delete on a resource and the resource on the"]
+ #[doc = "server does not match the condition. E.g., conflicting"]
+ #[doc = "read-modify-write on the same resource."]
+ pub const GRPC_STATUS_FAILED_PRECONDITION: Type = 9;
+ #[doc = " The operation was aborted, typically due to a concurrency issue"]
+ #[doc = "like sequencer check failures, transaction aborts, etc."]
+ #[doc = ""]
+ #[doc = "See litmus test above for deciding between FAILED_PRECONDITION,"]
+ #[doc = "ABORTED, and UNAVAILABLE."]
+ pub const GRPC_STATUS_ABORTED: Type = 10;
+ #[doc = " Operation was attempted past the valid range. E.g., seeking or"]
+ #[doc = "reading past end of file."]
+ #[doc = ""]
+ #[doc = "Unlike INVALID_ARGUMENT, this error indicates a problem that may"]
+ #[doc = "be fixed if the system state changes. For example, a 32-bit file"]
+ #[doc = "system will generate INVALID_ARGUMENT if asked to read at an"]
+ #[doc = "offset that is not in the range [0,2^32-1], but it will generate"]
+ #[doc = "OUT_OF_RANGE if asked to read from an offset past the current"]
+ #[doc = "file size."]
+ #[doc = ""]
+ #[doc = "There is a fair bit of overlap between FAILED_PRECONDITION and"]
+ #[doc = "OUT_OF_RANGE. We recommend using OUT_OF_RANGE (the more specific"]
+ #[doc = "error) when it applies so that callers who are iterating through"]
+ #[doc = "a space can easily look for an OUT_OF_RANGE error to detect when"]
+ #[doc = "they are done."]
+ pub const GRPC_STATUS_OUT_OF_RANGE: Type = 11;
+ #[doc = " Operation is not implemented or not supported/enabled in this service."]
+ pub const GRPC_STATUS_UNIMPLEMENTED: Type = 12;
+ #[doc = " Internal errors. Means some invariants expected by underlying"]
+ #[doc = "system has been broken. If you see one of these errors,"]
+ #[doc = "something is very broken."]
+ pub const GRPC_STATUS_INTERNAL: Type = 13;
+ #[doc = " The service is currently unavailable. This is a most likely a"]
+ #[doc = "transient condition and may be corrected by retrying with"]
+ #[doc = "a backoff. Note that it is not always safe to retry non-idempotent"]
+ #[doc = "operations."]
+ #[doc = ""]
+ #[doc = "WARNING: Although data MIGHT not have been transmitted when this"]
+ #[doc = "status occurs, there is NOT A GUARANTEE that the server has not seen"]
+ #[doc = "anything. So in general it is unsafe to retry on this status code"]
+ #[doc = "if the call is non-idempotent."]
+ #[doc = ""]
+ #[doc = "See litmus test above for deciding between FAILED_PRECONDITION,"]
+ #[doc = "ABORTED, and UNAVAILABLE."]
+ pub const GRPC_STATUS_UNAVAILABLE: Type = 14;
+ #[doc = " Unrecoverable data loss or corruption."]
+ pub const GRPC_STATUS_DATA_LOSS: Type = 15;
+ #[doc = " Force users to include a default branch:"]
+ pub const GRPC_STATUS__DO_NOT_USE: Type = -1;
+}
+#[repr(u32)]
+#[derive(Debug, Copy, Clone, Hash, PartialEq, Eq)]
+pub enum grpc_byte_buffer_type {
+ GRPC_BB_RAW = 0,
+}
+#[repr(C)]
+#[derive(Copy, Clone)]
+pub struct grpc_byte_buffer {
+ pub reserved: *mut ::std::os::raw::c_void,
+ pub type_: grpc_byte_buffer_type,
+ pub data: grpc_byte_buffer_grpc_byte_buffer_data,
+}
+#[repr(C)]
+#[derive(Copy, Clone)]
+pub union grpc_byte_buffer_grpc_byte_buffer_data {
+ pub reserved: grpc_byte_buffer_grpc_byte_buffer_data__bindgen_ty_1,
+ pub raw: grpc_byte_buffer_grpc_byte_buffer_data_grpc_compressed_buffer,
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_byte_buffer_grpc_byte_buffer_data__bindgen_ty_1 {
+ pub reserved: [*mut ::std::os::raw::c_void; 8usize],
+}
+#[repr(C)]
+#[derive(Copy, Clone)]
+pub struct grpc_byte_buffer_grpc_byte_buffer_data_grpc_compressed_buffer {
+ pub compression: grpc_compression_algorithm,
+ pub slice_buffer: grpc_slice_buffer,
+}
+impl ::std::fmt::Debug for grpc_byte_buffer_grpc_byte_buffer_data_grpc_compressed_buffer {
+ fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
+ write ! (f , "grpc_byte_buffer_grpc_byte_buffer_data_grpc_compressed_buffer {{ compression: {:?}, slice_buffer: {:?} }}" , self . compression , self . slice_buffer)
+ }
+}
+impl ::std::fmt::Debug for grpc_byte_buffer_grpc_byte_buffer_data {
+ fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
+ write!(f, "grpc_byte_buffer_grpc_byte_buffer_data {{ union }}")
+ }
+}
+impl ::std::fmt::Debug for grpc_byte_buffer {
+ fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
+ write!(
+ f,
+ "grpc_byte_buffer {{ reserved: {:?}, type: {:?}, data: {:?} }}",
+ self.reserved, self.type_, self.data
+ )
+ }
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_completion_queue {
+ _unused: [u8; 0],
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_channel {
+ _unused: [u8; 0],
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_server {
+ _unused: [u8; 0],
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_call {
+ _unused: [u8; 0],
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_socket_mutator {
+ _unused: [u8; 0],
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_socket_factory {
+ _unused: [u8; 0],
+}
+#[repr(u32)]
+#[doc = " Type specifier for grpc_arg"]
+#[derive(Debug, Copy, Clone, Hash, PartialEq, Eq)]
+pub enum grpc_arg_type {
+ GRPC_ARG_STRING = 0,
+ GRPC_ARG_INTEGER = 1,
+ GRPC_ARG_POINTER = 2,
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_arg_pointer_vtable {
+ pub copy: ::std::option::Option<
+ unsafe extern "C" fn(p: *mut ::std::os::raw::c_void) -> *mut ::std::os::raw::c_void,
+ >,
+ pub destroy: ::std::option::Option<unsafe extern "C" fn(p: *mut ::std::os::raw::c_void)>,
+ pub cmp: ::std::option::Option<
+ unsafe extern "C" fn(
+ p: *mut ::std::os::raw::c_void,
+ q: *mut ::std::os::raw::c_void,
+ ) -> ::std::os::raw::c_int,
+ >,
+}
+#[doc = " A single argument... each argument has a key and a value"]
+#[doc = ""]
+#[doc = "A note on naming keys:"]
+#[doc = "Keys are namespaced into groups, usually grouped by library, and are"]
+#[doc = "keys for module XYZ are named XYZ.key1, XYZ.key2, etc. Module names must"]
+#[doc = "be restricted to the regex [A-Za-z][_A-Za-z0-9]{,15}."]
+#[doc = "Key names must be restricted to the regex [A-Za-z][_A-Za-z0-9]{,47}."]
+#[doc = ""]
+#[doc = "GRPC core library keys are prefixed by grpc."]
+#[doc = ""]
+#[doc = "Library authors are strongly encouraged to \\#define symbolic constants for"]
+#[doc = "their keys so that it's possible to change them in the future."]
+#[repr(C)]
+#[derive(Copy, Clone)]
+pub struct grpc_arg {
+ pub type_: grpc_arg_type,
+ pub key: *mut ::std::os::raw::c_char,
+ pub value: grpc_arg_grpc_arg_value,
+}
+#[repr(C)]
+#[derive(Copy, Clone)]
+pub union grpc_arg_grpc_arg_value {
+ pub string: *mut ::std::os::raw::c_char,
+ pub integer: ::std::os::raw::c_int,
+ pub pointer: grpc_arg_grpc_arg_value_grpc_arg_pointer,
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_arg_grpc_arg_value_grpc_arg_pointer {
+ pub p: *mut ::std::os::raw::c_void,
+ pub vtable: *const grpc_arg_pointer_vtable,
+}
+impl ::std::fmt::Debug for grpc_arg_grpc_arg_value {
+ fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
+ write!(f, "grpc_arg_grpc_arg_value {{ union }}")
+ }
+}
+impl ::std::fmt::Debug for grpc_arg {
+ fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
+ write!(
+ f,
+ "grpc_arg {{ type: {:?}, key: {:?}, value: {:?} }}",
+ self.type_, self.key, self.value
+ )
+ }
+}
+#[doc = " An array of arguments that can be passed around."]
+#[doc = ""]
+#[doc = "Used to set optional channel-level configuration."]
+#[doc = "These configuration options are modelled as key-value pairs as defined"]
+#[doc = "by grpc_arg; keys are strings to allow easy backwards-compatible extension"]
+#[doc = "by arbitrary parties. All evaluation is performed at channel creation"]
+#[doc = "time (i.e. the keys and values in this structure need only live through the"]
+#[doc = "creation invocation)."]
+#[doc = ""]
+#[doc = "However, if one of the args has grpc_arg_type==GRPC_ARG_POINTER, then the"]
+#[doc = "grpc_arg_pointer_vtable must live until the channel args are done being"]
+#[doc = "used by core (i.e. when the object for use with which they were passed"]
+#[doc = "is destroyed)."]
+#[doc = ""]
+#[doc = "See the description of the \\ref grpc_arg_keys \"available args\" for more"]
+#[doc = "details."]
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_channel_args {
+ pub num_args: usize,
+ pub args: *mut grpc_arg,
+}
+#[repr(u32)]
+#[doc = " Result of a grpc call. If the caller satisfies the prerequisites of a"]
+#[doc = "particular operation, the grpc_call_error returned will be GRPC_CALL_OK."]
+#[doc = "Receiving any other value listed here is an indication of a bug in the"]
+#[doc = "caller."]
+#[derive(Debug, Copy, Clone, Hash, PartialEq, Eq)]
+pub enum grpc_call_error {
+ #[doc = " everything went ok"]
+ GRPC_CALL_OK = 0,
+ #[doc = " something failed, we don't know what"]
+ GRPC_CALL_ERROR = 1,
+ #[doc = " this method is not available on the server"]
+ GRPC_CALL_ERROR_NOT_ON_SERVER = 2,
+ #[doc = " this method is not available on the client"]
+ GRPC_CALL_ERROR_NOT_ON_CLIENT = 3,
+ #[doc = " this method must be called before server_accept"]
+ GRPC_CALL_ERROR_ALREADY_ACCEPTED = 4,
+ #[doc = " this method must be called before invoke"]
+ GRPC_CALL_ERROR_ALREADY_INVOKED = 5,
+ #[doc = " this method must be called after invoke"]
+ GRPC_CALL_ERROR_NOT_INVOKED = 6,
+ #[doc = " this call is already finished"]
+ #[doc = "(writes_done or write_status has already been called)"]
+ GRPC_CALL_ERROR_ALREADY_FINISHED = 7,
+ #[doc = " there is already an outstanding read/write operation on the call"]
+ GRPC_CALL_ERROR_TOO_MANY_OPERATIONS = 8,
+ #[doc = " the flags value was illegal for this call"]
+ GRPC_CALL_ERROR_INVALID_FLAGS = 9,
+ #[doc = " invalid metadata was passed to this call"]
+ GRPC_CALL_ERROR_INVALID_METADATA = 10,
+ #[doc = " invalid message was passed to this call"]
+ GRPC_CALL_ERROR_INVALID_MESSAGE = 11,
+ #[doc = " completion queue for notification has not been registered"]
+ #[doc = " with the server"]
+ GRPC_CALL_ERROR_NOT_SERVER_COMPLETION_QUEUE = 12,
+ #[doc = " this batch of operations leads to more operations than allowed"]
+ GRPC_CALL_ERROR_BATCH_TOO_BIG = 13,
+ #[doc = " payload type requested is not the type registered"]
+ GRPC_CALL_ERROR_PAYLOAD_TYPE_MISMATCH = 14,
+ #[doc = " completion queue has been shutdown"]
+ GRPC_CALL_ERROR_COMPLETION_QUEUE_SHUTDOWN = 15,
+}
+#[doc = " A single metadata element"]
+#[repr(C)]
+#[derive(Copy, Clone)]
+pub struct grpc_metadata {
+ #[doc = " the key, value values are expected to line up with grpc_mdelem: if"]
+ #[doc = "changing them, update metadata.h at the same time."]
+ pub key: grpc_slice,
+ pub value: grpc_slice,
+ pub internal_data: grpc_metadata__bindgen_ty_1,
+}
+#[doc = " The following fields are reserved for grpc internal use."]
+#[doc = "There is no need to initialize them, and they will be set to garbage"]
+#[doc = "during calls to grpc."]
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_metadata__bindgen_ty_1 {
+ pub obfuscated: [*mut ::std::os::raw::c_void; 4usize],
+}
+impl ::std::fmt::Debug for grpc_metadata {
+ fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
+ write!(
+ f,
+ "grpc_metadata {{ key: {:?}, value: {:?}, internal_data: {:?} }}",
+ self.key, self.value, self.internal_data
+ )
+ }
+}
+#[repr(u32)]
+#[doc = " The type of completion (for grpc_event)"]
+#[derive(Debug, Copy, Clone, Hash, PartialEq, Eq)]
+pub enum grpc_completion_type {
+ #[doc = " Shutting down"]
+ GRPC_QUEUE_SHUTDOWN = 0,
+ #[doc = " No event before timeout"]
+ GRPC_QUEUE_TIMEOUT = 1,
+ #[doc = " Operation completion"]
+ GRPC_OP_COMPLETE = 2,
+}
+#[doc = " The result of an operation."]
+#[doc = ""]
+#[doc = "Returned by a completion queue when the operation started with tag."]
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_event {
+ #[doc = " The type of the completion."]
+ pub type_: grpc_completion_type,
+ #[doc = " If the grpc_completion_type is GRPC_OP_COMPLETE, this field indicates"]
+ #[doc = "whether the operation was successful or not; 0 in case of failure and"]
+ #[doc = "non-zero in case of success."]
+ #[doc = "If grpc_completion_type is GRPC_QUEUE_SHUTDOWN or GRPC_QUEUE_TIMEOUT, this"]
+ #[doc = "field is guaranteed to be 0"]
+ pub success: ::std::os::raw::c_int,
+ #[doc = " The tag passed to grpc_call_start_batch etc to start this operation."]
+ #[doc = "Only* GRPC_OP_COMPLETE has a tag. For all other grpc_completion_type"]
+ #[doc = "values, tag is uninitialized."]
+ pub tag: *mut ::std::os::raw::c_void,
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_metadata_array {
+ pub count: usize,
+ pub capacity: usize,
+ pub metadata: *mut grpc_metadata,
+}
+#[repr(C)]
+#[derive(Copy, Clone)]
+pub struct grpc_call_details {
+ pub method: grpc_slice,
+ pub host: grpc_slice,
+ pub deadline: gpr_timespec,
+ pub flags: u32,
+ pub reserved: *mut ::std::os::raw::c_void,
+}
+impl ::std::fmt::Debug for grpc_call_details {
+ fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
+ write!(
+ f,
+ "grpc_call_details {{ method: {:?}, host: {:?}, deadline: {:?}, reserved: {:?} }}",
+ self.method, self.host, self.deadline, self.reserved
+ )
+ }
+}
+#[repr(u32)]
+#[derive(Debug, Copy, Clone, Hash, PartialEq, Eq)]
+pub enum grpc_op_type {
+ #[doc = " Send initial metadata: one and only one instance MUST be sent for each"]
+ #[doc = "call, unless the call was cancelled - in which case this can be skipped."]
+ #[doc = "This op completes after all bytes of metadata have been accepted by"]
+ #[doc = "outgoing flow control."]
+ GRPC_OP_SEND_INITIAL_METADATA = 0,
+ #[doc = " Send a message: 0 or more of these operations can occur for each call."]
+ #[doc = "This op completes after all bytes for the message have been accepted by"]
+ #[doc = "outgoing flow control."]
+ GRPC_OP_SEND_MESSAGE = 1,
+ #[doc = " Send a close from the client: one and only one instance MUST be sent from"]
+ #[doc = "the client, unless the call was cancelled - in which case this can be"]
+ #[doc = "skipped. This op completes after all bytes for the call"]
+ #[doc = "(including the close) have passed outgoing flow control."]
+ GRPC_OP_SEND_CLOSE_FROM_CLIENT = 2,
+ #[doc = " Send status from the server: one and only one instance MUST be sent from"]
+ #[doc = "the server unless the call was cancelled - in which case this can be"]
+ #[doc = "skipped. This op completes after all bytes for the call"]
+ #[doc = "(including the status) have passed outgoing flow control."]
+ GRPC_OP_SEND_STATUS_FROM_SERVER = 3,
+ #[doc = " Receive initial metadata: one and only one MUST be made on the client,"]
+ #[doc = "must not be made on the server."]
+ #[doc = "This op completes after all initial metadata has been read from the"]
+ #[doc = "peer."]
+ GRPC_OP_RECV_INITIAL_METADATA = 4,
+ #[doc = " Receive a message: 0 or more of these operations can occur for each call."]
+ #[doc = "This op completes after all bytes of the received message have been"]
+ #[doc = "read, or after a half-close has been received on this call."]
+ GRPC_OP_RECV_MESSAGE = 5,
+ #[doc = " Receive status on the client: one and only one must be made on the client."]
+ #[doc = "This operation always succeeds, meaning ops paired with this operation"]
+ #[doc = "will also appear to succeed, even though they may not have. In that case"]
+ #[doc = "the status will indicate some failure."]
+ #[doc = "This op completes after all activity on the call has completed."]
+ GRPC_OP_RECV_STATUS_ON_CLIENT = 6,
+ #[doc = " Receive close on the server: one and only one must be made on the"]
+ #[doc = "server. This op completes after the close has been received by the"]
+ #[doc = "server. This operation always succeeds, meaning ops paired with"]
+ #[doc = "this operation will also appear to succeed, even though they may not"]
+ #[doc = "have."]
+ GRPC_OP_RECV_CLOSE_ON_SERVER = 7,
+}
+#[doc = " Operation data: one field for each op type (except SEND_CLOSE_FROM_CLIENT"]
+#[doc = "which has no arguments)"]
+#[repr(C)]
+#[derive(Copy, Clone)]
+pub struct grpc_op {
+ #[doc = " Operation type, as defined by grpc_op_type"]
+ pub op: grpc_op_type,
+ #[doc = " Write flags bitset for grpc_begin_messages"]
+ pub flags: u32,
+ #[doc = " Reserved for future usage"]
+ pub reserved: *mut ::std::os::raw::c_void,
+ pub data: grpc_op_grpc_op_data,
+}
+#[repr(C)]
+#[derive(Copy, Clone)]
+pub union grpc_op_grpc_op_data {
+ pub reserved: grpc_op_grpc_op_data__bindgen_ty_1,
+ pub send_initial_metadata: grpc_op_grpc_op_data_grpc_op_send_initial_metadata,
+ pub send_message: grpc_op_grpc_op_data_grpc_op_send_message,
+ pub send_status_from_server: grpc_op_grpc_op_data_grpc_op_send_status_from_server,
+ pub recv_initial_metadata: grpc_op_grpc_op_data_grpc_op_recv_initial_metadata,
+ pub recv_message: grpc_op_grpc_op_data_grpc_op_recv_message,
+ pub recv_status_on_client: grpc_op_grpc_op_data_grpc_op_recv_status_on_client,
+ pub recv_close_on_server: grpc_op_grpc_op_data_grpc_op_recv_close_on_server,
+}
+#[doc = " Reserved for future usage"]
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_op_grpc_op_data__bindgen_ty_1 {
+ pub reserved: [*mut ::std::os::raw::c_void; 8usize],
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_op_grpc_op_data_grpc_op_send_initial_metadata { pub count : usize , pub metadata : * mut grpc_metadata , pub maybe_compression_level : grpc_op_grpc_op_data_grpc_op_send_initial_metadata_grpc_op_send_initial_metadata_maybe_compression_level , }
+#[doc = " If \\a is_set, \\a compression_level will be used for the call."]
+#[doc = " Otherwise, \\a compression_level won't be considered"]
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_op_grpc_op_data_grpc_op_send_initial_metadata_grpc_op_send_initial_metadata_maybe_compression_level
+{
+ pub is_set: u8,
+ pub level: grpc_compression_level,
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_op_grpc_op_data_grpc_op_send_message {
+ #[doc = " This op takes ownership of the slices in send_message. After"]
+ #[doc = " a call completes, the contents of send_message are not guaranteed"]
+ #[doc = " and likely empty. The original owner should still call"]
+ #[doc = " grpc_byte_buffer_destroy() on this object however."]
+ pub send_message: *mut grpc_byte_buffer,
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_op_grpc_op_data_grpc_op_send_status_from_server {
+ pub trailing_metadata_count: usize,
+ pub trailing_metadata: *mut grpc_metadata,
+ pub status: grpc_status_code::Type,
+ #[doc = " optional: set to NULL if no details need sending, non-NULL if they do"]
+ #[doc = " pointer will not be retained past the start_batch call"]
+ pub status_details: *mut grpc_slice,
+}
+#[doc = " ownership of the array is with the caller, but ownership of the elements"]
+#[doc = "stays with the call object (ie key, value members are owned by the call"]
+#[doc = "object, recv_initial_metadata->array is owned by the caller)."]
+#[doc = "After the operation completes, call grpc_metadata_array_destroy on this"]
+#[doc = "value, or reuse it in a future op."]
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_op_grpc_op_data_grpc_op_recv_initial_metadata {
+ pub recv_initial_metadata: *mut grpc_metadata_array,
+}
+#[doc = " ownership of the byte buffer is moved to the caller; the caller must"]
+#[doc = "call grpc_byte_buffer_destroy on this value, or reuse it in a future op."]
+#[doc = "The returned byte buffer will be NULL if trailing metadata was"]
+#[doc = "received instead of a message."]
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_op_grpc_op_data_grpc_op_recv_message {
+ pub recv_message: *mut *mut grpc_byte_buffer,
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_op_grpc_op_data_grpc_op_recv_status_on_client {
+ #[doc = " ownership of the array is with the caller, but ownership of the"]
+ #[doc = "elements stays with the call object (ie key, value members are owned"]
+ #[doc = "by the call object, trailing_metadata->array is owned by the caller)."]
+ #[doc = "After the operation completes, call grpc_metadata_array_destroy on"]
+ #[doc = "this value, or reuse it in a future op."]
+ pub trailing_metadata: *mut grpc_metadata_array,
+ pub status: *mut grpc_status_code::Type,
+ pub status_details: *mut grpc_slice,
+ #[doc = " If this is not nullptr, it will be populated with the full fidelity"]
+ #[doc = " error string for debugging purposes. The application is responsible"]
+ #[doc = " for freeing the data by using gpr_free()."]
+ pub error_string: *mut *const ::std::os::raw::c_char,
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_op_grpc_op_data_grpc_op_recv_close_on_server {
+ #[doc = " out argument, set to 1 if the call failed at the server for"]
+ #[doc = "a reason other than a non-OK status (cancel, deadline"]
+ #[doc = "exceeded, network failure, etc.), 0 otherwise (RPC processing ran to"]
+ #[doc = "completion and was able to provide any status from the server)"]
+ pub cancelled: *mut ::std::os::raw::c_int,
+}
+impl ::std::fmt::Debug for grpc_op_grpc_op_data {
+ fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
+ write!(f, "grpc_op_grpc_op_data {{ union }}")
+ }
+}
+impl ::std::fmt::Debug for grpc_op {
+ fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
+ write!(
+ f,
+ "grpc_op {{ op: {:?}, reserved: {:?}, data: {:?} }}",
+ self.op, self.reserved, self.data
+ )
+ }
+}
+#[doc = " Information requested from the channel."]
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_channel_info {
+ #[doc = " If non-NULL, will be set to point to a string indicating the LB"]
+ #[doc = " policy name. Caller takes ownership."]
+ pub lb_policy_name: *mut *mut ::std::os::raw::c_char,
+ #[doc = " If non-NULL, will be set to point to a string containing the"]
+ #[doc = " service config used by the channel in JSON form."]
+ pub service_config_json: *mut *mut ::std::os::raw::c_char,
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_resource_quota {
+ _unused: [u8; 0],
+}
+#[repr(u32)]
+#[doc = " Completion queues internally MAY maintain a set of file descriptors in a"]
+#[doc = "structure called 'pollset'. This enum specifies if a completion queue has an"]
+#[doc = "associated pollset and any restrictions on the type of file descriptors that"]
+#[doc = "can be present in the pollset."]
+#[doc = ""]
+#[doc = "I/O progress can only be made when grpc_completion_queue_next() or"]
+#[doc = "grpc_completion_queue_pluck() are called on the completion queue (unless the"]
+#[doc = "grpc_cq_polling_type is GRPC_CQ_NON_POLLING) and hence it is very important"]
+#[doc = "to actively call these APIs"]
+#[derive(Debug, Copy, Clone, Hash, PartialEq, Eq)]
+pub enum grpc_cq_polling_type {
+ #[doc = " The completion queue will have an associated pollset and there is no"]
+ #[doc = "restriction on the type of file descriptors the pollset may contain"]
+ GRPC_CQ_DEFAULT_POLLING = 0,
+ #[doc = " Similar to GRPC_CQ_DEFAULT_POLLING except that the completion queues will"]
+ #[doc = "not contain any 'listening file descriptors' (i.e file descriptors used to"]
+ #[doc = "listen to incoming channels)"]
+ GRPC_CQ_NON_LISTENING = 1,
+ #[doc = " The completion queue will not have an associated pollset. Note that"]
+ #[doc = "grpc_completion_queue_next() or grpc_completion_queue_pluck() MUST still"]
+ #[doc = "be called to pop events from the completion queue; it is not required to"]
+ #[doc = "call them actively to make I/O progress"]
+ GRPC_CQ_NON_POLLING = 2,
+}
+#[repr(u32)]
+#[doc = " Specifies the type of APIs to use to pop events from the completion queue"]
+#[derive(Debug, Copy, Clone, Hash, PartialEq, Eq)]
+pub enum grpc_cq_completion_type {
+ #[doc = " Events are popped out by calling grpc_completion_queue_next() API ONLY"]
+ GRPC_CQ_NEXT = 0,
+ #[doc = " Events are popped out by calling grpc_completion_queue_pluck() API ONLY"]
+ GRPC_CQ_PLUCK = 1,
+ #[doc = " Events trigger a callback specified as the tag"]
+ GRPC_CQ_CALLBACK = 2,
+}
+#[doc = " Specifies an interface class to be used as a tag for callback-based"]
+#[doc = " completion queues. This can be used directly, as the first element of a"]
+#[doc = " struct in C, or as a base class in C++. Its \"run\" value should be assigned to"]
+#[doc = " some non-member function, such as a static method."]
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_completion_queue_functor {
+ #[doc = " The run member specifies a function that will be called when this"]
+ #[doc = "tag is extracted from the completion queue. Its arguments will be a"]
+ #[doc = "pointer to this functor and a boolean that indicates whether the"]
+ #[doc = "operation succeeded (non-zero) or failed (zero)"]
+ pub functor_run: ::std::option::Option<
+ unsafe extern "C" fn(arg1: *mut grpc_completion_queue_functor, arg2: ::std::os::raw::c_int),
+ >,
+ #[doc = " The inlineable member specifies whether this functor can be run inline."]
+ #[doc = "This should only be used for trivial internally-defined functors."]
+ pub inlineable: ::std::os::raw::c_int,
+ #[doc = " The following fields are not API. They are meant for internal use."]
+ pub internal_success: ::std::os::raw::c_int,
+ pub internal_next: *mut grpc_completion_queue_functor,
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_completion_queue_attributes {
+ #[doc = " The version number of this structure. More fields might be added to this"]
+ #[doc = "structure in future."]
+ pub version: ::std::os::raw::c_int,
+ #[doc = " Set to GRPC_CQ_CURRENT_VERSION"]
+ pub cq_completion_type: grpc_cq_completion_type,
+ pub cq_polling_type: grpc_cq_polling_type,
+ #[doc = " When creating a callbackable CQ, pass in a functor to get invoked when"]
+ #[doc = " shutdown is complete"]
+ pub cq_shutdown_cb: *mut grpc_completion_queue_functor,
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_completion_queue_factory {
+ _unused: [u8; 0],
+}
+extern "C" {
+ #[doc = " Returns a RAW byte buffer instance over the given slices (up to \\a nslices)."]
+ #[doc = ""]
+ #[doc = " Increases the reference count for all \\a slices processed. The user is"]
+ #[doc = " responsible for invoking grpc_byte_buffer_destroy on the returned instance."]
+ pub fn grpc_raw_byte_buffer_create(
+ slices: *mut grpc_slice,
+ nslices: usize,
+ ) -> *mut grpc_byte_buffer;
+}
+extern "C" {
+ #[doc = " Returns a *compressed* RAW byte buffer instance over the given slices (up to"]
+ #[doc = " \\a nslices). The \\a compression argument defines the compression algorithm"]
+ #[doc = " used to generate the data in \\a slices."]
+ #[doc = ""]
+ #[doc = " Increases the reference count for all \\a slices processed. The user is"]
+ #[doc = " responsible for invoking grpc_byte_buffer_destroy on the returned instance."]
+ pub fn grpc_raw_compressed_byte_buffer_create(
+ slices: *mut grpc_slice,
+ nslices: usize,
+ compression: grpc_compression_algorithm,
+ ) -> *mut grpc_byte_buffer;
+}
+extern "C" {
+ #[doc = " Copies input byte buffer \\a bb."]
+ #[doc = ""]
+ #[doc = " Increases the reference count of all the source slices. The user is"]
+ #[doc = " responsible for calling grpc_byte_buffer_destroy over the returned copy."]
+ pub fn grpc_byte_buffer_copy(bb: *mut grpc_byte_buffer) -> *mut grpc_byte_buffer;
+}
+extern "C" {
+ #[doc = " Returns the size of the given byte buffer, in bytes."]
+ pub fn grpc_byte_buffer_length(bb: *mut grpc_byte_buffer) -> usize;
+}
+extern "C" {
+ #[doc = " Destroys \\a byte_buffer deallocating all its memory."]
+ pub fn grpc_byte_buffer_destroy(bb: *mut grpc_byte_buffer);
+}
+extern "C" {
+ #[doc = " Initialize \\a reader to read over \\a buffer."]
+ #[doc = " Returns 1 upon success, 0 otherwise."]
+ pub fn grpc_byte_buffer_reader_init(
+ reader: *mut grpc_byte_buffer_reader,
+ buffer: *mut grpc_byte_buffer,
+ ) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " Cleanup and destroy \\a reader"]
+ pub fn grpc_byte_buffer_reader_destroy(reader: *mut grpc_byte_buffer_reader);
+}
+extern "C" {
+ #[doc = " Updates \\a slice with the next piece of data from from \\a reader and returns"]
+ #[doc = " 1. Returns 0 at the end of the stream. Caller is responsible for calling"]
+ #[doc = " grpc_slice_unref on the result."]
+ pub fn grpc_byte_buffer_reader_next(
+ reader: *mut grpc_byte_buffer_reader,
+ slice: *mut grpc_slice,
+ ) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - This function may be removed and changed, in the future."]
+ #[doc = ""]
+ #[doc = " Updates \\a slice with the next piece of data from from \\a reader and returns"]
+ #[doc = " 1. Returns 0 at the end of the stream. Caller is responsible for making sure"]
+ #[doc = " the slice pointer remains valid when accessed."]
+ #[doc = ""]
+ #[doc = " NOTE: Do not use this function unless the caller can guarantee that the"]
+ #[doc = " underlying grpc_byte_buffer outlasts the use of the slice. This is only"]
+ #[doc = " safe when the underlying grpc_byte_buffer remains immutable while slice"]
+ #[doc = " is being accessed."]
+ pub fn grpc_byte_buffer_reader_peek(
+ reader: *mut grpc_byte_buffer_reader,
+ slice: *mut *mut grpc_slice,
+ ) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " Merge all data from \\a reader into single slice"]
+ pub fn grpc_byte_buffer_reader_readall(reader: *mut grpc_byte_buffer_reader) -> grpc_slice;
+}
+extern "C" {
+ #[doc = " Returns a RAW byte buffer instance from the output of \\a reader."]
+ pub fn grpc_raw_byte_buffer_from_reader(
+ reader: *mut grpc_byte_buffer_reader,
+ ) -> *mut grpc_byte_buffer;
+}
+extern "C" {
+ #[doc = " initialize a slice buffer"]
+ pub fn grpc_slice_buffer_init(sb: *mut grpc_slice_buffer);
+}
+extern "C" {
+ #[doc = " destroy a slice buffer - unrefs any held elements"]
+ pub fn grpc_slice_buffer_destroy(sb: *mut grpc_slice_buffer);
+}
+extern "C" {
+ #[doc = " Add an element to a slice buffer - takes ownership of the slice."]
+ #[doc = "This function is allowed to concatenate the passed in slice to the end of"]
+ #[doc = "some other slice if desired by the slice buffer."]
+ pub fn grpc_slice_buffer_add(sb: *mut grpc_slice_buffer, slice: grpc_slice);
+}
+extern "C" {
+ #[doc = " add an element to a slice buffer - takes ownership of the slice and returns"]
+ #[doc = "the index of the slice."]
+ #[doc = "Guarantees that the slice will not be concatenated at the end of another"]
+ #[doc = "slice (i.e. the data for this slice will begin at the first byte of the"]
+ #[doc = "slice at the returned index in sb->slices)"]
+ #[doc = "The implementation MAY decide to concatenate data at the end of a small"]
+ #[doc = "slice added in this fashion."]
+ pub fn grpc_slice_buffer_add_indexed(sb: *mut grpc_slice_buffer, slice: grpc_slice) -> usize;
+}
+extern "C" {
+ pub fn grpc_slice_buffer_addn(sb: *mut grpc_slice_buffer, slices: *mut grpc_slice, n: usize);
+}
+extern "C" {
+ #[doc = " add a very small (less than 8 bytes) amount of data to the end of a slice"]
+ #[doc = "buffer: returns a pointer into which to add the data"]
+ pub fn grpc_slice_buffer_tiny_add(sb: *mut grpc_slice_buffer, len: usize) -> *mut u8;
+}
+extern "C" {
+ #[doc = " pop the last buffer, but don't unref it"]
+ pub fn grpc_slice_buffer_pop(sb: *mut grpc_slice_buffer);
+}
+extern "C" {
+ #[doc = " clear a slice buffer, unref all elements"]
+ pub fn grpc_slice_buffer_reset_and_unref(sb: *mut grpc_slice_buffer);
+}
+extern "C" {
+ #[doc = " swap the contents of two slice buffers"]
+ pub fn grpc_slice_buffer_swap(a: *mut grpc_slice_buffer, b: *mut grpc_slice_buffer);
+}
+extern "C" {
+ #[doc = " move all of the elements of src into dst"]
+ pub fn grpc_slice_buffer_move_into(src: *mut grpc_slice_buffer, dst: *mut grpc_slice_buffer);
+}
+extern "C" {
+ #[doc = " remove n bytes from the end of a slice buffer"]
+ pub fn grpc_slice_buffer_trim_end(
+ sb: *mut grpc_slice_buffer,
+ n: usize,
+ garbage: *mut grpc_slice_buffer,
+ );
+}
+extern "C" {
+ #[doc = " move the first n bytes of src into dst"]
+ pub fn grpc_slice_buffer_move_first(
+ src: *mut grpc_slice_buffer,
+ n: usize,
+ dst: *mut grpc_slice_buffer,
+ );
+}
+extern "C" {
+ #[doc = " move the first n bytes of src into dst without adding references"]
+ pub fn grpc_slice_buffer_move_first_no_ref(
+ src: *mut grpc_slice_buffer,
+ n: usize,
+ dst: *mut grpc_slice_buffer,
+ );
+}
+extern "C" {
+ #[doc = " move the first n bytes of src into dst (copying them)"]
+ pub fn grpc_slice_buffer_move_first_into_buffer(
+ src: *mut grpc_slice_buffer,
+ n: usize,
+ dst: *mut ::std::os::raw::c_void,
+ );
+}
+extern "C" {
+ #[doc = " take the first slice in the slice buffer"]
+ pub fn grpc_slice_buffer_take_first(sb: *mut grpc_slice_buffer) -> grpc_slice;
+}
+extern "C" {
+ #[doc = " undo the above with (a possibly different) \\a slice"]
+ pub fn grpc_slice_buffer_undo_take_first(sb: *mut grpc_slice_buffer, slice: grpc_slice);
+}
+#[repr(u32)]
+#[doc = " Connectivity state of a channel."]
+#[derive(Debug, Copy, Clone, Hash, PartialEq, Eq)]
+pub enum grpc_connectivity_state {
+ #[doc = " channel is idle"]
+ GRPC_CHANNEL_IDLE = 0,
+ #[doc = " channel is connecting"]
+ GRPC_CHANNEL_CONNECTING = 1,
+ #[doc = " channel is ready for work"]
+ GRPC_CHANNEL_READY = 2,
+ #[doc = " channel has seen a failure but expects to recover"]
+ GRPC_CHANNEL_TRANSIENT_FAILURE = 3,
+ #[doc = " channel has seen a failure that it cannot recover from"]
+ GRPC_CHANNEL_SHUTDOWN = 4,
+}
+extern "C" {
+ #[doc = " Time constants."]
+ pub fn gpr_time_0(type_: gpr_clock_type) -> gpr_timespec;
+}
+extern "C" {
+ #[doc = " The zero time interval."]
+ pub fn gpr_inf_future(type_: gpr_clock_type) -> gpr_timespec;
+}
+extern "C" {
+ #[doc = " The far future"]
+ pub fn gpr_inf_past(type_: gpr_clock_type) -> gpr_timespec;
+}
+extern "C" {
+ #[doc = " initialize time subsystem"]
+ pub fn gpr_time_init();
+}
+extern "C" {
+ #[doc = " Return the current time measured from the given clocks epoch."]
+ pub fn gpr_now(clock: gpr_clock_type) -> gpr_timespec;
+}
+extern "C" {
+ #[doc = " Convert a timespec from one clock to another"]
+ pub fn gpr_convert_clock_type(t: gpr_timespec, clock_type: gpr_clock_type) -> gpr_timespec;
+}
+extern "C" {
+ #[doc = " Return -ve, 0, or +ve according to whether a < b, a == b, or a > b"]
+ #[doc = "respectively."]
+ pub fn gpr_time_cmp(a: gpr_timespec, b: gpr_timespec) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ pub fn gpr_time_max(a: gpr_timespec, b: gpr_timespec) -> gpr_timespec;
+}
+extern "C" {
+ pub fn gpr_time_min(a: gpr_timespec, b: gpr_timespec) -> gpr_timespec;
+}
+extern "C" {
+ #[doc = " Add and subtract times. Calculations saturate at infinities."]
+ pub fn gpr_time_add(a: gpr_timespec, b: gpr_timespec) -> gpr_timespec;
+}
+extern "C" {
+ pub fn gpr_time_sub(a: gpr_timespec, b: gpr_timespec) -> gpr_timespec;
+}
+extern "C" {
+ #[doc = " Return a timespec representing a given number of time units. INT64_MIN is"]
+ #[doc = "interpreted as gpr_inf_past, and INT64_MAX as gpr_inf_future."]
+ pub fn gpr_time_from_micros(us: i64, clock_type: gpr_clock_type) -> gpr_timespec;
+}
+extern "C" {
+ pub fn gpr_time_from_nanos(ns: i64, clock_type: gpr_clock_type) -> gpr_timespec;
+}
+extern "C" {
+ pub fn gpr_time_from_millis(ms: i64, clock_type: gpr_clock_type) -> gpr_timespec;
+}
+extern "C" {
+ pub fn gpr_time_from_seconds(s: i64, clock_type: gpr_clock_type) -> gpr_timespec;
+}
+extern "C" {
+ pub fn gpr_time_from_minutes(m: i64, clock_type: gpr_clock_type) -> gpr_timespec;
+}
+extern "C" {
+ pub fn gpr_time_from_hours(h: i64, clock_type: gpr_clock_type) -> gpr_timespec;
+}
+extern "C" {
+ pub fn gpr_time_to_millis(timespec: gpr_timespec) -> i32;
+}
+extern "C" {
+ #[doc = " Return 1 if two times are equal or within threshold of each other,"]
+ #[doc = "0 otherwise"]
+ pub fn gpr_time_similar(
+ a: gpr_timespec,
+ b: gpr_timespec,
+ threshold: gpr_timespec,
+ ) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " Sleep until at least 'until' - an absolute timeout"]
+ pub fn gpr_sleep_until(until: gpr_timespec);
+}
+extern "C" {
+ pub fn gpr_timespec_to_micros(t: gpr_timespec) -> f64;
+}
+extern "C" {
+ #[doc = " \\mainpage GRPC Core"]
+ #[doc = ""]
+ #[doc = " The GRPC Core library is a low-level library designed to be wrapped by higher"]
+ #[doc = " level libraries. The top-level API is provided in grpc.h. Security related"]
+ #[doc = " functionality lives in grpc_security.h."]
+ pub fn grpc_metadata_array_init(array: *mut grpc_metadata_array);
+}
+extern "C" {
+ pub fn grpc_metadata_array_destroy(array: *mut grpc_metadata_array);
+}
+extern "C" {
+ pub fn grpc_call_details_init(details: *mut grpc_call_details);
+}
+extern "C" {
+ pub fn grpc_call_details_destroy(details: *mut grpc_call_details);
+}
+extern "C" {
+ #[doc = " Registers a plugin to be initialized and destroyed with the library."]
+ #[doc = ""]
+ #[doc = "The \\a init and \\a destroy functions will be invoked as part of"]
+ #[doc = "\\a grpc_init() and \\a grpc_shutdown(), respectively."]
+ #[doc = "Note that these functions can be invoked an arbitrary number of times"]
+ #[doc = "(and hence so will \\a init and \\a destroy)."]
+ #[doc = "It is safe to pass NULL to either argument. Plugins are destroyed in"]
+ #[doc = "the reverse order they were initialized."]
+ pub fn grpc_register_plugin(
+ init: ::std::option::Option<unsafe extern "C" fn()>,
+ destroy: ::std::option::Option<unsafe extern "C" fn()>,
+ );
+}
+extern "C" {
+ #[doc = " Initialize the grpc library."]
+ #[doc = ""]
+ #[doc = "After it's called, a matching invocation to grpc_shutdown() is expected."]
+ #[doc = ""]
+ #[doc = "It is not safe to call any other grpc functions before calling this."]
+ #[doc = "(To avoid overhead, little checking is done, and some things may work. We"]
+ #[doc = "do not warrant that they will continue to do so in future revisions of this"]
+ #[doc = "library)."]
+ pub fn grpc_init();
+}
+extern "C" {
+ #[doc = " Shut down the grpc library."]
+ #[doc = ""]
+ #[doc = "Before it's called, there should haven been a matching invocation to"]
+ #[doc = "grpc_init()."]
+ #[doc = ""]
+ #[doc = "The last call to grpc_shutdown will initiate cleaning up of grpc library"]
+ #[doc = "internals, which can happen in another thread. Once the clean-up is done,"]
+ #[doc = "no memory is used by grpc, nor are any instructions executing within the"]
+ #[doc = "grpc library. Prior to calling, all application owned grpc objects must"]
+ #[doc = "have been destroyed."]
+ pub fn grpc_shutdown();
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL. Returns 1 if the grpc library has been initialized."]
+ #[doc = "TODO(ericgribkoff) Decide if this should be promoted to non-experimental as"]
+ #[doc = "part of stabilizing the fork support API, as tracked in"]
+ #[doc = "https://github.com/grpc/grpc/issues/15334"]
+ pub fn grpc_is_initialized() -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " DEPRECATED. Recommend to use grpc_shutdown only"]
+ pub fn grpc_shutdown_blocking();
+}
+extern "C" {
+ #[doc = " Return a string representing the current version of grpc"]
+ pub fn grpc_version_string() -> *const ::std::os::raw::c_char;
+}
+extern "C" {
+ #[doc = " Return a string specifying what the 'g' in gRPC stands for"]
+ pub fn grpc_g_stands_for() -> *const ::std::os::raw::c_char;
+}
+extern "C" {
+ #[doc = " Returns the completion queue factory based on the attributes. MAY return a"]
+ #[doc = "NULL if no factory can be found"]
+ pub fn grpc_completion_queue_factory_lookup(
+ attributes: *const grpc_completion_queue_attributes,
+ ) -> *const grpc_completion_queue_factory;
+}
+extern "C" {
+ #[doc = " Helper function to create a completion queue with grpc_cq_completion_type"]
+ #[doc = "of GRPC_CQ_NEXT and grpc_cq_polling_type of GRPC_CQ_DEFAULT_POLLING"]
+ pub fn grpc_completion_queue_create_for_next(
+ reserved: *mut ::std::os::raw::c_void,
+ ) -> *mut grpc_completion_queue;
+}
+extern "C" {
+ #[doc = " Helper function to create a completion queue with grpc_cq_completion_type"]
+ #[doc = "of GRPC_CQ_PLUCK and grpc_cq_polling_type of GRPC_CQ_DEFAULT_POLLING"]
+ pub fn grpc_completion_queue_create_for_pluck(
+ reserved: *mut ::std::os::raw::c_void,
+ ) -> *mut grpc_completion_queue;
+}
+extern "C" {
+ #[doc = " Helper function to create a completion queue with grpc_cq_completion_type"]
+ #[doc = "of GRPC_CQ_CALLBACK and grpc_cq_polling_type of GRPC_CQ_DEFAULT_POLLING."]
+ #[doc = "This function is experimental."]
+ pub fn grpc_completion_queue_create_for_callback(
+ shutdown_callback: *mut grpc_completion_queue_functor,
+ reserved: *mut ::std::os::raw::c_void,
+ ) -> *mut grpc_completion_queue;
+}
+extern "C" {
+ #[doc = " Create a completion queue"]
+ pub fn grpc_completion_queue_create(
+ factory: *const grpc_completion_queue_factory,
+ attributes: *const grpc_completion_queue_attributes,
+ reserved: *mut ::std::os::raw::c_void,
+ ) -> *mut grpc_completion_queue;
+}
+extern "C" {
+ #[doc = " Blocks until an event is available, the completion queue is being shut down,"]
+ #[doc = "or deadline is reached."]
+ #[doc = ""]
+ #[doc = "Returns a grpc_event with type GRPC_QUEUE_TIMEOUT on timeout,"]
+ #[doc = "otherwise a grpc_event describing the event that occurred."]
+ #[doc = ""]
+ #[doc = "Callers must not call grpc_completion_queue_next and"]
+ #[doc = "grpc_completion_queue_pluck simultaneously on the same completion queue."]
+ pub fn grpc_completion_queue_next(
+ cq: *mut grpc_completion_queue,
+ deadline: gpr_timespec,
+ reserved: *mut ::std::os::raw::c_void,
+ ) -> grpc_event;
+}
+extern "C" {
+ #[doc = " Blocks until an event with tag 'tag' is available, the completion queue is"]
+ #[doc = "being shutdown or deadline is reached."]
+ #[doc = ""]
+ #[doc = "Returns a grpc_event with type GRPC_QUEUE_TIMEOUT on timeout,"]
+ #[doc = "otherwise a grpc_event describing the event that occurred."]
+ #[doc = ""]
+ #[doc = "Callers must not call grpc_completion_queue_next and"]
+ #[doc = "grpc_completion_queue_pluck simultaneously on the same completion queue."]
+ #[doc = ""]
+ #[doc = "Completion queues support a maximum of GRPC_MAX_COMPLETION_QUEUE_PLUCKERS"]
+ #[doc = "concurrently executing plucks at any time."]
+ pub fn grpc_completion_queue_pluck(
+ cq: *mut grpc_completion_queue,
+ tag: *mut ::std::os::raw::c_void,
+ deadline: gpr_timespec,
+ reserved: *mut ::std::os::raw::c_void,
+ ) -> grpc_event;
+}
+extern "C" {
+ #[doc = " Begin destruction of a completion queue. Once all possible events are"]
+ #[doc = "drained then grpc_completion_queue_next will start to produce"]
+ #[doc = "GRPC_QUEUE_SHUTDOWN events only. At that point it's safe to call"]
+ #[doc = "grpc_completion_queue_destroy."]
+ #[doc = ""]
+ #[doc = "After calling this function applications should ensure that no"]
+ #[doc = "NEW work is added to be published on this completion queue."]
+ pub fn grpc_completion_queue_shutdown(cq: *mut grpc_completion_queue);
+}
+extern "C" {
+ #[doc = " Destroy a completion queue. The caller must ensure that the queue is"]
+ #[doc = "drained and no threads are executing grpc_completion_queue_next"]
+ pub fn grpc_completion_queue_destroy(cq: *mut grpc_completion_queue);
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API ************/"]
+ #[doc = " grpc_flush_cq_tls_cache() MUST be called on the same thread,"]
+ #[doc = " with the same cq."]
+ pub fn grpc_completion_queue_thread_local_cache_init(cq: *mut grpc_completion_queue);
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API ************/"]
+ #[doc = " Returns 1 if there was contents in the cache. If there was an event"]
+ #[doc = " in \\a cq tls cache, its tag is placed in tag, and ok is set to the"]
+ #[doc = " event success."]
+ pub fn grpc_completion_queue_thread_local_cache_flush(
+ cq: *mut grpc_completion_queue,
+ tag: *mut *mut ::std::os::raw::c_void,
+ ok: *mut ::std::os::raw::c_int,
+ ) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " Check the connectivity state of a channel."]
+ pub fn grpc_channel_check_connectivity_state(
+ channel: *mut grpc_channel,
+ try_to_connect: ::std::os::raw::c_int,
+ ) -> grpc_connectivity_state;
+}
+extern "C" {
+ #[doc = " Number of active \"external connectivity state watchers\" attached to a"]
+ #[doc = " channel."]
+ #[doc = " Useful for testing."]
+ pub fn grpc_channel_num_external_connectivity_watchers(
+ channel: *mut grpc_channel,
+ ) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " Watch for a change in connectivity state."]
+ #[doc = "Once the channel connectivity state is different from last_observed_state,"]
+ #[doc = "tag will be enqueued on cq with success=1."]
+ #[doc = "If deadline expires BEFORE the state is changed, tag will be enqueued on cq"]
+ #[doc = "with success=0."]
+ pub fn grpc_channel_watch_connectivity_state(
+ channel: *mut grpc_channel,
+ last_observed_state: grpc_connectivity_state,
+ deadline: gpr_timespec,
+ cq: *mut grpc_completion_queue,
+ tag: *mut ::std::os::raw::c_void,
+ );
+}
+extern "C" {
+ #[doc = " Check whether a grpc channel supports connectivity watcher"]
+ pub fn grpc_channel_support_connectivity_watcher(
+ channel: *mut grpc_channel,
+ ) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " Create a call given a grpc_channel, in order to call 'method'. All"]
+ #[doc = "completions are sent to 'completion_queue'. 'method' and 'host' need only"]
+ #[doc = "live through the invocation of this function."]
+ #[doc = "If parent_call is non-NULL, it must be a server-side call. It will be used"]
+ #[doc = "to propagate properties from the server call to this new client call,"]
+ #[doc = "depending on the value of \\a propagation_mask (see propagation_bits.h for"]
+ #[doc = "possible values)."]
+ pub fn grpc_channel_create_call(
+ channel: *mut grpc_channel,
+ parent_call: *mut grpc_call,
+ propagation_mask: u32,
+ completion_queue: *mut grpc_completion_queue,
+ method: grpc_slice,
+ host: *const grpc_slice,
+ deadline: gpr_timespec,
+ reserved: *mut ::std::os::raw::c_void,
+ ) -> *mut grpc_call;
+}
+extern "C" {
+ #[doc = " Pre-register a method/host pair on a channel."]
+ #[doc = "method and host are not owned and must remain alive while the channel is"]
+ #[doc = "alive."]
+ pub fn grpc_channel_register_call(
+ channel: *mut grpc_channel,
+ method: *const ::std::os::raw::c_char,
+ host: *const ::std::os::raw::c_char,
+ reserved: *mut ::std::os::raw::c_void,
+ ) -> *mut ::std::os::raw::c_void;
+}
+extern "C" {
+ #[doc = " Create a call given a handle returned from grpc_channel_register_call."]
+ #[doc = "\\sa grpc_channel_create_call."]
+ pub fn grpc_channel_create_registered_call(
+ channel: *mut grpc_channel,
+ parent_call: *mut grpc_call,
+ propagation_mask: u32,
+ completion_queue: *mut grpc_completion_queue,
+ registered_call_handle: *mut ::std::os::raw::c_void,
+ deadline: gpr_timespec,
+ reserved: *mut ::std::os::raw::c_void,
+ ) -> *mut grpc_call;
+}
+extern "C" {
+ #[doc = " Allocate memory in the grpc_call arena: this memory is automatically"]
+ #[doc = "discarded at call completion"]
+ pub fn grpc_call_arena_alloc(call: *mut grpc_call, size: usize) -> *mut ::std::os::raw::c_void;
+}
+extern "C" {
+ #[doc = " Start a batch of operations defined in the array ops; when complete, post a"]
+ #[doc = "completion of type 'tag' to the completion queue bound to the call."]
+ #[doc = "The order of ops specified in the batch has no significance."]
+ #[doc = "Only one operation of each type can be active at once in any given"]
+ #[doc = "batch."]
+ #[doc = "If a call to grpc_call_start_batch returns GRPC_CALL_OK you must call"]
+ #[doc = "grpc_completion_queue_next or grpc_completion_queue_pluck on the completion"]
+ #[doc = "queue associated with 'call' for work to be performed. If a call to"]
+ #[doc = "grpc_call_start_batch returns any value other than GRPC_CALL_OK it is"]
+ #[doc = "guaranteed that no state associated with 'call' is changed and it is not"]
+ #[doc = "appropriate to call grpc_completion_queue_next or"]
+ #[doc = "grpc_completion_queue_pluck consequent to the failed grpc_call_start_batch"]
+ #[doc = "call."]
+ #[doc = "If a call to grpc_call_start_batch with an empty batch returns"]
+ #[doc = "GRPC_CALL_OK, the tag is put in the completion queue immediately."]
+ #[doc = "THREAD SAFETY: access to grpc_call_start_batch in multi-threaded environment"]
+ #[doc = "needs to be synchronized. As an optimization, you may synchronize batches"]
+ #[doc = "containing just send operations independently from batches containing just"]
+ #[doc = "receive operations. Access to grpc_call_start_batch with an empty batch is"]
+ #[doc = "thread-compatible."]
+ pub fn grpc_call_start_batch(
+ call: *mut grpc_call,
+ ops: *const grpc_op,
+ nops: usize,
+ tag: *mut ::std::os::raw::c_void,
+ reserved: *mut ::std::os::raw::c_void,
+ ) -> grpc_call_error;
+}
+extern "C" {
+ #[doc = " Returns a newly allocated string representing the endpoint to which this"]
+ #[doc = "call is communicating with. The string is in the uri format accepted by"]
+ #[doc = "grpc_channel_create."]
+ #[doc = "The returned string should be disposed of with gpr_free()."]
+ #[doc = ""]
+ #[doc = "WARNING: this value is never authenticated or subject to any security"]
+ #[doc = "related code. It must not be used for any authentication related"]
+ #[doc = "functionality. Instead, use grpc_auth_context."]
+ pub fn grpc_call_get_peer(call: *mut grpc_call) -> *mut ::std::os::raw::c_char;
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct census_context {
+ _unused: [u8; 0],
+}
+extern "C" {
+ #[doc = " Set census context for a call; Must be called before first call to"]
+ #[doc = "grpc_call_start_batch()."]
+ pub fn grpc_census_call_set_context(call: *mut grpc_call, context: *mut census_context);
+}
+extern "C" {
+ #[doc = " Retrieve the calls current census context."]
+ pub fn grpc_census_call_get_context(call: *mut grpc_call) -> *mut census_context;
+}
+extern "C" {
+ #[doc = " Return a newly allocated string representing the target a channel was"]
+ #[doc = "created for."]
+ pub fn grpc_channel_get_target(channel: *mut grpc_channel) -> *mut ::std::os::raw::c_char;
+}
+extern "C" {
+ #[doc = " Request info about the channel."]
+ #[doc = "\\a channel_info indicates what information is being requested and"]
+ #[doc = "how that information will be returned."]
+ #[doc = "\\a channel_info is owned by the caller."]
+ pub fn grpc_channel_get_info(
+ channel: *mut grpc_channel,
+ channel_info: *const grpc_channel_info,
+ );
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL. Resets the channel's connect backoff."]
+ #[doc = "TODO(roth): When we see whether this proves useful, either promote"]
+ #[doc = "to non-experimental or remove it."]
+ pub fn grpc_channel_reset_connect_backoff(channel: *mut grpc_channel);
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_channel_credentials {
+ _unused: [u8; 0],
+}
+extern "C" {
+ #[doc = " Releases a channel credentials object."]
+ #[doc = "The creator of the credentials object is responsible for its release."]
+ pub fn grpc_channel_credentials_release(creds: *mut grpc_channel_credentials);
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_server_credentials {
+ _unused: [u8; 0],
+}
+extern "C" {
+ #[doc = " Releases a server_credentials object."]
+ #[doc = "The creator of the server_credentials object is responsible for its release."]
+ pub fn grpc_server_credentials_release(creds: *mut grpc_server_credentials);
+}
+extern "C" {
+ #[doc = " Creates a secure channel using the passed-in credentials. Additional"]
+ #[doc = "channel level configuration MAY be provided by grpc_channel_args, though"]
+ #[doc = "the expectation is that most clients will want to simply pass NULL. The"]
+ #[doc = "user data in 'args' need only live through the invocation of this function."]
+ #[doc = "However, if any args of the 'pointer' type are passed, then the referenced"]
+ #[doc = "vtable must be maintained by the caller until grpc_channel_destroy"]
+ #[doc = "terminates. See grpc_channel_args definition for more on this."]
+ pub fn grpc_channel_create(
+ target: *const ::std::os::raw::c_char,
+ creds: *mut grpc_channel_credentials,
+ args: *const grpc_channel_args,
+ ) -> *mut grpc_channel;
+}
+extern "C" {
+ #[doc = " Create a lame client: this client fails every operation attempted on it."]
+ pub fn grpc_lame_client_channel_create(
+ target: *const ::std::os::raw::c_char,
+ error_code: grpc_status_code::Type,
+ error_message: *const ::std::os::raw::c_char,
+ ) -> *mut grpc_channel;
+}
+extern "C" {
+ #[doc = " Close and destroy a grpc channel"]
+ pub fn grpc_channel_destroy(channel: *mut grpc_channel);
+}
+extern "C" {
+ #[doc = " Cancel an RPC."]
+ #[doc = "Can be called multiple times, from any thread."]
+ #[doc = "THREAD-SAFETY grpc_call_cancel and grpc_call_cancel_with_status"]
+ #[doc = "are thread-safe, and can be called at any point before grpc_call_unref"]
+ #[doc = "is called."]
+ pub fn grpc_call_cancel(
+ call: *mut grpc_call,
+ reserved: *mut ::std::os::raw::c_void,
+ ) -> grpc_call_error;
+}
+extern "C" {
+ #[doc = " Cancel an RPC."]
+ #[doc = "Can be called multiple times, from any thread."]
+ #[doc = "If a status has not been received for the call, set it to the status code"]
+ #[doc = "and description passed in."]
+ #[doc = "Importantly, this function does not send status nor description to the"]
+ #[doc = "remote endpoint."]
+ #[doc = "Note that \\a description doesn't need be a static string."]
+ #[doc = "It doesn't need to be alive after the call to"]
+ #[doc = "grpc_call_cancel_with_status completes."]
+ pub fn grpc_call_cancel_with_status(
+ call: *mut grpc_call,
+ status: grpc_status_code::Type,
+ description: *const ::std::os::raw::c_char,
+ reserved: *mut ::std::os::raw::c_void,
+ ) -> grpc_call_error;
+}
+extern "C" {
+ pub fn grpc_call_failed_before_recv_message(c: *const grpc_call) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " Ref a call."]
+ #[doc = "THREAD SAFETY: grpc_call_ref is thread-compatible"]
+ pub fn grpc_call_ref(call: *mut grpc_call);
+}
+extern "C" {
+ #[doc = " Unref a call."]
+ #[doc = "THREAD SAFETY: grpc_call_unref is thread-compatible"]
+ pub fn grpc_call_unref(call: *mut grpc_call);
+}
+extern "C" {
+ #[doc = " Request notification of a new call."]
+ #[doc = "Once a call is received, a notification tagged with \\a tag_new is added to"]
+ #[doc = "\\a cq_for_notification. \\a call, \\a details and \\a request_metadata are"]
+ #[doc = "updated with the appropriate call information. \\a cq_bound_to_call is bound"]
+ #[doc = "to \\a call, and batch operation notifications for that call will be posted"]
+ #[doc = "to \\a cq_bound_to_call."]
+ #[doc = "Note that \\a cq_for_notification must have been registered to the server via"]
+ #[doc = "\\a grpc_server_register_completion_queue."]
+ pub fn grpc_server_request_call(
+ server: *mut grpc_server,
+ call: *mut *mut grpc_call,
+ details: *mut grpc_call_details,
+ request_metadata: *mut grpc_metadata_array,
+ cq_bound_to_call: *mut grpc_completion_queue,
+ cq_for_notification: *mut grpc_completion_queue,
+ tag_new: *mut ::std::os::raw::c_void,
+ ) -> grpc_call_error;
+}
+#[repr(u32)]
+#[doc = " How to handle payloads for a registered method"]
+#[derive(Debug, Copy, Clone, Hash, PartialEq, Eq)]
+pub enum grpc_server_register_method_payload_handling {
+ #[doc = " Don't try to read the payload"]
+ GRPC_SRM_PAYLOAD_NONE = 0,
+ #[doc = " Read the initial payload as a byte buffer"]
+ GRPC_SRM_PAYLOAD_READ_INITIAL_BYTE_BUFFER = 1,
+}
+extern "C" {
+ #[doc = " Registers a method in the server."]
+ #[doc = "Methods to this (host, method) pair will not be reported by"]
+ #[doc = "grpc_server_request_call, but instead be reported by"]
+ #[doc = "grpc_server_request_registered_call when passed the appropriate"]
+ #[doc = "registered_method (as returned by this function)."]
+ #[doc = "Must be called before grpc_server_start."]
+ #[doc = "Returns NULL on failure."]
+ pub fn grpc_server_register_method(
+ server: *mut grpc_server,
+ method: *const ::std::os::raw::c_char,
+ host: *const ::std::os::raw::c_char,
+ payload_handling: grpc_server_register_method_payload_handling,
+ flags: u32,
+ ) -> *mut ::std::os::raw::c_void;
+}
+extern "C" {
+ #[doc = " Request notification of a new pre-registered call. 'cq_for_notification'"]
+ #[doc = "must have been registered to the server via"]
+ #[doc = "grpc_server_register_completion_queue."]
+ pub fn grpc_server_request_registered_call(
+ server: *mut grpc_server,
+ registered_method: *mut ::std::os::raw::c_void,
+ call: *mut *mut grpc_call,
+ deadline: *mut gpr_timespec,
+ request_metadata: *mut grpc_metadata_array,
+ optional_payload: *mut *mut grpc_byte_buffer,
+ cq_bound_to_call: *mut grpc_completion_queue,
+ cq_for_notification: *mut grpc_completion_queue,
+ tag_new: *mut ::std::os::raw::c_void,
+ ) -> grpc_call_error;
+}
+extern "C" {
+ #[doc = " Create a server. Additional configuration for each incoming channel can"]
+ #[doc = "be specified with args. If no additional configuration is needed, args can"]
+ #[doc = "be NULL. The user data in 'args' need only live through the invocation of"]
+ #[doc = "this function. However, if any args of the 'pointer' type are passed, then"]
+ #[doc = "the referenced vtable must be maintained by the caller until"]
+ #[doc = "grpc_server_destroy terminates. See grpc_channel_args definition for more"]
+ #[doc = "on this."]
+ pub fn grpc_server_create(
+ args: *const grpc_channel_args,
+ reserved: *mut ::std::os::raw::c_void,
+ ) -> *mut grpc_server;
+}
+extern "C" {
+ #[doc = " Register a completion queue with the server. Must be done for any"]
+ #[doc = "notification completion queue that is passed to grpc_server_request_*_call"]
+ #[doc = "and to grpc_server_shutdown_and_notify. Must be performed prior to"]
+ #[doc = "grpc_server_start."]
+ pub fn grpc_server_register_completion_queue(
+ server: *mut grpc_server,
+ cq: *mut grpc_completion_queue,
+ reserved: *mut ::std::os::raw::c_void,
+ );
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_serving_status_update {
+ pub code: grpc_status_code::Type,
+ pub error_message: *const ::std::os::raw::c_char,
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_server_xds_status_notifier {
+ pub on_serving_status_update: ::std::option::Option<
+ unsafe extern "C" fn(
+ user_data: *mut ::std::os::raw::c_void,
+ uri: *const ::std::os::raw::c_char,
+ update: grpc_serving_status_update,
+ ),
+ >,
+ pub user_data: *mut ::std::os::raw::c_void,
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_server_config_fetcher {
+ _unused: [u8; 0],
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL. Creates an xDS config fetcher."]
+ pub fn grpc_server_config_fetcher_xds_create(
+ notifier: grpc_server_xds_status_notifier,
+ args: *const grpc_channel_args,
+ ) -> *mut grpc_server_config_fetcher;
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL. Destroys a config fetcher."]
+ pub fn grpc_server_config_fetcher_destroy(config_fetcher: *mut grpc_server_config_fetcher);
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL. Sets the server's config fetcher. Takes ownership."]
+ #[doc = "Must be called before adding ports"]
+ pub fn grpc_server_set_config_fetcher(
+ server: *mut grpc_server,
+ config_fetcher: *mut grpc_server_config_fetcher,
+ );
+}
+extern "C" {
+ #[doc = " Add a HTTP2 over an encrypted link over tcp listener."]
+ #[doc = "Returns bound port number on success, 0 on failure."]
+ #[doc = "REQUIRES: server not started"]
+ pub fn grpc_server_add_http2_port(
+ server: *mut grpc_server,
+ addr: *const ::std::os::raw::c_char,
+ creds: *mut grpc_server_credentials,
+ ) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " Start a server - tells all listeners to start listening"]
+ pub fn grpc_server_start(server: *mut grpc_server);
+}
+extern "C" {
+ #[doc = " Begin shutting down a server."]
+ #[doc = "After completion, no new calls or connections will be admitted."]
+ #[doc = "Existing calls will be allowed to complete."]
+ #[doc = "Send a GRPC_OP_COMPLETE event when there are no more calls being serviced."]
+ #[doc = "Shutdown is idempotent, and all tags will be notified at once if multiple"]
+ #[doc = "grpc_server_shutdown_and_notify calls are made. 'cq' must have been"]
+ #[doc = "registered to this server via grpc_server_register_completion_queue."]
+ pub fn grpc_server_shutdown_and_notify(
+ server: *mut grpc_server,
+ cq: *mut grpc_completion_queue,
+ tag: *mut ::std::os::raw::c_void,
+ );
+}
+extern "C" {
+ #[doc = " Cancel all in-progress calls."]
+ #[doc = "Only usable after shutdown."]
+ pub fn grpc_server_cancel_all_calls(server: *mut grpc_server);
+}
+extern "C" {
+ #[doc = " Destroy a server."]
+ #[doc = "Shutdown must have completed beforehand (i.e. all tags generated by"]
+ #[doc = "grpc_server_shutdown_and_notify must have been received, and at least"]
+ #[doc = "one call to grpc_server_shutdown_and_notify must have been made)."]
+ pub fn grpc_server_destroy(server: *mut grpc_server);
+}
+extern "C" {
+ #[doc = " Enable or disable a tracer."]
+ #[doc = ""]
+ #[doc = "Tracers (usually controlled by the environment variable GRPC_TRACE)"]
+ #[doc = "allow printf-style debugging on GRPC internals, and are useful for"]
+ #[doc = "tracking down problems in the field."]
+ #[doc = ""]
+ #[doc = "Use of this function is not strictly thread-safe, but the"]
+ #[doc = "thread-safety issues raised by it should not be of concern."]
+ pub fn grpc_tracer_set_enabled(
+ name: *const ::std::os::raw::c_char,
+ enabled: ::std::os::raw::c_int,
+ ) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " Check whether a metadata key is legal (will be accepted by core)"]
+ pub fn grpc_header_key_is_legal(slice: grpc_slice) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " Check whether a non-binary metadata value is legal (will be accepted by"]
+ #[doc = "core)"]
+ pub fn grpc_header_nonbin_value_is_legal(slice: grpc_slice) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " Check whether a metadata key corresponds to a binary value"]
+ pub fn grpc_is_binary_header(slice: grpc_slice) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " Convert grpc_call_error values to a string"]
+ pub fn grpc_call_error_to_string(error: grpc_call_error) -> *const ::std::os::raw::c_char;
+}
+extern "C" {
+ #[doc = " Create a buffer pool"]
+ pub fn grpc_resource_quota_create(
+ trace_name: *const ::std::os::raw::c_char,
+ ) -> *mut grpc_resource_quota;
+}
+extern "C" {
+ #[doc = " Add a reference to a buffer pool"]
+ pub fn grpc_resource_quota_ref(resource_quota: *mut grpc_resource_quota);
+}
+extern "C" {
+ #[doc = " Drop a reference to a buffer pool"]
+ pub fn grpc_resource_quota_unref(resource_quota: *mut grpc_resource_quota);
+}
+extern "C" {
+ #[doc = " Update the size of a buffer pool"]
+ pub fn grpc_resource_quota_resize(resource_quota: *mut grpc_resource_quota, new_size: usize);
+}
+extern "C" {
+ #[doc = " Update the size of the maximum number of threads allowed"]
+ pub fn grpc_resource_quota_set_max_threads(
+ resource_quota: *mut grpc_resource_quota,
+ new_max_threads: ::std::os::raw::c_int,
+ );
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL. Dumps xDS configs as a serialized ClientConfig proto."]
+ #[doc = "The full name of the proto is envoy.service.status.v3.ClientConfig."]
+ pub fn grpc_dump_xds_configs() -> grpc_slice;
+}
+extern "C" {
+ #[doc = " Fetch a vtable for a grpc_channel_arg that points to a grpc_resource_quota"]
+ pub fn grpc_resource_quota_arg_vtable() -> *const grpc_arg_pointer_vtable;
+}
+extern "C" {
+ #[doc = " CHANNELZ API *************/"]
+ #[doc = "churn as the feature is implemented. This comment will be removed once"]
+ #[doc = "channelz is officially supported, and these APIs become stable. For now"]
+ #[doc = "you may track the progress by following this github issue:"]
+ #[doc = "https://github.com/grpc/grpc/issues/15340"]
+ #[doc = ""]
+ #[doc = "the following APIs return allocated JSON strings that match the response"]
+ #[doc = "objects from the channelz proto, found here:"]
+ #[doc = "https://github.com/grpc/grpc/blob/master/src/proto/grpc/channelz/channelz.proto."]
+ #[doc = ""]
+ #[doc = "For easy conversion to protobuf, The JSON is formatted according to:"]
+ #[doc = "https://developers.google.com/protocol-buffers/docs/proto3#json."]
+ pub fn grpc_channelz_get_top_channels(start_channel_id: isize) -> *mut ::std::os::raw::c_char;
+}
+extern "C" {
+ pub fn grpc_channelz_get_servers(start_server_id: isize) -> *mut ::std::os::raw::c_char;
+}
+extern "C" {
+ pub fn grpc_channelz_get_server(server_id: isize) -> *mut ::std::os::raw::c_char;
+}
+extern "C" {
+ pub fn grpc_channelz_get_server_sockets(
+ server_id: isize,
+ start_socket_id: isize,
+ max_results: isize,
+ ) -> *mut ::std::os::raw::c_char;
+}
+extern "C" {
+ pub fn grpc_channelz_get_channel(channel_id: isize) -> *mut ::std::os::raw::c_char;
+}
+extern "C" {
+ pub fn grpc_channelz_get_subchannel(subchannel_id: isize) -> *mut ::std::os::raw::c_char;
+}
+extern "C" {
+ pub fn grpc_channelz_get_socket(socket_id: isize) -> *mut ::std::os::raw::c_char;
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL - Subject to change."]
+ #[doc = " Fetch a vtable for grpc_channel_arg that points to"]
+ #[doc = " grpc_authorization_policy_provider."]
+ pub fn grpc_authorization_policy_provider_arg_vtable() -> *const grpc_arg_pointer_vtable;
+}
+extern "C" {
+ pub fn grpc_cronet_secure_channel_create(
+ engine: *mut ::std::os::raw::c_void,
+ target: *const ::std::os::raw::c_char,
+ args: *const grpc_channel_args,
+ reserved: *mut ::std::os::raw::c_void,
+ ) -> *mut grpc_channel;
+}
+extern "C" {
+ #[doc = " Create a secure channel to 'target' using file descriptor 'fd' and passed-in"]
+ #[doc = "credentials. The 'target' argument will be used to indicate the name for"]
+ #[doc = "this channel. Note that this API currently only supports insecure channel"]
+ #[doc = "credentials. Using other types of credentials will result in a failure."]
+ pub fn grpc_channel_create_from_fd(
+ target: *const ::std::os::raw::c_char,
+ fd: ::std::os::raw::c_int,
+ creds: *mut grpc_channel_credentials,
+ args: *const grpc_channel_args,
+ ) -> *mut grpc_channel;
+}
+extern "C" {
+ #[doc = " Add the connected secure communication channel based on file descriptor 'fd'"]
+ #[doc = "to the 'server' and server credentials 'creds'. The 'fd' must be an open file"]
+ #[doc = "descriptor corresponding to a connected socket. Events from the file"]
+ #[doc = "descriptor may come on any of the server completion queues (i.e completion"]
+ #[doc = "queues registered via the grpc_server_register_completion_queue API)."]
+ #[doc = "Note that this API currently only supports inseure server credentials"]
+ #[doc = "Using other types of credentials will result in a failure."]
+ #[doc = "TODO(hork): add channel_args to this API to allow endpoints and transports"]
+ #[doc = "created in this function to participate in the resource quota feature."]
+ pub fn grpc_server_add_channel_from_fd(
+ server: *mut grpc_server,
+ fd: ::std::os::raw::c_int,
+ creds: *mut grpc_server_credentials,
+ );
+}
+#[repr(u32)]
+#[doc = " Results for the SSL roots override callback."]
+#[derive(Debug, Copy, Clone, Hash, PartialEq, Eq)]
+pub enum grpc_ssl_roots_override_result {
+ GRPC_SSL_ROOTS_OVERRIDE_OK = 0,
+ GRPC_SSL_ROOTS_OVERRIDE_FAIL_PERMANENTLY = 1,
+ #[doc = " Do not try fallback options."]
+ GRPC_SSL_ROOTS_OVERRIDE_FAIL = 2,
+}
+#[repr(u32)]
+#[doc = " Callback results for dynamically loading a SSL certificate config."]
+#[derive(Debug, Copy, Clone, Hash, PartialEq, Eq)]
+pub enum grpc_ssl_certificate_config_reload_status {
+ GRPC_SSL_CERTIFICATE_CONFIG_RELOAD_UNCHANGED = 0,
+ GRPC_SSL_CERTIFICATE_CONFIG_RELOAD_NEW = 1,
+ GRPC_SSL_CERTIFICATE_CONFIG_RELOAD_FAIL = 2,
+}
+#[repr(u32)]
+#[derive(Debug, Copy, Clone, Hash, PartialEq, Eq)]
+pub enum grpc_ssl_client_certificate_request_type {
+ #[doc = " Server does not request client certificate."]
+ #[doc = "The certificate presented by the client is not checked by the server at"]
+ #[doc = "all. (A client may present a self signed or signed certificate or not"]
+ #[doc = "present a certificate at all and any of those option would be accepted)"]
+ GRPC_SSL_DONT_REQUEST_CLIENT_CERTIFICATE = 0,
+ #[doc = " Server requests client certificate but does not enforce that the client"]
+ #[doc = "presents a certificate."]
+ #[doc = ""]
+ #[doc = "If the client presents a certificate, the client authentication is left to"]
+ #[doc = "the application (the necessary metadata will be available to the"]
+ #[doc = "application via authentication context properties, see grpc_auth_context)."]
+ #[doc = ""]
+ #[doc = "The client's key certificate pair must be valid for the SSL connection to"]
+ #[doc = "be established."]
+ GRPC_SSL_REQUEST_CLIENT_CERTIFICATE_BUT_DONT_VERIFY = 1,
+ #[doc = " Server requests client certificate but does not enforce that the client"]
+ #[doc = "presents a certificate."]
+ #[doc = ""]
+ #[doc = "If the client presents a certificate, the client authentication is done by"]
+ #[doc = "the gRPC framework. (For a successful connection the client needs to either"]
+ #[doc = "present a certificate that can be verified against the root certificate"]
+ #[doc = "configured by the server or not present a certificate at all)"]
+ #[doc = ""]
+ #[doc = "The client's key certificate pair must be valid for the SSL connection to"]
+ #[doc = "be established."]
+ GRPC_SSL_REQUEST_CLIENT_CERTIFICATE_AND_VERIFY = 2,
+ #[doc = " Server requests client certificate and enforces that the client presents a"]
+ #[doc = "certificate."]
+ #[doc = ""]
+ #[doc = "If the client presents a certificate, the client authentication is left to"]
+ #[doc = "the application (the necessary metadata will be available to the"]
+ #[doc = "application via authentication context properties, see grpc_auth_context)."]
+ #[doc = ""]
+ #[doc = "The client's key certificate pair must be valid for the SSL connection to"]
+ #[doc = "be established."]
+ GRPC_SSL_REQUEST_AND_REQUIRE_CLIENT_CERTIFICATE_BUT_DONT_VERIFY = 3,
+ #[doc = " Server requests client certificate and enforces that the client presents a"]
+ #[doc = "certificate."]
+ #[doc = ""]
+ #[doc = "The certificate presented by the client is verified by the gRPC framework."]
+ #[doc = "(For a successful connection the client needs to present a certificate that"]
+ #[doc = "can be verified against the root certificate configured by the server)"]
+ #[doc = ""]
+ #[doc = "The client's key certificate pair must be valid for the SSL connection to"]
+ #[doc = "be established."]
+ GRPC_SSL_REQUEST_AND_REQUIRE_CLIENT_CERTIFICATE_AND_VERIFY = 4,
+}
+impl grpc_security_level {
+ pub const GRPC_SECURITY_NONE: grpc_security_level = grpc_security_level::GRPC_SECURITY_MIN;
+}
+impl grpc_security_level {
+ pub const GRPC_SECURITY_MAX: grpc_security_level =
+ grpc_security_level::GRPC_PRIVACY_AND_INTEGRITY;
+}
+#[repr(u32)]
+#[derive(Debug, Copy, Clone, Hash, PartialEq, Eq)]
+pub enum grpc_security_level {
+ GRPC_SECURITY_MIN = 0,
+ GRPC_INTEGRITY_ONLY = 1,
+ GRPC_PRIVACY_AND_INTEGRITY = 2,
+}
+#[repr(u32)]
+#[doc = " Type of local connections for which local channel/server credentials will be"]
+#[doc = " applied. It supports UDS and local TCP connections."]
+#[derive(Debug, Copy, Clone, Hash, PartialEq, Eq)]
+pub enum grpc_local_connect_type {
+ UDS = 0,
+ LOCAL_TCP = 1,
+}
+#[repr(u32)]
+#[doc = " The TLS versions that are supported by the SSL stack."]
+#[derive(Debug, Copy, Clone, Hash, PartialEq, Eq)]
+pub enum grpc_tls_version {
+ TLS1_2 = 0,
+ TLS1_3 = 1,
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_auth_context {
+ _unused: [u8; 0],
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_auth_property_iterator {
+ pub ctx: *const grpc_auth_context,
+ pub index: usize,
+ pub name: *const ::std::os::raw::c_char,
+}
+#[doc = " value, if not NULL, is guaranteed to be NULL terminated."]
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_auth_property {
+ pub name: *mut ::std::os::raw::c_char,
+ pub value: *mut ::std::os::raw::c_char,
+ pub value_length: usize,
+}
+extern "C" {
+ #[doc = " Returns NULL when the iterator is at the end."]
+ pub fn grpc_auth_property_iterator_next(
+ it: *mut grpc_auth_property_iterator,
+ ) -> *const grpc_auth_property;
+}
+extern "C" {
+ #[doc = " Iterates over the auth context."]
+ pub fn grpc_auth_context_property_iterator(
+ ctx: *const grpc_auth_context,
+ ) -> grpc_auth_property_iterator;
+}
+extern "C" {
+ #[doc = " Gets the peer identity. Returns an empty iterator (first _next will return"]
+ #[doc = "NULL) if the peer is not authenticated."]
+ pub fn grpc_auth_context_peer_identity(
+ ctx: *const grpc_auth_context,
+ ) -> grpc_auth_property_iterator;
+}
+extern "C" {
+ #[doc = " Finds a property in the context. May return an empty iterator (first _next"]
+ #[doc = "will return NULL) if no property with this name was found in the context."]
+ pub fn grpc_auth_context_find_properties_by_name(
+ ctx: *const grpc_auth_context,
+ name: *const ::std::os::raw::c_char,
+ ) -> grpc_auth_property_iterator;
+}
+extern "C" {
+ #[doc = " Gets the name of the property that indicates the peer identity. Will return"]
+ #[doc = "NULL if the peer is not authenticated."]
+ pub fn grpc_auth_context_peer_identity_property_name(
+ ctx: *const grpc_auth_context,
+ ) -> *const ::std::os::raw::c_char;
+}
+extern "C" {
+ #[doc = " Returns 1 if the peer is authenticated, 0 otherwise."]
+ pub fn grpc_auth_context_peer_is_authenticated(
+ ctx: *const grpc_auth_context,
+ ) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " Gets the auth context from the call. Caller needs to call"]
+ #[doc = "grpc_auth_context_release on the returned context."]
+ pub fn grpc_call_auth_context(call: *mut grpc_call) -> *mut grpc_auth_context;
+}
+extern "C" {
+ #[doc = " Releases the auth context returned from grpc_call_auth_context."]
+ pub fn grpc_auth_context_release(context: *mut grpc_auth_context);
+}
+extern "C" {
+ #[doc = " Add a property."]
+ pub fn grpc_auth_context_add_property(
+ ctx: *mut grpc_auth_context,
+ name: *const ::std::os::raw::c_char,
+ value: *const ::std::os::raw::c_char,
+ value_length: usize,
+ );
+}
+extern "C" {
+ #[doc = " Add a C string property."]
+ pub fn grpc_auth_context_add_cstring_property(
+ ctx: *mut grpc_auth_context,
+ name: *const ::std::os::raw::c_char,
+ value: *const ::std::os::raw::c_char,
+ );
+}
+extern "C" {
+ #[doc = " Sets the property name. Returns 1 if successful or 0 in case of failure"]
+ #[doc = "(which means that no property with this name exists)."]
+ pub fn grpc_auth_context_set_peer_identity_property_name(
+ ctx: *mut grpc_auth_context,
+ name: *const ::std::os::raw::c_char,
+ ) -> ::std::os::raw::c_int;
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_ssl_session_cache {
+ _unused: [u8; 0],
+}
+extern "C" {
+ #[doc = " Create LRU cache for client-side SSL sessions with the given capacity."]
+ #[doc = "If capacity is < 1, a default capacity is used instead."]
+ pub fn grpc_ssl_session_cache_create_lru(capacity: usize) -> *mut grpc_ssl_session_cache;
+}
+extern "C" {
+ #[doc = " Destroy SSL session cache."]
+ pub fn grpc_ssl_session_cache_destroy(cache: *mut grpc_ssl_session_cache);
+}
+extern "C" {
+ #[doc = " Create a channel arg with the given cache object."]
+ pub fn grpc_ssl_session_cache_create_channel_arg(
+ cache: *mut grpc_ssl_session_cache,
+ ) -> grpc_arg;
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_call_credentials {
+ _unused: [u8; 0],
+}
+extern "C" {
+ #[doc = " Releases a call credentials object."]
+ #[doc = "The creator of the credentials object is responsible for its release."]
+ pub fn grpc_call_credentials_release(creds: *mut grpc_call_credentials);
+}
+extern "C" {
+ #[doc = " Creates default credentials to connect to a google gRPC service."]
+ #[doc = "WARNING: Do NOT use this credentials to connect to a non-google service as"]
+ #[doc = "this could result in an oauth2 token leak. The security level of the"]
+ #[doc = "resulting connection is GRPC_PRIVACY_AND_INTEGRITY."]
+ #[doc = ""]
+ #[doc = "If specified, the supplied call credentials object will be attached to the"]
+ #[doc = "returned channel credentials object. The call_credentials object must remain"]
+ #[doc = "valid throughout the lifetime of the returned grpc_channel_credentials"]
+ #[doc = "object. It is expected that the call credentials object was generated"]
+ #[doc = "according to the Application Default Credentials mechanism and asserts the"]
+ #[doc = "identity of the default service account of the machine. Supplying any other"]
+ #[doc = "sort of call credential will result in undefined behavior, up to and"]
+ #[doc = "including the sudden and unexpected failure of RPCs."]
+ #[doc = ""]
+ #[doc = "If nullptr is supplied, the returned channel credentials object will use a"]
+ #[doc = "call credentials object based on the Application Default Credentials"]
+ #[doc = "mechanism."]
+ pub fn grpc_google_default_credentials_create(
+ call_credentials: *mut grpc_call_credentials,
+ ) -> *mut grpc_channel_credentials;
+}
+#[doc = " Callback for getting the SSL roots override from the application."]
+#[doc = "In case of success, *pem_roots_certs must be set to a NULL terminated string"]
+#[doc = "containing the list of PEM encoded root certificates. The ownership is passed"]
+#[doc = "to the core and freed (laster by the core) with gpr_free."]
+#[doc = "If this function fails and GRPC_DEFAULT_SSL_ROOTS_FILE_PATH environment is"]
+#[doc = "set to a valid path, it will override the roots specified this func"]
+pub type grpc_ssl_roots_override_callback = ::std::option::Option<
+ unsafe extern "C" fn(
+ pem_root_certs: *mut *mut ::std::os::raw::c_char,
+ ) -> grpc_ssl_roots_override_result,
+>;
+extern "C" {
+ #[doc = " Setup a callback to override the default TLS/SSL roots."]
+ #[doc = "This function is not thread-safe and must be called at initialization time"]
+ #[doc = "before any ssl credentials are created to have the desired side effect."]
+ #[doc = "If GRPC_DEFAULT_SSL_ROOTS_FILE_PATH environment is set to a valid path, the"]
+ #[doc = "callback will not be called."]
+ pub fn grpc_set_ssl_roots_override_callback(cb: grpc_ssl_roots_override_callback);
+}
+#[doc = " Object that holds a private key / certificate chain pair in PEM format."]
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_ssl_pem_key_cert_pair {
+ #[doc = " private_key is the NULL-terminated string containing the PEM encoding of"]
+ #[doc = "the client's private key."]
+ pub private_key: *const ::std::os::raw::c_char,
+ #[doc = " cert_chain is the NULL-terminated string containing the PEM encoding of"]
+ #[doc = "the client's certificate chain."]
+ pub cert_chain: *const ::std::os::raw::c_char,
+}
+#[doc = " Deprecated in favor of grpc_ssl_verify_peer_options. It will be removed"]
+#[doc = "after all of its call sites are migrated to grpc_ssl_verify_peer_options."]
+#[doc = "Object that holds additional peer-verification options on a secure"]
+#[doc = "channel."]
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct verify_peer_options {
+ #[doc = " If non-NULL this callback will be invoked with the expected"]
+ #[doc = "target_name, the peer's certificate (in PEM format), and whatever"]
+ #[doc = "userdata pointer is set below. If a non-zero value is returned by this"]
+ #[doc = "callback then it is treated as a verification failure. Invocation of"]
+ #[doc = "the callback is blocking, so any implementation should be light-weight."]
+ pub verify_peer_callback: ::std::option::Option<
+ unsafe extern "C" fn(
+ target_name: *const ::std::os::raw::c_char,
+ peer_pem: *const ::std::os::raw::c_char,
+ userdata: *mut ::std::os::raw::c_void,
+ ) -> ::std::os::raw::c_int,
+ >,
+ #[doc = " Arbitrary userdata that will be passed as the last argument to"]
+ #[doc = "verify_peer_callback."]
+ pub verify_peer_callback_userdata: *mut ::std::os::raw::c_void,
+ #[doc = " A destruct callback that will be invoked when the channel is being"]
+ #[doc = "cleaned up. The userdata argument will be passed to it. The intent is"]
+ #[doc = "to perform any cleanup associated with that userdata."]
+ pub verify_peer_destruct:
+ ::std::option::Option<unsafe extern "C" fn(userdata: *mut ::std::os::raw::c_void)>,
+}
+#[doc = " Object that holds additional peer-verification options on a secure"]
+#[doc = "channel."]
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_ssl_verify_peer_options {
+ #[doc = " If non-NULL this callback will be invoked with the expected"]
+ #[doc = "target_name, the peer's certificate (in PEM format), and whatever"]
+ #[doc = "userdata pointer is set below. If a non-zero value is returned by this"]
+ #[doc = "callback then it is treated as a verification failure. Invocation of"]
+ #[doc = "the callback is blocking, so any implementation should be light-weight."]
+ pub verify_peer_callback: ::std::option::Option<
+ unsafe extern "C" fn(
+ target_name: *const ::std::os::raw::c_char,
+ peer_pem: *const ::std::os::raw::c_char,
+ userdata: *mut ::std::os::raw::c_void,
+ ) -> ::std::os::raw::c_int,
+ >,
+ #[doc = " Arbitrary userdata that will be passed as the last argument to"]
+ #[doc = "verify_peer_callback."]
+ pub verify_peer_callback_userdata: *mut ::std::os::raw::c_void,
+ #[doc = " A destruct callback that will be invoked when the channel is being"]
+ #[doc = "cleaned up. The userdata argument will be passed to it. The intent is"]
+ #[doc = "to perform any cleanup associated with that userdata."]
+ pub verify_peer_destruct:
+ ::std::option::Option<unsafe extern "C" fn(userdata: *mut ::std::os::raw::c_void)>,
+}
+extern "C" {
+ #[doc = " Deprecated in favor of grpc_ssl_server_credentials_create_ex. It will be"]
+ #[doc = "removed after all of its call sites are migrated to"]
+ #[doc = "grpc_ssl_server_credentials_create_ex. Creates an SSL credentials object."]
+ #[doc = "The security level of the resulting connection is GRPC_PRIVACY_AND_INTEGRITY."]
+ #[doc = "- pem_root_certs is the NULL-terminated string containing the PEM encoding"]
+ #[doc = "of the server root certificates. If this parameter is NULL, the"]
+ #[doc = "implementation will first try to dereference the file pointed by the"]
+ #[doc = "GRPC_DEFAULT_SSL_ROOTS_FILE_PATH environment variable, and if that fails,"]
+ #[doc = "try to get the roots set by grpc_override_ssl_default_roots. Eventually,"]
+ #[doc = "if all these fail, it will try to get the roots from a well-known place on"]
+ #[doc = "disk (in the grpc install directory)."]
+ #[doc = ""]
+ #[doc = "gRPC has implemented root cache if the underlying OpenSSL library supports"]
+ #[doc = "it. The gRPC root certificates cache is only applicable on the default"]
+ #[doc = "root certificates, which is used when this parameter is nullptr. If user"]
+ #[doc = "provides their own pem_root_certs, when creating an SSL credential object,"]
+ #[doc = "gRPC would not be able to cache it, and each subchannel will generate a"]
+ #[doc = "copy of the root store. So it is recommended to avoid providing large room"]
+ #[doc = "pem with pem_root_certs parameter to avoid excessive memory consumption,"]
+ #[doc = "particularly on mobile platforms such as iOS."]
+ #[doc = "- pem_key_cert_pair is a pointer on the object containing client's private"]
+ #[doc = "key and certificate chain. This parameter can be NULL if the client does"]
+ #[doc = "not have such a key/cert pair."]
+ #[doc = "- verify_options is an optional verify_peer_options object which holds"]
+ #[doc = "additional options controlling how peer certificates are verified. For"]
+ #[doc = "example, you can supply a callback which receives the peer's certificate"]
+ #[doc = "with which you can do additional verification. Can be NULL, in which"]
+ #[doc = "case verification will retain default behavior. Any settings in"]
+ #[doc = "verify_options are copied during this call, so the verify_options"]
+ #[doc = "object can be released afterwards."]
+ pub fn grpc_ssl_credentials_create(
+ pem_root_certs: *const ::std::os::raw::c_char,
+ pem_key_cert_pair: *mut grpc_ssl_pem_key_cert_pair,
+ verify_options: *const verify_peer_options,
+ reserved: *mut ::std::os::raw::c_void,
+ ) -> *mut grpc_channel_credentials;
+}
+extern "C" {
+ pub fn grpc_ssl_credentials_create_ex(
+ pem_root_certs: *const ::std::os::raw::c_char,
+ pem_key_cert_pair: *mut grpc_ssl_pem_key_cert_pair,
+ verify_options: *const grpc_ssl_verify_peer_options,
+ reserved: *mut ::std::os::raw::c_void,
+ ) -> *mut grpc_channel_credentials;
+}
+extern "C" {
+ #[doc = " Creates a composite channel credentials object. The security level of"]
+ #[doc = " resulting connection is determined by channel_creds."]
+ pub fn grpc_composite_channel_credentials_create(
+ channel_creds: *mut grpc_channel_credentials,
+ call_creds: *mut grpc_call_credentials,
+ reserved: *mut ::std::os::raw::c_void,
+ ) -> *mut grpc_channel_credentials;
+}
+extern "C" {
+ #[doc = " Creates a composite call credentials object."]
+ pub fn grpc_composite_call_credentials_create(
+ creds1: *mut grpc_call_credentials,
+ creds2: *mut grpc_call_credentials,
+ reserved: *mut ::std::os::raw::c_void,
+ ) -> *mut grpc_call_credentials;
+}
+extern "C" {
+ #[doc = " Creates a compute engine credentials object for connecting to Google."]
+ #[doc = "WARNING: Do NOT use this credentials to connect to a non-google service as"]
+ #[doc = "this could result in an oauth2 token leak."]
+ pub fn grpc_google_compute_engine_credentials_create(
+ reserved: *mut ::std::os::raw::c_void,
+ ) -> *mut grpc_call_credentials;
+}
+extern "C" {
+ pub fn grpc_max_auth_token_lifetime() -> gpr_timespec;
+}
+extern "C" {
+ #[doc = " Creates a JWT credentials object. May return NULL if the input is invalid."]
+ #[doc = "- json_key is the JSON key string containing the client's private key."]
+ #[doc = "- token_lifetime is the lifetime of each Json Web Token (JWT) created with"]
+ #[doc = "this credentials. It should not exceed grpc_max_auth_token_lifetime or"]
+ #[doc = "will be cropped to this value."]
+ pub fn grpc_service_account_jwt_access_credentials_create(
+ json_key: *const ::std::os::raw::c_char,
+ token_lifetime: gpr_timespec,
+ reserved: *mut ::std::os::raw::c_void,
+ ) -> *mut grpc_call_credentials;
+}
+extern "C" {
+ #[doc = " Builds External Account credentials."]
+ #[doc = "- json_string is the JSON string containing the credentials options."]
+ #[doc = "- scopes_string contains the scopes to be binded with the credentials."]
+ #[doc = "This API is used for experimental purposes for now and may change in the"]
+ #[doc = "future."]
+ pub fn grpc_external_account_credentials_create(
+ json_string: *const ::std::os::raw::c_char,
+ scopes_string: *const ::std::os::raw::c_char,
+ ) -> *mut grpc_call_credentials;
+}
+extern "C" {
+ #[doc = " Creates an Oauth2 Refresh Token credentials object for connecting to Google."]
+ #[doc = "May return NULL if the input is invalid."]
+ #[doc = "WARNING: Do NOT use this credentials to connect to a non-google service as"]
+ #[doc = "this could result in an oauth2 token leak."]
+ #[doc = "- json_refresh_token is the JSON string containing the refresh token itself"]
+ #[doc = "along with a client_id and client_secret."]
+ pub fn grpc_google_refresh_token_credentials_create(
+ json_refresh_token: *const ::std::os::raw::c_char,
+ reserved: *mut ::std::os::raw::c_void,
+ ) -> *mut grpc_call_credentials;
+}
+extern "C" {
+ #[doc = " Creates an Oauth2 Access Token credentials with an access token that was"]
+ #[doc = "acquired by an out of band mechanism."]
+ pub fn grpc_access_token_credentials_create(
+ access_token: *const ::std::os::raw::c_char,
+ reserved: *mut ::std::os::raw::c_void,
+ ) -> *mut grpc_call_credentials;
+}
+extern "C" {
+ #[doc = " Creates an IAM credentials object for connecting to Google."]
+ pub fn grpc_google_iam_credentials_create(
+ authorization_token: *const ::std::os::raw::c_char,
+ authority_selector: *const ::std::os::raw::c_char,
+ reserved: *mut ::std::os::raw::c_void,
+ ) -> *mut grpc_call_credentials;
+}
+#[doc = " Options for creating STS Oauth Token Exchange credentials following the IETF"]
+#[doc = "draft https://tools.ietf.org/html/draft-ietf-oauth-token-exchange-16."]
+#[doc = "Optional fields may be set to NULL or empty string. It is the responsibility"]
+#[doc = "of the caller to ensure that the subject and actor tokens are refreshed on"]
+#[doc = "disk at the specified paths. This API is used for experimental purposes for"]
+#[doc = "now and may change in the future."]
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_sts_credentials_options {
+ pub token_exchange_service_uri: *const ::std::os::raw::c_char,
+ pub resource: *const ::std::os::raw::c_char,
+ pub audience: *const ::std::os::raw::c_char,
+ pub scope: *const ::std::os::raw::c_char,
+ pub requested_token_type: *const ::std::os::raw::c_char,
+ pub subject_token_path: *const ::std::os::raw::c_char,
+ pub subject_token_type: *const ::std::os::raw::c_char,
+ pub actor_token_path: *const ::std::os::raw::c_char,
+ pub actor_token_type: *const ::std::os::raw::c_char,
+}
+extern "C" {
+ #[doc = " Creates an STS credentials following the STS Token Exchanged specifed in the"]
+ #[doc = "IETF draft https://tools.ietf.org/html/draft-ietf-oauth-token-exchange-16."]
+ #[doc = "This API is used for experimental purposes for now and may change in the"]
+ #[doc = "future."]
+ pub fn grpc_sts_credentials_create(
+ options: *const grpc_sts_credentials_options,
+ reserved: *mut ::std::os::raw::c_void,
+ ) -> *mut grpc_call_credentials;
+}
+#[doc = " Callback function to be called by the metadata credentials plugin"]
+#[doc = "implementation when the metadata is ready."]
+#[doc = "- user_data is the opaque pointer that was passed in the get_metadata method"]
+#[doc = "of the grpc_metadata_credentials_plugin (see below)."]
+#[doc = "- creds_md is an array of credentials metadata produced by the plugin. It"]
+#[doc = "may be set to NULL in case of an error."]
+#[doc = "- num_creds_md is the number of items in the creds_md array."]
+#[doc = "- status must be GRPC_STATUS_OK in case of success or another specific error"]
+#[doc = "code otherwise."]
+#[doc = "- error_details contains details about the error if any. In case of success"]
+#[doc = "it should be NULL and will be otherwise ignored."]
+pub type grpc_credentials_plugin_metadata_cb = ::std::option::Option<
+ unsafe extern "C" fn(
+ user_data: *mut ::std::os::raw::c_void,
+ creds_md: *const grpc_metadata,
+ num_creds_md: usize,
+ status: grpc_status_code::Type,
+ error_details: *const ::std::os::raw::c_char,
+ ),
+>;
+#[doc = " Context that can be used by metadata credentials plugin in order to create"]
+#[doc = "auth related metadata."]
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_auth_metadata_context {
+ #[doc = " The fully qualifed service url."]
+ pub service_url: *const ::std::os::raw::c_char,
+ #[doc = " The method name of the RPC being called (not fully qualified)."]
+ #[doc = "The fully qualified method name can be built from the service_url:"]
+ #[doc = "full_qualified_method_name = ctx->service_url + '/' + ctx->method_name."]
+ pub method_name: *const ::std::os::raw::c_char,
+ #[doc = " The auth_context of the channel which gives the server's identity."]
+ pub channel_auth_context: *const grpc_auth_context,
+ #[doc = " Reserved for future use."]
+ pub reserved: *mut ::std::os::raw::c_void,
+}
+extern "C" {
+ #[doc = " Performs a deep copy from \\a from to \\a to."]
+ pub fn grpc_auth_metadata_context_copy(
+ from: *mut grpc_auth_metadata_context,
+ to: *mut grpc_auth_metadata_context,
+ );
+}
+extern "C" {
+ #[doc = " Releases internal resources held by \\a context."]
+ pub fn grpc_auth_metadata_context_reset(context: *mut grpc_auth_metadata_context);
+}
+#[doc = " grpc_metadata_credentials plugin is an API user provided structure used to"]
+#[doc = "create grpc_credentials objects that can be set on a channel (composed) or"]
+#[doc = "a call. See grpc_credentials_metadata_create_from_plugin below."]
+#[doc = "The grpc client stack will call the get_metadata method of the plugin for"]
+#[doc = "every call in scope for the credentials created from it."]
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_metadata_credentials_plugin {
+ #[doc = " The implementation of this method has to be non-blocking, but can"]
+ #[doc = "be performed synchronously or asynchronously."]
+ #[doc = ""]
+ #[doc = "If processing occurs synchronously, returns non-zero and populates"]
+ #[doc = "creds_md, num_creds_md, status, and error_details. In this case,"]
+ #[doc = "the caller takes ownership of the entries in creds_md and of"]
+ #[doc = "error_details. Note that if the plugin needs to return more than"]
+ #[doc = "GRPC_METADATA_CREDENTIALS_PLUGIN_SYNC_MAX entries in creds_md, it must"]
+ #[doc = "return asynchronously."]
+ #[doc = ""]
+ #[doc = "If processing occurs asynchronously, returns zero and invokes \\a cb"]
+ #[doc = "when processing is completed. \\a user_data will be passed as the"]
+ #[doc = "first parameter of the callback. NOTE: \\a cb MUST be invoked in a"]
+ #[doc = "different thread, not from the thread in which \\a get_metadata() is"]
+ #[doc = "invoked."]
+ #[doc = ""]
+ #[doc = "\\a context is the information that can be used by the plugin to create"]
+ #[doc = "auth metadata."]
+ pub get_metadata: ::std::option::Option<
+ unsafe extern "C" fn(
+ state: *mut ::std::os::raw::c_void,
+ context: grpc_auth_metadata_context,
+ cb: grpc_credentials_plugin_metadata_cb,
+ user_data: *mut ::std::os::raw::c_void,
+ creds_md: *mut grpc_metadata,
+ num_creds_md: *mut usize,
+ status: *mut grpc_status_code::Type,
+ error_details: *mut *const ::std::os::raw::c_char,
+ ) -> ::std::os::raw::c_int,
+ >,
+ #[doc = " Implements debug string of the given plugin. This method returns an"]
+ #[doc = " allocated string that the caller needs to free using gpr_free()"]
+ pub debug_string: ::std::option::Option<
+ unsafe extern "C" fn(state: *mut ::std::os::raw::c_void) -> *mut ::std::os::raw::c_char,
+ >,
+ #[doc = " Destroys the plugin state."]
+ pub destroy: ::std::option::Option<unsafe extern "C" fn(state: *mut ::std::os::raw::c_void)>,
+ #[doc = " State that will be set as the first parameter of the methods above."]
+ pub state: *mut ::std::os::raw::c_void,
+ #[doc = " Type of credentials that this plugin is implementing."]
+ pub type_: *const ::std::os::raw::c_char,
+}
+extern "C" {
+ #[doc = " Creates a credentials object from a plugin with a specified minimum security"]
+ #[doc = " level."]
+ pub fn grpc_metadata_credentials_create_from_plugin(
+ plugin: grpc_metadata_credentials_plugin,
+ min_security_level: grpc_security_level,
+ reserved: *mut ::std::os::raw::c_void,
+ ) -> *mut grpc_call_credentials;
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_ssl_server_certificate_config {
+ _unused: [u8; 0],
+}
+extern "C" {
+ #[doc = " Creates a grpc_ssl_server_certificate_config object."]
+ #[doc = "- pem_roots_cert is the NULL-terminated string containing the PEM encoding of"]
+ #[doc = "the client root certificates. This parameter may be NULL if the server does"]
+ #[doc = "not want the client to be authenticated with SSL."]
+ #[doc = "- pem_key_cert_pairs is an array private key / certificate chains of the"]
+ #[doc = "server. This parameter cannot be NULL."]
+ #[doc = "- num_key_cert_pairs indicates the number of items in the private_key_files"]
+ #[doc = "and cert_chain_files parameters. It must be at least 1."]
+ #[doc = "- It is the caller's responsibility to free this object via"]
+ #[doc = "grpc_ssl_server_certificate_config_destroy()."]
+ pub fn grpc_ssl_server_certificate_config_create(
+ pem_root_certs: *const ::std::os::raw::c_char,
+ pem_key_cert_pairs: *const grpc_ssl_pem_key_cert_pair,
+ num_key_cert_pairs: usize,
+ ) -> *mut grpc_ssl_server_certificate_config;
+}
+extern "C" {
+ #[doc = " Destroys a grpc_ssl_server_certificate_config object."]
+ pub fn grpc_ssl_server_certificate_config_destroy(
+ config: *mut grpc_ssl_server_certificate_config,
+ );
+}
+#[doc = " Callback to retrieve updated SSL server certificates, private keys, and"]
+#[doc = "trusted CAs (for client authentication)."]
+#[doc = "- user_data parameter, if not NULL, contains opaque data to be used by the"]
+#[doc = "callback."]
+#[doc = "- Use grpc_ssl_server_certificate_config_create to create the config."]
+#[doc = "- The caller assumes ownership of the config."]
+pub type grpc_ssl_server_certificate_config_callback = ::std::option::Option<
+ unsafe extern "C" fn(
+ user_data: *mut ::std::os::raw::c_void,
+ config: *mut *mut grpc_ssl_server_certificate_config,
+ ) -> grpc_ssl_certificate_config_reload_status,
+>;
+extern "C" {
+ #[doc = " Deprecated in favor of grpc_ssl_server_credentials_create_ex."]
+ #[doc = "Creates an SSL server_credentials object."]
+ #[doc = "- pem_roots_cert is the NULL-terminated string containing the PEM encoding of"]
+ #[doc = "the client root certificates. This parameter may be NULL if the server does"]
+ #[doc = "not want the client to be authenticated with SSL."]
+ #[doc = "- pem_key_cert_pairs is an array private key / certificate chains of the"]
+ #[doc = "server. This parameter cannot be NULL."]
+ #[doc = "- num_key_cert_pairs indicates the number of items in the private_key_files"]
+ #[doc = "and cert_chain_files parameters. It should be at least 1."]
+ #[doc = "- force_client_auth, if set to non-zero will force the client to authenticate"]
+ #[doc = "with an SSL cert. Note that this option is ignored if pem_root_certs is"]
+ #[doc = "NULL."]
+ pub fn grpc_ssl_server_credentials_create(
+ pem_root_certs: *const ::std::os::raw::c_char,
+ pem_key_cert_pairs: *mut grpc_ssl_pem_key_cert_pair,
+ num_key_cert_pairs: usize,
+ force_client_auth: ::std::os::raw::c_int,
+ reserved: *mut ::std::os::raw::c_void,
+ ) -> *mut grpc_server_credentials;
+}
+extern "C" {
+ #[doc = " Deprecated in favor of grpc_ssl_server_credentials_create_with_options."]
+ #[doc = "Same as grpc_ssl_server_credentials_create method except uses"]
+ #[doc = "grpc_ssl_client_certificate_request_type enum to support more ways to"]
+ #[doc = "authenticate client certificates."]
+ pub fn grpc_ssl_server_credentials_create_ex(
+ pem_root_certs: *const ::std::os::raw::c_char,
+ pem_key_cert_pairs: *mut grpc_ssl_pem_key_cert_pair,
+ num_key_cert_pairs: usize,
+ client_certificate_request: grpc_ssl_client_certificate_request_type,
+ reserved: *mut ::std::os::raw::c_void,
+ ) -> *mut grpc_server_credentials;
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_ssl_server_credentials_options {
+ _unused: [u8; 0],
+}
+extern "C" {
+ #[doc = " Creates an options object using a certificate config. Use this method when"]
+ #[doc = "the certificates and keys of the SSL server will not change during the"]
+ #[doc = "server's lifetime."]
+ #[doc = "- Takes ownership of the certificate_config parameter."]
+ pub fn grpc_ssl_server_credentials_create_options_using_config(
+ client_certificate_request: grpc_ssl_client_certificate_request_type,
+ certificate_config: *mut grpc_ssl_server_certificate_config,
+ ) -> *mut grpc_ssl_server_credentials_options;
+}
+extern "C" {
+ #[doc = " Creates an options object using a certificate config fetcher. Use this"]
+ #[doc = "method to reload the certificates and keys of the SSL server without"]
+ #[doc = "interrupting the operation of the server. Initial certificate config will be"]
+ #[doc = "fetched during server initialization."]
+ #[doc = "- user_data parameter, if not NULL, contains opaque data which will be passed"]
+ #[doc = "to the fetcher (see definition of"]
+ #[doc = "grpc_ssl_server_certificate_config_callback)."]
+ pub fn grpc_ssl_server_credentials_create_options_using_config_fetcher(
+ client_certificate_request: grpc_ssl_client_certificate_request_type,
+ cb: grpc_ssl_server_certificate_config_callback,
+ user_data: *mut ::std::os::raw::c_void,
+ ) -> *mut grpc_ssl_server_credentials_options;
+}
+extern "C" {
+ #[doc = " Destroys a grpc_ssl_server_credentials_options object."]
+ pub fn grpc_ssl_server_credentials_options_destroy(
+ options: *mut grpc_ssl_server_credentials_options,
+ );
+}
+extern "C" {
+ #[doc = " Creates an SSL server_credentials object using the provided options struct."]
+ #[doc = "- Takes ownership of the options parameter."]
+ pub fn grpc_ssl_server_credentials_create_with_options(
+ options: *mut grpc_ssl_server_credentials_options,
+ ) -> *mut grpc_server_credentials;
+}
+extern "C" {
+ #[doc = " Sets a credentials to a call. Can only be called on the client side before"]
+ #[doc = "grpc_call_start_batch."]
+ pub fn grpc_call_set_credentials(
+ call: *mut grpc_call,
+ creds: *mut grpc_call_credentials,
+ ) -> grpc_call_error;
+}
+#[doc = " Callback function that is called when the metadata processing is done."]
+#[doc = "- Consumed metadata will be removed from the set of metadata available on the"]
+#[doc = "call. consumed_md may be NULL if no metadata has been consumed."]
+#[doc = "- Response metadata will be set on the response. response_md may be NULL."]
+#[doc = "- status is GRPC_STATUS_OK for success or a specific status for an error."]
+#[doc = "Common error status for auth metadata processing is either"]
+#[doc = "GRPC_STATUS_UNAUTHENTICATED in case of an authentication failure or"]
+#[doc = "GRPC_STATUS PERMISSION_DENIED in case of an authorization failure."]
+#[doc = "- error_details gives details about the error. May be NULL."]
+pub type grpc_process_auth_metadata_done_cb = ::std::option::Option<
+ unsafe extern "C" fn(
+ user_data: *mut ::std::os::raw::c_void,
+ consumed_md: *const grpc_metadata,
+ num_consumed_md: usize,
+ response_md: *const grpc_metadata,
+ num_response_md: usize,
+ status: grpc_status_code::Type,
+ error_details: *const ::std::os::raw::c_char,
+ ),
+>;
+#[doc = " Pluggable server-side metadata processor object."]
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_auth_metadata_processor {
+ #[doc = " The context object is read/write: it contains the properties of the"]
+ #[doc = "channel peer and it is the job of the process function to augment it with"]
+ #[doc = "properties derived from the passed-in metadata."]
+ #[doc = "The lifetime of these objects is guaranteed until cb is invoked."]
+ pub process: ::std::option::Option<
+ unsafe extern "C" fn(
+ state: *mut ::std::os::raw::c_void,
+ context: *mut grpc_auth_context,
+ md: *const grpc_metadata,
+ num_md: usize,
+ cb: grpc_process_auth_metadata_done_cb,
+ user_data: *mut ::std::os::raw::c_void,
+ ),
+ >,
+ pub destroy: ::std::option::Option<unsafe extern "C" fn(state: *mut ::std::os::raw::c_void)>,
+ pub state: *mut ::std::os::raw::c_void,
+}
+extern "C" {
+ pub fn grpc_server_credentials_set_auth_metadata_processor(
+ creds: *mut grpc_server_credentials,
+ processor: grpc_auth_metadata_processor,
+ );
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_alts_credentials_options {
+ _unused: [u8; 0],
+}
+extern "C" {
+ #[doc = " This method creates a grpc ALTS credentials client options instance."]
+ #[doc = " It is used for experimental purpose for now and subject to change."]
+ pub fn grpc_alts_credentials_client_options_create() -> *mut grpc_alts_credentials_options;
+}
+extern "C" {
+ #[doc = " This method creates a grpc ALTS credentials server options instance."]
+ #[doc = " It is used for experimental purpose for now and subject to change."]
+ pub fn grpc_alts_credentials_server_options_create() -> *mut grpc_alts_credentials_options;
+}
+extern "C" {
+ #[doc = " This method adds a target service account to grpc client's ALTS credentials"]
+ #[doc = " options instance. It is used for experimental purpose for now and subject"]
+ #[doc = " to change."]
+ #[doc = ""]
+ #[doc = " - options: grpc ALTS credentials options instance."]
+ #[doc = " - service_account: service account of target endpoint."]
+ pub fn grpc_alts_credentials_client_options_add_target_service_account(
+ options: *mut grpc_alts_credentials_options,
+ service_account: *const ::std::os::raw::c_char,
+ );
+}
+extern "C" {
+ #[doc = " This method destroys a grpc_alts_credentials_options instance by"]
+ #[doc = " de-allocating all of its occupied memory. It is used for experimental purpose"]
+ #[doc = " for now and subject to change."]
+ #[doc = ""]
+ #[doc = " - options: a grpc_alts_credentials_options instance that needs to be"]
+ #[doc = " destroyed."]
+ pub fn grpc_alts_credentials_options_destroy(options: *mut grpc_alts_credentials_options);
+}
+extern "C" {
+ #[doc = " This method creates an ALTS channel credential object. The security"]
+ #[doc = " level of the resulting connection is GRPC_PRIVACY_AND_INTEGRITY."]
+ #[doc = " It is used for experimental purpose for now and subject to change."]
+ #[doc = ""]
+ #[doc = " - options: grpc ALTS credentials options instance for client."]
+ #[doc = ""]
+ #[doc = " It returns the created ALTS channel credential object."]
+ pub fn grpc_alts_credentials_create(
+ options: *const grpc_alts_credentials_options,
+ ) -> *mut grpc_channel_credentials;
+}
+extern "C" {
+ #[doc = " This method creates an ALTS server credential object. It is used for"]
+ #[doc = " experimental purpose for now and subject to change."]
+ #[doc = ""]
+ #[doc = " - options: grpc ALTS credentials options instance for server."]
+ #[doc = ""]
+ #[doc = " It returns the created ALTS server credential object."]
+ pub fn grpc_alts_server_credentials_create(
+ options: *const grpc_alts_credentials_options,
+ ) -> *mut grpc_server_credentials;
+}
+extern "C" {
+ #[doc = " This method creates a local channel credential object. The security level"]
+ #[doc = " of the resulting connection is GRPC_PRIVACY_AND_INTEGRITY for UDS and"]
+ #[doc = " GRPC_SECURITY_NONE for LOCAL_TCP. It is used for experimental purpose"]
+ #[doc = " for now and subject to change."]
+ #[doc = ""]
+ #[doc = " - type: local connection type"]
+ #[doc = ""]
+ #[doc = " It returns the created local channel credential object."]
+ pub fn grpc_local_credentials_create(
+ type_: grpc_local_connect_type,
+ ) -> *mut grpc_channel_credentials;
+}
+extern "C" {
+ #[doc = " This method creates a local server credential object. It is used for"]
+ #[doc = " experimental purpose for now and subject to change."]
+ #[doc = ""]
+ #[doc = " - type: local connection type"]
+ #[doc = ""]
+ #[doc = " It returns the created local server credential object."]
+ pub fn grpc_local_server_credentials_create(
+ type_: grpc_local_connect_type,
+ ) -> *mut grpc_server_credentials;
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_tls_credentials_options {
+ _unused: [u8; 0],
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_tls_certificate_provider {
+ _unused: [u8; 0],
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_tls_identity_pairs {
+ _unused: [u8; 0],
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " Creates a grpc_tls_identity_pairs that stores a list of identity credential"]
+ #[doc = " data, including identity private key and identity certificate chain."]
+ pub fn grpc_tls_identity_pairs_create() -> *mut grpc_tls_identity_pairs;
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " Adds a identity private key and a identity certificate chain to"]
+ #[doc = " grpc_tls_identity_pairs. This function will make an internal copy of"]
+ #[doc = " |private_key| and |cert_chain|."]
+ pub fn grpc_tls_identity_pairs_add_pair(
+ pairs: *mut grpc_tls_identity_pairs,
+ private_key: *const ::std::os::raw::c_char,
+ cert_chain: *const ::std::os::raw::c_char,
+ );
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " Destroys a grpc_tls_identity_pairs object. If this object is passed to a"]
+ #[doc = " provider initiation function, the ownership is transferred so this function"]
+ #[doc = " doesn't need to be called. Otherwise the creator of the"]
+ #[doc = " grpc_tls_identity_pairs object is responsible for its destruction."]
+ pub fn grpc_tls_identity_pairs_destroy(pairs: *mut grpc_tls_identity_pairs);
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " Creates a grpc_tls_certificate_provider that will load credential data from"]
+ #[doc = " static string during initialization. This provider will always return the"]
+ #[doc = " same cert data for all cert names."]
+ #[doc = " root_certificate and pem_key_cert_pairs can be nullptr, indicating the"]
+ #[doc = " corresponding credential data is not needed."]
+ #[doc = " This function will make a copy of |root_certificate|."]
+ #[doc = " The ownership of |pem_key_cert_pairs| is transferred."]
+ pub fn grpc_tls_certificate_provider_static_data_create(
+ root_certificate: *const ::std::os::raw::c_char,
+ pem_key_cert_pairs: *mut grpc_tls_identity_pairs,
+ ) -> *mut grpc_tls_certificate_provider;
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " Creates a grpc_tls_certificate_provider that will watch the credential"]
+ #[doc = " changes on the file system. This provider will always return the up-to-date"]
+ #[doc = " cert data for all the cert names callers set through"]
+ #[doc = " |grpc_tls_credentials_options|. Note that this API only supports one key-cert"]
+ #[doc = " file and hence one set of identity key-cert pair, so SNI(Server Name"]
+ #[doc = " Indication) is not supported."]
+ #[doc = " - private_key_path is the file path of the private key. This must be set if"]
+ #[doc = " |identity_certificate_path| is set. Otherwise, it could be null if no"]
+ #[doc = " identity credentials are needed."]
+ #[doc = " - identity_certificate_path is the file path of the identity certificate"]
+ #[doc = " chain. This must be set if |private_key_path| is set. Otherwise, it could"]
+ #[doc = " be null if no identity credentials are needed."]
+ #[doc = " - root_cert_path is the file path to the root certificate bundle. This"]
+ #[doc = " may be null if no root certs are needed."]
+ #[doc = " - refresh_interval_sec is the refreshing interval that we will check the"]
+ #[doc = " files for updates."]
+ #[doc = " It does not take ownership of parameters."]
+ pub fn grpc_tls_certificate_provider_file_watcher_create(
+ private_key_path: *const ::std::os::raw::c_char,
+ identity_certificate_path: *const ::std::os::raw::c_char,
+ root_cert_path: *const ::std::os::raw::c_char,
+ refresh_interval_sec: ::std::os::raw::c_uint,
+ ) -> *mut grpc_tls_certificate_provider;
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " Releases a grpc_tls_certificate_provider object. The creator of the"]
+ #[doc = " grpc_tls_certificate_provider object is responsible for its release."]
+ pub fn grpc_tls_certificate_provider_release(provider: *mut grpc_tls_certificate_provider);
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " Creates an grpc_tls_credentials_options."]
+ pub fn grpc_tls_credentials_options_create() -> *mut grpc_tls_credentials_options;
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " Sets the credential provider in the options."]
+ #[doc = " The |options| will implicitly take a new ref to the |provider|."]
+ pub fn grpc_tls_credentials_options_set_certificate_provider(
+ options: *mut grpc_tls_credentials_options,
+ provider: *mut grpc_tls_certificate_provider,
+ );
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " If set, gRPC stack will keep watching the root certificates with"]
+ #[doc = " name |root_cert_name|."]
+ #[doc = " If this is not set on the client side, we will use the root certificates"]
+ #[doc = " stored in the default system location, since client side must provide root"]
+ #[doc = " certificates in TLS."]
+ #[doc = " If this is not set on the server side, we will not watch any root certificate"]
+ #[doc = " updates, and assume no root certificates needed for the server(single-side"]
+ #[doc = " TLS). Default root certs on the server side is not supported."]
+ pub fn grpc_tls_credentials_options_watch_root_certs(
+ options: *mut grpc_tls_credentials_options,
+ );
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " Sets the name of the root certificates being watched."]
+ #[doc = " If not set, We will use a default empty string as the root certificate name."]
+ pub fn grpc_tls_credentials_options_set_root_cert_name(
+ options: *mut grpc_tls_credentials_options,
+ root_cert_name: *const ::std::os::raw::c_char,
+ );
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " If set, gRPC stack will keep watching the identity key-cert pairs"]
+ #[doc = " with name |identity_cert_name|."]
+ #[doc = " This is required on the server side, and optional on the client side."]
+ pub fn grpc_tls_credentials_options_watch_identity_key_cert_pairs(
+ options: *mut grpc_tls_credentials_options,
+ );
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " Sets the name of the identity certificates being watched."]
+ #[doc = " If not set, We will use a default empty string as the identity certificate"]
+ #[doc = " name."]
+ pub fn grpc_tls_credentials_options_set_identity_cert_name(
+ options: *mut grpc_tls_credentials_options,
+ identity_cert_name: *const ::std::os::raw::c_char,
+ );
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " Sets the options of whether to request and/or verify client certs. This shall"]
+ #[doc = " only be called on the server side."]
+ pub fn grpc_tls_credentials_options_set_cert_request_type(
+ options: *mut grpc_tls_credentials_options,
+ type_: grpc_ssl_client_certificate_request_type,
+ );
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " If set, gRPC will read all hashed x.509 CRL files in the directory and"]
+ #[doc = " enforce the CRL files on all TLS handshakes. Only supported for OpenSSL"]
+ #[doc = " version > 1.1."]
+ #[doc = " It is used for experimental purpose for now and subject to change."]
+ pub fn grpc_tls_credentials_options_set_crl_directory(
+ options: *mut grpc_tls_credentials_options,
+ crl_directory: *const ::std::os::raw::c_char,
+ );
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " Sets the options of whether to verify server certs on the client side."]
+ #[doc = " Passing in a non-zero value indicates verifying the certs."]
+ pub fn grpc_tls_credentials_options_set_verify_server_cert(
+ options: *mut grpc_tls_credentials_options,
+ verify_server_cert: ::std::os::raw::c_int,
+ );
+}
+#[doc = " EXPERIMENTAL API - Subject to change"]
+#[doc = ""]
+#[doc = " The read-only request information exposed in a verification call."]
+#[doc = " Callers should not directly manage the ownership of it. We will make sure it"]
+#[doc = " is always available inside verify() or cancel() call, and will destroy the"]
+#[doc = " object at the end of custom verification."]
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_tls_custom_verification_check_request {
+ pub target_name: *const ::std::os::raw::c_char,
+ pub peer_info: grpc_tls_custom_verification_check_request_peer_info,
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_tls_custom_verification_check_request_peer_info {
+ pub common_name: *const ::std::os::raw::c_char,
+ pub san_names: grpc_tls_custom_verification_check_request_peer_info_san_names,
+ pub peer_cert: *const ::std::os::raw::c_char,
+ pub peer_cert_full_chain: *const ::std::os::raw::c_char,
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_tls_custom_verification_check_request_peer_info_san_names {
+ pub uri_names: *mut *mut ::std::os::raw::c_char,
+ pub uri_names_size: usize,
+ pub dns_names: *mut *mut ::std::os::raw::c_char,
+ pub dns_names_size: usize,
+ pub email_names: *mut *mut ::std::os::raw::c_char,
+ pub email_names_size: usize,
+ pub ip_names: *mut *mut ::std::os::raw::c_char,
+ pub ip_names_size: usize,
+}
+#[doc = " EXPERIMENTAL API - Subject to change"]
+#[doc = ""]
+#[doc = " A callback function provided by gRPC as a parameter of the |verify| function"]
+#[doc = " in grpc_tls_certificate_verifier_external. If |verify| is expected to be run"]
+#[doc = " asynchronously, the implementer of |verify| will need to invoke this callback"]
+#[doc = " with |callback_arg| and proper verification status at the end to bring the"]
+#[doc = " control back to gRPC C core."]
+pub type grpc_tls_on_custom_verification_check_done_cb = ::std::option::Option<
+ unsafe extern "C" fn(
+ request: *mut grpc_tls_custom_verification_check_request,
+ callback_arg: *mut ::std::os::raw::c_void,
+ status: grpc_status_code::Type,
+ error_details: *const ::std::os::raw::c_char,
+ ),
+>;
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_tls_certificate_verifier {
+ _unused: [u8; 0],
+}
+#[doc = " EXPERIMENTAL API - Subject to change"]
+#[doc = ""]
+#[doc = " A struct containing all the necessary functions a custom external verifier"]
+#[doc = " needs to implement to be able to be converted to an internal verifier."]
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_tls_certificate_verifier_external {
+ pub user_data: *mut ::std::os::raw::c_void,
+ #[doc = " A function pointer containing the verification logic that will be"]
+ #[doc = " performed after the TLS handshake is done. It could be processed"]
+ #[doc = " synchronously or asynchronously."]
+ #[doc = " - If expected to be processed synchronously, the implementer should"]
+ #[doc = " populate the verification result through |sync_status| and"]
+ #[doc = " |sync_error_details|, and then return true."]
+ #[doc = " - If expected to be processed asynchronously, the implementer should return"]
+ #[doc = " false immediately, and then in the asynchronous thread invoke |callback|"]
+ #[doc = " with the verification result. The implementer MUST NOT invoke the async"]
+ #[doc = " |callback| in the same thread before |verify| returns, otherwise it can"]
+ #[doc = " lead to deadlocks."]
+ #[doc = ""]
+ #[doc = " user_data: any argument that is passed in the user_data of"]
+ #[doc = " grpc_tls_certificate_verifier_external during construction time"]
+ #[doc = " can be retrieved later here."]
+ #[doc = " request: request information exposed to the function implementer."]
+ #[doc = " callback: the callback that the function implementer needs to invoke, if"]
+ #[doc = " return a non-zero value. It is usually invoked when the"]
+ #[doc = " asynchronous verification is done, and serves to bring the"]
+ #[doc = " control back to gRPC."]
+ #[doc = " callback_arg: A pointer to the internal ExternalVerifier instance. This is"]
+ #[doc = " mainly used as an argument in |callback|, if want to invoke"]
+ #[doc = " |callback| in async mode."]
+ #[doc = " sync_status: indicates if a connection should be allowed. This should only"]
+ #[doc = " be used if the verification check is done synchronously."]
+ #[doc = " sync_error_details: the error generated while verifying a connection. This"]
+ #[doc = " should only be used if the verification check is done"]
+ #[doc = " synchronously. the implementation must allocate the"]
+ #[doc = " error string via gpr_malloc() or gpr_strdup()."]
+ #[doc = " return: return 0 if |verify| is expected to be executed asynchronously,"]
+ #[doc = " otherwise return a non-zero value."]
+ pub verify: ::std::option::Option<
+ unsafe extern "C" fn(
+ user_data: *mut ::std::os::raw::c_void,
+ request: *mut grpc_tls_custom_verification_check_request,
+ callback: grpc_tls_on_custom_verification_check_done_cb,
+ callback_arg: *mut ::std::os::raw::c_void,
+ sync_status: *mut grpc_status_code::Type,
+ sync_error_details: *mut *mut ::std::os::raw::c_char,
+ ) -> ::std::os::raw::c_int,
+ >,
+ #[doc = " A function pointer that cleans up the caller-specified resources when the"]
+ #[doc = " verifier is still running but the whole connection got cancelled. This"]
+ #[doc = " could happen when the verifier is doing some async operations, and the"]
+ #[doc = " whole handshaker object got destroyed because of connection time limit is"]
+ #[doc = " reached, or any other reasons. In such cases, function implementers might"]
+ #[doc = " want to be notified, and properly clean up some resources."]
+ #[doc = ""]
+ #[doc = " user_data: any argument that is passed in the user_data of"]
+ #[doc = " grpc_tls_certificate_verifier_external during construction time"]
+ #[doc = " can be retrieved later here."]
+ #[doc = " request: request information exposed to the function implementer. It will"]
+ #[doc = " be the same request object that was passed to verify(), and it"]
+ #[doc = " tells the cancel() which request to cancel."]
+ pub cancel: ::std::option::Option<
+ unsafe extern "C" fn(
+ user_data: *mut ::std::os::raw::c_void,
+ request: *mut grpc_tls_custom_verification_check_request,
+ ),
+ >,
+ #[doc = " A function pointer that does some additional destruction work when the"]
+ #[doc = " verifier is destroyed. This is used when the caller wants to associate some"]
+ #[doc = " objects to the lifetime of external_verifier, and destroy them when"]
+ #[doc = " external_verifier got destructed. For example, in C++, the class containing"]
+ #[doc = " user-specified callback functions should not be destroyed before"]
+ #[doc = " external_verifier, since external_verifier will invoke them while being"]
+ #[doc = " used."]
+ #[doc = " Note that the caller MUST delete the grpc_tls_certificate_verifier_external"]
+ #[doc = " object itself in this function, otherwise it will cause memory leaks. That"]
+ #[doc = " also means the user_data has to carries at least a self pointer, for the"]
+ #[doc = " callers to later delete it in destruct()."]
+ #[doc = ""]
+ #[doc = " user_data: any argument that is passed in the user_data of"]
+ #[doc = " grpc_tls_certificate_verifier_external during construction time"]
+ #[doc = " can be retrieved later here."]
+ pub destruct:
+ ::std::option::Option<unsafe extern "C" fn(user_data: *mut ::std::os::raw::c_void)>,
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " Converts an external verifier to an internal verifier."]
+ #[doc = " Note that we will not take the ownership of the external_verifier. Callers"]
+ #[doc = " will need to delete external_verifier in its own destruct function."]
+ pub fn grpc_tls_certificate_verifier_external_create(
+ external_verifier: *mut grpc_tls_certificate_verifier_external,
+ ) -> *mut grpc_tls_certificate_verifier;
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " Factory function for an internal verifier that will do the default hostname"]
+ #[doc = " check."]
+ pub fn grpc_tls_certificate_verifier_host_name_create() -> *mut grpc_tls_certificate_verifier;
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " Releases a grpc_tls_certificate_verifier object. The creator of the"]
+ #[doc = " grpc_tls_certificate_verifier object is responsible for its release."]
+ pub fn grpc_tls_certificate_verifier_release(verifier: *mut grpc_tls_certificate_verifier);
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " Sets the verifier in options. The |options| will implicitly take a new ref to"]
+ #[doc = " the |verifier|. If not set on the client side, we will verify server's"]
+ #[doc = " certificates, and check the default hostname. If not set on the server side,"]
+ #[doc = " we will verify client's certificates."]
+ pub fn grpc_tls_credentials_options_set_certificate_verifier(
+ options: *mut grpc_tls_credentials_options,
+ verifier: *mut grpc_tls_certificate_verifier,
+ );
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " Sets the options of whether to check the hostname of the peer on a per-call"]
+ #[doc = " basis. This is usually used in a combination with virtual hosting at the"]
+ #[doc = " client side, where each individual call on a channel can have a different"]
+ #[doc = " host associated with it."]
+ #[doc = " This check is intended to verify that the host specified for the individual"]
+ #[doc = " call is covered by the cert that the peer presented."]
+ #[doc = " The default is a non-zero value, which indicates performing such checks."]
+ pub fn grpc_tls_credentials_options_set_check_call_host(
+ options: *mut grpc_tls_credentials_options,
+ check_call_host: ::std::os::raw::c_int,
+ );
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " Performs the verification logic of an internal verifier."]
+ #[doc = " This is typically used when composing the internal verifiers as part of the"]
+ #[doc = " custom verification."]
+ #[doc = " If |grpc_tls_certificate_verifier_verify| returns true, inspect the"]
+ #[doc = " verification result through request->status and request->error_details."]
+ #[doc = " Otherwise, inspect through the parameter of |callback|."]
+ pub fn grpc_tls_certificate_verifier_verify(
+ verifier: *mut grpc_tls_certificate_verifier,
+ request: *mut grpc_tls_custom_verification_check_request,
+ callback: grpc_tls_on_custom_verification_check_done_cb,
+ callback_arg: *mut ::std::os::raw::c_void,
+ sync_status: *mut grpc_status_code::Type,
+ sync_error_details: *mut *mut ::std::os::raw::c_char,
+ ) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " Performs the cancellation logic of an internal verifier."]
+ #[doc = " This is typically used when composing the internal verifiers as part of the"]
+ #[doc = " custom verification."]
+ pub fn grpc_tls_certificate_verifier_cancel(
+ verifier: *mut grpc_tls_certificate_verifier,
+ request: *mut grpc_tls_custom_verification_check_request,
+ );
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " Creates a TLS channel credential object based on the"]
+ #[doc = " grpc_tls_credentials_options specified by callers. The"]
+ #[doc = " grpc_channel_credentials will take the ownership of the |options|. The"]
+ #[doc = " security level of the resulting connection is GRPC_PRIVACY_AND_INTEGRITY."]
+ pub fn grpc_tls_credentials_create(
+ options: *mut grpc_tls_credentials_options,
+ ) -> *mut grpc_channel_credentials;
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " Creates a TLS server credential object based on the"]
+ #[doc = " grpc_tls_credentials_options specified by callers. The"]
+ #[doc = " grpc_server_credentials will take the ownership of the |options|."]
+ pub fn grpc_tls_server_credentials_create(
+ options: *mut grpc_tls_credentials_options,
+ ) -> *mut grpc_server_credentials;
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " This method creates an insecure channel credentials object."]
+ pub fn grpc_insecure_credentials_create() -> *mut grpc_channel_credentials;
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " This method creates an insecure server credentials object."]
+ pub fn grpc_insecure_server_credentials_create() -> *mut grpc_server_credentials;
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " This method creates an xDS channel credentials object."]
+ #[doc = ""]
+ #[doc = " Creating a channel with credentials of this type indicates that the channel"]
+ #[doc = " should get credentials configuration from the xDS control plane."]
+ #[doc = ""]
+ #[doc = " \\a fallback_credentials are used if the channel target does not have the"]
+ #[doc = " 'xds:///' scheme or if the xDS control plane does not provide information on"]
+ #[doc = " how to fetch credentials dynamically. Does NOT take ownership of the \\a"]
+ #[doc = " fallback_credentials. (Internally takes a ref to the object.)"]
+ pub fn grpc_xds_credentials_create(
+ fallback_credentials: *mut grpc_channel_credentials,
+ ) -> *mut grpc_channel_credentials;
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change"]
+ #[doc = ""]
+ #[doc = " This method creates an xDS server credentials object."]
+ #[doc = ""]
+ #[doc = " \\a fallback_credentials are used if the xDS control plane does not provide"]
+ #[doc = " information on how to fetch credentials dynamically."]
+ #[doc = ""]
+ #[doc = " Does NOT take ownership of the \\a fallback_credentials. (Internally takes"]
+ #[doc = " a ref to the object.)"]
+ pub fn grpc_xds_server_credentials_create(
+ fallback_credentials: *mut grpc_server_credentials,
+ ) -> *mut grpc_server_credentials;
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpc_authorization_policy_provider {
+ _unused: [u8; 0],
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL - Subject to change."]
+ #[doc = " Creates a grpc_authorization_policy_provider using gRPC authorization policy"]
+ #[doc = " from static string."]
+ #[doc = " - authz_policy is the input gRPC authorization policy."]
+ #[doc = " - code is the error status code on failure. On success, it equals"]
+ #[doc = " GRPC_STATUS_OK."]
+ #[doc = " - error_details contains details about the error if any. If the"]
+ #[doc = " initialization is successful, it will be null. Caller must use gpr_free to"]
+ #[doc = " destroy this string."]
+ pub fn grpc_authorization_policy_provider_static_data_create(
+ authz_policy: *const ::std::os::raw::c_char,
+ code: *mut grpc_status_code::Type,
+ error_details: *mut *const ::std::os::raw::c_char,
+ ) -> *mut grpc_authorization_policy_provider;
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL - Subject to change."]
+ #[doc = " Creates a grpc_authorization_policy_provider by watching for gRPC"]
+ #[doc = " authorization policy changes in filesystem."]
+ #[doc = " - authz_policy is the file path of gRPC authorization policy."]
+ #[doc = " - refresh_interval_sec is the amount of time the internal thread would wait"]
+ #[doc = " before checking for file updates."]
+ #[doc = " - code is the error status code on failure. On success, it equals"]
+ #[doc = " GRPC_STATUS_OK."]
+ #[doc = " - error_details contains details about the error if any. If the"]
+ #[doc = " initialization is successful, it will be null. Caller must use gpr_free to"]
+ #[doc = " destroy this string."]
+ pub fn grpc_authorization_policy_provider_file_watcher_create(
+ authz_policy_path: *const ::std::os::raw::c_char,
+ refresh_interval_sec: ::std::os::raw::c_uint,
+ code: *mut grpc_status_code::Type,
+ error_details: *mut *const ::std::os::raw::c_char,
+ ) -> *mut grpc_authorization_policy_provider;
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL - Subject to change."]
+ #[doc = " Releases grpc_authorization_policy_provider object. The creator of"]
+ #[doc = " grpc_authorization_policy_provider is responsible for its release."]
+ pub fn grpc_authorization_policy_provider_release(
+ provider: *mut grpc_authorization_policy_provider,
+ );
+}
+extern "C" {
+ #[doc = " EXPERIMENTAL API - Subject to change."]
+ #[doc = " Configures a grpc_tls_credentials_options object with tls session key"]
+ #[doc = " logging capability. TLS channels using these credentials have tls session"]
+ #[doc = " key logging enabled."]
+ #[doc = " - options is the grpc_tls_credentials_options object"]
+ #[doc = " - path is a string pointing to the location where TLS session keys would be"]
+ #[doc = " stored."]
+ pub fn grpc_tls_credentials_options_set_tls_session_key_log_file_path(
+ options: *mut grpc_tls_credentials_options,
+ path: *const ::std::os::raw::c_char,
+ );
+}
+#[repr(u32)]
+#[doc = " The severity of a log message - use the #defines below when calling into"]
+#[doc = "gpr_log to additionally supply file and line data"]
+#[derive(Debug, Copy, Clone, Hash, PartialEq, Eq)]
+pub enum gpr_log_severity {
+ GPR_LOG_SEVERITY_DEBUG = 0,
+ GPR_LOG_SEVERITY_INFO = 1,
+ GPR_LOG_SEVERITY_ERROR = 2,
+}
+extern "C" {
+ #[doc = " Returns a string representation of the log severity"]
+ pub fn gpr_log_severity_string(severity: gpr_log_severity) -> *const ::std::os::raw::c_char;
+}
+extern "C" {
+ #[doc = " Log a message. It's advised to use GPR_xxx above to generate the context"]
+ #[doc = " for each message"]
+ pub fn gpr_log(
+ file: *const ::std::os::raw::c_char,
+ line: ::std::os::raw::c_int,
+ severity: gpr_log_severity,
+ format: *const ::std::os::raw::c_char,
+ ...
+ );
+}
+extern "C" {
+ pub fn gpr_should_log(severity: gpr_log_severity) -> ::std::os::raw::c_int;
+}
+extern "C" {
+ pub fn gpr_log_message(
+ file: *const ::std::os::raw::c_char,
+ line: ::std::os::raw::c_int,
+ severity: gpr_log_severity,
+ message: *const ::std::os::raw::c_char,
+ );
+}
+extern "C" {
+ #[doc = " Set global log verbosity"]
+ pub fn gpr_set_log_verbosity(min_severity_to_print: gpr_log_severity);
+}
+extern "C" {
+ pub fn gpr_log_verbosity_init();
+}
+#[doc = " Log overrides: applications can use this API to intercept logging calls"]
+#[doc = "and use their own implementations"]
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct gpr_log_func_args {
+ pub file: *const ::std::os::raw::c_char,
+ pub line: ::std::os::raw::c_int,
+ pub severity: gpr_log_severity,
+ pub message: *const ::std::os::raw::c_char,
+}
+pub type gpr_log_func = ::std::option::Option<unsafe extern "C" fn(args: *mut gpr_log_func_args)>;
+extern "C" {
+ pub fn gpr_set_log_function(func: gpr_log_func);
+}
+extern "C" {
+ #[doc = " malloc."]
+ #[doc = " If size==0, always returns NULL. Otherwise this function never returns NULL."]
+ #[doc = " The pointer returned is suitably aligned for any kind of variable it could"]
+ #[doc = " contain."]
+ pub fn gpr_malloc(size: usize) -> *mut ::std::os::raw::c_void;
+}
+extern "C" {
+ #[doc = " like malloc, but zero all bytes before returning them"]
+ pub fn gpr_zalloc(size: usize) -> *mut ::std::os::raw::c_void;
+}
+extern "C" {
+ #[doc = " free"]
+ pub fn gpr_free(ptr: *mut ::std::os::raw::c_void);
+}
+extern "C" {
+ #[doc = " realloc, never returns NULL"]
+ pub fn gpr_realloc(p: *mut ::std::os::raw::c_void, size: usize) -> *mut ::std::os::raw::c_void;
+}
+extern "C" {
+ #[doc = " aligned malloc, never returns NULL, will align to alignment, which"]
+ #[doc = " must be a power of 2."]
+ pub fn gpr_malloc_aligned(size: usize, alignment: usize) -> *mut ::std::os::raw::c_void;
+}
+extern "C" {
+ #[doc = " free memory allocated by gpr_malloc_aligned"]
+ pub fn gpr_free_aligned(ptr: *mut ::std::os::raw::c_void);
+}
+extern "C" {
+ #[doc = " Return the number of CPU cores on the current system. Will return 0 if"]
+ #[doc = "the information is not available."]
+ pub fn gpr_cpu_num_cores() -> ::std::os::raw::c_uint;
+}
+extern "C" {
+ #[doc = " Return the CPU on which the current thread is executing; N.B. This should"]
+ #[doc = "be considered advisory only - it is possible that the thread is switched"]
+ #[doc = "to a different CPU at any time. Returns a value in range"]
+ #[doc = "[0, gpr_cpu_num_cores() - 1]"]
+ pub fn gpr_cpu_current_cpu() -> ::std::os::raw::c_uint;
+}
+extern "C" {
+ #[doc = " Returns a string allocated with gpr_malloc that contains a UTF-8"]
+ #[doc = " formatted error message, corresponding to the error messageid."]
+ #[doc = " Use in conjunction with GetLastError() et al."]
+ pub fn gpr_format_message(messageid: ::std::os::raw::c_int) -> *mut ::std::os::raw::c_char;
+}
+extern "C" {
+ #[doc = " Returns a copy of src that can be passed to gpr_free()."]
+ #[doc = "If allocation fails or if src is NULL, returns NULL."]
+ pub fn gpr_strdup(src: *const ::std::os::raw::c_char) -> *mut ::std::os::raw::c_char;
+}
+extern "C" {
+ #[doc = " printf to a newly-allocated string. The set of supported formats may vary"]
+ #[doc = "between platforms."]
+ #[doc = ""]
+ #[doc = "On success, returns the number of bytes printed (excluding the final '\\0'),"]
+ #[doc = "and *strp points to a string which must later be destroyed with gpr_free()."]
+ #[doc = ""]
+ #[doc = "On error, returns -1 and sets *strp to NULL. If the format string is bad,"]
+ #[doc = "the result is undefined."]
+ pub fn gpr_asprintf(
+ strp: *mut *mut ::std::os::raw::c_char,
+ format: *const ::std::os::raw::c_char,
+ ...
+ ) -> ::std::os::raw::c_int;
+}
+pub type gpr_thd_id = usize;
+extern "C" {
+ #[doc = " Returns the identifier of the current thread."]
+ pub fn gpr_thd_currentid() -> gpr_thd_id;
+}
+#[doc = " Reader for byte buffers. Iterates over slices in the byte buffer"]
+#[repr(C)]
+#[derive(Copy, Clone)]
+pub struct grpc_byte_buffer_reader {
+ pub buffer_in: *mut grpc_byte_buffer,
+ pub buffer_out: *mut grpc_byte_buffer,
+ pub current: grpc_byte_buffer_reader_grpc_byte_buffer_reader_current,
+}
+#[doc = " Different current objects correspond to different types of byte buffers"]
+#[repr(C)]
+#[derive(Copy, Clone)]
+pub union grpc_byte_buffer_reader_grpc_byte_buffer_reader_current {
+ #[doc = " Index into a slice buffer's array of slices"]
+ pub index: ::std::os::raw::c_uint,
+}
+impl ::std::fmt::Debug for grpc_byte_buffer_reader_grpc_byte_buffer_reader_current {
+ fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
+ write!(
+ f,
+ "grpc_byte_buffer_reader_grpc_byte_buffer_reader_current {{ union }}"
+ )
+ }
+}
+impl ::std::fmt::Debug for grpc_byte_buffer_reader {
+ fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
+ write!(
+ f,
+ "grpc_byte_buffer_reader {{ buffer_in: {:?}, buffer_out: {:?}, current: {:?} }}",
+ self.buffer_in, self.buffer_out, self.current
+ )
+ }
+}
+#[repr(C)]
+#[derive(Copy, Clone)]
+pub struct grpcwrap_batch_context {
+ pub send_initial_metadata: grpc_metadata_array,
+ pub send_message: *mut grpc_byte_buffer,
+ pub send_status_from_server: grpcwrap_batch_context__bindgen_ty_1,
+ pub recv_initial_metadata: grpc_metadata_array,
+ pub recv_message: *mut grpc_byte_buffer,
+ pub recv_status_on_client: grpcwrap_batch_context__bindgen_ty_2,
+ pub recv_close_on_server_cancelled: ::std::os::raw::c_int,
+}
+#[repr(C)]
+#[derive(Debug, Copy, Clone)]
+pub struct grpcwrap_batch_context__bindgen_ty_1 {
+ pub trailing_metadata: grpc_metadata_array,
+}
+#[repr(C)]
+#[derive(Copy, Clone)]
+pub struct grpcwrap_batch_context__bindgen_ty_2 {
+ pub trailing_metadata: grpc_metadata_array,
+ pub status: grpc_status_code::Type,
+ pub status_details: grpc_slice,
+ pub error_string: *const ::std::os::raw::c_char,
+}
+impl ::std::fmt::Debug for grpcwrap_batch_context__bindgen_ty_2 {
+ fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
+ write ! (f , "grpcwrap_batch_context__bindgen_ty_2 {{ trailing_metadata: {:?}, status: {:?}, status_details: {:?}, error_string: {:?} }}" , self . trailing_metadata , self . status , self . status_details , self . error_string)
+ }
+}
+impl ::std::fmt::Debug for grpcwrap_batch_context {
+ fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
+ write ! (f , "grpcwrap_batch_context {{ send_initial_metadata: {:?}, send_message: {:?}, send_status_from_server: {:?}, recv_initial_metadata: {:?}, recv_message: {:?}, recv_status_on_client: {:?}, recv_close_on_server_cancelled: {:?} }}" , self . send_initial_metadata , self . send_message , self . send_status_from_server , self . recv_initial_metadata , self . recv_message , self . recv_status_on_client , self . recv_close_on_server_cancelled)
+ }
+}
+extern "C" {
+ pub fn grpcwrap_batch_context_create() -> *mut grpcwrap_batch_context;
+}
+#[repr(C)]
+#[derive(Copy, Clone)]
+pub struct grpcwrap_request_call_context {
+ pub call: *mut grpc_call,
+ pub call_details: grpc_call_details,
+ pub request_metadata: grpc_metadata_array,
+}
+impl ::std::fmt::Debug for grpcwrap_request_call_context {
+ fn fmt(&self, f: &mut ::std::fmt::Formatter<'_>) -> ::std::fmt::Result {
+ write ! (f , "grpcwrap_request_call_context {{ call: {:?}, call_details: {:?}, request_metadata: {:?} }}" , self . call , self . call_details , self . request_metadata)
+ }
+}
+extern "C" {
+ pub fn grpcwrap_request_call_context_create() -> *mut grpcwrap_request_call_context;
+}
+extern "C" {
+ pub fn grpcwrap_metadata_array_destroy_metadata_only(array: *mut grpc_metadata_array);
+}
+extern "C" {
+ pub fn grpcwrap_metadata_array_destroy_metadata_including_entries(
+ array: *mut grpc_metadata_array,
+ );
+}
+extern "C" {
+ pub fn grpcwrap_metadata_array_destroy_full(array: *mut grpc_metadata_array);
+}
+extern "C" {
+ pub fn grpcwrap_metadata_array_init(array: *mut grpc_metadata_array, capacity: usize);
+}
+extern "C" {
+ pub fn grpcwrap_metadata_array_add(
+ array: *mut grpc_metadata_array,
+ key: *const ::std::os::raw::c_char,
+ key_length: usize,
+ value: *const ::std::os::raw::c_char,
+ value_length: usize,
+ );
+}
+extern "C" {
+ pub fn grpcwrap_metadata_array_get_key(
+ array: *const grpc_metadata_array,
+ index: usize,
+ key_length: *mut usize,
+ ) -> *const ::std::os::raw::c_char;
+}
+extern "C" {
+ pub fn grpcwrap_metadata_array_get_value(
+ array: *const grpc_metadata_array,
+ index: usize,
+ value_length: *mut usize,
+ ) -> *const ::std::os::raw::c_char;
+}
+extern "C" {
+ pub fn grpcwrap_metadata_array_cleanup(array: *mut grpc_metadata_array);
+}
+extern "C" {
+ pub fn grpcwrap_metadata_array_shrink_to_fit(array: *mut grpc_metadata_array);
+}
+extern "C" {
+ pub fn grpcwrap_metadata_array_move(
+ dest: *mut grpc_metadata_array,
+ src: *mut grpc_metadata_array,
+ );
+}
+extern "C" {
+ pub fn grpcwrap_batch_context_destroy(ctx: *mut grpcwrap_batch_context);
+}
+extern "C" {
+ pub fn grpcwrap_request_call_context_destroy(ctx: *mut grpcwrap_request_call_context);
+}
+extern "C" {
+ pub fn grpcwrap_batch_context_take_recv_initial_metadata(
+ ctx: *mut grpcwrap_batch_context,
+ res: *mut grpc_metadata_array,
+ );
+}
+extern "C" {
+ pub fn grpcwrap_batch_context_take_recv_status_on_client_trailing_metadata(
+ ctx: *mut grpcwrap_batch_context,
+ res: *mut grpc_metadata_array,
+ );
+}
+extern "C" {
+ pub fn grpcwrap_slice_raw_offset(
+ slice: *const grpc_slice,
+ offset: usize,
+ len: *mut usize,
+ ) -> *const ::std::os::raw::c_char;
+}
+extern "C" {
+ pub fn grpcwrap_slice_copy(slice: *const grpc_slice) -> grpc_slice;
+}
+extern "C" {
+ pub fn grpcwrap_slice_unref(slice: *const grpc_slice);
+}
+extern "C" {
+ pub fn grpcwrap_slice_ref(slice: *const grpc_slice) -> grpc_slice;
+}
+extern "C" {
+ pub fn grpcwrap_slice_length(slice: *const grpc_slice) -> usize;
+}
+extern "C" {
+ pub fn grpcwrap_batch_context_take_recv_message(
+ ctx: *mut grpcwrap_batch_context,
+ ) -> *mut grpc_byte_buffer;
+}
+extern "C" {
+ pub fn grpcwrap_batch_context_recv_status_on_client_status(
+ ctx: *const grpcwrap_batch_context,
+ ) -> grpc_status_code::Type;
+}
+extern "C" {
+ pub fn grpcwrap_batch_context_recv_status_on_client_details(
+ ctx: *const grpcwrap_batch_context,
+ details_length: *mut usize,
+ ) -> *const ::std::os::raw::c_char;
+}
+extern "C" {
+ pub fn grpcwrap_batch_context_recv_status_on_client_trailing_metadata(
+ ctx: *const grpcwrap_batch_context,
+ ) -> *const grpc_metadata_array;
+}
+extern "C" {
+ pub fn grpcwrap_batch_context_recv_status_on_client_error_string(
+ ctx: *const grpcwrap_batch_context,
+ ) -> *const ::std::os::raw::c_char;
+}
+extern "C" {
+ pub fn grpcwrap_request_call_context_ref_call(
+ ctx: *mut grpcwrap_request_call_context,
+ ) -> *mut grpc_call;
+}
+extern "C" {
+ pub fn grpcwrap_request_call_context_get_call(
+ ctx: *mut grpcwrap_request_call_context,
+ ) -> *mut grpc_call;
+}
+extern "C" {
+ pub fn grpcwrap_request_call_context_method(
+ ctx: *const grpcwrap_request_call_context,
+ method_length: *mut usize,
+ ) -> *const ::std::os::raw::c_char;
+}
+extern "C" {
+ pub fn grpcwrap_request_call_context_host(
+ ctx: *const grpcwrap_request_call_context,
+ host_length: *mut usize,
+ ) -> *const ::std::os::raw::c_char;
+}
+extern "C" {
+ pub fn grpcwrap_request_call_context_deadline(
+ ctx: *const grpcwrap_request_call_context,
+ ) -> gpr_timespec;
+}
+extern "C" {
+ pub fn grpcwrap_request_call_context_metadata_array(
+ ctx: *const grpcwrap_request_call_context,
+ ) -> *const grpc_metadata_array;
+}
+extern "C" {
+ pub fn grpcwrap_batch_context_recv_close_on_server_cancelled(
+ ctx: *const grpcwrap_batch_context,
+ ) -> i32;
+}
+extern "C" {
+ pub fn grpcwrap_channel_create_call(
+ channel: *mut grpc_channel,
+ parent_call: *mut grpc_call,
+ propagation_mask: u32,
+ cq: *mut grpc_completion_queue,
+ method: *const ::std::os::raw::c_char,
+ method_len: usize,
+ host: *const ::std::os::raw::c_char,
+ host_len: usize,
+ deadline: gpr_timespec,
+ ) -> *mut grpc_call;
+}
+extern "C" {
+ pub fn grpcwrap_channel_args_create(num_args: usize) -> *mut grpc_channel_args;
+}
+extern "C" {
+ pub fn grpcwrap_channel_args_set_string(
+ args: *mut grpc_channel_args,
+ index: usize,
+ key: *const ::std::os::raw::c_char,
+ value: *const ::std::os::raw::c_char,
+ );
+}
+extern "C" {
+ pub fn grpcwrap_channel_args_set_integer(
+ args: *mut grpc_channel_args,
+ index: usize,
+ key: *const ::std::os::raw::c_char,
+ value: ::std::os::raw::c_int,
+ );
+}
+extern "C" {
+ pub fn grpcwrap_channel_args_set_pointer_vtable(
+ args: *mut grpc_channel_args,
+ index: usize,
+ key: *const ::std::os::raw::c_char,
+ value: *mut ::std::os::raw::c_void,
+ vtable: *const grpc_arg_pointer_vtable,
+ );
+}
+extern "C" {
+ pub fn grpcwrap_channel_args_destroy(args: *mut grpc_channel_args);
+}
+extern "C" {
+ pub fn grpcwrap_call_start_unary(
+ call: *mut grpc_call,
+ ctx: *mut grpcwrap_batch_context,
+ send_buffer: *mut grpc_slice,
+ write_flags: u32,
+ initial_metadata: *mut grpc_metadata_array,
+ initial_metadata_flags: u32,
+ tag: *mut ::std::os::raw::c_void,
+ ) -> grpc_call_error;
+}
+extern "C" {
+ pub fn grpcwrap_call_start_client_streaming(
+ call: *mut grpc_call,
+ ctx: *mut grpcwrap_batch_context,
+ initial_metadata: *mut grpc_metadata_array,
+ initial_metadata_flags: u32,
+ tag: *mut ::std::os::raw::c_void,
+ ) -> grpc_call_error;
+}
+extern "C" {
+ pub fn grpcwrap_call_start_server_streaming(
+ call: *mut grpc_call,
+ ctx: *mut grpcwrap_batch_context,
+ send_buffer: *mut grpc_slice,
+ write_flags: u32,
+ initial_metadata: *mut grpc_metadata_array,
+ initial_metadata_flags: u32,
+ tag: *mut ::std::os::raw::c_void,
+ ) -> grpc_call_error;
+}
+extern "C" {
+ pub fn grpcwrap_call_start_duplex_streaming(
+ call: *mut grpc_call,
+ ctx: *mut grpcwrap_batch_context,
+ initial_metadata: *mut grpc_metadata_array,
+ initial_metadata_flags: u32,
+ tag: *mut ::std::os::raw::c_void,
+ ) -> grpc_call_error;
+}
+extern "C" {
+ pub fn grpcwrap_call_recv_initial_metadata(
+ call: *mut grpc_call,
+ ctx: *mut grpcwrap_batch_context,
+ tag: *mut ::std::os::raw::c_void,
+ ) -> grpc_call_error;
+}
+extern "C" {
+ pub fn grpcwrap_call_send_message(
+ call: *mut grpc_call,
+ ctx: *mut grpcwrap_batch_context,
+ send_buffer: *mut grpc_slice,
+ write_flags: u32,
+ initial_metadata: *mut grpc_metadata_array,
+ initial_metadata_flags: u32,
+ tag: *mut ::std::os::raw::c_void,
+ ) -> grpc_call_error;
+}
+extern "C" {
+ pub fn grpcwrap_call_send_close_from_client(
+ call: *mut grpc_call,
+ tag: *mut ::std::os::raw::c_void,
+ ) -> grpc_call_error;
+}
+extern "C" {
+ pub fn grpcwrap_call_send_status_from_server(
+ call: *mut grpc_call,
+ ctx: *mut grpcwrap_batch_context,
+ status_code: grpc_status_code::Type,
+ status_details: *const ::std::os::raw::c_char,
+ status_details_len: usize,
+ initial_metadata: *mut grpc_metadata_array,
+ initial_metadata_flags: u32,
+ trailing_metadata: *mut grpc_metadata_array,
+ optional_send_buffer: *mut grpc_slice,
+ write_flags: u32,
+ tag: *mut ::std::os::raw::c_void,
+ ) -> grpc_call_error;
+}
+extern "C" {
+ pub fn grpcwrap_call_recv_message(
+ call: *mut grpc_call,
+ ctx: *mut grpcwrap_batch_context,
+ tag: *mut ::std::os::raw::c_void,
+ ) -> grpc_call_error;
+}
+extern "C" {
+ pub fn grpcwrap_call_start_serverside(
+ call: *mut grpc_call,
+ ctx: *mut grpcwrap_batch_context,
+ tag: *mut ::std::os::raw::c_void,
+ ) -> grpc_call_error;
+}
+extern "C" {
+ pub fn grpcwrap_call_send_initial_metadata(
+ call: *mut grpc_call,
+ ctx: *mut grpcwrap_batch_context,
+ initial_metadata: *mut grpc_metadata_array,
+ tag: *mut ::std::os::raw::c_void,
+ ) -> grpc_call_error;
+}
+extern "C" {
+ #[doc = " Kick call's completion queue, it should be called after there is an event"]
+ #[doc = "ready to poll."]
+ #[doc = "THREAD SAFETY: grpcwrap_call_kick_completion_queue is thread-safe"]
+ #[doc = "because it does not change the call's state."]
+ pub fn grpcwrap_call_kick_completion_queue(
+ call: *mut grpc_call,
+ tag: *mut ::std::os::raw::c_void,
+ ) -> grpc_call_error;
+}
+extern "C" {
+ pub fn grpcwrap_server_request_call(
+ server: *mut grpc_server,
+ cq: *mut grpc_completion_queue,
+ ctx: *mut grpcwrap_request_call_context,
+ tag: *mut ::std::os::raw::c_void,
+ ) -> grpc_call_error;
+}