0000: 2f 2a 0a 2a 2a 20 32 30 30 31 20 53 65 70 74 65 /*.** 2001 Septe
0010: 6d 62 65 72 20 31 36 0a 2a 2a 0a 2a 2a 20 54 68 mber 16.**.** Th
0020: 65 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69 e author disclai
0030: 6d 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20 ms copyright to
0040: 74 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65 this source code
0050: 2e 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a . In place of.*
0060: 2a 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 * a legal notice
0070: 2c 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73 , here is a bles
0080: 73 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d sing:.**.** M
0090: 61 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 ay you do good a
00a0: 6e 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 nd not evil..**
00b0: 20 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 May you find
00c0: 66 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20 forgiveness for
00d0: 79 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 yourself and for
00e0: 67 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 give others..**
00f0: 20 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65 May you share
0100: 20 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 freely, never t
0110: 61 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 aking more than
0120: 79 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a you give..**.***
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0170: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a ***********.**.*
0180: 2a 20 54 68 69 73 20 66 69 6c 65 20 63 6f 6e 74 * This file cont
0190: 61 69 6e 73 20 63 6f 64 65 20 74 68 61 74 20 69 ains code that i
01a0: 73 20 73 70 65 63 69 66 69 63 20 74 6f 20 70 61 s specific to pa
01b0: 72 74 69 63 75 6c 61 72 20 6f 70 65 72 61 74 69 rticular operati
01c0: 6e 67 0a 2a 2a 20 73 79 73 74 65 6d 73 2e 20 20 ng.** systems.
01d0: 54 68 65 20 70 75 72 70 6f 73 65 20 6f 66 20 74 The purpose of t
01e0: 68 69 73 20 66 69 6c 65 20 69 73 20 74 6f 20 70 his file is to p
01f0: 72 6f 76 69 64 65 20 61 20 75 6e 69 66 6f 72 6d rovide a uniform
0200: 20 61 62 73 74 72 61 63 74 0a 2a 2a 20 6f 6e 20 abstract.** on
0210: 77 68 69 63 68 20 74 68 65 20 72 65 73 74 20 6f which the rest o
0220: 66 20 53 51 4c 69 74 65 20 63 61 6e 20 6f 70 65 f SQLite can ope
0230: 72 61 74 65 2e 0a 2a 2f 0a 23 69 6e 63 6c 75 64 rate..*/.#includ
0240: 65 20 22 73 71 6c 69 74 65 49 6e 74 2e 68 22 0a e "sqliteInt.h".
0250: 23 69 6e 63 6c 75 64 65 20 22 6f 73 2e 68 22 0a #include "os.h".
0260: 0a 23 69 66 6e 64 65 66 20 4f 53 5f 55 4e 49 58 .#ifndef OS_UNIX
0270: 0a 23 20 69 66 6e 64 65 66 20 4f 53 5f 57 49 4e .# ifndef OS_WIN
0280: 0a 23 20 20 64 65 66 69 6e 65 20 4f 53 5f 55 4e .# define OS_UN
0290: 49 58 20 31 0a 23 20 65 6c 73 65 0a 23 20 20 64 IX 1.# else.# d
02a0: 65 66 69 6e 65 20 4f 53 5f 55 4e 49 58 20 30 0a efine OS_UNIX 0.
02b0: 23 20 65 6e 64 69 66 0a 23 65 6e 64 69 66 0a 23 # endif.#endif.#
02c0: 69 66 6e 64 65 66 20 4f 53 5f 57 49 4e 0a 23 20 ifndef OS_WIN.#
02d0: 64 65 66 69 6e 65 20 4f 53 5f 57 49 4e 20 30 0a define OS_WIN 0.
02e0: 23 65 6e 64 69 66 0a 23 69 66 20 4f 53 5f 55 4e #endif.#if OS_UN
02f0: 49 58 0a 23 20 69 6e 63 6c 75 64 65 20 3c 75 6e IX.# include <un
0300: 69 73 74 64 2e 68 3e 0a 23 20 69 6e 63 6c 75 64 istd.h>.# includ
0310: 65 20 3c 66 63 6e 74 6c 2e 68 3e 0a 23 20 69 6e e <fcntl.h>.# in
0320: 63 6c 75 64 65 20 3c 73 79 73 2f 73 74 61 74 2e clude <sys/stat.
0330: 68 3e 0a 23 20 69 6e 63 6c 75 64 65 20 3c 74 69 h>.# include <ti
0340: 6d 65 2e 68 3e 0a 23 65 6e 64 69 66 0a 23 69 66 me.h>.#endif.#if
0350: 20 4f 53 5f 57 49 4e 0a 23 20 69 6e 63 6c 75 64 OS_WIN.# includ
0360: 65 20 3c 77 69 6e 62 61 73 65 2e 68 3e 0a 23 65 e <winbase.h>.#e
0370: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 44 65 6c 65 ndif../*.** Dele
0380: 74 65 20 74 68 65 20 6e 61 6d 65 64 20 66 69 6c te the named fil
0390: 65 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 4f e.*/.int sqliteO
03a0: 73 44 65 6c 65 74 65 28 63 6f 6e 73 74 20 63 68 sDelete(const ch
03b0: 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 29 7b 0a ar *zFilename){.
03c0: 23 69 66 20 4f 53 5f 55 4e 49 58 0a 20 20 75 6e #if OS_UNIX. un
03d0: 6c 69 6e 6b 28 7a 46 69 6c 65 6e 61 6d 65 29 3b link(zFilename);
03e0: 0a 23 65 6e 64 69 66 0a 23 69 66 20 4f 53 5f 57 .#endif.#if OS_W
03f0: 49 4e 0a 20 20 44 65 6c 65 74 65 46 69 6c 65 28 IN. DeleteFile(
0400: 7a 46 69 6c 65 6e 61 6d 65 29 3b 0a 23 65 6e 64 zFilename);.#end
0410: 69 66 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 if. return SQLI
0420: 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 TE_OK;.}../*.**
0430: 52 65 74 75 72 6e 20 54 52 55 45 20 69 66 20 74 Return TRUE if t
0440: 68 65 20 6e 61 6d 65 64 20 66 69 6c 65 20 65 78 he named file ex
0450: 69 73 74 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c ists..*/.int sql
0460: 69 74 65 4f 73 46 69 6c 65 45 78 69 73 74 73 28 iteOsFileExists(
0470: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69 6c const char *zFil
0480: 65 6e 61 6d 65 29 7b 0a 23 69 66 20 4f 53 5f 55 ename){.#if OS_U
0490: 4e 49 58 0a 20 20 72 65 74 75 72 6e 20 61 63 63 NIX. return acc
04a0: 65 73 73 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 30 ess(zFilename, 0
04b0: 29 3d 3d 30 3b 0a 23 65 6e 64 69 66 0a 23 69 66 )==0;.#endif.#if
04c0: 20 4f 53 5f 57 49 4e 0a 20 20 48 41 4e 44 4c 45 OS_WIN. HANDLE
04d0: 20 68 3b 0a 20 20 68 20 3d 20 43 72 65 61 74 65 h;. h = Create
04e0: 46 69 6c 65 28 7a 42 75 66 2c 0a 20 20 20 20 47 File(zBuf,. G
04f0: 45 4e 45 52 49 43 5f 52 45 41 44 2c 0a 20 20 20 ENERIC_READ,.
0500: 20 30 2c 0a 20 20 20 20 4e 55 4c 4c 2c 0a 20 20 0,. NULL,.
0510: 20 20 4f 50 45 4e 5f 45 58 49 53 54 49 4e 47 2c OPEN_EXISTING,
0520: 0a 20 20 20 20 46 49 4c 45 5f 41 54 54 52 49 42 . FILE_ATTRIB
0530: 55 54 45 5f 4e 4f 52 4d 41 4c 20 7c 20 46 49 4c UTE_NORMAL | FIL
0540: 45 5f 46 4c 41 47 5f 52 41 4e 44 4f 4d 5f 41 43 E_FLAG_RANDOM_AC
0550: 43 45 53 53 2c 0a 20 20 20 20 4e 55 4c 4c 0a 20 CESS,. NULL.
0560: 20 29 3b 0a 20 20 69 66 28 20 68 21 3d 49 4e 56 );. if( h!=INV
0570: 41 4c 49 44 5f 46 49 4c 45 5f 48 41 4e 44 4c 45 ALID_FILE_HANDLE
0580: 20 29 7b 0a 20 20 20 20 43 6c 6f 73 65 48 61 6e ){. CloseHan
0590: 64 6c 65 28 68 29 3b 0a 20 20 20 20 72 65 74 75 dle(h);. retu
05a0: 72 6e 20 31 3b 0a 20 20 7d 0a 20 20 72 65 74 75 rn 1;. }. retu
05b0: 72 6e 20 30 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a rn 0;.#endif.}..
05c0: 0a 2f 2a 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74 ./*.** Attempt t
05d0: 6f 20 6f 70 65 6e 20 61 20 66 69 6c 65 20 66 6f o open a file fo
05e0: 72 20 62 6f 74 68 20 72 65 61 64 69 6e 67 20 61 r both reading a
05f0: 6e 64 20 77 72 69 74 69 6e 67 2e 20 20 49 66 20 nd writing. If
0600: 74 68 61 74 0a 2a 2a 20 66 61 69 6c 73 2c 20 74 that.** fails, t
0610: 72 79 20 6f 70 65 6e 69 6e 67 20 69 74 20 72 65 ry opening it re
0620: 61 64 2d 6f 6e 6c 79 2e 20 20 49 66 20 74 68 65 ad-only. If the
0630: 20 66 69 6c 65 20 64 6f 65 73 20 6e 6f 74 20 65 file does not e
0640: 78 69 73 74 2c 0a 2a 2a 20 74 72 79 20 74 6f 20 xist,.** try to
0650: 63 72 65 61 74 65 20 69 74 2e 0a 2a 2a 0a 2a 2a create it..**.**
0660: 20 4f 6e 20 73 75 63 63 65 73 73 2c 20 61 20 68 On success, a h
0670: 61 6e 64 6c 65 20 66 6f 72 20 74 68 65 20 6f 70 andle for the op
0680: 65 6e 20 66 69 6c 65 20 69 73 20 77 72 69 74 74 en file is writt
0690: 65 6e 20 74 6f 20 2a 70 52 65 73 75 6c 74 0a 2a en to *pResult.*
06a0: 2a 20 61 6e 64 20 2a 70 52 65 61 64 6f 6e 6c 79 * and *pReadonly
06b0: 20 69 73 20 73 65 74 20 74 6f 20 30 20 69 66 20 is set to 0 if
06c0: 74 68 65 20 66 69 6c 65 20 77 61 73 20 6f 70 65 the file was ope
06d0: 6e 65 64 20 66 6f 72 20 72 65 61 64 69 6e 67 20 ned for reading
06e0: 61 6e 64 0a 2a 2a 20 77 72 69 74 69 6e 67 20 6f and.** writing o
06f0: 72 20 31 20 69 66 20 74 68 65 20 66 69 6c 65 20 r 1 if the file
0700: 77 61 73 20 6f 70 65 6e 65 64 20 72 65 61 64 2d was opened read-
0710: 6f 6e 6c 79 2e 20 20 54 68 65 20 66 75 6e 63 74 only. The funct
0720: 69 6f 6e 20 72 65 74 75 72 6e 73 0a 2a 2a 20 53 ion returns.** S
0730: 51 4c 49 54 45 5f 4f 4b 2e 0a 2a 2a 0a 2a 2a 20 QLITE_OK..**.**
0740: 4f 6e 20 66 61 69 6c 75 72 65 2c 20 74 68 65 20 On failure, the
0750: 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 function returns
0760: 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e SQLITE_CANTOPEN
0770: 20 61 6e 64 20 6c 65 61 76 65 73 0a 2a 2a 20 2a and leaves.** *
0780: 70 52 65 73 75 6c 73 74 20 61 6e 64 20 2a 70 52 pResulst and *pR
0790: 65 61 64 6f 6e 6c 79 20 75 6e 63 68 61 6e 67 65 eadonly unchange
07a0: 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 d..*/.int sqlite
07b0: 4f 73 4f 70 65 6e 52 65 61 64 57 72 69 74 65 28 OsOpenReadWrite(
07c0: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a . const char *z
07d0: 46 69 6c 65 6e 61 6d 65 2c 0a 20 20 4f 73 46 69 Filename,. OsFi
07e0: 6c 65 20 2a 70 52 65 73 75 6c 74 2c 0a 20 20 69 le *pResult,. i
07f0: 6e 74 20 2a 70 52 65 61 64 6f 6e 6c 79 0a 29 7b nt *pReadonly.){
0800: 0a 23 69 66 20 4f 53 5f 55 4e 49 58 0a 20 20 69 .#if OS_UNIX. i
0810: 6e 74 20 66 64 20 3d 20 6f 70 65 6e 28 7a 46 69 nt fd = open(zFi
0820: 6c 65 6e 61 6d 65 2c 20 4f 5f 52 44 57 52 7c 4f lename, O_RDWR|O
0830: 5f 43 52 45 41 54 2c 20 30 36 34 34 29 3b 0a 20 _CREAT, 0644);.
0840: 20 69 66 28 20 66 64 3c 30 20 29 7b 0a 20 20 20 if( fd<0 ){.
0850: 20 66 64 20 3d 20 6f 70 65 6e 28 7a 46 69 6c 65 fd = open(zFile
0860: 6e 61 6d 65 2c 20 4f 5f 52 44 4f 4e 4c 59 29 3b name, O_RDONLY);
0870: 0a 20 20 20 20 69 66 28 20 66 64 3c 30 20 29 7b . if( fd<0 ){
0880: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 . return SQ
0890: 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 3b 20 0a LITE_CANTOPEN; .
08a0: 20 20 20 20 7d 0a 20 20 20 20 2a 70 52 65 61 64 }. *pRead
08b0: 6f 6e 6c 79 20 3d 20 31 3b 0a 20 20 7d 65 6c 73 only = 1;. }els
08c0: 65 7b 0a 20 20 20 20 2a 70 52 65 61 64 6f 6e 6c e{. *pReadonl
08d0: 79 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 2a 70 52 y = 0;. }. *pR
08e0: 65 73 75 6c 74 20 3d 20 66 64 3b 0a 20 20 72 65 esult = fd;. re
08f0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
0900: 23 65 6e 64 69 66 0a 23 69 66 20 4f 53 5f 57 49 #endif.#if OS_WI
0910: 4e 0a 20 20 48 41 4e 44 4c 45 20 68 20 3d 20 43 N. HANDLE h = C
0920: 72 65 61 74 65 46 69 6c 65 28 7a 46 69 6c 65 6e reateFile(zFilen
0930: 61 6d 65 2c 0a 20 20 20 20 20 47 45 4e 45 52 49 ame,. GENERI
0940: 43 5f 52 45 41 44 20 7c 20 47 45 4e 45 52 49 43 C_READ | GENERIC
0950: 5f 57 52 49 54 45 2c 0a 20 20 20 20 20 46 49 4c _WRITE,. FIL
0960: 45 5f 53 48 41 52 45 5f 52 45 41 44 20 7c 20 46 E_SHARE_READ | F
0970: 49 4c 45 5f 53 48 41 52 45 5f 57 52 49 54 45 2c ILE_SHARE_WRITE,
0980: 0a 20 20 20 20 20 4e 55 4c 4c 2c 0a 20 20 20 20 . NULL,.
0990: 20 4f 50 45 4e 5f 41 4c 57 41 59 53 2c 0a 20 20 OPEN_ALWAYS,.
09a0: 20 20 20 46 49 4c 45 5f 41 54 54 52 49 42 55 54 FILE_ATTRIBUT
09b0: 45 5f 4e 4f 52 4d 41 4c 20 7c 20 46 49 4c 45 5f E_NORMAL | FILE_
09c0: 46 4c 41 47 5f 52 41 4e 44 4f 4d 5f 41 43 43 45 FLAG_RANDOM_ACCE
09d0: 53 53 2c 0a 20 20 20 20 20 4e 55 4c 4c 0a 20 20 SS,. NULL.
09e0: 29 3b 0a 20 20 69 66 28 20 68 3d 3d 49 4e 56 41 );. if( h==INVA
09f0: 4c 49 44 5f 48 41 4e 44 4c 45 5f 56 41 4c 55 45 LID_HANDLE_VALUE
0a00: 20 29 7b 0a 20 20 20 20 48 41 4e 44 4c 45 20 68 ){. HANDLE h
0a10: 20 3d 20 43 72 65 61 74 65 46 69 6c 65 28 7a 46 = CreateFile(zF
0a20: 69 6c 65 6e 61 6d 65 2c 0a 20 20 20 20 20 20 20 ilename,.
0a30: 47 45 4e 45 52 49 43 5f 52 45 41 44 2c 0a 20 20 GENERIC_READ,.
0a40: 20 20 20 20 20 46 49 4c 45 5f 53 48 41 52 45 5f FILE_SHARE_
0a50: 52 45 41 44 2c 0a 20 20 20 20 20 20 20 4e 55 4c READ,. NUL
0a60: 4c 2c 0a 20 20 20 20 20 20 20 4f 50 45 4e 5f 41 L,. OPEN_A
0a70: 4c 57 41 59 53 2c 0a 20 20 20 20 20 20 20 46 49 LWAYS,. FI
0a80: 4c 45 5f 41 54 54 52 49 42 55 54 45 5f 4e 4f 52 LE_ATTRIBUTE_NOR
0a90: 4d 41 4c 20 7c 20 46 49 4c 45 5f 46 4c 41 47 5f MAL | FILE_FLAG_
0aa0: 52 41 4e 44 4f 4d 5f 41 43 43 45 53 53 2c 0a 20 RANDOM_ACCESS,.
0ab0: 20 20 20 20 20 20 4e 55 4c 4c 0a 20 20 20 20 29 NULL. )
0ac0: 3b 0a 20 20 20 20 69 66 28 20 68 3d 3d 49 4e 56 ;. if( h==INV
0ad0: 41 4c 49 44 5f 48 41 4e 44 4c 45 5f 56 41 4c 55 ALID_HANDLE_VALU
0ae0: 45 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 E ){. retur
0af0: 6e 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 n SQLITE_CANTOPE
0b00: 4e 3b 0a 20 20 20 20 7d 0a 20 20 20 20 2a 70 52 N;. }. *pR
0b10: 65 61 64 6f 6e 6c 79 20 3d 20 31 3b 0a 20 20 7d eadonly = 1;. }
0b20: 65 6c 73 65 7b 0a 20 20 20 20 2a 70 52 65 61 64 else{. *pRead
0b30: 6f 6e 6c 79 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 only = 0;. }.
0b40: 2a 70 52 65 73 75 6c 74 20 3d 20 68 3b 0a 20 20 *pResult = h;.
0b50: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
0b60: 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 0a 2f 2a 0a ;.#endif.}.../*.
0b70: 2a 2a 20 41 74 74 65 6d 70 74 20 74 6f 20 6f 70 ** Attempt to op
0b80: 65 6e 20 61 20 6e 65 77 20 66 69 6c 65 20 66 6f en a new file fo
0b90: 72 20 65 78 63 6c 75 73 69 76 65 20 61 63 63 65 r exclusive acce
0ba0: 73 73 20 62 79 20 74 68 69 73 20 70 72 6f 63 65 ss by this proce
0bb0: 73 73 2e 0a 2a 2a 20 54 68 65 20 66 69 6c 65 20 ss..** The file
0bc0: 77 69 6c 6c 20 62 65 20 6f 70 65 6e 65 64 20 66 will be opened f
0bd0: 6f 72 20 62 6f 74 68 20 72 65 61 64 69 6e 67 20 or both reading
0be0: 61 6e 64 20 77 72 69 74 69 6e 67 2e 20 20 54 6f and writing. To
0bf0: 20 61 76 6f 69 64 0a 2a 2a 20 61 20 70 6f 74 65 avoid.** a pote
0c00: 6e 74 69 61 6c 20 73 65 63 75 72 69 74 79 20 70 ntial security p
0c10: 72 6f 62 6c 65 6d 2c 20 77 65 20 64 6f 20 6e 6f roblem, we do no
0c20: 74 20 61 6c 6c 6f 77 20 74 68 65 20 66 69 6c 65 t allow the file
0c30: 20 74 6f 20 68 61 76 65 0a 2a 2a 20 70 72 65 76 to have.** prev
0c40: 69 6f 75 73 6c 79 20 65 78 69 73 74 65 64 2e 20 iously existed.
0c50: 20 4e 6f 72 20 64 6f 20 77 65 20 61 6c 6c 6f 77 Nor do we allow
0c60: 20 74 68 65 20 66 69 6c 65 20 74 6f 20 62 65 20 the file to be
0c70: 61 20 73 79 6d 62 6f 6c 69 63 0a 2a 2a 20 6c 69 a symbolic.** li
0c80: 6e 6b 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 20 73 75 63 nk..**.** On suc
0c90: 63 65 73 73 2c 20 77 72 69 74 65 20 74 68 65 20 cess, write the
0ca0: 66 69 6c 65 20 68 61 6e 64 6c 65 20 69 6e 74 6f file handle into
0cb0: 20 2a 70 52 65 73 75 6c 74 20 61 6e 64 20 72 65 *pResult and re
0cc0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 2e 0a turn SQLITE_OK..
0cd0: 2a 2a 0a 2a 2a 20 4f 6e 20 66 61 69 6c 75 72 65 **.** On failure
0ce0: 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f , return SQLITE_
0cf0: 43 41 4e 54 4f 50 45 4e 2e 0a 2a 2f 0a 69 6e 74 CANTOPEN..*/.int
0d00: 20 73 71 6c 69 74 65 4f 73 4f 70 65 6e 45 78 63 sqliteOsOpenExc
0d10: 6c 75 73 69 76 65 28 63 6f 6e 73 74 20 63 68 61 lusive(const cha
0d20: 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 4f 73 r *zFilename, Os
0d30: 46 69 6c 65 20 2a 70 52 65 73 75 6c 74 29 7b 0a File *pResult){.
0d40: 23 69 66 20 4f 53 5f 55 4e 49 58 0a 20 20 69 6e #if OS_UNIX. in
0d50: 74 20 66 64 3b 0a 20 20 69 66 28 20 61 63 63 65 t fd;. if( acce
0d60: 73 73 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 30 29 ss(zFilename, 0)
0d70: 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 ==0 ){. retur
0d80: 6e 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 n SQLITE_CANTOPE
0d90: 4e 3b 0a 20 20 7d 0a 23 69 66 6e 64 65 66 20 4f N;. }.#ifndef O
0da0: 5f 4e 4f 46 4f 4c 4c 4f 57 0a 23 20 64 65 66 69 _NOFOLLOW.# defi
0db0: 6e 65 20 4f 5f 4e 4f 46 4f 4c 4c 4f 57 20 30 0a ne O_NOFOLLOW 0.
0dc0: 23 65 6e 64 69 66 0a 20 20 66 64 20 3d 20 6f 70 #endif. fd = op
0dd0: 65 6e 28 7a 46 69 6c 65 6e 61 6d 65 2c 20 4f 5f en(zFilename, O_
0de0: 52 44 57 52 7c 4f 5f 43 52 45 41 54 7c 4f 5f 45 RDWR|O_CREAT|O_E
0df0: 58 43 4c 7c 4f 5f 4e 4f 46 4f 4c 4c 4f 57 2c 20 XCL|O_NOFOLLOW,
0e00: 30 36 30 30 29 3b 0a 20 20 69 66 28 20 66 64 3c 0600);. if( fd<
0e10: 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 0 ){. return
0e20: 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 3b SQLITE_CANTOPEN;
0e30: 0a 20 20 7d 0a 20 20 2a 70 52 65 73 75 6c 74 20 . }. *pResult
0e40: 3d 20 66 64 3b 0a 20 20 72 65 74 75 72 6e 20 53 = fd;. return S
0e50: 51 4c 49 54 45 5f 4f 4b 3b 0a 23 65 6e 64 69 66 QLITE_OK;.#endif
0e60: 0a 23 69 66 20 4f 53 5f 57 49 4e 0a 20 20 48 41 .#if OS_WIN. HA
0e70: 4e 44 4c 45 20 68 20 3d 20 43 72 65 61 74 65 46 NDLE h = CreateF
0e80: 69 6c 65 28 7a 46 69 6c 65 6e 61 6d 65 2c 0a 20 ile(zFilename,.
0e90: 20 20 20 20 47 45 4e 45 52 49 43 5f 52 45 41 44 GENERIC_READ
0ea0: 20 7c 20 47 45 4e 45 52 49 43 5f 57 52 49 54 45 | GENERIC_WRITE
0eb0: 2c 0a 20 20 20 20 20 30 2c 0a 20 20 20 20 20 4e ,. 0,. N
0ec0: 55 4c 4c 2c 0a 20 20 20 20 20 43 52 45 41 54 45 ULL,. CREATE
0ed0: 5f 41 4c 57 41 59 53 2c 0a 20 20 20 20 20 46 49 _ALWAYS,. FI
0ee0: 4c 45 5f 41 54 54 52 49 42 55 54 45 5f 4e 4f 52 LE_ATTRIBUTE_NOR
0ef0: 4d 41 4c 20 7c 20 46 49 4c 45 5f 46 4c 41 47 5f MAL | FILE_FLAG_
0f00: 52 41 4e 44 4f 4d 5f 41 43 43 45 53 53 2c 0a 20 RANDOM_ACCESS,.
0f10: 20 20 20 20 4e 55 4c 4c 0a 20 20 29 3b 0a 20 20 NULL. );.
0f20: 69 66 28 20 68 3d 3d 49 4e 56 41 4c 49 44 5f 48 if( h==INVALID_H
0f30: 41 4e 44 4c 45 5f 56 41 4c 55 45 20 29 7b 0a 20 ANDLE_VALUE ){.
0f40: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
0f50: 5f 43 41 4e 54 4f 50 45 4e 3b 0a 20 20 7d 0a 20 _CANTOPEN;. }.
0f60: 20 2a 70 52 65 73 75 6c 74 20 3d 20 68 3b 0a 20 *pResult = h;.
0f70: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
0f80: 4b 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a K;.#endif.}../*.
0f90: 2a 2a 20 41 74 74 65 6d 70 74 20 74 6f 20 6f 70 ** Attempt to op
0fa0: 65 6e 20 61 20 6e 65 77 20 66 69 6c 65 20 66 6f en a new file fo
0fb0: 72 20 72 65 61 64 2d 6f 6e 6c 79 20 61 63 63 65 r read-only acce
0fc0: 73 73 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 20 73 75 63 ss..**.** On suc
0fd0: 63 65 73 73 2c 20 77 72 69 74 65 20 74 68 65 20 cess, write the
0fe0: 66 69 6c 65 20 68 61 6e 64 6c 65 20 69 6e 74 6f file handle into
0ff0: 20 2a 70 52 65 73 75 6c 74 20 61 6e 64 20 72 65 *pResult and re
1000: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 2e 0a turn SQLITE_OK..
1010: 2a 2a 0a 2a 2a 20 4f 6e 20 66 61 69 6c 75 72 65 **.** On failure
1020: 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f , return SQLITE_
1030: 43 41 4e 54 4f 50 45 4e 2e 0a 2a 2f 0a 69 6e 74 CANTOPEN..*/.int
1040: 20 73 71 6c 69 74 65 4f 73 4f 70 65 6e 52 65 61 sqliteOsOpenRea
1050: 64 4f 6e 6c 79 28 63 6f 6e 73 74 20 63 68 61 72 dOnly(const char
1060: 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c 20 4f 73 46 *zFilename, OsF
1070: 69 6c 65 20 2a 70 52 65 73 75 6c 74 29 7b 0a 23 ile *pResult){.#
1080: 69 66 20 4f 53 5f 55 4e 49 58 0a 20 20 69 6e 74 if OS_UNIX. int
1090: 20 66 64 20 3d 20 6f 70 65 6e 28 7a 46 69 6c 65 fd = open(zFile
10a0: 6e 61 6d 65 2c 20 4f 5f 52 44 4f 4e 4c 59 29 3b name, O_RDONLY);
10b0: 0a 20 20 69 66 28 20 66 64 3c 30 20 29 7b 0a 20 . if( fd<0 ){.
10c0: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
10d0: 5f 43 41 4e 54 4f 50 45 4e 3b 0a 20 20 7d 0a 20 _CANTOPEN;. }.
10e0: 20 2a 70 52 65 73 75 6c 74 20 3d 20 66 64 3b 0a *pResult = fd;.
10f0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
1100: 4f 4b 3b 0a 23 65 6e 64 69 66 0a 23 69 66 20 4f OK;.#endif.#if O
1110: 53 5f 57 49 4e 0a 20 20 48 41 4e 44 4c 45 20 68 S_WIN. HANDLE h
1120: 20 3d 20 43 72 65 61 74 65 46 69 6c 65 28 7a 46 = CreateFile(zF
1130: 69 6c 65 6e 61 6d 65 2c 0a 20 20 20 20 20 47 45 ilename,. GE
1140: 4e 45 52 49 43 5f 52 45 41 44 2c 0a 20 20 20 20 NERIC_READ,.
1150: 20 30 2c 0a 20 20 20 20 20 4e 55 4c 4c 2c 0a 20 0,. NULL,.
1160: 20 20 20 20 4f 50 45 4e 5f 45 58 49 53 54 49 4e OPEN_EXISTIN
1170: 47 2c 0a 20 20 20 20 20 46 49 4c 45 5f 41 54 54 G,. FILE_ATT
1180: 52 49 42 55 54 45 5f 4e 4f 52 4d 41 4c 20 7c 20 RIBUTE_NORMAL |
1190: 46 49 4c 45 5f 46 4c 41 47 5f 52 41 4e 44 4f 4d FILE_FLAG_RANDOM
11a0: 5f 41 43 43 45 53 53 2c 0a 20 20 20 20 20 4e 55 _ACCESS,. NU
11b0: 4c 4c 0a 20 20 29 3b 0a 20 20 69 66 28 20 68 3d LL. );. if( h=
11c0: 3d 49 4e 56 41 4c 49 44 5f 48 41 4e 44 4c 45 5f =INVALID_HANDLE_
11d0: 56 41 4c 55 45 20 29 7b 0a 20 20 20 20 72 65 74 VALUE ){. ret
11e0: 75 72 6e 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f urn SQLITE_CANTO
11f0: 50 45 4e 3b 0a 20 20 7d 0a 20 20 2a 70 52 65 73 PEN;. }. *pRes
1200: 75 6c 74 20 3d 20 68 3b 0a 20 20 72 65 74 75 72 ult = h;. retur
1210: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 23 65 6e n SQLITE_OK;.#en
1220: 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 dif.}../*.** Cre
1230: 61 74 65 20 61 20 74 65 6d 70 6f 72 61 72 79 20 ate a temporary
1240: 66 69 6c 65 20 6e 61 6d 65 20 69 6e 20 7a 42 75 file name in zBu
1250: 66 2e 20 20 7a 42 75 66 20 6d 75 73 74 20 62 65 f. zBuf must be
1260: 20 62 69 67 20 65 6e 6f 75 67 68 20 74 6f 0a 2a big enough to.*
1270: 2a 20 68 6f 6c 64 20 61 74 20 6c 65 61 73 74 20 * hold at least
1280: 53 51 4c 49 54 45 5f 54 45 4d 50 4e 41 4d 45 5f SQLITE_TEMPNAME_
1290: 53 49 5a 45 20 63 68 61 72 61 63 74 65 72 73 2e SIZE characters.
12a0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 4f 73 .*/.int sqliteOs
12b0: 54 65 6d 70 46 69 6c 65 4e 61 6d 65 28 63 68 61 TempFileName(cha
12c0: 72 20 2a 7a 42 75 66 29 7b 0a 23 69 66 20 4f 53 r *zBuf){.#if OS
12d0: 5f 55 4e 49 58 0a 20 20 73 74 61 74 69 63 20 63 _UNIX. static c
12e0: 6f 6e 73 74 20 63 68 61 72 20 2a 61 7a 44 69 72 onst char *azDir
12f0: 73 5b 5d 20 3d 20 7b 0a 20 20 20 20 20 22 2e 22 s[] = {. "."
1300: 2c 0a 20 20 20 20 20 22 2f 76 61 72 2f 74 6d 70 ,. "/var/tmp
1310: 22 2c 0a 20 20 20 20 20 22 2f 75 73 72 2f 74 6d ",. "/usr/tm
1320: 70 22 2c 0a 20 20 20 20 20 22 2f 74 6d 70 22 2c p",. "/tmp",
1330: 0a 20 20 7d 3b 0a 20 20 73 74 61 74 69 63 20 63 . };. static c
1340: 68 61 72 20 7a 43 68 61 72 73 5b 5d 20 3d 0a 20 har zChars[] =.
1350: 20 20 20 22 61 62 63 64 65 66 67 68 69 6a 6b 6c "abcdefghijkl
1360: 6d 6e 6f 70 71 72 73 74 75 76 77 78 79 7a 22 0a mnopqrstuvwxyz".
1370: 20 20 20 20 22 41 42 43 44 45 46 47 48 49 4a 4b "ABCDEFGHIJK
1380: 4c 4d 4e 4f 50 51 52 53 54 55 56 57 58 59 5a 22 LMNOPQRSTUVWXYZ"
1390: 0a 20 20 20 20 22 30 31 32 33 34 35 36 37 38 39 . "0123456789
13a0: 22 3b 0a 20 20 69 6e 74 20 69 2c 20 6a 3b 0a 20 ";. int i, j;.
13b0: 20 73 74 72 75 63 74 20 73 74 61 74 20 62 75 66 struct stat buf
13c0: 3b 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a ;. const char *
13d0: 7a 44 69 72 20 3d 20 22 2e 22 3b 0a 20 20 66 6f zDir = ".";. fo
13e0: 72 28 69 3d 30 3b 20 69 3c 73 69 7a 65 6f 66 28 r(i=0; i<sizeof(
13f0: 61 7a 44 69 72 73 29 2f 73 69 7a 65 6f 66 28 61 azDirs)/sizeof(a
1400: 7a 44 69 72 73 5b 30 5d 29 3b 20 69 2b 2b 29 7b zDirs[0]); i++){
1410: 0a 20 20 20 20 69 66 28 20 73 74 61 74 28 61 7a . if( stat(az
1420: 44 69 72 73 5b 69 5d 2c 20 26 62 75 66 29 20 29 Dirs[i], &buf) )
1430: 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 69 continue;. i
1440: 66 28 20 21 53 5f 49 53 44 49 52 28 62 75 66 2e f( !S_ISDIR(buf.
1450: 73 74 5f 6d 6f 64 65 29 20 29 20 63 6f 6e 74 69 st_mode) ) conti
1460: 6e 75 65 3b 0a 20 20 20 20 69 66 28 20 61 63 63 nue;. if( acc
1470: 65 73 73 28 61 7a 44 69 72 73 5b 69 5d 2c 20 30 ess(azDirs[i], 0
1480: 37 29 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 7) ) continue;.
1490: 20 20 20 7a 44 69 72 20 3d 20 61 7a 44 69 72 73 zDir = azDirs
14a0: 5b 69 5d 3b 0a 20 20 20 20 62 72 65 61 6b 3b 0a [i];. break;.
14b0: 20 20 7d 0a 20 20 64 6f 7b 0a 20 20 20 20 73 70 }. do{. sp
14c0: 72 69 6e 74 66 28 7a 42 75 66 2c 20 22 25 73 2f rintf(zBuf, "%s/
14d0: 73 71 6c 69 74 65 5f 22 2c 20 7a 44 69 72 29 3b sqlite_", zDir);
14e0: 0a 20 20 20 20 6a 20 3d 20 73 74 72 6c 65 6e 28 . j = strlen(
14f0: 7a 42 75 66 29 3b 0a 20 20 20 20 66 6f 72 28 69 zBuf);. for(i
1500: 3d 30 3b 20 69 3c 31 35 3b 20 69 2b 2b 29 7b 0a =0; i<15; i++){.
1510: 20 20 20 20 20 20 69 6e 74 20 6e 20 3d 20 73 71 int n = sq
1520: 6c 69 74 65 52 61 6e 64 6f 6d 42 79 74 65 28 29 liteRandomByte()
1530: 20 25 20 73 69 7a 65 6f 66 28 7a 43 68 61 72 73 % sizeof(zChars
1540: 29 3b 0a 20 20 20 20 20 20 7a 42 75 66 5b 6a 2b );. zBuf[j+
1550: 2b 5d 20 3d 20 7a 43 68 61 72 73 5b 6e 5d 3b 0a +] = zChars[n];.
1560: 20 20 20 20 7d 0a 20 20 20 20 7a 42 75 66 5b 6a }. zBuf[j
1570: 5d 20 3d 20 30 3b 0a 20 20 7d 77 68 69 6c 65 28 ] = 0;. }while(
1580: 20 61 63 63 65 73 73 28 7a 42 75 66 2c 30 29 3d access(zBuf,0)=
1590: 3d 30 20 29 3b 0a 23 65 6e 64 69 66 0a 23 69 66 =0 );.#endif.#if
15a0: 20 4f 53 5f 57 49 4e 0a 20 20 69 6e 74 20 69 2c OS_WIN. int i,
15b0: 20 6a 3b 0a 20 20 48 41 4e 44 4c 45 20 68 3b 0a j;. HANDLE h;.
15c0: 20 20 63 68 61 72 20 7a 54 65 6d 70 50 61 74 68 char zTempPath
15d0: 5b 53 51 4c 49 54 45 5f 54 45 4d 50 4e 41 4d 45 [SQLITE_TEMPNAME
15e0: 5f 53 49 5a 45 5d 3b 0a 20 20 47 65 74 54 65 6d _SIZE];. GetTem
15f0: 70 50 61 74 68 28 53 51 4c 49 54 45 5f 54 45 4d pPath(SQLITE_TEM
1600: 50 4e 41 4d 45 5f 53 49 5a 45 2d 33 30 2c 20 7a PNAME_SIZE-30, z
1610: 54 65 6d 70 50 61 74 68 29 3b 0a 20 20 66 6f 72 TempPath);. for
1620: 28 3b 3b 29 7b 0a 20 20 20 20 73 70 72 69 6e 74 (;;){. sprint
1630: 66 28 7a 42 75 66 2c 20 22 25 73 2f 73 71 6c 69 f(zBuf, "%s/sqli
1640: 74 65 5f 22 2c 20 7a 54 65 6d 70 50 61 74 68 29 te_", zTempPath)
1650: 3b 0a 20 20 20 20 6a 20 3d 20 73 74 72 6c 65 6e ;. j = strlen
1660: 28 7a 42 75 66 29 3b 0a 20 20 20 20 66 6f 72 28 (zBuf);. for(
1670: 69 3d 30 3b 20 69 3c 31 35 3b 20 69 2b 2b 29 7b i=0; i<15; i++){
1680: 0a 20 20 20 20 20 20 69 6e 74 20 6e 20 3d 20 73 . int n = s
1690: 71 6c 69 74 65 52 61 6e 64 6f 6d 42 79 74 65 28 qliteRandomByte(
16a0: 29 20 25 20 73 69 7a 65 6f 66 28 7a 43 68 61 72 ) % sizeof(zChar
16b0: 73 29 3b 0a 20 20 20 20 20 20 7a 42 75 66 5b 6a s);. zBuf[j
16c0: 2b 2b 5d 20 3d 20 7a 43 68 61 72 73 5b 6e 5d 3b ++] = zChars[n];
16d0: 0a 20 20 20 20 7d 0a 20 20 20 20 7a 42 75 66 5b . }. zBuf[
16e0: 6a 5d 20 3d 20 30 3b 0a 20 20 20 20 69 66 28 20 j] = 0;. if(
16f0: 21 73 71 6c 69 74 65 4f 73 46 69 6c 65 45 78 69 !sqliteOsFileExi
1700: 73 74 73 28 7a 42 75 66 29 20 29 20 62 72 65 61 sts(zBuf) ) brea
1710: 6b 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 k;. }.#endif.
1720: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
1730: 3b 20 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 ; .}../*.** Clos
1740: 65 20 61 20 66 69 6c 65 0a 2a 2f 0a 69 6e 74 20 e a file.*/.int
1750: 73 71 6c 69 74 65 4f 73 43 6c 6f 73 65 28 4f 73 sqliteOsClose(Os
1760: 46 69 6c 65 20 69 64 29 7b 0a 23 69 66 20 4f 53 File id){.#if OS
1770: 5f 55 4e 49 58 0a 20 20 63 6c 6f 73 65 28 69 64 _UNIX. close(id
1780: 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 );. return SQLI
1790: 54 45 5f 4f 4b 3b 0a 23 65 6e 64 69 66 0a 23 69 TE_OK;.#endif.#i
17a0: 66 20 4f 53 5f 57 49 4e 0a 20 20 43 6c 6f 73 65 f OS_WIN. Close
17b0: 48 61 6e 64 6c 65 28 69 64 29 3b 0a 20 20 72 65 Handle(id);. re
17c0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
17d0: 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 #endif.}../*.**
17e0: 52 65 61 64 20 64 61 74 61 20 66 72 6f 6d 20 61 Read data from a
17f0: 20 66 69 6c 65 20 69 6e 74 6f 20 61 20 62 75 66 file into a buf
1800: 66 65 72 2e 20 20 52 65 74 75 72 6e 20 74 68 65 fer. Return the
1810: 20 6e 75 6d 62 65 72 20 6f 66 0a 2a 2a 20 62 79 number of.** by
1820: 74 65 73 20 61 63 74 75 61 6c 6c 79 20 72 65 61 tes actually rea
1830: 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 d..*/.int sqlite
1840: 4f 73 52 65 61 64 28 4f 73 46 69 6c 65 20 69 64 OsRead(OsFile id
1850: 2c 20 76 6f 69 64 20 2a 70 42 75 66 2c 20 69 6e , void *pBuf, in
1860: 74 20 61 6d 74 29 7b 0a 23 69 66 20 4f 53 5f 55 t amt){.#if OS_U
1870: 4e 49 58 0a 20 20 69 6e 74 20 67 6f 74 3b 0a 20 NIX. int got;.
1880: 20 67 6f 74 20 3d 20 72 65 61 64 28 69 64 2c 20 got = read(id,
1890: 70 42 75 66 2c 20 61 6d 74 29 3b 0a 20 20 69 66 pBuf, amt);. if
18a0: 28 20 67 6f 74 3c 30 20 29 20 67 6f 74 20 3d 20 ( got<0 ) got =
18b0: 30 3b 0a 20 20 72 65 74 75 72 6e 20 67 6f 74 3d 0;. return got=
18c0: 3d 61 6d 74 20 3f 20 53 51 4c 49 54 45 5f 4f 4b =amt ? SQLITE_OK
18d0: 20 3a 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 3b : SQLITE_IOERR;
18e0: 0a 23 65 6e 64 69 66 0a 23 69 66 20 4f 53 5f 57 .#endif.#if OS_W
18f0: 49 4e 0a 20 20 69 6e 74 20 67 6f 74 3b 0a 20 20 IN. int got;.
1900: 69 66 28 20 21 52 65 61 64 46 69 6c 65 28 69 64 if( !ReadFile(id
1910: 2c 20 70 42 75 66 2c 20 61 6d 74 2c 20 26 67 6f , pBuf, amt, &go
1920: 74 2c 20 30 29 20 29 7b 0a 20 20 20 20 67 6f 74 t, 0) ){. got
1930: 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75 = 0;. }. retu
1940: 72 6e 20 67 6f 74 3d 3d 61 6d 74 20 3f 20 53 51 rn got==amt ? SQ
1950: 4c 49 54 45 5f 4f 4b 20 3a 20 53 51 4c 49 54 45 LITE_OK : SQLITE
1960: 5f 49 4f 45 52 52 3b 0a 23 65 6e 64 69 66 0a 7d _IOERR;.#endif.}
1970: 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 20 64 61 ../*.** Write da
1980: 74 61 20 66 72 6f 6d 20 61 20 62 75 66 66 65 72 ta from a buffer
1990: 20 69 6e 74 6f 20 61 20 66 69 6c 65 2e 20 20 52 into a file. R
19a0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 eturn SQLITE_OK
19b0: 6f 6e 20 73 75 63 63 65 73 73 0a 2a 2a 20 6f 72 on success.** or
19c0: 20 73 6f 6d 65 20 6f 74 68 65 72 20 65 72 72 6f some other erro
19d0: 72 20 63 6f 64 65 20 6f 6e 20 66 61 69 6c 75 72 r code on failur
19e0: 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 e..*/.int sqlite
19f0: 4f 73 57 72 69 74 65 28 4f 73 46 69 6c 65 20 69 OsWrite(OsFile i
1a00: 64 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 d, const void *p
1a10: 42 75 66 2c 20 69 6e 74 20 61 6d 74 29 7b 0a 23 Buf, int amt){.#
1a20: 69 66 20 4f 53 5f 55 4e 49 58 0a 20 20 69 6e 74 if OS_UNIX. int
1a30: 20 77 72 6f 74 65 3b 0a 20 20 77 72 6f 74 65 20 wrote;. wrote
1a40: 3d 20 77 72 69 74 65 28 69 64 2c 20 70 42 75 66 = write(id, pBuf
1a50: 2c 20 61 6d 74 29 3b 0a 20 20 69 66 28 20 77 72 , amt);. if( wr
1a60: 6f 74 65 3c 61 6d 74 20 29 20 72 65 74 75 72 6e ote<amt ) return
1a70: 20 53 51 4c 49 54 45 5f 46 55 4c 4c 3b 0a 20 20 SQLITE_FULL;.
1a80: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
1a90: 3b 0a 23 65 6e 64 69 66 0a 23 69 66 20 4f 53 5f ;.#endif.#if OS_
1aa0: 57 49 4e 0a 20 20 69 6e 74 20 77 72 6f 74 65 3b WIN. int wrote;
1ab0: 0a 20 20 69 66 28 20 21 57 72 69 74 65 46 69 6c . if( !WriteFil
1ac0: 65 28 69 64 2c 20 70 42 75 66 2c 20 61 6d 74 2c e(id, pBuf, amt,
1ad0: 20 26 77 72 6f 74 65 2c 20 30 29 20 7c 7c 20 77 &wrote, 0) || w
1ae0: 72 6f 74 65 3c 61 6d 74 20 29 7b 0a 20 20 20 20 rote<amt ){.
1af0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 46 55 return SQLITE_FU
1b00: 4c 4c 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e LL;. }. return
1b10: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 23 65 6e 64 SQLITE_OK;.#end
1b20: 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 if.}../*.** Move
1b30: 20 74 68 65 20 72 65 61 64 2f 77 72 69 74 65 20 the read/write
1b40: 70 6f 69 6e 74 65 72 20 69 6e 20 61 20 66 69 6c pointer in a fil
1b50: 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 e..*/.int sqlite
1b60: 4f 73 53 65 65 6b 28 4f 73 46 69 6c 65 20 69 64 OsSeek(OsFile id
1b70: 2c 20 69 6e 74 20 6f 66 66 73 65 74 29 7b 0a 23 , int offset){.#
1b80: 69 66 20 4f 53 5f 55 4e 49 58 0a 20 20 6c 73 65 if OS_UNIX. lse
1b90: 65 6b 28 69 64 2c 20 6f 66 66 73 65 74 2c 20 53 ek(id, offset, S
1ba0: 45 45 4b 5f 53 45 54 29 3b 0a 20 20 72 65 74 75 EEK_SET);. retu
1bb0: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 23 65 rn SQLITE_OK;.#e
1bc0: 6e 64 69 66 0a 23 69 66 20 4f 53 5f 57 49 4e 0a ndif.#if OS_WIN.
1bd0: 20 20 53 65 74 46 69 6c 65 50 6f 69 6e 74 65 72 SetFilePointer
1be0: 28 69 64 2c 20 6f 66 66 73 65 74 2c 20 30 2c 20 (id, offset, 0,
1bf0: 46 49 4c 45 5f 42 45 47 49 4e 29 3b 0a 20 20 72 FILE_BEGIN);. r
1c00: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
1c10: 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a .#endif.}../*.**
1c20: 20 4d 61 6b 65 20 73 75 72 65 20 61 6c 6c 20 77 Make sure all w
1c30: 72 69 74 65 73 20 74 6f 20 61 20 70 61 72 74 69 rites to a parti
1c40: 63 75 6c 61 72 20 66 69 6c 65 20 61 72 65 20 63 cular file are c
1c50: 6f 6d 6d 69 74 74 65 64 20 74 6f 20 64 69 73 6b ommitted to disk
1c60: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 4f ..*/.int sqliteO
1c70: 73 53 79 6e 63 28 4f 73 46 69 6c 65 20 69 64 29 sSync(OsFile id)
1c80: 7b 0a 23 69 66 20 4f 53 5f 55 4e 49 58 0a 20 20 {.#if OS_UNIX.
1c90: 72 65 74 75 72 6e 20 66 73 79 6e 63 28 69 64 29 return fsync(id)
1ca0: 3d 3d 30 20 3f 20 53 51 4c 49 54 45 5f 4f 4b 20 ==0 ? SQLITE_OK
1cb0: 3a 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 3b 0a : SQLITE_IOERR;.
1cc0: 23 65 6e 64 69 66 0a 23 69 66 20 4f 53 5f 57 49 #endif.#if OS_WI
1cd0: 4e 0a 20 20 72 65 74 75 72 6e 20 46 6c 75 73 68 N. return Flush
1ce0: 46 69 6c 65 42 75 66 66 65 72 73 28 69 64 29 20 FileBuffers(id)
1cf0: 3f 20 53 51 4c 49 54 45 5f 4f 4b 20 3a 20 53 51 ? SQLITE_OK : SQ
1d00: 4c 49 54 45 5f 49 4f 45 52 52 3b 0a 23 65 6e 64 LITE_IOERR;.#end
1d10: 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 72 75 6e if.}../*.** Trun
1d20: 63 61 74 65 20 61 6e 20 6f 70 65 6e 20 66 69 6c cate an open fil
1d30: 65 20 74 6f 20 61 20 73 70 65 63 69 66 69 65 64 e to a specified
1d40: 20 73 69 7a 65 0a 2a 2f 0a 69 6e 74 20 73 71 6c size.*/.int sql
1d50: 69 74 65 4f 73 54 72 75 6e 63 61 74 65 28 4f 73 iteOsTruncate(Os
1d60: 46 69 6c 65 20 69 64 2c 20 69 6e 74 20 6e 42 79 File id, int nBy
1d70: 74 65 29 7b 0a 23 69 66 20 4f 53 5f 55 4e 49 58 te){.#if OS_UNIX
1d80: 0a 20 20 72 65 74 75 72 6e 20 66 74 72 75 6e 63 . return ftrunc
1d90: 61 74 65 28 69 64 2c 20 6e 42 79 74 65 29 3d 3d ate(id, nByte)==
1da0: 30 20 3f 20 53 51 4c 49 54 45 5f 4f 4b 20 3a 20 0 ? SQLITE_OK :
1db0: 53 51 4c 49 54 45 5f 49 4f 45 52 52 3b 0a 23 65 SQLITE_IOERR;.#e
1dc0: 6e 64 69 66 0a 23 69 66 20 4f 53 5f 57 49 4e 0a ndif.#if OS_WIN.
1dd0: 20 20 53 65 74 46 69 6c 65 50 6f 69 6e 74 65 72 SetFilePointer
1de0: 28 69 64 2c 20 6e 42 79 74 65 2c 20 30 2c 20 46 (id, nByte, 0, F
1df0: 49 4c 45 5f 42 45 47 49 4e 29 3b 0a 20 20 53 65 ILE_BEGIN);. Se
1e00: 74 45 6e 64 4f 66 46 69 6c 65 28 69 64 29 3b 0a tEndOfFile(id);.
1e10: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
1e20: 4f 4b 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a OK;.#endif.}../*
1e30: 0a 2a 2a 20 44 65 74 65 72 6d 69 6e 65 20 74 68 .** Determine th
1e40: 65 20 63 75 72 72 65 6e 74 20 73 69 7a 65 20 6f e current size o
1e50: 66 20 61 20 66 69 6c 65 20 69 6e 20 62 79 74 65 f a file in byte
1e60: 73 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 4f s.*/.int sqliteO
1e70: 73 46 69 6c 65 53 69 7a 65 28 4f 73 46 69 6c 65 sFileSize(OsFile
1e80: 20 69 64 2c 20 69 6e 74 20 2a 70 53 69 7a 65 29 id, int *pSize)
1e90: 7b 0a 23 69 66 20 4f 53 5f 55 4e 49 58 0a 20 20 {.#if OS_UNIX.
1ea0: 73 74 72 75 63 74 20 73 74 61 74 20 62 75 66 3b struct stat buf;
1eb0: 0a 20 20 69 66 28 20 66 73 74 61 74 28 69 64 2c . if( fstat(id,
1ec0: 20 26 62 75 66 29 21 3d 30 20 29 7b 0a 20 20 20 &buf)!=0 ){.
1ed0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 return SQLITE_I
1ee0: 4f 45 52 52 3b 0a 20 20 7d 0a 20 20 2a 70 53 69 OERR;. }. *pSi
1ef0: 7a 65 20 3d 20 62 75 66 2e 73 74 5f 73 69 7a 65 ze = buf.st_size
1f00: 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ;. return SQLIT
1f10: 45 5f 4f 4b 3b 0a 23 65 6e 64 69 66 0a 23 69 66 E_OK;.#endif.#if
1f20: 20 4f 53 5f 57 49 4e 0a 20 20 2a 70 53 69 7a 65 OS_WIN. *pSize
1f30: 20 3d 20 47 65 74 46 69 6c 65 53 69 7a 65 28 69 = GetFileSize(i
1f40: 64 2c 20 30 29 3b 0a 20 20 72 65 74 75 72 6e 20 d, 0);. return
1f50: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 23 65 6e 64 69 SQLITE_OK;.#endi
1f60: 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 47 65 74 20 61 f.}../*.** Get a
1f70: 20 72 65 61 64 20 6f 72 20 77 72 69 74 65 20 6c read or write l
1f80: 6f 63 6b 20 6f 6e 20 61 20 66 69 6c 65 2e 0a 2a ock on a file..*
1f90: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 4f 73 4c 6f /.int sqliteOsLo
1fa0: 63 6b 28 4f 73 46 69 6c 65 20 69 64 2c 20 69 6e ck(OsFile id, in
1fb0: 74 20 77 72 6c 6f 63 6b 29 7b 0a 23 69 66 20 4f t wrlock){.#if O
1fc0: 53 5f 55 4e 49 58 0a 20 20 69 6e 74 20 72 63 3b S_UNIX. int rc;
1fd0: 0a 20 20 73 74 72 75 63 74 20 66 6c 6f 63 6b 20 . struct flock
1fe0: 6c 6f 63 6b 3b 0a 20 20 6c 6f 63 6b 2e 6c 5f 74 lock;. lock.l_t
1ff0: 79 70 65 20 3d 20 77 72 6c 6f 63 6b 20 3f 20 46 ype = wrlock ? F
2000: 5f 57 52 4c 43 4b 20 3a 20 46 5f 52 44 4c 43 4b _WRLCK : F_RDLCK
2010: 3b 0a 20 20 6c 6f 63 6b 2e 6c 5f 77 68 65 6e 63 ;. lock.l_whenc
2020: 65 20 3d 20 53 45 45 4b 5f 53 45 54 3b 0a 20 20 e = SEEK_SET;.
2030: 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 20 3d 20 6c lock.l_start = l
2040: 6f 63 6b 2e 6c 5f 6c 65 6e 20 3d 20 30 4c 3b 0a ock.l_len = 0L;.
2050: 20 20 72 63 20 3d 20 66 63 6e 74 6c 28 69 64 2c rc = fcntl(id,
2060: 20 46 5f 53 45 54 4c 4b 2c 20 26 6c 6f 63 6b 29 F_SETLK, &lock)
2070: 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3d 3d 30 ;. return rc==0
2080: 20 3f 20 53 51 4c 49 54 45 5f 4f 4b 20 3a 20 53 ? SQLITE_OK : S
2090: 51 4c 49 54 45 5f 42 55 53 59 3b 0a 23 65 6e 64 QLITE_BUSY;.#end
20a0: 69 66 0a 23 69 66 20 4f 53 5f 57 49 4e 0a 20 20 if.#if OS_WIN.
20b0: 69 66 28 20 21 4c 6f 63 6b 46 69 6c 65 28 69 64 if( !LockFile(id
20c0: 2c 20 30 2c 20 30 2c 20 31 30 32 34 2c 20 30 29 , 0, 0, 1024, 0)
20d0: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 ){. return S
20e0: 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 7d 0a QLITE_BUSY;. }.
20f0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
2100: 4f 4b 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a OK;.#endif.}../*
2110: 0a 2a 2a 20 52 65 6c 65 61 73 65 20 74 68 65 20 .** Release the
2120: 72 65 61 64 20 6f 72 20 77 72 69 74 65 20 6c 6f read or write lo
2130: 63 6b 20 66 72 6f 6d 20 61 20 66 69 6c 65 2e 0a ck from a file..
2140: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 4f 73 55 */.int sqliteOsU
2150: 6e 6c 6f 63 6b 28 4f 73 46 69 6c 65 20 69 64 29 nlock(OsFile id)
2160: 7b 0a 23 69 66 20 4f 53 5f 55 4e 49 58 0a 20 20 {.#if OS_UNIX.
2170: 69 6e 74 20 72 63 3b 0a 20 20 73 74 72 75 63 74 int rc;. struct
2180: 20 66 6c 6f 63 6b 20 6c 6f 63 6b 3b 0a 20 20 6c flock lock;. l
2190: 6f 63 6b 2e 6c 5f 74 79 70 65 20 3d 20 46 5f 55 ock.l_type = F_U
21a0: 4e 4c 43 4b 3b 0a 20 20 6c 6f 63 6b 2e 6c 5f 77 NLCK;. lock.l_w
21b0: 68 65 6e 63 65 20 3d 20 53 45 45 4b 5f 53 45 54 hence = SEEK_SET
21c0: 3b 0a 20 20 6c 6f 63 6b 2e 6c 5f 73 74 61 72 74 ;. lock.l_start
21d0: 20 3d 20 6c 6f 63 6b 2e 6c 5f 6c 65 6e 20 3d 20 = lock.l_len =
21e0: 30 4c 3b 0a 20 20 72 63 20 3d 20 66 63 6e 74 6c 0L;. rc = fcntl
21f0: 28 69 64 2c 20 46 5f 53 45 54 4c 4b 2c 20 26 6c (id, F_SETLK, &l
2200: 6f 63 6b 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 ock);. return r
2210: 63 3d 3d 30 20 3f 20 53 51 4c 49 54 45 5f 4f 4b c==0 ? SQLITE_OK
2220: 20 3a 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 3b : SQLITE_IOERR;
2230: 0a 23 65 6e 64 69 66 0a 23 69 66 20 4f 53 5f 57 .#endif.#if OS_W
2240: 49 4e 0a 20 20 72 65 74 75 72 6e 20 55 6e 6c 6f IN. return Unlo
2250: 63 6b 46 69 6c 65 28 69 64 2c 20 30 2c 20 30 2c ckFile(id, 0, 0,
2260: 20 31 30 32 34 2c 20 30 29 20 3f 20 53 51 4c 49 1024, 0) ? SQLI
2270: 54 45 5f 4f 4b 20 3a 20 53 51 4c 49 54 45 5f 49 TE_OK : SQLITE_I
2280: 4f 45 52 52 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a OERR;.#endif.}..
2290: 2f 2a 0a 2a 2a 20 47 65 74 20 69 6e 66 6f 72 6d /*.** Get inform
22a0: 61 74 69 6f 6e 20 74 6f 20 73 65 65 64 20 74 68 ation to seed th
22b0: 65 20 72 61 6e 64 6f 6d 20 6e 75 6d 62 65 72 20 e random number
22c0: 67 65 6e 65 72 61 74 6f 72 2e 0a 2a 2f 0a 69 6e generator..*/.in
22d0: 74 20 73 71 6c 69 74 65 4f 73 52 61 6e 64 6f 6d t sqliteOsRandom
22e0: 53 65 65 64 28 63 68 61 72 20 2a 7a 42 75 66 29 Seed(char *zBuf)
22f0: 7b 0a 23 69 66 20 4f 53 5f 55 4e 49 58 0a 20 20 {.#if OS_UNIX.
2300: 69 6e 74 20 70 69 64 3b 0a 20 20 74 69 6d 65 28 int pid;. time(
2310: 28 74 69 6d 65 5f 74 2a 29 7a 42 75 66 29 3b 0a (time_t*)zBuf);.
2320: 20 20 7a 42 75 66 20 2b 3d 20 73 69 7a 65 6f 66 zBuf += sizeof
2330: 28 74 69 6d 65 5f 74 29 3b 0a 20 20 70 69 64 20 (time_t);. pid
2340: 3d 20 67 65 74 70 69 64 28 29 3b 0a 20 20 6d 65 = getpid();. me
2350: 6d 63 70 79 28 7a 42 75 66 2c 20 26 70 69 64 2c mcpy(zBuf, &pid,
2360: 20 73 69 7a 65 6f 66 28 70 69 64 29 29 3b 0a 20 sizeof(pid));.
2370: 20 7a 42 75 66 20 2b 3d 20 70 69 64 3b 0a 20 20 zBuf += pid;.
2380: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
2390: 3b 0a 23 65 6e 64 69 66 0a 23 69 66 20 4f 53 5f ;.#endif.#if OS_
23a0: 57 49 4e 0a 20 20 47 65 74 53 79 73 74 65 6d 54 WIN. GetSystemT
23b0: 69 6d 65 28 28 4c 50 53 59 53 54 45 4d 54 49 4d ime((LPSYSTEMTIM
23c0: 45 29 7a 42 75 66 29 3b 0a 20 20 72 65 74 75 72 E)zBuf);. retur
23d0: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 23 65 6e n SQLITE_OK;.#en
23e0: 64 69 66 20 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 6c dif .}../*.** Sl
23f0: 65 65 70 20 66 6f 72 20 61 20 6c 69 74 74 6c 65 eep for a little
2400: 20 77 68 69 6c 65 2e 20 20 52 65 74 75 72 6e 20 while. Return
2410: 74 68 65 20 61 6d 6f 75 6e 74 20 6f 66 20 74 69 the amount of ti
2420: 6d 65 20 73 6c 65 70 74 2e 0a 2a 2f 0a 69 6e 74 me slept..*/.int
2430: 20 73 71 6c 69 74 65 4f 73 53 6c 65 65 70 28 69 sqliteOsSleep(i
2440: 6e 74 20 6d 73 29 7b 0a 23 69 66 20 4f 53 5f 55 nt ms){.#if OS_U
2450: 4e 49 58 0a 23 69 66 20 64 65 66 69 6e 65 64 28 NIX.#if defined(
2460: 48 41 56 45 5f 55 53 4c 45 45 50 29 20 26 26 20 HAVE_USLEEP) &&
2470: 48 41 56 45 5f 55 53 4c 45 45 50 0a 20 20 75 73 HAVE_USLEEP. us
2480: 6c 65 65 70 28 6d 73 2a 31 30 30 30 29 3b 0a 20 leep(ms*1000);.
2490: 20 72 65 74 75 72 6e 20 6d 73 3b 0a 23 65 6c 73 return ms;.#els
24a0: 65 0a 20 20 73 6c 65 65 70 28 28 6d 73 2b 39 39 e. sleep((ms+99
24b0: 39 29 2f 31 30 30 30 29 3b 0a 20 20 72 65 74 75 9)/1000);. retu
24c0: 72 6e 20 31 30 30 30 2a 28 28 6d 73 2b 39 39 39 rn 1000*((ms+999
24d0: 29 2f 31 30 30 30 29 3b 0a 23 65 6e 64 69 66 0a )/1000);.#endif.
24e0: 23 65 6e 64 69 66 0a 23 69 66 20 4f 53 5f 57 49 #endif.#if OS_WI
24f0: 4e 0a 20 20 53 6c 65 65 70 28 6d 73 29 3b 0a 20 N. Sleep(ms);.
2500: 20 72 65 74 75 72 6e 20 6d 73 3b 0a 23 65 6e 64 return ms;.#end
2510: 69 66 0a 7d 0a if.}.