diff options
Diffstat (limited to 'static/netbsd/man3/sqlite3_enable_load_extension.3')
| -rw-r--r-- | static/netbsd/man3/sqlite3_enable_load_extension.3 | 50 |
1 files changed, 50 insertions, 0 deletions
diff --git a/static/netbsd/man3/sqlite3_enable_load_extension.3 b/static/netbsd/man3/sqlite3_enable_load_extension.3 new file mode 100644 index 00000000..1ad739f6 --- /dev/null +++ b/static/netbsd/man3/sqlite3_enable_load_extension.3 @@ -0,0 +1,50 @@ +.Dd January 24, 2024 +.Dt SQLITE3_ENABLE_LOAD_EXTENSION 3 +.Os +.Sh NAME +.Nm sqlite3_enable_load_extension +.Nd enable or disable extension loading +.Sh SYNOPSIS +.In sqlite3.h +.Ft int +.Fo sqlite3_enable_load_extension +.Fa "sqlite3 *db" +.Fa "int onoff" +.Fc +.Sh DESCRIPTION +So as not to open security holes in older applications that are unprepared +to deal with extension loading, and as a means of +disabling extension loading while evaluating user-entered +SQL, the following API is provided to turn the +.Fn sqlite3_load_extension +mechanism on and off. +.Pp +Extension loading is off by default. +Call the sqlite3_enable_load_extension() routine with onoff==1 to turn +extension loading on and call it with onoff==0 to turn it back off +again. +.Pp +This interface enables or disables both the C-API +.Fn sqlite3_load_extension +and the SQL function +.Fn load_extension . +Use sqlite3_db_config(db,SQLITE_DBCONFIG_ENABLE_LOAD_EXTENSION,..) +to enable or disable only the C-API. +.Pp +\fBSecurity warning:\fP It is recommended that extension loading be enabled +using the SQLITE_DBCONFIG_ENABLE_LOAD_EXTENSION +method rather than this interface, so the +.Fn load_extension +SQL function remains disabled. +This will prevent SQL injections from giving attackers access to extension +loading capabilities. +.Sh IMPLEMENTATION NOTES +These declarations were extracted from the +interface documentation at line 7180. +.Bd -literal +SQLITE_API int sqlite3_enable_load_extension(sqlite3 *db, int onoff); +.Ed +.Sh SEE ALSO +.Xr sqlite3_db_config 3 , +.Xr sqlite3_load_extension 3 , +.Xr SQLITE_DBCONFIG_MAINDBNAME 3 |
