lib/sqlite/sqlite3.c

6652 **     <li><b>sqlite3_backup_step()</b> is called one or more times to transfer
6683 ** ^The [sqlite3_backup] object may be used with the sqlite3_backup_step() and
6687 ** [[sqlite3_backup_step()]] <b>sqlite3_backup_step()</b>
6689 ** ^Function sqlite3_backup_step(B,N) will copy up to N pages between
6692 ** ^If sqlite3_backup_step(B,N) successfully copies N pages and there
6694 ** ^If sqlite3_backup_step(B,N) successfully finishes copying all pages
6696 ** ^If an error occurs while running sqlite3_backup_step(B,N),
6698 ** [SQLITE_DONE], a call to sqlite3_backup_step() may return [SQLITE_READONLY],
6702 ** ^(The sqlite3_backup_step() might return [SQLITE_READONLY] if
6711 ** ^If sqlite3_backup_step() cannot obtain a required file-system lock, then
6716 ** sqlite3_backup_step() can be retried later. ^If the source
6718 ** is being used to write to the source database when sqlite3_backup_step()
6720 ** case the call to sqlite3_backup_step() can be retried later on. ^(If
6723 ** there is no point in retrying the call to sqlite3_backup_step(). These
6728 ** ^The first call to sqlite3_backup_step() obtains an exclusive lock
6731 ** and sqlite3_backup_step() returns [SQLITE_DONE].  ^Every call to
6732 ** sqlite3_backup_step() obtains a [shared lock] on the source database that
6733 ** lasts for the duration of the sqlite3_backup_step() call.
6735 ** sqlite3_backup_step(), the source database may be modified mid-way
6739 ** restarted by the next call to sqlite3_backup_step(). ^If the source
6746 ** When sqlite3_backup_step() has returned [SQLITE_DONE], or when the
6751 ** ^If sqlite3_backup_step() has not yet returned [SQLITE_DONE], then any
6757 ** sqlite3_backup_step() errors occurred, regardless or whether or not
6758 ** sqlite3_backup_step() completed.
6760 ** sqlite3_backup_step() call on the same [sqlite3_backup] object, then
6763 ** ^A return of [SQLITE_BUSY] or [SQLITE_LOCKED] from sqlite3_backup_step()
6770 ** ^Each call to sqlite3_backup_step() sets two values inside
6777 ** sqlite3_backup_step(). ^If the source database is modified during a backup
6807 ** threads may safely make multiple concurrent calls to sqlite3_backup_step().
6810 ** same time as another thread is invoking sqlite3_backup_step() it is
6819 SQLITE_API int sqlite3_backup_step(sqlite3_backup *p, int nPage);
56593   ** sqlite3_backup_step(). The user is required to ensure that no
56771 SQLITE_API int sqlite3_backup_step(sqlite3_backup *p, int nPage){
57039 ** call to sqlite3_backup_step().
57047 ** recent call to sqlite3_backup_step().
57122   ** to 0. This is used by the implementations of sqlite3_backup_step()
57134   ** sqlite3_backup_step(), we can guarantee that the copy finishes
57139   sqlite3_backup_step(&b, 0x7FFFFFFF);
89293 #define sqlite3_backup_step            sqlite3_api->backup_step
89647   sqlite3_backup_step,