1/*
2 * Copyright (c) 2015, 2021, Oracle and/or its affiliates.
3 *
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License, version 2.0,
6 * as published by the Free Software Foundation.
7 *
8 * This program is also distributed with certain software (including
9 * but not limited to OpenSSL) that is licensed under separate terms,
10 * as designated in a particular file or component or in included license
11 * documentation.  The authors of MySQL hereby grant you an additional
12 * permission to link the program and your derivative works with the
13 * separately licensed software that they have included with MySQL.
14 *
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18 * GNU General Public License, version 2.0, for more details.
19 *
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
23 * 02110-1301  USA
24 */
25syntax = "proto2";
26
27// ifdef PROTOBUF_LITE: option optimize_for = LITE_RUNTIME;
28
29import "mysqlx_datatypes.proto";
30
31package Mysqlx.Connection;
32option java_package = "com.mysql.cj.x.protobuf";
33
34// a Capability
35//
36// a tuple of a ``name`` and a :protobuf:msg:`Mysqlx.Datatypes::Any`
37message Capability {
38  required string name = 1;
39  required Mysqlx.Datatypes.Any value = 2;
40}
41
42// Capabilities
43message Capabilities {
44  repeated Capability capabilities = 1;
45}
46
47// get supported connection capabilities and their current state
48//
49//   :returns: :protobuf:msg:`Mysqlx.Connection::Capabilities` or :protobuf:msg:`Mysqlx::Error`
50//
51message CapabilitiesGet {
52};
53
54// sets connection capabilities atomically
55//
56// only provided values are changed, other values are left unchanged.
57// If any of the changes fails, all changes are discarded.
58//
59// :precond: active sessions == 0
60// :returns: :protobuf:msg:`Mysqlx::Ok` or :protobuf:msg:`Mysqlx::Error`
61message CapabilitiesSet {
62  required Capabilities capabilities = 1;
63};
64
65// announce to the server that the client wants to close the connection
66//
67// it discards any session state of the server
68//
69// :Returns: :protobuf:msg:`Mysqlx::Ok`
70message Close {
71};
72
73