OmniSciDB  94e8789169
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
Parser Namespace Reference

Namespaces

 anonymous_namespace{ParserNode.cpp}
 

Classes

class  Node
 
class  SQLType
 
class  Expr
 
class  Literal
 
class  NullLiteral
 
class  StringLiteral
 
class  IntLiteral
 
class  FixedPtLiteral
 
class  FloatLiteral
 
class  DoubleLiteral
 
class  TimestampLiteral
 
class  UserLiteral
 
class  ArrayLiteral
 
class  OperExpr
 
class  SubqueryExpr
 
class  IsNullExpr
 
class  InExpr
 
class  InSubquery
 
class  InValues
 
class  BetweenExpr
 
class  CharLengthExpr
 
class  CardinalityExpr
 
class  LikeExpr
 
class  RegexpExpr
 
class  LikelihoodExpr
 
class  ExistsExpr
 
class  ColumnRef
 
class  FunctionRef
 
class  CastExpr
 
class  ExprPair
 
class  CaseExpr
 
class  TableRef
 
class  Stmt
 
class  DMLStmt
 
class  DDLStmt
 
class  TableElement
 
class  ColumnConstraintDef
 
class  CompressDef
 
class  ColumnDef
 
class  TableConstraintDef
 
class  UniqueDef
 
class  ForeignKeyDef
 
class  CheckDef
 
class  SharedDictionaryDef
 
class  ShardKeyDef
 
class  NameValueAssign
 
class  CreateTableBaseStmt
 
class  CreateTableStmt
 
struct  DistributedConnector
 
struct  LocalConnector
 
class  CreateDataframeStmt
 
class  InsertIntoTableAsSelectStmt
 
class  CreateTableAsSelectStmt
 
class  DropTableStmt
 
class  TruncateTableStmt
 
class  OptimizeTableStmt
 
class  ValidateStmt
 
class  RenameDatabaseStmt
 
class  RenameUserStmt
 
class  RenameTableStmt
 
class  RenameColumnStmt
 
class  AddColumnStmt
 
class  DropColumnStmt
 
class  AlterTableParamStmt
 
class  DumpRestoreTableStmtBase
 
class  DumpTableStmt
 
class  RestoreTableStmt
 
class  CopyTableStmt
 
class  CreateRoleStmt
 
class  DropRoleStmt
 
class  GrantPrivilegesStmt
 
class  RevokePrivilegesStmt
 
class  ShowPrivilegesStmt
 
class  GrantRoleStmt
 
class  RevokeRoleStmt
 
class  QueryExpr
 
class  UnionQuery
 
class  SelectEntry
 
class  QuerySpec
 
class  OrderSpec
 
class  SelectStmt
 
class  ShowCreateTableStmt
 
class  ExportQueryStmt
 
class  CreateViewStmt
 
class  DropViewStmt
 
class  CreateDBStmt
 
class  DropDBStmt
 
class  CreateUserStmt
 
class  AlterUserStmt
 
class  DropUserStmt
 
class  InsertStmt
 
class  InsertValuesStmt
 
class  Assignment
 
class  UpdateStmt
 
class  DeleteStmt
 
struct  DefaultValidate
 
struct  DefaultValidate< IntLiteral >
 
struct  PositiveOrZeroValidate
 
struct  DefaultValidate< StringLiteral >
 
struct  CaseSensitiveValidate
 
struct  ShouldInvalidateSessionsByDB
 
struct  ShouldInvalidateSessionsByUser
 
struct  ShouldInvalidateSessionsByDB< DropDBStmt >
 
struct  ShouldInvalidateSessionsByUser< DropUserStmt >
 
struct  ShouldInvalidateSessionsByDB< RenameDatabaseStmt >
 
struct  ShouldInvalidateSessionsByUser< RenameUserStmt >
 
class  TrackedPtr
 
class  TrackedListPtr
 

Functions

template<typename DDLSTMT >
auto parseDDL (const std::string &stmt_type, const std::string &stmt_str)
 
std::shared_ptr< ResultSetgetResultSet (QueryStateProxy query_state_proxy, const std::string select_stmt, std::vector< TargetMetaInfo > &targets, bool validate_only=false, std::vector< size_t > outer_fragment_indices={})
 
