summaryrefslogtreecommitdiff
path: root/static/netbsd/man3/sqlite3_enable_load_extension.3
diff options
context:
space:
mode:
Diffstat (limited to 'static/netbsd/man3/sqlite3_enable_load_extension.3')
-rw-r--r--static/netbsd/man3/sqlite3_enable_load_extension.350
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