/ Check-in [96e95aa5]
Login

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
Comment:Update the "experimental" markings on C/C++ interfaces. (CVS 5421)
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1: 96e95aa5e6c237bb9330900c2e1ac446158eca46
User & Date: drh 2008-07-16 13:29:51
Context
2008-07-16
14:02
Fix a bug in the error reporting of sqlite3_table_column_metadata(). (CVS 5422) check-in: 7eba18c3 user: drh tags: trunk
13:29
Update the "experimental" markings on C/C++ interfaces. (CVS 5421) check-in: 96e95aa5 user: drh tags: trunk
12:33
Fix a bug in the HOMEGROWN_RECURSIVE_MUTEX implementation for unix. Ticket #3224. (CVS 5420) check-in: 9af2514c user: drh tags: trunk
Changes
Hide Diffs Side-by-Side Diffs Ignore Whitespace Patch

Changes to src/sqlite.h.in.

    26     26   ** on how SQLite interfaces are suppose to operate.
    27     27   **
    28     28   ** The name of this file under configuration management is "sqlite.h.in".
    29     29   ** The makefile makes some minor changes to this file (such as inserting
    30     30   ** the version number) and changes its name to "sqlite3.h" as
    31     31   ** part of the build process.
    32     32   **
    33         -** @(#) $Id: sqlite.h.in,v 1.371 2008/07/14 18:38:17 drh Exp $
           33  +** @(#) $Id: sqlite.h.in,v 1.372 2008/07/16 13:29:51 drh Exp $
    34     34   */
    35     35   #ifndef _SQLITE3_H_
    36     36   #define _SQLITE3_H_
    37     37   #include <stdarg.h>     /* Needed for the definition of va_list */
    38     38   
    39     39   /*
    40     40   ** Make sure we can call this stuff from C++.
................................................................................
   960    960   ** what property of SQLite is to be configured.  Subsequent arguments
   961    961   ** vary depending on the [SQLITE_CONFIG_SINGLETHREAD | configuration option]
   962    962   ** in the first argument.
   963    963   **
   964    964   ** When a configuration option is set, sqlite3_config() returns SQLITE_OK.
   965    965   ** If the option is unknown or SQLite is unable to set the option
   966    966   ** then this routine returns a non-zero [error code].
          967  +**
          968  +** The sqlite3_config() interface is considered experimental in that
          969  +** new configuration options may be added in future releases and existing
          970  +** configuration options may be discontinued or modified.
   967    971   */
   968    972   int sqlite3_config(int, ...);
   969    973   
   970    974   /*
   971    975   ** CAPI3REF: Memory Allocation Routines {F10155}
   972    976   **
   973    977   ** An instance of this object defines the interface between SQLite
................................................................................
  1022   1026   };
  1023   1027   
  1024   1028   /*
  1025   1029   ** CAPI3REF: Configuration Options {F10160}
  1026   1030   **
  1027   1031   ** These constants are the available integer configuration options that
  1028   1032   ** can be passed as the first argument to the [sqlite3_config()] interface.
         1033  +**
         1034  +** New configuration options may be added in future releases of SQLite.
         1035  +** Existing configuration options might be discontinued.  Applications
         1036  +** should check the return code from [sqlite3_config()] to make sure that
         1037  +** the call worked.  The [sqlite3_config()] interface will return a
         1038  +** non-zero [error code] if a discontinued or unsupported configuration option
         1039  +** is invoked.
  1029   1040   **
  1030   1041   ** <dl>
  1031   1042   ** <dt>SQLITE_CONFIG_SINGLETHREAD</dt>
  1032   1043   ** <dd>There are no arguments to this option.  This option disables
  1033   1044   ** all mutexing and puts SQLite into a mode where it can only be used
  1034   1045   ** by a single thread.</dd>
  1035   1046   **
................................................................................
  2524   2535   ** large, default limits.  Databases managed by external sources can
  2525   2536   ** be given much smaller limits designed to prevent a denial of service
  2526   2537   ** attack.  Developers might also want to use the [sqlite3_set_authorizer()]
  2527   2538   ** interface to further control untrusted SQL.  The size of the database
  2528   2539   ** created by an untrusted script can be contained using the
  2529   2540   ** [max_page_count] [PRAGMA].
  2530   2541   **
  2531         -** This interface is currently considered experimental and is subject
  2532         -** to change or removal without prior notice.
         2542  +** New run-time limit categories may be added in future releases.
  2533   2543   **
  2534   2544   ** INVARIANTS:
  2535   2545   **
  2536   2546   ** {F12762} A successful call to [sqlite3_limit(D,C,V)] where V is
  2537   2547   **          positive changes the limit on the size of construct C in the
  2538   2548   **          [database connection] D to the lesser of V and the hard upper
  2539   2549   **          bound on the size of C that is set at compile-time.
................................................................................
  4744   4754   ** an error or constraint causes an implicit rollback to occur.
  4745   4755   ** The rollback callback is not invoked if a transaction is
  4746   4756   ** automatically rolled back because the database connection is closed.
  4747   4757   ** The rollback callback is not invoked if a transaction is
  4748   4758   ** rolled back because a commit callback returned non-zero.
  4749   4759   ** <todo> Check on this </todo>
  4750   4760   **
  4751         -** These are experimental interfaces and are subject to change.
  4752         -**
  4753   4761   ** INVARIANTS:
  4754   4762   **
  4755   4763   ** {F12951} The [sqlite3_commit_hook(D,F,P)] interface registers the
  4756   4764   **          callback function F to be invoked with argument P whenever
  4757   4765   **          a transaction commits on the [database connection] D.
  4758   4766   **
  4759   4767   ** {F12952} The [sqlite3_commit_hook(D,F,P)] interface returns the P argument
................................................................................
  5113   5121   ** to all new [database connections]. {END}
  5114   5122   **
  5115   5123   ** This routine stores a pointer to the extension in an array that is
  5116   5124   ** obtained from [sqlite3_malloc()].  If you run a memory leak checker
  5117   5125   ** on your program and it reports a leak because of this array, invoke
  5118   5126   ** [sqlite3_reset_auto_extension()] prior to shutdown to free the memory.
  5119   5127   **
  5120         -** This interface is experimental and is subject to change or
  5121         -** removal in future releases of SQLite.
  5122         -**
  5123   5128   ** {F12641} This function registers an extension entry point that is
  5124   5129   **          automatically invoked whenever a new [database connection]
  5125   5130   **          is opened using [sqlite3_open()], [sqlite3_open16()],
  5126   5131   **          or [sqlite3_open_v2()].
  5127   5132   **
  5128   5133   ** {F12642} Duplicate extensions are detected so calling this routine
  5129   5134   **          multiple times with the same extension is harmless.
................................................................................
  5138   5143   /*
  5139   5144   ** CAPI3REF: Reset Automatic Extension Loading {F12660}
  5140   5145   **
  5141   5146   ** This function disables all previously registered automatic
  5142   5147   ** extensions. {END}  It undoes the effect of all prior
  5143   5148   ** [sqlite3_auto_extension()] calls.
  5144   5149   **
  5145         -** This interface is experimental and is subject to change or
  5146         -** removal in future releases of SQLite.
  5147         -**
  5148   5150   ** {F12661} This function disables all previously registered
  5149   5151   **          automatic extensions.
  5150   5152   **
  5151   5153   ** {F12662} This function disables automatic extensions in all threads.
  5152   5154   */
  5153   5155   void sqlite3_reset_auto_extension(void);
  5154   5156