void check_alter_table_privilege (const Catalog_Namespace::SessionInfo &session, const TableDescriptor *td)
 
std::vector< std::string > splitObjectHierName (const std::string &hierName)
 
std::string extractObjectNameFromHierName (const std::string &objectHierName, const std::string &objectType, const Catalog_Namespace::Catalog &cat)
 
static std::pair
< AccessPrivileges,
DBObjectType
parseStringPrivs (const std::string &privs, const DBObjectType &objectType, const std::string &object_name)
 
static DBObject createObject (const std::string &objectName, DBObjectType objectType)
 
static void checkStringLiteral (const std::string &option_name, const std::unique_ptr< NameValueAssign > &p)
 
static bool readBooleanLiteral (const std::string &option_name, const std::unique_ptr< NameValueAssign > &p)
 
void execute_calcite_ddl (const std::string &ddl_statement, std::shared_ptr< Catalog_Namespace::SessionInfo const > session_ptr)
 
void parser_slistval_to_vector (std::list< std::string * > *l, std::vector< std::string > &v)
 

Function Documentation

void Parser::check_alter_table_privilege ( const Catalog_Namespace::SessionInfo session,
const TableDescriptor td 
)

Definition at line 3518 of file ParserNode.cpp.

References AccessPrivileges::ALTER_TABLE, Catalog_Namespace::SessionInfo::get_currentUser(), Catalog_Namespace::SessionInfo::getCatalog(), Catalog_Namespace::UserMetadata::isSuper, DBObject::loadKey(), DBObject::setPrivileges(), TableDBObjectType, TableDescriptor::tableName, TableDescriptor::userId, and Catalog_Namespace::UserMetadata::userId.

Referenced by Parser::AddColumnStmt::check_executable(), Parser::RenameTableStmt::execute(), Parser::RenameColumnStmt::execute(), Parser::DropColumnStmt::execute(), and Parser::AlterTableParamStmt::execute().

3519  {
3520  if (session.get_currentUser().isSuper ||
3521  session.get_currentUser().userId == td->userId) {
3522  return;
3523  }
3524  std::vector<DBObject> privObjects;
3525  DBObject dbObject(td->tableName, TableDBObjectType);
3526  dbObject.loadKey(session.getCatalog());
3527  dbObject.setPrivileges(AccessPrivileges::ALTER_TABLE);
3528  privObjects.push_back(dbObject);
3529  if (!SysCatalog::instance().checkPrivileges(session.get_currentUser(), privObjects)) {
3530  throw std::runtime_error("Current user does not have the privilege to alter table: " +
3531  td->tableName);
3532  }
3533 }
std::string tableName
static const AccessPrivileges ALTER_TABLE
Definition: DBObject.h:166
Catalog & getCatalog() const
Definition: SessionInfo.h:66
const UserMetadata & get_currentUser() const
Definition: SessionInfo.h:72
std::atomic< bool > isSuper
Definition: SysCatalog.h:96

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

static void Parser::checkStringLiteral ( const std::string &  option_name,
const std::unique_ptr< NameValueAssign > &  p 
)
static

Definition at line 5102 of file ParserNode.cpp.

References CHECK.

Referenced by Parser::CreateDBStmt::execute(), Parser::CreateUserStmt::execute(), and Parser::AlterUserStmt::execute().

5103  {
5104  CHECK(p);
5105  if (!dynamic_cast<const StringLiteral*>(p->get_value())) {
5106  throw std::runtime_error(option_name + " option must be a string literal.");
5107  }
5108 }
#define CHECK(condition)
Definition: Logger.h:197

+ Here is the caller graph for this function:

static DBObject Parser::createObject ( const std::string &  objectName,
DBObjectType  objectType 
)
static

Definition at line 4504 of file ParserNode.cpp.

References DashboardDBObjectType.

Referenced by Parser::GrantPrivilegesStmt::execute(), Parser::RevokePrivilegesStmt::execute(), and Parser::ShowPrivilegesStmt::execute().

4504  {
4505  if (objectType == DashboardDBObjectType) {
4506  int32_t dashboard_id = -1;
4507  if (!objectName.empty()) {
4508  try {
4509  dashboard_id = stoi(objectName);
4510  } catch (const std::exception&) {
4511  throw std::runtime_error(
4512  "Privileges on dashboards should be changed via integer dashboard ID");
4513  }
4514  }
4515  return DBObject(dashboard_id, objectType);
4516  } else {
4517  return DBObject(objectName, objectType);
4518  }
4519 }

