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