0
0
mirror of https://gitlab.com/cznic/sqlite.git synced 2025-05-17 23:26:41 +00:00
Files

204 lines
5.4 KiB
Go
Raw Permalink Normal View History

// Copyright 2017 The Sqlite Authors. All rights reserved.
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.
2021-12-02 14:56:58 +01:00
// Package sqlite is a sql/database driver using a CGo-free port of the C
// SQLite3 library.
2021-02-21 22:21:30 +01:00
//
// SQLite is an in-process implementation of a self-contained, serverless,
// zero-configuration, transactional SQL database engine.
//
2022-03-21 12:47:38 +01:00
// Thanks
//
// This project is sponsored by Schleibinger Geräte Teubert u. Greim GmbH by
// allowing one of the maintainers to work on it also in office hours.
//
// Supported platforms and architectures
//
// These combinations of GOOS and GOARCH are currently supported
//
2021-12-02 14:56:58 +01:00
// OS Arch SQLite version
// ------------------------------
2022-12-28 23:26:14 +01:00
// darwin amd64 3.40.1
// darwin arm64 3.40.1
// freebsd amd64 3.40.1
// freebsd arm64 3.40.1
// linux 386 3.40.1
// linux amd64 3.40.1
// linux arm 3.40.1
// linux arm64 3.40.1
// linux ppc64le 3.40.1
// linux riscv64 3.40.1
// windows amd64 3.40.1
// windows arm64 3.40.1
//
2020-11-19 17:53:04 +01:00
// Builders
//
2021-01-08 14:09:57 +01:00
// Builder results available at
2020-11-19 17:53:04 +01:00
//
document v1.20.0 release - Upgrade to SQLite 3.40.0: https://sqlite.org/releaselog/3_40_0.html - Support linux/ppc64le https://modern-c.appspot.com/-/builder/?importpath=modernc.org%2fsqlite modernc.org/sqlite builder results Import path Builder Time Commit OS Arch Result Version modernc.org/sqlite pi64 2022-11-28 12:46:52 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 linux arm64 PASS go1.19.3 modernc.org/sqlite freebsd_arm64 2022-11-28 12:01:58 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 freebsd arm64 PASS go1.19.2 modernc.org/sqlite pi400 2022-11-28 11:59:01 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 windows arm64 PASS go1.19.3 modernc.org/sqlite riscv64 2022-11-28 07:25:11 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 linux riscv64 PASS go1.19.3 modernc.org/sqlite win64 2022-11-28 06:03:26 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 windows amd64 PASS go1.19.3 modernc.org/sqlite s390x 2022-11-28 04:20:49 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 linux s390x FAIL go1.19.3 modernc.org/sqlite freebsd_arm 2022-11-28 04:19:40 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 freebsd arm FAIL go1.19.2 modernc.org/sqlite pi32 2022-11-28 02:59:24 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 linux arm PASS go1.19.3 modernc.org/sqlite netbsd_arm 2022-11-28 01:08:46 +0000 UTC 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 netbsd arm FAIL go1.18.3 modernc.org/sqlite win32 2022-11-28 00:50:15 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 windows 386 FAIL go1.19.3 modernc.org/sqlite netbsd_386 2022-11-28 00:02:35 +0100 +0100 41cc2963fceaf4e0c20bd592fc1e57936ff0b757 netbsd 386 FAIL go1.18.3 modernc.org/sqlite nuc64 2022-11-27 20:45:49 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 linux amd64 PASS go1.19.3 modernc.org/sqlite ppc64le 2022-11-27 20:38:59 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 linux ppc64le PASS go1.19.3 modernc.org/sqlite darwin 2022-11-27 20:13:59 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 darwin amd64 PASS go1.19.3 modernc.org/sqlite freebsd64 2022-11-27 19:55:34 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 freebsd amd64 PASS go1.19.3 modernc.org/sqlite e5-1650 2022-11-27 19:47:20 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 linux 386 PASS go1.19.3 modernc.org/sqlite darwin-m1 2022-11-27 19:44:56 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 darwin arm64 PASS go1.19.3 modernc.org/sqlite openbsd64 2022-11-27 19:30:58 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 openbsd amd64 FAIL go1.19.1 modernc.org/sqlite netbsd64 2022-11-27 19:27:14 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 netbsd amd64 FAIL go1.18.3 modernc.org/sqlite openbsd_arm64 2022-10-25 09:34:13 +0200 +0200 e8e7bc00f818a913b0d449e580c93c915c81338f openbsd arm64 FAIL go1.19.1 modernc.org/sqlite freebsd-386 2022-09-18 01:02:00 +0200 +0200 99d11133fd86a80e08f4031151d6aae821fe9af6 freebsd 386 FAIL go1.19.1 All builder results Results as of 2022-11-28 12:43:26 +0000 UTC
2022-11-28 14:14:37 +01:00
// https://modern-c.appspot.com/-/builder/?importpath=modernc.org%2fsqlite
2020-11-19 17:53:04 +01:00
//
// Changelog
//
document v1.20.0 release - Upgrade to SQLite 3.40.0: https://sqlite.org/releaselog/3_40_0.html - Support linux/ppc64le https://modern-c.appspot.com/-/builder/?importpath=modernc.org%2fsqlite modernc.org/sqlite builder results Import path Builder Time Commit OS Arch Result Version modernc.org/sqlite pi64 2022-11-28 12:46:52 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 linux arm64 PASS go1.19.3 modernc.org/sqlite freebsd_arm64 2022-11-28 12:01:58 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 freebsd arm64 PASS go1.19.2 modernc.org/sqlite pi400 2022-11-28 11:59:01 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 windows arm64 PASS go1.19.3 modernc.org/sqlite riscv64 2022-11-28 07:25:11 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 linux riscv64 PASS go1.19.3 modernc.org/sqlite win64 2022-11-28 06:03:26 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 windows amd64 PASS go1.19.3 modernc.org/sqlite s390x 2022-11-28 04:20:49 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 linux s390x FAIL go1.19.3 modernc.org/sqlite freebsd_arm 2022-11-28 04:19:40 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 freebsd arm FAIL go1.19.2 modernc.org/sqlite pi32 2022-11-28 02:59:24 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 linux arm PASS go1.19.3 modernc.org/sqlite netbsd_arm 2022-11-28 01:08:46 +0000 UTC 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 netbsd arm FAIL go1.18.3 modernc.org/sqlite win32 2022-11-28 00:50:15 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 windows 386 FAIL go1.19.3 modernc.org/sqlite netbsd_386 2022-11-28 00:02:35 +0100 +0100 41cc2963fceaf4e0c20bd592fc1e57936ff0b757 netbsd 386 FAIL go1.18.3 modernc.org/sqlite nuc64 2022-11-27 20:45:49 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 linux amd64 PASS go1.19.3 modernc.org/sqlite ppc64le 2022-11-27 20:38:59 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 linux ppc64le PASS go1.19.3 modernc.org/sqlite darwin 2022-11-27 20:13:59 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 darwin amd64 PASS go1.19.3 modernc.org/sqlite freebsd64 2022-11-27 19:55:34 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 freebsd amd64 PASS go1.19.3 modernc.org/sqlite e5-1650 2022-11-27 19:47:20 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 linux 386 PASS go1.19.3 modernc.org/sqlite darwin-m1 2022-11-27 19:44:56 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 darwin arm64 PASS go1.19.3 modernc.org/sqlite openbsd64 2022-11-27 19:30:58 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 openbsd amd64 FAIL go1.19.1 modernc.org/sqlite netbsd64 2022-11-27 19:27:14 +0100 +0100 76945bb9b2bbcf2557738fcb8d4facdd3399eca4 netbsd amd64 FAIL go1.18.3 modernc.org/sqlite openbsd_arm64 2022-10-25 09:34:13 +0200 +0200 e8e7bc00f818a913b0d449e580c93c915c81338f openbsd arm64 FAIL go1.19.1 modernc.org/sqlite freebsd-386 2022-09-18 01:02:00 +0200 +0200 99d11133fd86a80e08f4031151d6aae821fe9af6 freebsd 386 FAIL go1.19.1 All builder results Results as of 2022-11-28 12:43:26 +0000 UTC
2022-11-28 14:14:37 +01:00
// 2022-11-28 v1.20.0
//
// Support linux/ppc64le.
//
2022-09-15 11:30:54 +02:00
// 2022-09-16 v1.19.0:
//
// Support frebsd/arm64.
//
2022-07-25 10:19:12 +02:00
// 2022-07-26 v1.18.0:
2022-07-24 17:32:15 +02:00
//
// Adds support for Go fs.FS based SQLite virtual filesystems, see function New
2022-07-25 10:19:12 +02:00
// in modernc.org/sqlite/vfs and/or TestVFS in all_test.go
2022-07-24 17:32:15 +02:00
//
2022-04-24 11:19:23 +02:00
// 2022-04-24 v1.17.0:
//
// Support windows/arm64.
//
2022-04-04 14:52:56 +02:00
// 2022-04-04 v1.16.0:
//
// Support scalar application defined functions written in Go.
//
// https://www.sqlite.org/appfunc.html
//
// 2022-03-13 v1.15.0:
//
// Support linux/riscv64.
//
// 2021-11-13 v1.14.0:
//
// Support windows/amd64. This target had previously only experimental status
// because of a now resolved memory leak.
//
// 2021-09-07 v1.13.0:
//
// Support freebsd/amd64.
//
// Changelog
//
// 2021-06-23 v1.11.0:
2021-06-13 18:48:40 +02:00
//
// Upgrade to use sqlite 3.36.0, release notes at https://www.sqlite.org/releaselog/3_36_0.html.
2021-06-13 18:48:40 +02:00
//
2021-05-06 17:34:05 +02:00
// 2021-05-06 v1.10.6:
2021-05-06 17:29:51 +02:00
//
// Fixes a memory corruption issue
// (https://gitlab.com/cznic/sqlite/-/issues/53). Versions since v1.8.6 were
2021-05-06 17:35:10 +02:00
// affected and should be updated to v1.10.6.
2021-05-06 17:29:51 +02:00
//
2021-03-14 10:46:32 -03:00
// 2021-03-14 v1.10.0:
//
// Update to use sqlite 3.35.0, release notes at https://www.sqlite.org/releaselog/3_35_0.html.
//
2021-03-11 13:11:31 -04:00
// 2021-03-11 v1.9.0:
//
// Support darwin/arm64.
//
2021-01-08 14:09:57 +01:00
// 2021-01-08 v1.8.0:
//
// Support darwin/amd64.
//
2020-09-13 19:31:58 +02:00
// 2020-09-13 v1.7.0:
2020-09-13 15:31:23 +02:00
//
// Support linux/arm and linux/arm64.
//
2020-09-08 13:39:54 +02:00
// 2020-09-08 v1.6.0:
2020-09-08 13:31:08 +02:00
//
// Support linux/386.
//
// 2020-09-03 v1.5.0:
//
// This project is now completely CGo-free, including the Tcl tests.
//
2020-08-26 23:31:54 +02:00
// 2020-08-26 v1.4.0:
//
// First stable release for linux/amd64. The database/sql driver and its tests
// are CGo free. Tests of the translated sqlite3.c library still require CGo.
//
// $ make full
//
// ...
//
// SQLite 2020-08-14 13:23:32 fca8dc8b578f215a969cd899336378966156154710873e68b3d9ac5881b0ff3f
// 0 errors out of 928271 tests on 3900x Linux 64-bit little-endian
// WARNING: Multi-threaded tests skipped: Linked against a non-threadsafe Tcl build
// All memory allocations freed - no leaks
// Maximum memory usage: 9156360 bytes
// Current memory usage: 0 bytes
// Number of malloc() : -1 calls
// --- PASS: TestTclTest (1785.04s)
// PASS
// ok modernc.org/sqlite 1785.041s
// $
//
2020-07-26 22:36:18 +02:00
// 2020-07-26 v1.4.0-beta1:
//
// The project has reached beta status while supporting linux/amd64 only at the
// moment. The 'extraquick' Tcl testsuite reports
//
// 630 errors out of 200177 tests on Linux 64-bit little-endian
//
// and some memory leaks
//
// Unfreed memory: 698816 bytes in 322 allocations
//
2019-12-28 11:22:30 +01:00
// 2019-12-28 v1.2.0-alpha.3: Third alpha fixes issue #19.
//
// It also bumps the minor version as the repository was wrongly already tagged
// with v1.1.0 before. Even though the tag was deleted there are proxies that
// cached that tag. Thanks /u/garaktailor for detecting the problem and
// suggesting this solution.
//
2019-12-26 17:24:51 +01:00
// 2019-12-26 v1.1.0-alpha.2: Second alpha release adds support for accessing a
// database concurrently by multiple goroutines and/or processes. v1.1.0 is now
// considered feature-complete. Next planed release should be a beta with a
// proper test suite.
//
// 2019-12-18 v1.1.0-alpha.1: First alpha release using the new cc/v3, gocc,
// qbe toolchain. Some primitive tests pass on linux_{amd64,386}. Not yet safe
// for concurrent access by multiple goroutines. Next alpha release is planed
// to arrive before the end of this year.
2019-12-18 17:51:11 +01:00
//
2017-06-10 17:00:25 +02:00
// 2017-06-10 Windows/Intel no more uses the VM (thanks Steffen Butzer).
//
// 2017-06-05 Linux/Intel no more uses the VM (cznic/virtual).
//
// Connecting to a database
//
// To access a Sqlite database do something like
//
// import (
// "database/sql"
//
2018-11-06 18:03:25 +01:00
// _ "modernc.org/sqlite"
// )
//
// ...
//
//
// db, err := sql.Open("sqlite", dsnURI)
//
// ...
//
2020-08-26 23:31:54 +02:00
// Debug and development versions
//
// A comma separated list of options can be passed to `go generate` via the
// environment variable GO_GENERATE. Some useful options include for example:
//
// -DSQLITE_DEBUG
// -DSQLITE_MEM_DEBUG
// -ccgo-verify-structs
//
// To create a debug/development version, issue for example:
//
// $ GO_GENERATE=-DSQLITE_DEBUG,-DSQLITE_MEM_DEBUG go generate
//
// Note: To run `go generate` you need to have modernc.org/ccgo/v3 installed.
//
// Sqlite documentation
//
// See https://sqlite.org/docs.html
2018-11-06 18:03:25 +01:00
package sqlite // import "modernc.org/sqlite"