+ Here is the caller graph for this function:

void Parser::execute_calcite_ddl ( const std::string &  plan_result,
std::shared_ptr< Catalog_Namespace::SessionInfo const >  session_ptr 
)

A helper function for parsing the DDL returned from calcite as part of the plan result to a parser node in this class. Currently only used in QueryRunner/DistributedQueryRunner, where we do not want to link in the thrift dependencies wich DdlCommandExecutor currently brings along.

Definition at line 5316 of file ParserNode.cpp.

References CHECK, and VLOG.

5318  {
5319  CHECK(!ddl_statement.empty());
5320  VLOG(2) << "Parsing JSON DDL from Calcite: " << ddl_statement;
5321  rapidjson::Document ddl_query;
5322  ddl_query.Parse(ddl_statement);
5323  CHECK(ddl_query.IsObject());
5324  CHECK(ddl_query.HasMember("payload"));
5325  CHECK(ddl_query["payload"].IsObject());
5326  const auto& payload = ddl_query["payload"].GetObject();
5327  CHECK(payload.HasMember("command"));
5328  CHECK(payload["command"].IsString());
5329 
5330  const auto& ddl_command = std::string_view(payload["command"].GetString());
5331  if (ddl_command == "CREATE_TABLE") {
5332  auto create_table_stmt = Parser::CreateTableStmt(payload);
5333  create_table_stmt.execute(*session_ptr);
5334  } else if (ddl_command == "DROP_TABLE") {
5335  auto drop_table_stmt = Parser::DropTableStmt(payload);
5336  drop_table_stmt.execute(*session_ptr);
5337  } else if (ddl_command == "CREATE_VIEW") {
5338  auto create_view_stmt = Parser::CreateViewStmt(payload);
5339  create_view_stmt.execute(*session_ptr);
5340  } else if (ddl_command == "DROP_VIEW") {
5341  auto drop_view_stmt = Parser::DropViewStmt(payload);
5342  drop_view_stmt.execute(*session_ptr);
5343  } else {
5344  throw std::runtime_error("Unsupported DDL command");
5345  }
5346 }
#define CHECK(condition)
Definition: Logger.h:197
#define VLOG(n)
Definition: Logger.h:291
std::string Parser::extractObjectNameFromHierName ( const std::string &  objectHierName,
const std::string &  objectType,
const Catalog_Namespace::Catalog cat 
)

Definition at line 4371 of file ParserNode.cpp.

References splitObjectHierName().

Referenced by Parser::GrantPrivilegesStmt::execute(), Parser::RevokePrivilegesStmt::execute(), and Parser::ShowPrivilegesStmt::execute().

4373  {
4374  std::string objectName;
4375  std::vector<std::string> componentNames = splitObjectHierName(objectHierName);
4376  if (objectType.compare("DATABASE") == 0) {
4377  if (componentNames.size() == 1) {
4378  objectName = componentNames[0];
4379  } else {
4380  throw std::runtime_error("DB object name is not correct " + objectHierName);
4381  }
4382  } else {
4383  if (objectType.compare("TABLE") == 0 || objectType.compare("DASHBOARD") == 0 ||
4384  objectType.compare("VIEW") == 0 || objectType.compare("SERVER") == 0) {
4385  switch (componentNames.size()) {
4386  case (1): {
4387  objectName = componentNames[0];
4388  break;
4389  }
4390  case (2): {
4391  objectName = componentNames[1];
4392  break;
4393  }
4394  default: {
4395  throw std::runtime_error("DB object name is not correct " + objectHierName);
4396  }
4397  }
4398  } else {
4399  throw std::runtime_error("DB object type " + objectType + " is not supported.");
4400  }
4401  }
4402  return objectName;
4403 }
std::vector< std::string > splitObjectHierName(const std::string &hierName)

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

std::shared_ptr<ResultSet> Parser::getResultSet ( QueryStateProxy  query_state_proxy,
const std::string  select_stmt,
std::vector< TargetMetaInfo > &  targets,
bool  validate_only = false,
std::vector< size_t >  outer_fragment_indices = {} 
)

