mysql_refresh(3)

mysql_refresh3

Name

mysql_refresh - flushes information on the server

Synopsis

#include <mysql.h>
int mysql_refresh(MYSQL * mysql, unsigned int options);

Description

Flushes different types of information stored on the server. The bit-masked parameter options specify which kind of information will be flushed.

Parameters

•

mysql - a mysql handle, which was previously allocated by mysql_init(3) and connected by mysql_real_connect(3).

•

options - a bit masked composed integer. See below.

options can be any combination of the following flags:

OptionDescription
REFRESH_GRANTRefresh grant tables.
REFRESH_LOGFlush logs.
REFRESH_TABLESFlush table cache.
REFRESH_HOSTSFlush host cache.
REFRESH_STATUSReset status variables.
REFRESH_THREADSFlush thread cache.
REFRESH_SLAVEReset master server information and restart slaves.
REFRESH_MASTERRemove binary log files.

Notes

•

To combine different values in the options parameter use the OR operator `|'.

•

mysql_reload() is an alias for mysql_refresh().

Return value

Returns zero on success, otherwise non zero.

Releases

3 releases since Debian 12 (Bookworm); the text changed 1 time.

  1. 12
  2. 13–Arch

From mariadb 13.0.2-2 in Arch Linux 2026-11-01. Also shipped by mariadb-lts. Parsed by carta from the page's man source.