StoneDB/sql/sql_thd_internal_api.h

110 lines
3.8 KiB
C++

/* Copyright (c) 2015, 2021, Oracle and/or its affiliates.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License, version 2.0,
as published by the Free Software Foundation.
This program is also distributed with certain software (including
but not limited to OpenSSL) that is licensed under separate terms,
as designated in a particular file or component or in included license
documentation. The authors of MySQL hereby grant you an additional
permission to link the program and your derivative works with the
separately licensed software that they have included with MySQL.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License, version 2.0, for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA */
#ifndef SQL_THD_INTERNAL_API_INCLUDED
#define SQL_THD_INTERNAL_API_INCLUDED
/*
This file defines THD-related API calls that are meant for internal
usage (e.g. InnoDB, Thread Pool) only. There are therefore no stabilty
guarantees.
*/
#include "my_global.h"
#include "my_thread.h"
#include "mysql/psi/psi.h"
class THD;
/**
Set up various THD data for a new connection
@param thd THD object
@param stack_start Start of stack for connection
@param bound True if bound to a physical thread.
@param psi_key Instrumentation key for the thread.
*/
int thd_init(THD *thd, char *stack_start, bool bound, PSI_thread_key psi_key);
/**
Create a THD and do proper initialization of it.
@param enable_plugins Should dynamic plugin support be enabled?
@param background_thread Is this a background thread?
@param bound True if bound to a physical thread.
@param psi_key Instrumentation key for the thread.
@note Dynamic plugin support is only possible for THDs that
are created after the server has initialized properly.
@note THDs for background threads are currently not added to
the global THD list. So they will e.g. not be visible in
SHOW PROCESSLIST and the server will not wait for them to
terminate during shutdown.
*/
THD *create_thd(bool enable_plugins, bool background_thread, bool bound, PSI_thread_key psi_key);
/**
Cleanup the THD object, remove it from the global list of THDs
and delete it.
@param THD pointer to THD object.
*/
void destroy_thd(THD *thd);
/**
Set thread stack in THD object
@param thd Thread object
@param stack_start Start of stack to set in THD object
*/
void thd_set_thread_stack(THD *thd, const char *stack_start);
/**
Test a file path whether it is same as mysql data directory path.
@param path null terminated character string
@return
@retval true The path is different from mysql data directory.
@retval false The path is same as mysql data directory.
*/
bool is_mysql_datadir_path(const char *path);
/**
Create a temporary file.
@details
The temporary file is created in a location specified by the parameter
path. if path is null, then it will be created on the location given
by the mysql server configuration (--tmpdir option). The caller
does not need to delete the file, it will be deleted automatically.
@param path location for creating temporary file
@param prefix prefix for temporary file name
@retval -1 error
@retval >=0 a file handle that can be passed to dup or my_close
*/
int mysql_tmpfile_path(const char *path, const char *prefix);
#endif // SQL_THD_INTERNAL_API_INCLUDED