Definition at line 2550 of file ParserNode.cpp.

Referenced by Parser::LocalConnector::query().

2554  {}) {
2555  auto const session = query_state_proxy.getQueryState().getConstSessionInfo();
2556  auto& catalog = session->getCatalog();
2557 
2559 #ifdef HAVE_CUDA
2560  const auto device_type = session->get_executor_device_type();
2561 #else
2562  const auto device_type = ExecutorDeviceType::CPU;
2563 #endif // HAVE_CUDA
2564  auto calcite_mgr = catalog.getCalciteMgr();
2565 
2566  // TODO MAT this should actually get the global or the session parameter for
2567  // view optimization
2568  const auto query_ra =
2569  calcite_mgr
2570  ->process(query_state_proxy, pg_shim(select_stmt), {}, true, false, false, true)
2571  .plan_result;
2572  RelAlgExecutor ra_executor(executor.get(), catalog, query_ra);
2574  const auto& query_hints = ra_executor.getParsedQueryHints();
2575  if (query_hints.cpu_mode) {
2576  co.device_type = ExecutorDeviceType::CPU;
2577  }
2579  // TODO(adb): Need a better method of dropping constants into this ExecutionOptions
2580  // struct
2581  ExecutionOptions eo = {false,
2582  true,
2583  false,
2584  true,
2585  false,
2586  false,
2587  validate_only,
2588  false,
2589  10000,
2590  false,
2591  false,
2592  0.9,
2593  false,
2594  1000,
2596  outer_fragment_indices};
2597  ExecutionResult result{std::make_shared<ResultSet>(std::vector<TargetInfo>{},
2600  nullptr,
2601  nullptr,
2602  0,
2603  0),
2604  {}};
2605  result = ra_executor.executeRelAlgQuery(co, eo, false, nullptr);
2606  targets = result.getTargetsMeta();
2607 
2608  return result.getRows();
2609 }
static std::shared_ptr< Executor > getExecutor(const ExecutorId id, const std::string &debug_dir="", const std::string &debug_file="", const SystemParameters system_parameters=SystemParameters())
Definition: Execute.cpp:157
QueryState & getQueryState()
Definition: QueryState.h:181
static CompilationOptions defaults(const ExecutorDeviceType device_type=ExecutorDeviceType::GPU)
std::shared_ptr< Catalog_Namespace::SessionInfo const > getConstSessionInfo() const
Definition: QueryState.cpp:77
std::string pg_shim(const std::string &query)
static const ExecutorId UNITARY_EXECUTOR_ID
Definition: Execute.h:375

+ Here is the caller graph for this function:

template<typename DDLSTMT >
auto Parser::parseDDL ( const std::string &  stmt_type,
const std::string &  stmt_str 
)

Definition at line 29 of file ParseDDL.h.

References run_benchmark_import::parser.

29  {
30  std::list<std::unique_ptr<Parser::Stmt>> parse_trees;
31  std::string last_parsed;
32  SQLParser parser;
33  if (parser.parse(stmt_str, parse_trees, last_parsed) > 0) {
34  throw std::runtime_error("Syntax error in " + stmt_type + " \"" + stmt_str +
35  "\" at " + last_parsed);
36  }
37  if (auto ddl_stmt = dynamic_cast<DDLSTMT*>(parse_trees.front().get())) {
38  parse_trees.front().release();
39  return std::unique_ptr<DDLSTMT>(ddl_stmt);
40  }
41  throw std::runtime_error("Expected " + stmt_type + " is not found in \"" + stmt_str +
42  "\"");
43 }
void Parser::parser_slistval_to_vector ( std::list< std::string * > *  l,
std::vector< std::string > &  v 
)
inline

Definition at line 1527 of file ParserNode.h.

References CHECK.

Referenced by Parser::GrantPrivilegesStmt::GrantPrivilegesStmt(), Parser::GrantRoleStmt::GrantRoleStmt(), Parser::RevokePrivilegesStmt::RevokePrivilegesStmt(), and Parser::RevokeRoleStmt::RevokeRoleStmt().

1528  {
1529  CHECK(l);
1530  for (auto str : *l) {
1531  v.push_back(*str);
1532  delete str;
1533  }
1534  delete l;
1535 }
#define CHECK(condition)
Definition: Logger.h:197

