Debian Codegraph @

www/c3ref/c_iocap_atomic.html

raw
1 <!DOCTYPE html>
2 <html><head>
3 <meta name="viewport" content="width=device-width, initial-scale=1.0">
4 <meta http-equiv="content-type" content="text/html; charset=UTF-8">
5 <link href="../sqlite.css" rel="stylesheet">
6 <title>Device Characteristics</title>
7 <!-- path=../ -->
8 </head>
9 <body>
10 <div class=nosearch>
11 <a href="../index.html">
12 <img class="logo" src="../images/sqlite370_banner.svg" alt="SQLite" border="0">
13 </a>
14 <div><!-- IE hack to prevent disappearing logo --></div>
15 <div class="tagline desktoponly">
16 Small. Fast. Reliable.<br>Choose any three.
17 </div>
18 <div class="menu mainmenu">
19 <ul>
20 <li><a href="../index.html">Home</a>
21 <li class='mobileonly'><a href="javascript:void(0)" onclick='toggle_div("submenu")'>Menu</a>
22 <li class='wideonly'><a href='../about.html'>About</a>
23 <li class='desktoponly'><a href="../docs.html">Documentation</a>
24 <li class='desktoponly'><a href="../download.html">Download</a>
25 <li class='wideonly'><a href='../copyright.html'>License</a>
26 <li class='desktoponly'><a href="../support.html">Support</a>
27 <li class='desktoponly'><a href="../prosupport.html">Purchase</a>
28 <li class='search' id='search_menubutton'>
29 <a href="javascript:void(0)" onclick='toggle_search()'>Search</a>
30 </ul>
31 </div>
32 <div class="menu submenu" id="submenu">
33 <ul>
34 <li><a href='../about.html'>About</a>
35 <li><a href='../docs.html'>Documentation</a>
36 <li><a href='../download.html'>Download</a>
37 <li><a href='../support.html'>Support</a>
38 <li><a href='../prosupport.html'>Purchase</a>
39 </ul>
40 </div>
41 <div class="searchmenu" id="searchmenu">
42 <form method="GET" action="../search">
43 <select name="s" id="searchtype">
44 <option value="d">Search Documentation</option>
45 <option value="c">Search Changelog</option>
46 </select>
47 <input type="text" name="q" id="searchbox" value="">
48 <input type="submit" value="Go">
49 </form>
50 </div>
51 </div>
52 <script>
53 function toggle_div(nm) {
54 var w = document.getElementById(nm);
55 if( w.style.display=="block" ){
56 w.style.display = "none";
57 }else{
58 w.style.display = "block";
59 }
60 }
61 function toggle_search() {
62 var w = document.getElementById("searchmenu");
63 if( w.style.display=="block" ){
64 w.style.display = "none";
65 } else {
66 w.style.display = "block";
67 setTimeout(function(){
68 document.getElementById("searchbox").focus()
69 }, 30);
70 }
71 }
72 function div_off(nm){document.getElementById(nm).style.display="none";}
73 window.onbeforeunload = function(e){div_off("submenu");}
74 /* Disable the Search feature if we are not operating from CGI, since */
75 /* Search is accomplished using CGI and will not work without it. */
76 if( !location.origin || !location.origin.match || !location.origin.match(/http/) ){
77 document.getElementById("search_menubutton").style.display = "none";
78 }
79 /* Used by the Hide/Show button beside syntax diagrams, to toggle the */
80 function hideorshow(btn,obj){
81 var x = document.getElementById(obj);
82 var b = document.getElementById(btn);
83 if( x.style.display!='none' ){
84 x.style.display = 'none';
85 b.innerHTML='show';
86 }else{
87 x.style.display = '';
88 b.innerHTML='hide';
89 }
90 return false;
91 }
92 var antiRobot = 0;
93 function antiRobotGo(){
94 if( antiRobot!=3 ) return;
95 antiRobot = 7;
96 var j = document.getElementById("mtimelink");
97 if(j && j.hasAttribute("data-href")) j.href=j.getAttribute("data-href");
98 }
99 function antiRobotDefense(){
100 document.body.onmousedown=function(){
101 antiRobot |= 2;
102 antiRobotGo();
103 document.body.onmousedown=null;
104 }
105 document.body.onmousemove=function(){
106 antiRobot |= 2;
107 antiRobotGo();
108 document.body.onmousemove=null;
109 }
110 setTimeout(function(){
111 antiRobot |= 1;
112 antiRobotGo();
113 }, 100)
114 antiRobotGo();
115 }
116 antiRobotDefense();
117 </script>
118 <!-- keywords: SQLITE_IOCAP_ATOMIC SQLITE_IOCAP_ATOMIC16K SQLITE_IOCAP_ATOMIC1K SQLITE_IOCAP_ATOMIC2K SQLITE_IOCAP_ATOMIC32K SQLITE_IOCAP_ATOMIC4K SQLITE_IOCAP_ATOMIC512 SQLITE_IOCAP_ATOMIC64K SQLITE_IOCAP_ATOMIC8K SQLITE_IOCAP_BATCH_ATOMIC SQLITE_IOCAP_IMMUTABLE SQLITE_IOCAP_POWERSAFE_OVERWRITE SQLITE_IOCAP_SAFE_APPEND SQLITE_IOCAP_SEQUENTIAL SQLITE_IOCAP_SUBPAGE_READ SQLITE_IOCAP_UNDELETABLE_WHEN_OPEN -->
119 <div class=nosearch>
120 <a href="../c3ref/intro.html"><h2>SQLite C Interface</h2></a>
121 <h2>Device Characteristics</h2>
122 </div>
123 <blockquote><pre>
124 #define SQLITE_IOCAP_ATOMIC 0x00000001
125 #define SQLITE_IOCAP_ATOMIC512 0x00000002
126 #define SQLITE_IOCAP_ATOMIC1K 0x00000004
127 #define SQLITE_IOCAP_ATOMIC2K 0x00000008
128 #define SQLITE_IOCAP_ATOMIC4K 0x00000010
129 #define SQLITE_IOCAP_ATOMIC8K 0x00000020
130 #define SQLITE_IOCAP_ATOMIC16K 0x00000040
131 #define SQLITE_IOCAP_ATOMIC32K 0x00000080
132 #define SQLITE_IOCAP_ATOMIC64K 0x00000100
133 #define SQLITE_IOCAP_SAFE_APPEND 0x00000200
134 #define SQLITE_IOCAP_SEQUENTIAL 0x00000400
135 #define SQLITE_IOCAP_UNDELETABLE_WHEN_OPEN 0x00000800
136 #define SQLITE_IOCAP_POWERSAFE_OVERWRITE 0x00001000
137 #define SQLITE_IOCAP_IMMUTABLE 0x00002000
138 #define SQLITE_IOCAP_BATCH_ATOMIC 0x00004000
139 #define SQLITE_IOCAP_SUBPAGE_READ 0x00008000
140 </pre></blockquote>
141 <p>
142 The xDeviceCharacteristics method of the <a href="../c3ref/io_methods.html">sqlite3_io_methods</a>
143 object returns an integer which is a vector of these
144 bit values expressing I/O characteristics of the mass storage
145 device that holds the file that the <a href="../c3ref/io_methods.html">sqlite3_io_methods</a>
146 refers to.</p>
147
148 <p>The SQLITE_IOCAP_ATOMIC property means that all writes of
149 any size are atomic. The SQLITE_IOCAP_ATOMICnnn values
150 mean that writes of blocks that are nnn bytes in size and
151 are aligned to an address which is an integer multiple of
152 nnn are atomic. The SQLITE_IOCAP_SAFE_APPEND value means
153 that when data is appended to a file, the data is appended
154 first then the size of the file is extended, never the other
155 way around. The SQLITE_IOCAP_SEQUENTIAL property means that
156 information is written to disk in the same order as calls
157 to xWrite(). The SQLITE_IOCAP_POWERSAFE_OVERWRITE property means that
158 after reboot following a crash or power loss, the only bytes in a
159 file that were written at the application level might have changed
160 and that adjacent bytes, even bytes within the same sector are
161 guaranteed to be unchanged. The SQLITE_IOCAP_UNDELETABLE_WHEN_OPEN
162 flag indicates that a file cannot be deleted when open. The
163 SQLITE_IOCAP_IMMUTABLE flag indicates that the file is on
164 read-only media and cannot be changed even by processes with
165 elevated privileges.</p>
166
167 <p>The SQLITE_IOCAP_BATCH_ATOMIC property means that the underlying
168 filesystem supports doing multiple write operations atomically when those
169 write operations are bracketed by <a href="../c3ref/c_fcntl_begin_atomic_write.html#sqlitefcntlbeginatomicwrite">SQLITE_FCNTL_BEGIN_ATOMIC_WRITE</a> and
170 <a href="../c3ref/c_fcntl_begin_atomic_write.html#sqlitefcntlcommitatomicwrite">SQLITE_FCNTL_COMMIT_ATOMIC_WRITE</a>.</p>
171
172 <p>The SQLITE_IOCAP_SUBPAGE_READ property means that it is ok to read
173 from the database file in amounts that are not a multiple of the
174 page size and that do not begin at a page boundary. Without this
175 property, SQLite is careful to only do full-page reads and write
176 on aligned pages, with the one exception that it will do a sub-page
177 read of the first page to access the database header.
178 </p><p>See also lists of
179 <a href="../c3ref/objlist.html">Objects</a>,
180 <a href="../c3ref/constlist.html">Constants</a>, and
181 <a href="../c3ref/funclist.html">Functions</a>.</p>
182