dm_db_backup Function

public function dm_db_backup(db, path, wal, callback, nsteps, sleep_time) result(rc)

Uses

  • proc~~dm_db_backup~~UsesGraph proc~dm_db_backup dm_db_backup module~dm_file dm_file proc~dm_db_backup->module~dm_file module~dm_error dm_error module~dm_file->module~dm_error module~dm_kind dm_kind module~dm_file->module~dm_kind module~dm_error->module~dm_kind module~dm_ascii dm_ascii module~dm_error->module~dm_ascii iso_fortran_env iso_fortran_env module~dm_kind->iso_fortran_env

Creates online backup of given database. The functions assumes 500 steps and a sleep time of 250 msec by default, if the arguments are not passed.

The function returns the following error codes:

  • E_DB if closing the database failed.
  • E_DB_BACKUP if SQLite backup failed.
  • E_EXIST if backup database exists.
  • E_READ_ONLY if database is opened read-only.

Arguments

Type IntentOptional Attributes Name
type(db_type), intent(inout) :: db

Database type.
character(len=*), intent(in) :: path

File path of backup database to be created.
logical, intent(in), optional :: wal

Enable WAL mode for backup.
procedure(dm_db_backup_callback), optional :: callback

Progress callback routine.
integer, intent(in), optional :: nsteps

Number of steps per iteration (default: 500).
integer, intent(in), optional :: sleep_time

Sleep time per iteration in msec (default: 250 msec).

Return Value integer


Calls

proc~~dm_db_backup~~CallsGraph proc~dm_db_backup dm_db_backup interface~dm_present dm_present proc~dm_db_backup->interface~dm_present proc~dm_db_close dm_db_close proc~dm_db_backup->proc~dm_db_close proc~dm_db_is_read_only dm_db_is_read_only proc~dm_db_backup->proc~dm_db_is_read_only proc~dm_db_open dm_db_open proc~dm_db_backup->proc~dm_db_open proc~dm_db_sleep dm_db_sleep proc~dm_db_backup->proc~dm_db_sleep proc~dm_file_exists dm_file_exists proc~dm_db_backup->proc~dm_file_exists proc~dm_is_error dm_is_error proc~dm_db_backup->proc~dm_is_error sqlite3_backup_finish sqlite3_backup_finish proc~dm_db_backup->sqlite3_backup_finish sqlite3_backup_init sqlite3_backup_init proc~dm_db_backup->sqlite3_backup_init sqlite3_backup_pagecount sqlite3_backup_pagecount proc~dm_db_backup->sqlite3_backup_pagecount sqlite3_backup_remaining sqlite3_backup_remaining proc~dm_db_backup->sqlite3_backup_remaining sqlite3_backup_step sqlite3_backup_step proc~dm_db_backup->sqlite3_backup_step proc~dm_db_close->interface~dm_present proc~dm_db_close->proc~dm_is_error proc~dm_db_optimize dm_db_optimize proc~dm_db_close->proc~dm_db_optimize sqlite3_close sqlite3_close proc~dm_db_close->sqlite3_close proc~dm_db_open->interface~dm_present proc~dm_db_open->proc~dm_file_exists proc~dm_db_open->proc~dm_is_error proc~dm_db_is_connected dm_db_is_connected proc~dm_db_open->proc~dm_db_is_connected proc~dm_db_set_application_id dm_db_set_application_id proc~dm_db_open->proc~dm_db_set_application_id proc~dm_db_set_busy_timeout dm_db_set_busy_timeout proc~dm_db_open->proc~dm_db_set_busy_timeout proc~dm_db_set_foreign_keys dm_db_set_foreign_keys proc~dm_db_open->proc~dm_db_set_foreign_keys proc~dm_db_set_journal_mode dm_db_set_journal_mode proc~dm_db_open->proc~dm_db_set_journal_mode proc~dm_db_set_schema_version dm_db_set_schema_version proc~dm_db_open->proc~dm_db_set_schema_version proc~dm_db_validate dm_db_validate proc~dm_db_open->proc~dm_db_validate proc~dm_file_is_readable dm_file_is_readable proc~dm_db_open->proc~dm_file_is_readable proc~dm_file_is_writeable dm_file_is_writeable proc~dm_db_open->proc~dm_file_is_writeable sqlite3_initialize sqlite3_initialize proc~dm_db_open->sqlite3_initialize sqlite3_open_v2 sqlite3_open_v2 proc~dm_db_open->sqlite3_open_v2 sqlite3_sleep sqlite3_sleep proc~dm_db_sleep->sqlite3_sleep interface~dm_db_pragma_set dm_db_pragma_set proc~dm_db_optimize->interface~dm_db_pragma_set proc~dm_db_set_application_id->interface~dm_db_pragma_set sqlite3_busy_timeout sqlite3_busy_timeout proc~dm_db_set_busy_timeout->sqlite3_busy_timeout proc~dm_db_set_foreign_keys->interface~dm_db_pragma_set proc~dm_btoa dm_btoa proc~dm_db_set_foreign_keys->proc~dm_btoa proc~dm_db_set_journal_mode->interface~dm_db_pragma_set proc~dm_db_set_schema_version->interface~dm_db_pragma_set proc~dm_db_validate->proc~dm_is_error proc~dm_db_get_application_id dm_db_get_application_id proc~dm_db_validate->proc~dm_db_get_application_id proc~dm_db_get_schema_version dm_db_get_schema_version proc~dm_db_validate->proc~dm_db_get_schema_version c_access c_access proc~dm_file_is_readable->c_access proc~dm_f_c_string dm_f_c_string proc~dm_file_is_readable->proc~dm_f_c_string proc~dm_file_is_writeable->c_access proc~dm_file_is_writeable->proc~dm_f_c_string interface~dm_db_pragma_get dm_db_pragma_get proc~dm_db_get_application_id->interface~dm_db_pragma_get proc~dm_db_get_schema_version->interface~dm_db_pragma_get