+ Here is the caller graph for this function:

static std::pair<AccessPrivileges, DBObjectType> Parser::parseStringPrivs ( const std::string &  privs,
const DBObjectType objectType,
const std::string &  object_name 
)
static

Definition at line 4405 of file ParserNode.cpp.

References AccessPrivileges::ACCESS, AccessPrivileges::ALL_DASHBOARD, AccessPrivileges::ALL_DATABASE, AccessPrivileges::ALL_SERVER, AccessPrivileges::ALL_TABLE, AccessPrivileges::ALL_VIEW, AccessPrivileges::ALTER_SERVER, AccessPrivileges::ALTER_TABLE, AccessPrivileges::CREATE_DASHBOARD, AccessPrivileges::CREATE_SERVER, AccessPrivileges::CREATE_TABLE, AccessPrivileges::CREATE_VIEW, DashboardDBObjectType, DatabaseDBObjectType, AccessPrivileges::DELETE_DASHBOARD, AccessPrivileges::DELETE_FROM_TABLE, AccessPrivileges::DROP_SERVER, AccessPrivileges::DROP_TABLE, AccessPrivileges::DROP_VIEW, AccessPrivileges::EDIT_DASHBOARD, AccessPrivileges::INSERT_INTO_TABLE, run_benchmark_import::result, AccessPrivileges::SELECT_FROM_TABLE, AccessPrivileges::SELECT_FROM_VIEW, ServerDBObjectType, TableDBObjectType, AccessPrivileges::TRUNCATE_TABLE, AccessPrivileges::UPDATE_IN_TABLE, AccessPrivileges::VIEW_DASHBOARD, AccessPrivileges::VIEW_SQL_EDITOR, and ViewDBObjectType.

Referenced by Parser::GrantPrivilegesStmt::execute(), and Parser::RevokePrivilegesStmt::execute().

