contrib/sqlite3/sqlite3.c

7138 **     <li><b>sqlite3_backup_step()</b> is called one or more times to transfer
7169 ** ^The [sqlite3_backup] object may be used with the sqlite3_backup_step() and
7173 ** [[sqlite3_backup_step()]] <b>sqlite3_backup_step()</b>
7175 ** ^Function sqlite3_backup_step(B,N) will copy up to N pages between
7178 ** ^If sqlite3_backup_step(B,N) successfully copies N pages and there
7180 ** ^If sqlite3_backup_step(B,N) successfully finishes copying all pages
7182 ** ^If an error occurs while running sqlite3_backup_step(B,N),
7184 ** [SQLITE_DONE], a call to sqlite3_backup_step() may return [SQLITE_READONLY],
7188 ** ^(The sqlite3_backup_step() might return [SQLITE_READONLY] if
7197 ** ^If sqlite3_backup_step() cannot obtain a required file-system lock, then
7202 ** sqlite3_backup_step() can be retried later. ^If the source
7204 ** is being used to write to the source database when sqlite3_backup_step()
7206 ** case the call to sqlite3_backup_step() can be retried later on. ^(If
7209 ** there is no point in retrying the call to sqlite3_backup_step(). These
7214 ** ^The first call to sqlite3_backup_step() obtains an exclusive lock
7217 ** and sqlite3_backup_step() returns [SQLITE_DONE].  ^Every call to
7218 ** sqlite3_backup_step() obtains a [shared lock] on the source database that
7219 ** lasts for the duration of the sqlite3_backup_step() call.
7221 ** sqlite3_backup_step(), the source database may be modified mid-way
7225 ** restarted by the next call to sqlite3_backup_step(). ^If the source
7232 ** When sqlite3_backup_step() has returned [SQLITE_DONE], or when the
7237 ** ^If sqlite3_backup_step() has not yet returned [SQLITE_DONE], then any
7243 ** sqlite3_backup_step() errors occurred, regardless or whether or not
7244 ** sqlite3_backup_step() completed.
7246 ** sqlite3_backup_step() call on the same [sqlite3_backup] object, then
7249 ** ^A return of [SQLITE_BUSY] or [SQLITE_LOCKED] from sqlite3_backup_step()
7256 ** ^Each call to sqlite3_backup_step() sets two values inside
7263 ** sqlite3_backup_step(). ^If the source database is modified during a backup
7293 ** threads may safely make multiple concurrent calls to sqlite3_backup_step().
7296 ** same time as another thread is invoking sqlite3_backup_step() it is
7305 SQLITE_API int sqlite3_backup_step(sqlite3_backup *p, int nPage);
58180   ** sqlite3_backup_step(). The user is required to ensure that no
58368 SQLITE_API int sqlite3_backup_step(sqlite3_backup *p, int nPage){
58660 ** call to sqlite3_backup_step().
58668 ** recent call to sqlite3_backup_step().
58753   ** to 0. This is used by the implementations of sqlite3_backup_step()
58765   ** sqlite3_backup_step(), we can guarantee that the copy finishes
58770   sqlite3_backup_step(&b, 0x7FFFFFFF);
92613 #define sqlite3_backup_step            sqlite3_api->backup_step
92990   sqlite3_backup_step,