Documentation Home
MySQL Cluster API Developer Guide
Download this Manual
PDF (US Ltr) - 4.8Mb
PDF (A4) - 4.8Mb
EPUB - 1.9Mb
HTML Download (TGZ) - 1.8Mb
HTML Download (Zip) - 1.9Mb


MySQL Cluster API Developer Guide  /  ...  /  ndb_mgm_get_clusterlog_severity_filter()

3.2.7.1 ndb_mgm_get_clusterlog_severity_filter()

Description. This function is used to retrieve the cluster log severity filter currently in force.

Important

The parameters and return type of this function changed significantly between MySQL 5.1.13 and 5.1.14. The changes are detailed in the Signature, Parameters, and Return Type sections that follow.

These changes were done in order to make this function thread-safe. The pre-5.1.14 version is still supported for backward compatibility, but you should protect it with a mutex if you intend to call it from more than one thread.

Signature. As of MySQL 5.1.14:

int ndb_mgm_get_clusterlog_severity_filter
    (
      NdbMgmHandle handle,
      struct ndb_mgm_severity* severity,
      unsigned int size
    )

In MySQL 5.1.13 and earlier, this function took only a single parameter, as shown here:

const unsigned int* ndb_mgm_get_clusterlog_severity_filter
    (
      NdbMgmHandle handle
    )

Parameters. This function added two new parameters in MySQL 5.1.14.

  • All MySQL 5.1 releases:

    An NdbMgmHandle.

  • Additionally, in MySQL 5.1.14 and later:

    • A vector severity of seven (NDB_MGM_EVENT_SEVERITY_ALL) elements, each of which is an ndb_mgm_severity structure, where each element contains 1 if a severity indicator is enabled and 0 if not. A severity level is stored at position ndb_mgm_clusterlog_level; for example the error level is stored at position NDB_MGM_EVENT_SEVERITY_ERROR. The first element (position NDB_MGM_EVENT_SEVERITY_ON) in the vector signals whether the cluster log is disabled or enabled.

    • The size of the vector (NDB_MGM_EVENT_SEVERITY_ALL).

Return value. This function's return type changed beginning with MySQL 5.1.14.

  • MySQL 5.1.13 and earlier: A severity filter, which is a vector containing 7 elements. Each element equals 1 if the corresponding severity indicator is enabled, and 0 if it is not. A severity level is stored at position ndb_mgm_clusterlog_level—for example, the error level is stored at position NDB_MGM_EVENT_SEVERITY_ERROR. The first element in the vector (NDB_MGM_EVENT_SEVERITY_ON) signals whether the cluster log is enabled or disabled.

  • MySQL 5.1.14 and later: The number of returned severities, or -1 in the event of an error.


User Comments
Sign Up Login You must be logged in to post a comment.