4408  {
4409  static const std::map<std::pair<const std::string, const DBObjectType>,
4410  std::pair<const AccessPrivileges, const DBObjectType>>
4411  privileges_lookup{
4412  {{"ALL"s, DatabaseDBObjectType},
4415  {{"ALL"s, DashboardDBObjectType},
4418  {{"ALL"s, ServerDBObjectType},
4420 
4421  {{"CREATE TABLE"s, DatabaseDBObjectType},
4423  {{"CREATE"s, DatabaseDBObjectType},
4425  {{"SELECT"s, DatabaseDBObjectType},
4427  {{"INSERT"s, DatabaseDBObjectType},
4429  {{"TRUNCATE"s, DatabaseDBObjectType},
4431  {{"UPDATE"s, DatabaseDBObjectType},
4433  {{"DELETE"s, DatabaseDBObjectType},
4435  {{"DROP"s, DatabaseDBObjectType},
4437  {{"ALTER"s, DatabaseDBObjectType},
4439 
4440  {{"SELECT"s, TableDBObjectType},
4442  {{"INSERT"s, TableDBObjectType},
4444  {{"TRUNCATE"s, TableDBObjectType},
4446  {{"UPDATE"s, TableDBObjectType},
4448  {{"DELETE"s, TableDBObjectType},
4450  {{"DROP"s, TableDBObjectType},
4452  {{"ALTER"s, TableDBObjectType},
4454 
4455  {{"CREATE VIEW"s, DatabaseDBObjectType},
4457  {{"SELECT VIEW"s, DatabaseDBObjectType},
4459  {{"DROP VIEW"s, DatabaseDBObjectType},
4461  {{"SELECT"s, ViewDBObjectType},
4464 
4465  {{"CREATE DASHBOARD"s, DatabaseDBObjectType},
4467  {{"EDIT DASHBOARD"s, DatabaseDBObjectType},
4469  {{"VIEW DASHBOARD"s, DatabaseDBObjectType},
4471  {{"DELETE DASHBOARD"s, DatabaseDBObjectType},
4473  {{"VIEW"s, DashboardDBObjectType},
4475  {{"EDIT"s, DashboardDBObjectType},
4477  {{"DELETE"s, DashboardDBObjectType},
4479 
4480  {{"CREATE SERVER"s, DatabaseDBObjectType},
4482  {{"DROP SERVER"s, DatabaseDBObjectType},
4484  {{"DROP"s, ServerDBObjectType},
4486  {{"ALTER SERVER"s, DatabaseDBObjectType},
4488  {{"ALTER"s, ServerDBObjectType},
4490 
4491  {{"VIEW SQL EDITOR"s, DatabaseDBObjectType},
4493  {{"ACCESS"s, DatabaseDBObjectType},
4495 
4496  auto result = privileges_lookup.find(std::make_pair(privs, objectType));
4497  if (result == privileges_lookup.end()) {
4498  throw std::runtime_error("Privileges " + privs + " on DB object " + object_name +
4499  " are not correct.");
4500  }
4501  return result->second;
4502 }
static const AccessPrivileges VIEW_SQL_EDITOR
Definition: DBObject.h:153
static const AccessPrivileges VIEW_DASHBOARD
Definition: DBObject.h:172
static const AccessPrivileges DROP_SERVER
Definition: DBObject.h:190
static const AccessPrivileges ALL_DATABASE
Definition: DBObject.h:152
static const AccessPrivileges ALTER_TABLE
Definition: DBObject.h:166
static const AccessPrivileges TRUNCATE_TABLE
Definition: DBObject.h:165
static const AccessPrivileges INSERT_INTO_TABLE
Definition: DBObject.h:162
static const AccessPrivileges CREATE_DASHBOARD
Definition: DBObject.h:171
static const AccessPrivileges SELECT_FROM_TABLE
Definition: DBObject.h:161
static const AccessPrivileges ALL_VIEW
Definition: DBObject.h:178
static const AccessPrivileges ALTER_SERVER
Definition: DBObject.h:191
static const AccessPrivileges DROP_TABLE
Definition: DBObject.h:160
static const AccessPrivileges ALL_SERVER
Definition: DBObject.h:188
static const AccessPrivileges CREATE_SERVER
Definition: DBObject.h:189
static const AccessPrivileges DELETE_FROM_TABLE
Definition: DBObject.h:164
static const AccessPrivileges CREATE_TABLE
Definition: DBObject.h:159
static const AccessPrivileges SELECT_FROM_VIEW
Definition: DBObject.h:181
static const AccessPrivileges ALL_DASHBOARD
Definition: DBObject.h:170
static const AccessPrivileges ACCESS
Definition: DBObject.h:154
static const AccessPrivileges ALL_TABLE
Definition: DBObject.h:158
static const AccessPrivileges DROP_VIEW
Definition: DBObject.h:180
static const AccessPrivileges CREATE_VIEW
Definition: DBObject.h:179
static const AccessPrivileges DELETE_DASHBOARD
Definition: DBObject.h:174
static const AccessPrivileges EDIT_DASHBOARD
Definition: DBObject.h:173
static const AccessPrivileges UPDATE_IN_TABLE
Definition: DBObject.h:163

+ Here is the caller graph for this function:

static bool Parser::readBooleanLiteral ( const std::string &  option_name,
const std::unique_ptr< NameValueAssign > &  p 
)
static

Definition at line 5170 of file ParserNode.cpp.

References CHECK.

Referenced by Parser::CreateUserStmt::execute(), and Parser::AlterUserStmt::execute().

5171  {
5172  CHECK(p);
5173  const std::string* str =
5174  static_cast<const StringLiteral*>(p->get_value())->get_stringval();
5175  if (boost::iequals(*str, "true")) {
5176  return true;
5177  } else if (boost::iequals(*str, "false")) {
5178  return false;
5179  } else {
5180  throw std::runtime_error("Value to " + option_name + " must be TRUE or FALSE.");
5181  }
5182 }
#define CHECK(condition)
Definition: Logger.h:197

+ Here is the caller graph for this function:

std::vector<std::string> Parser::splitObjectHierName ( const std::string &  hierName)

Definition at line 4365 of file ParserNode.cpp.

References split().

Referenced by extractObjectNameFromHierName().

4365  {
4366  std::vector<std::string> componentNames;
4367  boost::split(componentNames, hierName, boost::is_any_of("."));
4368  return componentNames;
4369 }
std::vector< std::string > split(std::string_view str, std::string_view delim, std::optional< size_t > maxsplit)
split apart a string into a vector of substrings

+ Here is the call graph for this function:

+ Here is the caller graph for this function: