mirror of
https://github.com/FirebirdSQL/firebird.git
synced 2025-01-24 21:23:04 +01:00
f09ef16560
Simple RECREATE_DATABASE is equal to CREATE_DATABASE,
RECREATE_DATABASE OVERWRITE is equal to REPLACE_DATABASE.
2. gbak uses isc_dpb_overwrite to create database over existing files
3. engine overwrite existing files only if asked explicitly by
user by setting isc_dpb_overwrite to 1
4. fixed unregistered bug - when gbak uses service manager and passed
command line contains invalid switch. Service reports error and
finish but not call Service::svc_started therefore response is not
send and gbak is stalled forever
173 lines
10 KiB
C
173 lines
10 KiB
C
/*
|
|
* PROGRAM: JRD Backup and Restore Program
|
|
* MODULE: burpswi.h
|
|
* DESCRIPTION: Burp switches
|
|
*
|
|
* The contents of this file are subject to the Interbase Public
|
|
* License Version 1.0 (the "License"); you may not use this file
|
|
* except in compliance with the License. You may obtain a copy
|
|
* of the License at http://www.Inprise.com/IPL.html
|
|
*
|
|
* Software distributed under the License is distributed on an
|
|
* "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express
|
|
* or implied. See the License for the specific language governing
|
|
* rights and limitations under the License.
|
|
*
|
|
* The Original Code was created by Inprise Corporation
|
|
* and its predecessors. Portions created by Inprise Corporation are
|
|
* Copyright (C) Inprise Corporation.
|
|
*
|
|
* All Rights Reserved.
|
|
* Contributor(s): ______________________________________.
|
|
* 2001.07.06 Sean Leyne - Code Cleanup, removed "#ifdef READONLY_DATABASE"
|
|
* conditionals, as the engine now fully supports
|
|
* readonly databases.
|
|
*/
|
|
|
|
#ifndef BURP_BURPSWI_H
|
|
#define BURP_BURPSWI_H
|
|
|
|
#include "../jrd/common.h"
|
|
#include "../jrd/ibase.h"
|
|
|
|
/* Local copies of global variables. They will be copied into
|
|
a data structure. */
|
|
|
|
// Local variables
|
|
|
|
const int IN_SW_BURP_0 = 0; // the unknowable switch
|
|
const int IN_SW_BURP_B = 1; // backup
|
|
const int IN_SW_BURP_C = 2; // create_database
|
|
const int IN_SW_BURP_F = 3; // file names and starting page
|
|
const int IN_SW_BURP_M = 4; // backup only metadata
|
|
const int IN_SW_BURP_N = 5; // do not restore validity conditions
|
|
const int IN_SW_BURP_P = 6; // specify output page size
|
|
const int IN_SW_BURP_R = 7; // replace existing database
|
|
const int IN_SW_BURP_U = 9; // don't back up security information
|
|
const int IN_SW_BURP_V = 10; // verify actions
|
|
const int IN_SW_BURP_Z = 11; // print version number
|
|
// const int IN_SW_BURP_D = 12; * backup file on tape - APOLLO only
|
|
const int IN_SW_BURP_E = 13; // expand (no compress)
|
|
const int IN_SW_BURP_Y = 14; // redirect/suppress status and error output
|
|
const int IN_SW_BURP_L = 15; // ignore limbo transactions
|
|
const int IN_SW_BURP_T = 16; // build a 'transportable' backup (V4 default)
|
|
const int IN_SW_BURP_O = 17; // commit after each relation
|
|
const int IN_SW_BURP_I = 18; // deactivate indexes
|
|
const int IN_SW_BURP_K = 19; // kill any shadows defined on database
|
|
const int IN_SW_BURP_G = 20; // inhibit garbage collection
|
|
const int IN_SW_BURP_IG = 21; // database is largely trash try anyway
|
|
const int IN_SW_BURP_FA = 22; // blocking factor
|
|
const int IN_SW_BURP_US = 23; // use all space on data page
|
|
const int IN_SW_BURP_OL = 24; // write RDB$DESCRIPTIONS & SOURCE in old manner
|
|
// const int IN_SW_BURP_7 = 25; * force creation of an ODS 7 database
|
|
const int IN_SW_BURP_USER = 26; // default user name to use on attach
|
|
const int IN_SW_BURP_PASS = 27; // default password to use on attach
|
|
const int IN_SW_BURP_S = 28; // skip some number of bytes if find a bad attribute
|
|
const int IN_SW_BURP_NT = 29; // build a "non-transportable" backup (V3 default)
|
|
// const int IN_SW_BURP_BUG8183 = 30; * use workaround to allow restore database
|
|
// v3.3 with comment field inside of index
|
|
// definition
|
|
const int IN_SW_BURP_ROLE = 31; // default SQL role to use on attach
|
|
const int IN_SW_BURP_CO = 32; // convert external tables to internal tables during backup
|
|
const int IN_SW_BURP_BU = 33; // specify page buffers for cache
|
|
const int IN_SW_BURP_SE = 34; // use services manager
|
|
const int IN_SW_BURP_MODE = 35; // database could be restored ReadOnly
|
|
/**************************************************************************/
|
|
// The next two 'virtual' switches are hidden from user and are needed
|
|
// for services API
|
|
/**************************************************************************/
|
|
const int IN_SW_BURP_HIDDEN_RDONLY = 36;
|
|
const int IN_SW_BURP_HIDDEN_RDWRITE = 37;
|
|
|
|
const int IN_SW_BURP_RECREATE = 38; // recreate database
|
|
/**************************************************************************/
|
|
// used 0BCDEFGILMNOPRSTUVYZ available AHJQWX
|
|
|
|
static const char* BURP_SW_MODE_RO = "read_only";
|
|
static const char* BURP_SW_MODE_RW = "read_write";
|
|
static const char* BURP_SW_OVERWRITE = "OVERWRITE"; // recreate with overwrite
|
|
|
|
|
|
static in_sw_tab_t burp_in_sw_table [] =
|
|
{
|
|
{IN_SW_BURP_B, 0, "BACKUP_DATABASE", 0, 0, 0, FALSE, 60, 0, NULL},
|
|
// msg 60: %sBACKUP_DATABASE backup database to file
|
|
{IN_SW_BURP_BU, isc_spb_res_buffers, "BUFFERS", 0, 0, 0, FALSE, 257, 0, NULL},
|
|
// msg 257: %sBU(FFERS) override default page buffers
|
|
{IN_SW_BURP_C, isc_spb_res_create, "CREATE_DATABASE", 0, 0, 0, FALSE, 73, 0, NULL},
|
|
// msg 73: %sCREATE_DATABASE create database from backup file
|
|
{IN_SW_BURP_CO, isc_spb_bkp_convert, "CONVERT", 0, 0, 0, FALSE, 254, 0, NULL},
|
|
// msg 254: %sCO(NVERT) backup external files as tables
|
|
{IN_SW_BURP_E, isc_spb_bkp_expand, "EXPAND", 0, 0, 0, FALSE, 97, 0, NULL},
|
|
// msg 97: %sEXPAND no data compression
|
|
{IN_SW_BURP_F, 0, "FILE_NAMES", 0, 0, 0, FALSE, 0, 0, NULL},
|
|
{IN_SW_BURP_FA, isc_spb_bkp_factor, "FACTOR", 0, 0, 0, FALSE, 181, 0, NULL},
|
|
/* msg 181; %sFACTOR blocking factor */
|
|
{IN_SW_BURP_G, isc_spb_bkp_no_garbage_collect, "GARBAGE_COLLECT", 0, 0, 0, FALSE, 177, 0, NULL},
|
|
// msg 177:%sGARBAGE_COLLECT inhibit garbage collection
|
|
{IN_SW_BURP_I, isc_spb_res_deactivate_idx, "INACTIVE", 0, 0, 0, FALSE, 78, 0, NULL},
|
|
// msg 78:%sINACTIVE deactivate indexes during restore
|
|
{IN_SW_BURP_IG, isc_spb_bkp_ignore_checksums, "IGNORE", 0, 0, 0, FALSE, 178, 0, NULL},
|
|
// msg 178:%sIGNORE ignore bad checksums
|
|
{IN_SW_BURP_K, isc_spb_res_no_shadow, "KILL", 0, 0, 0, FALSE, 172, 0, NULL},
|
|
// msg 172:%sKILL restore without creating shadows
|
|
{IN_SW_BURP_L, isc_spb_bkp_ignore_limbo, "LIMBO", 0, 0, 0, FALSE, 98, 0, NULL},
|
|
// msg 98 ignore transactions in limbo
|
|
{IN_SW_BURP_M, isc_spb_bkp_metadata_only, "METADATA", 0, 0, 0, FALSE, 0, 0, NULL},
|
|
{IN_SW_BURP_M, 0, "META_DATA", 0, 0, 0, FALSE, 63, 0, NULL},
|
|
// msg 63: %sMETA_DATA backup metadata only
|
|
{IN_SW_BURP_MODE, 0, "MODE", 0, 0, 0, FALSE, 278, 0, NULL},
|
|
// msg 278: %sMODE read_only or read_write access
|
|
{IN_SW_BURP_N, isc_spb_res_no_validity, "NO_VALIDITY", 0, 0, 0, FALSE, 187, 0, NULL},
|
|
// msg 187: %sN(O_VALIDITY) do not restore database validity conditions
|
|
{IN_SW_BURP_NT, isc_spb_bkp_non_transportable, "NT", 0, 0, 0, FALSE, 239, 0, NULL},
|
|
// msg 239: %sNT Non-Transportable backup file format
|
|
{IN_SW_BURP_O, isc_spb_res_one_at_a_time, "ONE_AT_A_TIME", 0, 0, 0, FALSE, 99, 0, NULL},
|
|
// msg 99: %sONE_AT_A_TIME restore one relation at a time
|
|
{IN_SW_BURP_OL, isc_spb_bkp_old_descriptions, "OLD_DESCRIPTIONS", 0, 0, 0, FALSE, 186, 0, NULL},
|
|
// msg 186: %sOLD_DESCRIPTIONS save old style metadata descriptions
|
|
{IN_SW_BURP_P, isc_spb_res_page_size, "PAGE_SIZE", 0, 0, 0, FALSE, 101, 0, NULL},
|
|
// msg 101: %sPAGE_SIZE override default page size
|
|
{IN_SW_BURP_PASS, 0, "PASSWORD", 0, 0, 0, FALSE, 190, 0, NULL},
|
|
// msg 190: %sPA(SSWORD) InterBase password
|
|
{IN_SW_BURP_RECREATE, 0, "RECREATE_DATABASE", 0, 0, 0, FALSE, 284, 0, NULL},
|
|
// msg 284: %sR(ECREATE_DATABASE) [O(VERWRITE)] create (or replace if OVERWRITE used) database from backup file
|
|
{IN_SW_BURP_R, isc_spb_res_replace, "REPLACE_DATABASE", 0, 0, 0, FALSE, 112, 0, NULL},
|
|
// msg 112: %sREP(LACE_DATABASE) replace database from backup file
|
|
/**************************************************************
|
|
** msg 252: %sRO(LE) InterBase SQL role
|
|
***************************************************************/
|
|
{IN_SW_BURP_ROLE, isc_spb_sql_role_name, "ROLE", 0, 0, 0, FALSE, 252, 0, NULL},
|
|
{IN_SW_BURP_S, 0, "SKIP_BAD_DATA", 0, 0, 0, FALSE, 0, 0, NULL},
|
|
{IN_SW_BURP_SE, 0, "SERVICE", 0, 0, 0, FALSE, 277, 0, NULL},
|
|
// msg 277: %sSE(RVICE) use services manager
|
|
{IN_SW_BURP_T, 0, "TRANSPORTABLE", 0, 0, 0, FALSE, 175, 0, NULL},
|
|
// msg 175: %sTRANSPORTABLE transportable backup -- data in XDR format
|
|
/*
|
|
{IN_SW_BURP_U, 0, "UNPROTECTED", 0, 0, 0, FALSE, 0, 0, NULL},
|
|
*/
|
|
{IN_SW_BURP_US, isc_spb_res_use_all_space, "USE_ALL_SPACE", 0, 0, 0, FALSE, 276, 0, NULL},
|
|
// msg 276: %sUSE_(ALL_SPACE) do not reserve space for record versions
|
|
{IN_SW_BURP_USER, 0, "USER", 0, 0, 0, FALSE, 191, 0, NULL},
|
|
// msg 191: %sUSER InterBase user name
|
|
{IN_SW_BURP_V, isc_spb_verbose, "VERBOSE", 0, 0, 0, FALSE, 0, 0, NULL},
|
|
{IN_SW_BURP_V, 0, "VERIFY", 0, 0, 0, FALSE, 113, 0, NULL},
|
|
// msg 113: %sVERIFY report each action taken
|
|
{IN_SW_BURP_Y, 0, "Y", 0, 0, 0, FALSE, 109, 0, NULL},
|
|
// msg 109: %sY redirect/suppress output (file path or OUTPUT_SUPPRESS)
|
|
{IN_SW_BURP_Z, 0, "Z", 0, 0, 0, FALSE, 104, 0, NULL},
|
|
// msg 104: %sZ print version number
|
|
/**************************************************************************/
|
|
// The next two 'virtual' switches are hidden from user and are needed
|
|
// for services API
|
|
/**************************************************************************/
|
|
{IN_SW_BURP_HIDDEN_RDONLY, isc_spb_res_am_readonly, "mode read_only", 0, 0, 0, FALSE, 0, 0, NULL},
|
|
{IN_SW_BURP_HIDDEN_RDWRITE, isc_spb_res_am_readwrite, "mode read_write", 0, 0, 0, FALSE, 0, 0, NULL},
|
|
/**************************************************************************/
|
|
{IN_SW_BURP_0, 0, NULL, 0, 0, 0, FALSE, 0, 0, NULL}
|
|
};
|
|
|
|
|
|
#endif // BURP_BURP_H
|
|
|