xref: /freebsd/contrib/sqlite3/shell.c (revision 3416500aef140042c64bc149cb1ec6620483bc44)
1 /*
2 ** 2001 September 15
3 **
4 ** The author disclaims copyright to this source code.  In place of
5 ** a legal notice, here is a blessing:
6 **
7 **    May you do good and not evil.
8 **    May you find forgiveness for yourself and forgive others.
9 **    May you share freely, never taking more than you give.
10 **
11 *************************************************************************
12 ** This file contains code to implement the "sqlite" command line
13 ** utility for accessing SQLite databases.
14 */
15 #if (defined(_WIN32) || defined(WIN32)) && !defined(_CRT_SECURE_NO_WARNINGS)
16 /* This needs to come before any includes for MSVC compiler */
17 #define _CRT_SECURE_NO_WARNINGS
18 #endif
19 
20 /*
21 ** If requested, include the SQLite compiler options file for MSVC.
22 */
23 #if defined(INCLUDE_MSVC_H)
24 #include "msvc.h"
25 #endif
26 
27 /*
28 ** No support for loadable extensions in VxWorks.
29 */
30 #if (defined(__RTP__) || defined(_WRS_KERNEL)) && !SQLITE_OMIT_LOAD_EXTENSION
31 # define SQLITE_OMIT_LOAD_EXTENSION 1
32 #endif
33 
34 /*
35 ** Enable large-file support for fopen() and friends on unix.
36 */
37 #ifndef SQLITE_DISABLE_LFS
38 # define _LARGE_FILE       1
39 # ifndef _FILE_OFFSET_BITS
40 #   define _FILE_OFFSET_BITS 64
41 # endif
42 # define _LARGEFILE_SOURCE 1
43 #endif
44 
45 #include <stdlib.h>
46 #include <string.h>
47 #include <stdio.h>
48 #include <assert.h>
49 #include "sqlite3.h"
50 #if SQLITE_USER_AUTHENTICATION
51 # include "sqlite3userauth.h"
52 #endif
53 #include <ctype.h>
54 #include <stdarg.h>
55 
56 #if !defined(_WIN32) && !defined(WIN32)
57 # include <signal.h>
58 # if !defined(__RTP__) && !defined(_WRS_KERNEL)
59 #  include <pwd.h>
60 # endif
61 # include <unistd.h>
62 # include <sys/types.h>
63 #endif
64 
65 #if HAVE_READLINE
66 # include <readline/readline.h>
67 # include <readline/history.h>
68 #endif
69 
70 #if HAVE_EDITLINE
71 # include <editline/readline.h>
72 #endif
73 
74 #if HAVE_EDITLINE || HAVE_READLINE
75 
76 # define shell_add_history(X) add_history(X)
77 # define shell_read_history(X) read_history(X)
78 # define shell_write_history(X) write_history(X)
79 # define shell_stifle_history(X) stifle_history(X)
80 # define shell_readline(X) readline(X)
81 
82 #elif HAVE_LINENOISE
83 
84 # include "linenoise.h"
85 # define shell_add_history(X) linenoiseHistoryAdd(X)
86 # define shell_read_history(X) linenoiseHistoryLoad(X)
87 # define shell_write_history(X) linenoiseHistorySave(X)
88 # define shell_stifle_history(X) linenoiseHistorySetMaxLen(X)
89 # define shell_readline(X) linenoise(X)
90 
91 #else
92 
93 # define shell_read_history(X)
94 # define shell_write_history(X)
95 # define shell_stifle_history(X)
96 
97 # define SHELL_USE_LOCAL_GETLINE 1
98 #endif
99 
100 
101 #if defined(_WIN32) || defined(WIN32)
102 # include <io.h>
103 # include <fcntl.h>
104 # define isatty(h) _isatty(h)
105 # ifndef access
106 #  define access(f,m) _access((f),(m))
107 # endif
108 # undef popen
109 # define popen _popen
110 # undef pclose
111 # define pclose _pclose
112 #else
113  /* Make sure isatty() has a prototype. */
114  extern int isatty(int);
115 
116 # if !defined(__RTP__) && !defined(_WRS_KERNEL)
117   /* popen and pclose are not C89 functions and so are
118   ** sometimes omitted from the <stdio.h> header */
119    extern FILE *popen(const char*,const char*);
120    extern int pclose(FILE*);
121 # else
122 #  define SQLITE_OMIT_POPEN 1
123 # endif
124 #endif
125 
126 #if defined(_WIN32_WCE)
127 /* Windows CE (arm-wince-mingw32ce-gcc) does not provide isatty()
128  * thus we always assume that we have a console. That can be
129  * overridden with the -batch command line option.
130  */
131 #define isatty(x) 1
132 #endif
133 
134 /* ctype macros that work with signed characters */
135 #define IsSpace(X)  isspace((unsigned char)X)
136 #define IsDigit(X)  isdigit((unsigned char)X)
137 #define ToLower(X)  (char)tolower((unsigned char)X)
138 
139 #if defined(_WIN32) || defined(WIN32)
140 #include <windows.h>
141 
142 /* string conversion routines only needed on Win32 */
143 extern char *sqlite3_win32_unicode_to_utf8(LPCWSTR);
144 extern char *sqlite3_win32_mbcs_to_utf8_v2(const char *, int);
145 extern char *sqlite3_win32_utf8_to_mbcs_v2(const char *, int);
146 #endif
147 
148 /* On Windows, we normally run with output mode of TEXT so that \n characters
149 ** are automatically translated into \r\n.  However, this behavior needs
150 ** to be disabled in some cases (ex: when generating CSV output and when
151 ** rendering quoted strings that contain \n characters).  The following
152 ** routines take care of that.
153 */
154 #if defined(_WIN32) || defined(WIN32)
155 static void setBinaryMode(FILE *file, int isOutput){
156   if( isOutput ) fflush(file);
157   _setmode(_fileno(file), _O_BINARY);
158 }
159 static void setTextMode(FILE *file, int isOutput){
160   if( isOutput ) fflush(file);
161   _setmode(_fileno(file), _O_TEXT);
162 }
163 #else
164 # define setBinaryMode(X,Y)
165 # define setTextMode(X,Y)
166 #endif
167 
168 
169 /* True if the timer is enabled */
170 static int enableTimer = 0;
171 
172 /* Return the current wall-clock time */
173 static sqlite3_int64 timeOfDay(void){
174   static sqlite3_vfs *clockVfs = 0;
175   sqlite3_int64 t;
176   if( clockVfs==0 ) clockVfs = sqlite3_vfs_find(0);
177   if( clockVfs->iVersion>=2 && clockVfs->xCurrentTimeInt64!=0 ){
178     clockVfs->xCurrentTimeInt64(clockVfs, &t);
179   }else{
180     double r;
181     clockVfs->xCurrentTime(clockVfs, &r);
182     t = (sqlite3_int64)(r*86400000.0);
183   }
184   return t;
185 }
186 
187 #if !defined(_WIN32) && !defined(WIN32) && !defined(__minux)
188 #include <sys/time.h>
189 #include <sys/resource.h>
190 
191 /* VxWorks does not support getrusage() as far as we can determine */
192 #if defined(_WRS_KERNEL) || defined(__RTP__)
193 struct rusage {
194   struct timeval ru_utime; /* user CPU time used */
195   struct timeval ru_stime; /* system CPU time used */
196 };
197 #define getrusage(A,B) memset(B,0,sizeof(*B))
198 #endif
199 
200 /* Saved resource information for the beginning of an operation */
201 static struct rusage sBegin;  /* CPU time at start */
202 static sqlite3_int64 iBegin;  /* Wall-clock time at start */
203 
204 /*
205 ** Begin timing an operation
206 */
207 static void beginTimer(void){
208   if( enableTimer ){
209     getrusage(RUSAGE_SELF, &sBegin);
210     iBegin = timeOfDay();
211   }
212 }
213 
214 /* Return the difference of two time_structs in seconds */
215 static double timeDiff(struct timeval *pStart, struct timeval *pEnd){
216   return (pEnd->tv_usec - pStart->tv_usec)*0.000001 +
217          (double)(pEnd->tv_sec - pStart->tv_sec);
218 }
219 
220 /*
221 ** Print the timing results.
222 */
223 static void endTimer(void){
224   if( enableTimer ){
225     sqlite3_int64 iEnd = timeOfDay();
226     struct rusage sEnd;
227     getrusage(RUSAGE_SELF, &sEnd);
228     printf("Run Time: real %.3f user %f sys %f\n",
229        (iEnd - iBegin)*0.001,
230        timeDiff(&sBegin.ru_utime, &sEnd.ru_utime),
231        timeDiff(&sBegin.ru_stime, &sEnd.ru_stime));
232   }
233 }
234 
235 #define BEGIN_TIMER beginTimer()
236 #define END_TIMER endTimer()
237 #define HAS_TIMER 1
238 
239 #elif (defined(_WIN32) || defined(WIN32))
240 
241 /* Saved resource information for the beginning of an operation */
242 static HANDLE hProcess;
243 static FILETIME ftKernelBegin;
244 static FILETIME ftUserBegin;
245 static sqlite3_int64 ftWallBegin;
246 typedef BOOL (WINAPI *GETPROCTIMES)(HANDLE, LPFILETIME, LPFILETIME,
247                                     LPFILETIME, LPFILETIME);
248 static GETPROCTIMES getProcessTimesAddr = NULL;
249 
250 /*
251 ** Check to see if we have timer support.  Return 1 if necessary
252 ** support found (or found previously).
253 */
254 static int hasTimer(void){
255   if( getProcessTimesAddr ){
256     return 1;
257   } else {
258     /* GetProcessTimes() isn't supported in WIN95 and some other Windows
259     ** versions. See if the version we are running on has it, and if it
260     ** does, save off a pointer to it and the current process handle.
261     */
262     hProcess = GetCurrentProcess();
263     if( hProcess ){
264       HINSTANCE hinstLib = LoadLibrary(TEXT("Kernel32.dll"));
265       if( NULL != hinstLib ){
266         getProcessTimesAddr =
267             (GETPROCTIMES) GetProcAddress(hinstLib, "GetProcessTimes");
268         if( NULL != getProcessTimesAddr ){
269           return 1;
270         }
271         FreeLibrary(hinstLib);
272       }
273     }
274   }
275   return 0;
276 }
277 
278 /*
279 ** Begin timing an operation
280 */
281 static void beginTimer(void){
282   if( enableTimer && getProcessTimesAddr ){
283     FILETIME ftCreation, ftExit;
284     getProcessTimesAddr(hProcess,&ftCreation,&ftExit,
285                         &ftKernelBegin,&ftUserBegin);
286     ftWallBegin = timeOfDay();
287   }
288 }
289 
290 /* Return the difference of two FILETIME structs in seconds */
291 static double timeDiff(FILETIME *pStart, FILETIME *pEnd){
292   sqlite_int64 i64Start = *((sqlite_int64 *) pStart);
293   sqlite_int64 i64End = *((sqlite_int64 *) pEnd);
294   return (double) ((i64End - i64Start) / 10000000.0);
295 }
296 
297 /*
298 ** Print the timing results.
299 */
300 static void endTimer(void){
301   if( enableTimer && getProcessTimesAddr){
302     FILETIME ftCreation, ftExit, ftKernelEnd, ftUserEnd;
303     sqlite3_int64 ftWallEnd = timeOfDay();
304     getProcessTimesAddr(hProcess,&ftCreation,&ftExit,&ftKernelEnd,&ftUserEnd);
305     printf("Run Time: real %.3f user %f sys %f\n",
306        (ftWallEnd - ftWallBegin)*0.001,
307        timeDiff(&ftUserBegin, &ftUserEnd),
308        timeDiff(&ftKernelBegin, &ftKernelEnd));
309   }
310 }
311 
312 #define BEGIN_TIMER beginTimer()
313 #define END_TIMER endTimer()
314 #define HAS_TIMER hasTimer()
315 
316 #else
317 #define BEGIN_TIMER
318 #define END_TIMER
319 #define HAS_TIMER 0
320 #endif
321 
322 /*
323 ** Used to prevent warnings about unused parameters
324 */
325 #define UNUSED_PARAMETER(x) (void)(x)
326 
327 /*
328 ** If the following flag is set, then command execution stops
329 ** at an error if we are not interactive.
330 */
331 static int bail_on_error = 0;
332 
333 /*
334 ** Threat stdin as an interactive input if the following variable
335 ** is true.  Otherwise, assume stdin is connected to a file or pipe.
336 */
337 static int stdin_is_interactive = 1;
338 
339 /*
340 ** On Windows systems we have to know if standard output is a console
341 ** in order to translate UTF-8 into MBCS.  The following variable is
342 ** true if translation is required.
343 */
344 static int stdout_is_console = 1;
345 
346 /*
347 ** The following is the open SQLite database.  We make a pointer
348 ** to this database a static variable so that it can be accessed
349 ** by the SIGINT handler to interrupt database processing.
350 */
351 static sqlite3 *globalDb = 0;
352 
353 /*
354 ** True if an interrupt (Control-C) has been received.
355 */
356 static volatile int seenInterrupt = 0;
357 
358 /*
359 ** This is the name of our program. It is set in main(), used
360 ** in a number of other places, mostly for error messages.
361 */
362 static char *Argv0;
363 
364 /*
365 ** Prompt strings. Initialized in main. Settable with
366 **   .prompt main continue
367 */
368 static char mainPrompt[20];     /* First line prompt. default: "sqlite> "*/
369 static char continuePrompt[20]; /* Continuation prompt. default: "   ...> " */
370 
371 /*
372 ** Render output like fprintf().  Except, if the output is going to the
373 ** console and if this is running on a Windows machine, translate the
374 ** output from UTF-8 into MBCS.
375 */
376 #if defined(_WIN32) || defined(WIN32)
377 void utf8_printf(FILE *out, const char *zFormat, ...){
378   va_list ap;
379   va_start(ap, zFormat);
380   if( stdout_is_console && (out==stdout || out==stderr) ){
381     char *z1 = sqlite3_vmprintf(zFormat, ap);
382     char *z2 = sqlite3_win32_utf8_to_mbcs_v2(z1, 0);
383     sqlite3_free(z1);
384     fputs(z2, out);
385     sqlite3_free(z2);
386   }else{
387     vfprintf(out, zFormat, ap);
388   }
389   va_end(ap);
390 }
391 #elif !defined(utf8_printf)
392 # define utf8_printf fprintf
393 #endif
394 
395 /*
396 ** Render output like fprintf().  This should not be used on anything that
397 ** includes string formatting (e.g. "%s").
398 */
399 #if !defined(raw_printf)
400 # define raw_printf fprintf
401 #endif
402 
403 /*
404 ** Write I/O traces to the following stream.
405 */
406 #ifdef SQLITE_ENABLE_IOTRACE
407 static FILE *iotrace = 0;
408 #endif
409 
410 /*
411 ** This routine works like printf in that its first argument is a
412 ** format string and subsequent arguments are values to be substituted
413 ** in place of % fields.  The result of formatting this string
414 ** is written to iotrace.
415 */
416 #ifdef SQLITE_ENABLE_IOTRACE
417 static void SQLITE_CDECL iotracePrintf(const char *zFormat, ...){
418   va_list ap;
419   char *z;
420   if( iotrace==0 ) return;
421   va_start(ap, zFormat);
422   z = sqlite3_vmprintf(zFormat, ap);
423   va_end(ap);
424   utf8_printf(iotrace, "%s", z);
425   sqlite3_free(z);
426 }
427 #endif
428 
429 
430 /*
431 ** Determines if a string is a number of not.
432 */
433 static int isNumber(const char *z, int *realnum){
434   if( *z=='-' || *z=='+' ) z++;
435   if( !IsDigit(*z) ){
436     return 0;
437   }
438   z++;
439   if( realnum ) *realnum = 0;
440   while( IsDigit(*z) ){ z++; }
441   if( *z=='.' ){
442     z++;
443     if( !IsDigit(*z) ) return 0;
444     while( IsDigit(*z) ){ z++; }
445     if( realnum ) *realnum = 1;
446   }
447   if( *z=='e' || *z=='E' ){
448     z++;
449     if( *z=='+' || *z=='-' ) z++;
450     if( !IsDigit(*z) ) return 0;
451     while( IsDigit(*z) ){ z++; }
452     if( realnum ) *realnum = 1;
453   }
454   return *z==0;
455 }
456 
457 /*
458 ** A global char* and an SQL function to access its current value
459 ** from within an SQL statement. This program used to use the
460 ** sqlite_exec_printf() API to substitue a string into an SQL statement.
461 ** The correct way to do this with sqlite3 is to use the bind API, but
462 ** since the shell is built around the callback paradigm it would be a lot
463 ** of work. Instead just use this hack, which is quite harmless.
464 */
465 static const char *zShellStatic = 0;
466 static void shellstaticFunc(
467   sqlite3_context *context,
468   int argc,
469   sqlite3_value **argv
470 ){
471   assert( 0==argc );
472   assert( zShellStatic );
473   UNUSED_PARAMETER(argc);
474   UNUSED_PARAMETER(argv);
475   sqlite3_result_text(context, zShellStatic, -1, SQLITE_STATIC);
476 }
477 
478 
479 /*
480 ** Compute a string length that is limited to what can be stored in
481 ** lower 30 bits of a 32-bit signed integer.
482 */
483 static int strlen30(const char *z){
484   const char *z2 = z;
485   while( *z2 ){ z2++; }
486   return 0x3fffffff & (int)(z2 - z);
487 }
488 
489 /*
490 ** This routine reads a line of text from FILE in, stores
491 ** the text in memory obtained from malloc() and returns a pointer
492 ** to the text.  NULL is returned at end of file, or if malloc()
493 ** fails.
494 **
495 ** If zLine is not NULL then it is a malloced buffer returned from
496 ** a previous call to this routine that may be reused.
497 */
498 static char *local_getline(char *zLine, FILE *in){
499   int nLine = zLine==0 ? 0 : 100;
500   int n = 0;
501 
502   while( 1 ){
503     if( n+100>nLine ){
504       nLine = nLine*2 + 100;
505       zLine = realloc(zLine, nLine);
506       if( zLine==0 ) return 0;
507     }
508     if( fgets(&zLine[n], nLine - n, in)==0 ){
509       if( n==0 ){
510         free(zLine);
511         return 0;
512       }
513       zLine[n] = 0;
514       break;
515     }
516     while( zLine[n] ) n++;
517     if( n>0 && zLine[n-1]=='\n' ){
518       n--;
519       if( n>0 && zLine[n-1]=='\r' ) n--;
520       zLine[n] = 0;
521       break;
522     }
523   }
524 #if defined(_WIN32) || defined(WIN32)
525   /* For interactive input on Windows systems, translate the
526   ** multi-byte characterset characters into UTF-8. */
527   if( stdin_is_interactive ){
528     char *zTrans = sqlite3_win32_mbcs_to_utf8_v2(zLine, 0);
529     if( zTrans ){
530       int nTrans = strlen30(zTrans)+1;
531       if( nTrans>nLine ){
532         zLine = realloc(zLine, nTrans);
533         if( zLine==0 ){
534           sqlite3_free(zTrans);
535           return 0;
536         }
537       }
538       memcpy(zLine, zTrans, nTrans);
539       sqlite3_free(zTrans);
540     }
541   }
542 #endif /* defined(_WIN32) || defined(WIN32) */
543   return zLine;
544 }
545 
546 /*
547 ** Retrieve a single line of input text.
548 **
549 ** If in==0 then read from standard input and prompt before each line.
550 ** If isContinuation is true, then a continuation prompt is appropriate.
551 ** If isContinuation is zero, then the main prompt should be used.
552 **
553 ** If zPrior is not NULL then it is a buffer from a prior call to this
554 ** routine that can be reused.
555 **
556 ** The result is stored in space obtained from malloc() and must either
557 ** be freed by the caller or else passed back into this routine via the
558 ** zPrior argument for reuse.
559 */
560 static char *one_input_line(FILE *in, char *zPrior, int isContinuation){
561   char *zPrompt;
562   char *zResult;
563   if( in!=0 ){
564     zResult = local_getline(zPrior, in);
565   }else{
566     zPrompt = isContinuation ? continuePrompt : mainPrompt;
567 #if SHELL_USE_LOCAL_GETLINE
568     printf("%s", zPrompt);
569     fflush(stdout);
570     zResult = local_getline(zPrior, stdin);
571 #else
572     free(zPrior);
573     zResult = shell_readline(zPrompt);
574     if( zResult && *zResult ) shell_add_history(zResult);
575 #endif
576   }
577   return zResult;
578 }
579 
580 #if defined(SQLITE_ENABLE_SESSION)
581 /*
582 ** State information for a single open session
583 */
584 typedef struct OpenSession OpenSession;
585 struct OpenSession {
586   char *zName;             /* Symbolic name for this session */
587   int nFilter;             /* Number of xFilter rejection GLOB patterns */
588   char **azFilter;         /* Array of xFilter rejection GLOB patterns */
589   sqlite3_session *p;      /* The open session */
590 };
591 #endif
592 
593 /*
594 ** Shell output mode information from before ".explain on",
595 ** saved so that it can be restored by ".explain off"
596 */
597 typedef struct SavedModeInfo SavedModeInfo;
598 struct SavedModeInfo {
599   int valid;          /* Is there legit data in here? */
600   int mode;           /* Mode prior to ".explain on" */
601   int showHeader;     /* The ".header" setting prior to ".explain on" */
602   int colWidth[100];  /* Column widths prior to ".explain on" */
603 };
604 
605 /*
606 ** State information about the database connection is contained in an
607 ** instance of the following structure.
608 */
609 typedef struct ShellState ShellState;
610 struct ShellState {
611   sqlite3 *db;           /* The database */
612   int echoOn;            /* True to echo input commands */
613   int autoExplain;       /* Automatically turn on .explain mode */
614   int autoEQP;           /* Run EXPLAIN QUERY PLAN prior to seach SQL stmt */
615   int statsOn;           /* True to display memory stats before each finalize */
616   int scanstatsOn;       /* True to display scan stats before each finalize */
617   int countChanges;      /* True to display change counts */
618   int backslashOn;       /* Resolve C-style \x escapes in SQL input text */
619   int outCount;          /* Revert to stdout when reaching zero */
620   int cnt;               /* Number of records displayed so far */
621   FILE *out;             /* Write results here */
622   FILE *traceOut;        /* Output for sqlite3_trace() */
623   int nErr;              /* Number of errors seen */
624   int mode;              /* An output mode setting */
625   int cMode;             /* temporary output mode for the current query */
626   int normalMode;        /* Output mode before ".explain on" */
627   int writableSchema;    /* True if PRAGMA writable_schema=ON */
628   int showHeader;        /* True to show column names in List or Column mode */
629   unsigned shellFlgs;    /* Various flags */
630   char *zDestTable;      /* Name of destination table when MODE_Insert */
631   char colSeparator[20]; /* Column separator character for several modes */
632   char rowSeparator[20]; /* Row separator character for MODE_Ascii */
633   int colWidth[100];     /* Requested width of each column when in column mode*/
634   int actualWidth[100];  /* Actual width of each column */
635   char nullValue[20];    /* The text to print when a NULL comes back from
636                          ** the database */
637   char outfile[FILENAME_MAX]; /* Filename for *out */
638   const char *zDbFilename;    /* name of the database file */
639   char *zFreeOnClose;         /* Filename to free when closing */
640   const char *zVfs;           /* Name of VFS to use */
641   sqlite3_stmt *pStmt;   /* Current statement if any. */
642   FILE *pLog;            /* Write log output here */
643   int *aiIndent;         /* Array of indents used in MODE_Explain */
644   int nIndent;           /* Size of array aiIndent[] */
645   int iIndent;           /* Index of current op in aiIndent[] */
646 #if defined(SQLITE_ENABLE_SESSION)
647   int nSession;             /* Number of active sessions */
648   OpenSession aSession[4];  /* Array of sessions.  [0] is in focus. */
649 #endif
650 };
651 
652 /*
653 ** These are the allowed shellFlgs values
654 */
655 #define SHFLG_Scratch     0x00001     /* The --scratch option is used */
656 #define SHFLG_Pagecache   0x00002     /* The --pagecache option is used */
657 #define SHFLG_Lookaside   0x00004     /* Lookaside memory is used */
658 
659 /*
660 ** These are the allowed modes.
661 */
662 #define MODE_Line     0  /* One column per line.  Blank line between records */
663 #define MODE_Column   1  /* One record per line in neat columns */
664 #define MODE_List     2  /* One record per line with a separator */
665 #define MODE_Semi     3  /* Same as MODE_List but append ";" to each line */
666 #define MODE_Html     4  /* Generate an XHTML table */
667 #define MODE_Insert   5  /* Generate SQL "insert" statements */
668 #define MODE_Tcl      6  /* Generate ANSI-C or TCL quoted elements */
669 #define MODE_Csv      7  /* Quote strings, numbers are plain */
670 #define MODE_Explain  8  /* Like MODE_Column, but do not truncate data */
671 #define MODE_Ascii    9  /* Use ASCII unit and record separators (0x1F/0x1E) */
672 #define MODE_Pretty  10  /* Pretty-print schemas */
673 
674 static const char *modeDescr[] = {
675   "line",
676   "column",
677   "list",
678   "semi",
679   "html",
680   "insert",
681   "tcl",
682   "csv",
683   "explain",
684   "ascii",
685   "prettyprint",
686 };
687 
688 /*
689 ** These are the column/row/line separators used by the various
690 ** import/export modes.
691 */
692 #define SEP_Column    "|"
693 #define SEP_Row       "\n"
694 #define SEP_Tab       "\t"
695 #define SEP_Space     " "
696 #define SEP_Comma     ","
697 #define SEP_CrLf      "\r\n"
698 #define SEP_Unit      "\x1F"
699 #define SEP_Record    "\x1E"
700 
701 /*
702 ** Number of elements in an array
703 */
704 #define ArraySize(X)  (int)(sizeof(X)/sizeof(X[0]))
705 
706 /*
707 ** A callback for the sqlite3_log() interface.
708 */
709 static void shellLog(void *pArg, int iErrCode, const char *zMsg){
710   ShellState *p = (ShellState*)pArg;
711   if( p->pLog==0 ) return;
712   utf8_printf(p->pLog, "(%d) %s\n", iErrCode, zMsg);
713   fflush(p->pLog);
714 }
715 
716 /*
717 ** Output the given string as a hex-encoded blob (eg. X'1234' )
718 */
719 static void output_hex_blob(FILE *out, const void *pBlob, int nBlob){
720   int i;
721   char *zBlob = (char *)pBlob;
722   raw_printf(out,"X'");
723   for(i=0; i<nBlob; i++){ raw_printf(out,"%02x",zBlob[i]&0xff); }
724   raw_printf(out,"'");
725 }
726 
727 /*
728 ** Output the given string as a quoted string using SQL quoting conventions.
729 */
730 static void output_quoted_string(FILE *out, const char *z){
731   int i;
732   int nSingle = 0;
733   setBinaryMode(out, 1);
734   for(i=0; z[i]; i++){
735     if( z[i]=='\'' ) nSingle++;
736   }
737   if( nSingle==0 ){
738     utf8_printf(out,"'%s'",z);
739   }else{
740     raw_printf(out,"'");
741     while( *z ){
742       for(i=0; z[i] && z[i]!='\''; i++){}
743       if( i==0 ){
744         raw_printf(out,"''");
745         z++;
746       }else if( z[i]=='\'' ){
747         utf8_printf(out,"%.*s''",i,z);
748         z += i+1;
749       }else{
750         utf8_printf(out,"%s",z);
751         break;
752       }
753     }
754     raw_printf(out,"'");
755   }
756   setTextMode(out, 1);
757 }
758 
759 /*
760 ** Output the given string as a quoted according to C or TCL quoting rules.
761 */
762 static void output_c_string(FILE *out, const char *z){
763   unsigned int c;
764   fputc('"', out);
765   while( (c = *(z++))!=0 ){
766     if( c=='\\' ){
767       fputc(c, out);
768       fputc(c, out);
769     }else if( c=='"' ){
770       fputc('\\', out);
771       fputc('"', out);
772     }else if( c=='\t' ){
773       fputc('\\', out);
774       fputc('t', out);
775     }else if( c=='\n' ){
776       fputc('\\', out);
777       fputc('n', out);
778     }else if( c=='\r' ){
779       fputc('\\', out);
780       fputc('r', out);
781     }else if( !isprint(c&0xff) ){
782       raw_printf(out, "\\%03o", c&0xff);
783     }else{
784       fputc(c, out);
785     }
786   }
787   fputc('"', out);
788 }
789 
790 /*
791 ** Output the given string with characters that are special to
792 ** HTML escaped.
793 */
794 static void output_html_string(FILE *out, const char *z){
795   int i;
796   if( z==0 ) z = "";
797   while( *z ){
798     for(i=0;   z[i]
799             && z[i]!='<'
800             && z[i]!='&'
801             && z[i]!='>'
802             && z[i]!='\"'
803             && z[i]!='\'';
804         i++){}
805     if( i>0 ){
806       utf8_printf(out,"%.*s",i,z);
807     }
808     if( z[i]=='<' ){
809       raw_printf(out,"&lt;");
810     }else if( z[i]=='&' ){
811       raw_printf(out,"&amp;");
812     }else if( z[i]=='>' ){
813       raw_printf(out,"&gt;");
814     }else if( z[i]=='\"' ){
815       raw_printf(out,"&quot;");
816     }else if( z[i]=='\'' ){
817       raw_printf(out,"&#39;");
818     }else{
819       break;
820     }
821     z += i + 1;
822   }
823 }
824 
825 /*
826 ** If a field contains any character identified by a 1 in the following
827 ** array, then the string must be quoted for CSV.
828 */
829 static const char needCsvQuote[] = {
830   1, 1, 1, 1, 1, 1, 1, 1,   1, 1, 1, 1, 1, 1, 1, 1,
831   1, 1, 1, 1, 1, 1, 1, 1,   1, 1, 1, 1, 1, 1, 1, 1,
832   1, 0, 1, 0, 0, 0, 0, 1,   0, 0, 0, 0, 0, 0, 0, 0,
833   0, 0, 0, 0, 0, 0, 0, 0,   0, 0, 0, 0, 0, 0, 0, 0,
834   0, 0, 0, 0, 0, 0, 0, 0,   0, 0, 0, 0, 0, 0, 0, 0,
835   0, 0, 0, 0, 0, 0, 0, 0,   0, 0, 0, 0, 0, 0, 0, 0,
836   0, 0, 0, 0, 0, 0, 0, 0,   0, 0, 0, 0, 0, 0, 0, 0,
837   0, 0, 0, 0, 0, 0, 0, 0,   0, 0, 0, 0, 0, 0, 0, 1,
838   1, 1, 1, 1, 1, 1, 1, 1,   1, 1, 1, 1, 1, 1, 1, 1,
839   1, 1, 1, 1, 1, 1, 1, 1,   1, 1, 1, 1, 1, 1, 1, 1,
840   1, 1, 1, 1, 1, 1, 1, 1,   1, 1, 1, 1, 1, 1, 1, 1,
841   1, 1, 1, 1, 1, 1, 1, 1,   1, 1, 1, 1, 1, 1, 1, 1,
842   1, 1, 1, 1, 1, 1, 1, 1,   1, 1, 1, 1, 1, 1, 1, 1,
843   1, 1, 1, 1, 1, 1, 1, 1,   1, 1, 1, 1, 1, 1, 1, 1,
844   1, 1, 1, 1, 1, 1, 1, 1,   1, 1, 1, 1, 1, 1, 1, 1,
845   1, 1, 1, 1, 1, 1, 1, 1,   1, 1, 1, 1, 1, 1, 1, 1,
846 };
847 
848 /*
849 ** Output a single term of CSV.  Actually, p->colSeparator is used for
850 ** the separator, which may or may not be a comma.  p->nullValue is
851 ** the null value.  Strings are quoted if necessary.  The separator
852 ** is only issued if bSep is true.
853 */
854 static void output_csv(ShellState *p, const char *z, int bSep){
855   FILE *out = p->out;
856   if( z==0 ){
857     utf8_printf(out,"%s",p->nullValue);
858   }else{
859     int i;
860     int nSep = strlen30(p->colSeparator);
861     for(i=0; z[i]; i++){
862       if( needCsvQuote[((unsigned char*)z)[i]]
863          || (z[i]==p->colSeparator[0] &&
864              (nSep==1 || memcmp(z, p->colSeparator, nSep)==0)) ){
865         i = 0;
866         break;
867       }
868     }
869     if( i==0 ){
870       putc('"', out);
871       for(i=0; z[i]; i++){
872         if( z[i]=='"' ) putc('"', out);
873         putc(z[i], out);
874       }
875       putc('"', out);
876     }else{
877       utf8_printf(out, "%s", z);
878     }
879   }
880   if( bSep ){
881     utf8_printf(p->out, "%s", p->colSeparator);
882   }
883 }
884 
885 #ifdef SIGINT
886 /*
887 ** This routine runs when the user presses Ctrl-C
888 */
889 static void interrupt_handler(int NotUsed){
890   UNUSED_PARAMETER(NotUsed);
891   seenInterrupt++;
892   if( seenInterrupt>2 ) exit(1);
893   if( globalDb ) sqlite3_interrupt(globalDb);
894 }
895 #endif
896 
897 /*
898 ** When the ".auth ON" is set, the following authorizer callback is
899 ** invoked.  It always returns SQLITE_OK.
900 */
901 static int shellAuth(
902   void *pClientData,
903   int op,
904   const char *zA1,
905   const char *zA2,
906   const char *zA3,
907   const char *zA4
908 ){
909   ShellState *p = (ShellState*)pClientData;
910   static const char *azAction[] = { 0,
911      "CREATE_INDEX",         "CREATE_TABLE",         "CREATE_TEMP_INDEX",
912      "CREATE_TEMP_TABLE",    "CREATE_TEMP_TRIGGER",  "CREATE_TEMP_VIEW",
913      "CREATE_TRIGGER",       "CREATE_VIEW",          "DELETE",
914      "DROP_INDEX",           "DROP_TABLE",           "DROP_TEMP_INDEX",
915      "DROP_TEMP_TABLE",      "DROP_TEMP_TRIGGER",    "DROP_TEMP_VIEW",
916      "DROP_TRIGGER",         "DROP_VIEW",            "INSERT",
917      "PRAGMA",               "READ",                 "SELECT",
918      "TRANSACTION",          "UPDATE",               "ATTACH",
919      "DETACH",               "ALTER_TABLE",          "REINDEX",
920      "ANALYZE",              "CREATE_VTABLE",        "DROP_VTABLE",
921      "FUNCTION",             "SAVEPOINT",            "RECURSIVE"
922   };
923   int i;
924   const char *az[4];
925   az[0] = zA1;
926   az[1] = zA2;
927   az[2] = zA3;
928   az[3] = zA4;
929   raw_printf(p->out, "authorizer: %s", azAction[op]);
930   for(i=0; i<4; i++){
931     raw_printf(p->out, " ");
932     if( az[i] ){
933       output_c_string(p->out, az[i]);
934     }else{
935       raw_printf(p->out, "NULL");
936     }
937   }
938   raw_printf(p->out, "\n");
939   return SQLITE_OK;
940 }
941 
942 
943 /*
944 ** This is the callback routine that the shell
945 ** invokes for each row of a query result.
946 */
947 static int shell_callback(
948   void *pArg,
949   int nArg,        /* Number of result columns */
950   char **azArg,    /* Text of each result column */
951   char **azCol,    /* Column names */
952   int *aiType      /* Column types */
953 ){
954   int i;
955   ShellState *p = (ShellState*)pArg;
956 
957   switch( p->cMode ){
958     case MODE_Line: {
959       int w = 5;
960       if( azArg==0 ) break;
961       for(i=0; i<nArg; i++){
962         int len = strlen30(azCol[i] ? azCol[i] : "");
963         if( len>w ) w = len;
964       }
965       if( p->cnt++>0 ) utf8_printf(p->out, "%s", p->rowSeparator);
966       for(i=0; i<nArg; i++){
967         utf8_printf(p->out,"%*s = %s%s", w, azCol[i],
968                 azArg[i] ? azArg[i] : p->nullValue, p->rowSeparator);
969       }
970       break;
971     }
972     case MODE_Explain:
973     case MODE_Column: {
974       static const int aExplainWidths[] = {4, 13, 4, 4, 4, 13, 2, 13};
975       const int *colWidth;
976       int showHdr;
977       char *rowSep;
978       if( p->cMode==MODE_Column ){
979         colWidth = p->colWidth;
980         showHdr = p->showHeader;
981         rowSep = p->rowSeparator;
982       }else{
983         colWidth = aExplainWidths;
984         showHdr = 1;
985         rowSep = SEP_Row;
986       }
987       if( p->cnt++==0 ){
988         for(i=0; i<nArg; i++){
989           int w, n;
990           if( i<ArraySize(p->colWidth) ){
991             w = colWidth[i];
992           }else{
993             w = 0;
994           }
995           if( w==0 ){
996             w = strlen30(azCol[i] ? azCol[i] : "");
997             if( w<10 ) w = 10;
998             n = strlen30(azArg && azArg[i] ? azArg[i] : p->nullValue);
999             if( w<n ) w = n;
1000           }
1001           if( i<ArraySize(p->actualWidth) ){
1002             p->actualWidth[i] = w;
1003           }
1004           if( showHdr ){
1005             if( w<0 ){
1006               utf8_printf(p->out,"%*.*s%s",-w,-w,azCol[i],
1007                       i==nArg-1 ? rowSep : "  ");
1008             }else{
1009               utf8_printf(p->out,"%-*.*s%s",w,w,azCol[i],
1010                       i==nArg-1 ? rowSep : "  ");
1011             }
1012           }
1013         }
1014         if( showHdr ){
1015           for(i=0; i<nArg; i++){
1016             int w;
1017             if( i<ArraySize(p->actualWidth) ){
1018                w = p->actualWidth[i];
1019                if( w<0 ) w = -w;
1020             }else{
1021                w = 10;
1022             }
1023             utf8_printf(p->out,"%-*.*s%s",w,w,
1024                    "----------------------------------------------------------"
1025                    "----------------------------------------------------------",
1026                     i==nArg-1 ? rowSep : "  ");
1027           }
1028         }
1029       }
1030       if( azArg==0 ) break;
1031       for(i=0; i<nArg; i++){
1032         int w;
1033         if( i<ArraySize(p->actualWidth) ){
1034            w = p->actualWidth[i];
1035         }else{
1036            w = 10;
1037         }
1038         if( p->cMode==MODE_Explain && azArg[i] && strlen30(azArg[i])>w ){
1039           w = strlen30(azArg[i]);
1040         }
1041         if( i==1 && p->aiIndent && p->pStmt ){
1042           if( p->iIndent<p->nIndent ){
1043             utf8_printf(p->out, "%*.s", p->aiIndent[p->iIndent], "");
1044           }
1045           p->iIndent++;
1046         }
1047         if( w<0 ){
1048           utf8_printf(p->out,"%*.*s%s",-w,-w,
1049               azArg[i] ? azArg[i] : p->nullValue,
1050               i==nArg-1 ? rowSep : "  ");
1051         }else{
1052           utf8_printf(p->out,"%-*.*s%s",w,w,
1053               azArg[i] ? azArg[i] : p->nullValue,
1054               i==nArg-1 ? rowSep : "  ");
1055         }
1056       }
1057       break;
1058     }
1059     case MODE_Semi: {   /* .schema and .fullschema output */
1060       utf8_printf(p->out, "%s;\n", azArg[0]);
1061       break;
1062     }
1063     case MODE_Pretty: {  /* .schema and .fullschema with --indent */
1064       char *z;
1065       int j;
1066       int nParen = 0;
1067       char cEnd = 0;
1068       char c;
1069       int nLine = 0;
1070       assert( nArg==1 );
1071       if( azArg[0]==0 ) break;
1072       if( sqlite3_strlike("CREATE VIEW%", azArg[0], 0)==0
1073        || sqlite3_strlike("CREATE TRIG%", azArg[0], 0)==0
1074       ){
1075         utf8_printf(p->out, "%s;\n", azArg[0]);
1076         break;
1077       }
1078       z = sqlite3_mprintf("%s", azArg[0]);
1079       j = 0;
1080       for(i=0; IsSpace(z[i]); i++){}
1081       for(; (c = z[i])!=0; i++){
1082         if( IsSpace(c) ){
1083           if( IsSpace(z[j-1]) || z[j-1]=='(' ) continue;
1084         }else if( (c=='(' || c==')') && j>0 && IsSpace(z[j-1]) ){
1085           j--;
1086         }
1087         z[j++] = c;
1088       }
1089       while( j>0 && IsSpace(z[j-1]) ){ j--; }
1090       z[j] = 0;
1091       if( strlen30(z)>=79 ){
1092         for(i=j=0; (c = z[i])!=0; i++){
1093           if( c==cEnd ){
1094             cEnd = 0;
1095           }else if( c=='"' || c=='\'' || c=='`' ){
1096             cEnd = c;
1097           }else if( c=='[' ){
1098             cEnd = ']';
1099           }else if( c=='(' ){
1100             nParen++;
1101           }else if( c==')' ){
1102             nParen--;
1103             if( nLine>0 && nParen==0 && j>0 ){
1104               utf8_printf(p->out, "%.*s\n", j, z);
1105               j = 0;
1106             }
1107           }
1108           z[j++] = c;
1109           if( nParen==1 && (c=='(' || c==',' || c=='\n') ){
1110             if( c=='\n' ) j--;
1111             utf8_printf(p->out, "%.*s\n  ", j, z);
1112             j = 0;
1113             nLine++;
1114             while( IsSpace(z[i+1]) ){ i++; }
1115           }
1116         }
1117         z[j] = 0;
1118       }
1119       utf8_printf(p->out, "%s;\n", z);
1120       sqlite3_free(z);
1121       break;
1122     }
1123     case MODE_List: {
1124       if( p->cnt++==0 && p->showHeader ){
1125         for(i=0; i<nArg; i++){
1126           utf8_printf(p->out,"%s%s",azCol[i],
1127                   i==nArg-1 ? p->rowSeparator : p->colSeparator);
1128         }
1129       }
1130       if( azArg==0 ) break;
1131       for(i=0; i<nArg; i++){
1132         char *z = azArg[i];
1133         if( z==0 ) z = p->nullValue;
1134         utf8_printf(p->out, "%s", z);
1135         if( i<nArg-1 ){
1136           utf8_printf(p->out, "%s", p->colSeparator);
1137         }else{
1138           utf8_printf(p->out, "%s", p->rowSeparator);
1139         }
1140       }
1141       break;
1142     }
1143     case MODE_Html: {
1144       if( p->cnt++==0 && p->showHeader ){
1145         raw_printf(p->out,"<TR>");
1146         for(i=0; i<nArg; i++){
1147           raw_printf(p->out,"<TH>");
1148           output_html_string(p->out, azCol[i]);
1149           raw_printf(p->out,"</TH>\n");
1150         }
1151         raw_printf(p->out,"</TR>\n");
1152       }
1153       if( azArg==0 ) break;
1154       raw_printf(p->out,"<TR>");
1155       for(i=0; i<nArg; i++){
1156         raw_printf(p->out,"<TD>");
1157         output_html_string(p->out, azArg[i] ? azArg[i] : p->nullValue);
1158         raw_printf(p->out,"</TD>\n");
1159       }
1160       raw_printf(p->out,"</TR>\n");
1161       break;
1162     }
1163     case MODE_Tcl: {
1164       if( p->cnt++==0 && p->showHeader ){
1165         for(i=0; i<nArg; i++){
1166           output_c_string(p->out,azCol[i] ? azCol[i] : "");
1167           if(i<nArg-1) utf8_printf(p->out, "%s", p->colSeparator);
1168         }
1169         utf8_printf(p->out, "%s", p->rowSeparator);
1170       }
1171       if( azArg==0 ) break;
1172       for(i=0; i<nArg; i++){
1173         output_c_string(p->out, azArg[i] ? azArg[i] : p->nullValue);
1174         if(i<nArg-1) utf8_printf(p->out, "%s", p->colSeparator);
1175       }
1176       utf8_printf(p->out, "%s", p->rowSeparator);
1177       break;
1178     }
1179     case MODE_Csv: {
1180       setBinaryMode(p->out, 1);
1181       if( p->cnt++==0 && p->showHeader ){
1182         for(i=0; i<nArg; i++){
1183           output_csv(p, azCol[i] ? azCol[i] : "", i<nArg-1);
1184         }
1185         utf8_printf(p->out, "%s", p->rowSeparator);
1186       }
1187       if( nArg>0 ){
1188         for(i=0; i<nArg; i++){
1189           output_csv(p, azArg[i], i<nArg-1);
1190         }
1191         utf8_printf(p->out, "%s", p->rowSeparator);
1192       }
1193       setTextMode(p->out, 1);
1194       break;
1195     }
1196     case MODE_Insert: {
1197       p->cnt++;
1198       if( azArg==0 ) break;
1199       utf8_printf(p->out,"INSERT INTO %s",p->zDestTable);
1200       if( p->showHeader ){
1201         raw_printf(p->out,"(");
1202         for(i=0; i<nArg; i++){
1203           char *zSep = i>0 ? ",": "";
1204           utf8_printf(p->out, "%s%s", zSep, azCol[i]);
1205         }
1206         raw_printf(p->out,")");
1207       }
1208       raw_printf(p->out," VALUES(");
1209       for(i=0; i<nArg; i++){
1210         char *zSep = i>0 ? ",": "";
1211         if( (azArg[i]==0) || (aiType && aiType[i]==SQLITE_NULL) ){
1212           utf8_printf(p->out,"%sNULL",zSep);
1213         }else if( aiType && aiType[i]==SQLITE_TEXT ){
1214           if( zSep[0] ) utf8_printf(p->out,"%s",zSep);
1215           output_quoted_string(p->out, azArg[i]);
1216         }else if( aiType && (aiType[i]==SQLITE_INTEGER
1217                              || aiType[i]==SQLITE_FLOAT) ){
1218           utf8_printf(p->out,"%s%s",zSep, azArg[i]);
1219         }else if( aiType && aiType[i]==SQLITE_BLOB && p->pStmt ){
1220           const void *pBlob = sqlite3_column_blob(p->pStmt, i);
1221           int nBlob = sqlite3_column_bytes(p->pStmt, i);
1222           if( zSep[0] ) utf8_printf(p->out,"%s",zSep);
1223           output_hex_blob(p->out, pBlob, nBlob);
1224         }else if( isNumber(azArg[i], 0) ){
1225           utf8_printf(p->out,"%s%s",zSep, azArg[i]);
1226         }else{
1227           if( zSep[0] ) utf8_printf(p->out,"%s",zSep);
1228           output_quoted_string(p->out, azArg[i]);
1229         }
1230       }
1231       raw_printf(p->out,");\n");
1232       break;
1233     }
1234     case MODE_Ascii: {
1235       if( p->cnt++==0 && p->showHeader ){
1236         for(i=0; i<nArg; i++){
1237           if( i>0 ) utf8_printf(p->out, "%s", p->colSeparator);
1238           utf8_printf(p->out,"%s",azCol[i] ? azCol[i] : "");
1239         }
1240         utf8_printf(p->out, "%s", p->rowSeparator);
1241       }
1242       if( azArg==0 ) break;
1243       for(i=0; i<nArg; i++){
1244         if( i>0 ) utf8_printf(p->out, "%s", p->colSeparator);
1245         utf8_printf(p->out,"%s",azArg[i] ? azArg[i] : p->nullValue);
1246       }
1247       utf8_printf(p->out, "%s", p->rowSeparator);
1248       break;
1249     }
1250   }
1251   return 0;
1252 }
1253 
1254 /*
1255 ** This is the callback routine that the SQLite library
1256 ** invokes for each row of a query result.
1257 */
1258 static int callback(void *pArg, int nArg, char **azArg, char **azCol){
1259   /* since we don't have type info, call the shell_callback with a NULL value */
1260   return shell_callback(pArg, nArg, azArg, azCol, NULL);
1261 }
1262 
1263 /*
1264 ** Set the destination table field of the ShellState structure to
1265 ** the name of the table given.  Escape any quote characters in the
1266 ** table name.
1267 */
1268 static void set_table_name(ShellState *p, const char *zName){
1269   int i, n;
1270   int needQuote;
1271   char *z;
1272 
1273   if( p->zDestTable ){
1274     free(p->zDestTable);
1275     p->zDestTable = 0;
1276   }
1277   if( zName==0 ) return;
1278   needQuote = !isalpha((unsigned char)*zName) && *zName!='_';
1279   for(i=n=0; zName[i]; i++, n++){
1280     if( !isalnum((unsigned char)zName[i]) && zName[i]!='_' ){
1281       needQuote = 1;
1282       if( zName[i]=='\'' ) n++;
1283     }
1284   }
1285   if( needQuote ) n += 2;
1286   z = p->zDestTable = malloc( n+1 );
1287   if( z==0 ){
1288     raw_printf(stderr,"Error: out of memory\n");
1289     exit(1);
1290   }
1291   n = 0;
1292   if( needQuote ) z[n++] = '\'';
1293   for(i=0; zName[i]; i++){
1294     z[n++] = zName[i];
1295     if( zName[i]=='\'' ) z[n++] = '\'';
1296   }
1297   if( needQuote ) z[n++] = '\'';
1298   z[n] = 0;
1299 }
1300 
1301 /* zIn is either a pointer to a NULL-terminated string in memory obtained
1302 ** from malloc(), or a NULL pointer. The string pointed to by zAppend is
1303 ** added to zIn, and the result returned in memory obtained from malloc().
1304 ** zIn, if it was not NULL, is freed.
1305 **
1306 ** If the third argument, quote, is not '\0', then it is used as a
1307 ** quote character for zAppend.
1308 */
1309 static char *appendText(char *zIn, char const *zAppend, char quote){
1310   int len;
1311   int i;
1312   int nAppend = strlen30(zAppend);
1313   int nIn = (zIn?strlen30(zIn):0);
1314 
1315   len = nAppend+nIn+1;
1316   if( quote ){
1317     len += 2;
1318     for(i=0; i<nAppend; i++){
1319       if( zAppend[i]==quote ) len++;
1320     }
1321   }
1322 
1323   zIn = (char *)realloc(zIn, len);
1324   if( !zIn ){
1325     return 0;
1326   }
1327 
1328   if( quote ){
1329     char *zCsr = &zIn[nIn];
1330     *zCsr++ = quote;
1331     for(i=0; i<nAppend; i++){
1332       *zCsr++ = zAppend[i];
1333       if( zAppend[i]==quote ) *zCsr++ = quote;
1334     }
1335     *zCsr++ = quote;
1336     *zCsr++ = '\0';
1337     assert( (zCsr-zIn)==len );
1338   }else{
1339     memcpy(&zIn[nIn], zAppend, nAppend);
1340     zIn[len-1] = '\0';
1341   }
1342 
1343   return zIn;
1344 }
1345 
1346 
1347 /*
1348 ** Execute a query statement that will generate SQL output.  Print
1349 ** the result columns, comma-separated, on a line and then add a
1350 ** semicolon terminator to the end of that line.
1351 **
1352 ** If the number of columns is 1 and that column contains text "--"
1353 ** then write the semicolon on a separate line.  That way, if a
1354 ** "--" comment occurs at the end of the statement, the comment
1355 ** won't consume the semicolon terminator.
1356 */
1357 static int run_table_dump_query(
1358   ShellState *p,           /* Query context */
1359   const char *zSelect,     /* SELECT statement to extract content */
1360   const char *zFirstRow    /* Print before first row, if not NULL */
1361 ){
1362   sqlite3_stmt *pSelect;
1363   int rc;
1364   int nResult;
1365   int i;
1366   const char *z;
1367   rc = sqlite3_prepare_v2(p->db, zSelect, -1, &pSelect, 0);
1368   if( rc!=SQLITE_OK || !pSelect ){
1369     utf8_printf(p->out, "/**** ERROR: (%d) %s *****/\n", rc,
1370                 sqlite3_errmsg(p->db));
1371     if( (rc&0xff)!=SQLITE_CORRUPT ) p->nErr++;
1372     return rc;
1373   }
1374   rc = sqlite3_step(pSelect);
1375   nResult = sqlite3_column_count(pSelect);
1376   while( rc==SQLITE_ROW ){
1377     if( zFirstRow ){
1378       utf8_printf(p->out, "%s", zFirstRow);
1379       zFirstRow = 0;
1380     }
1381     z = (const char*)sqlite3_column_text(pSelect, 0);
1382     utf8_printf(p->out, "%s", z);
1383     for(i=1; i<nResult; i++){
1384       utf8_printf(p->out, ",%s", sqlite3_column_text(pSelect, i));
1385     }
1386     if( z==0 ) z = "";
1387     while( z[0] && (z[0]!='-' || z[1]!='-') ) z++;
1388     if( z[0] ){
1389       raw_printf(p->out, "\n;\n");
1390     }else{
1391       raw_printf(p->out, ";\n");
1392     }
1393     rc = sqlite3_step(pSelect);
1394   }
1395   rc = sqlite3_finalize(pSelect);
1396   if( rc!=SQLITE_OK ){
1397     utf8_printf(p->out, "/**** ERROR: (%d) %s *****/\n", rc,
1398                 sqlite3_errmsg(p->db));
1399     if( (rc&0xff)!=SQLITE_CORRUPT ) p->nErr++;
1400   }
1401   return rc;
1402 }
1403 
1404 /*
1405 ** Allocate space and save off current error string.
1406 */
1407 static char *save_err_msg(
1408   sqlite3 *db            /* Database to query */
1409 ){
1410   int nErrMsg = 1+strlen30(sqlite3_errmsg(db));
1411   char *zErrMsg = sqlite3_malloc64(nErrMsg);
1412   if( zErrMsg ){
1413     memcpy(zErrMsg, sqlite3_errmsg(db), nErrMsg);
1414   }
1415   return zErrMsg;
1416 }
1417 
1418 #ifdef __linux__
1419 /*
1420 ** Attempt to display I/O stats on Linux using /proc/PID/io
1421 */
1422 static void displayLinuxIoStats(FILE *out){
1423   FILE *in;
1424   char z[200];
1425   sqlite3_snprintf(sizeof(z), z, "/proc/%d/io", getpid());
1426   in = fopen(z, "rb");
1427   if( in==0 ) return;
1428   while( fgets(z, sizeof(z), in)!=0 ){
1429     static const struct {
1430       const char *zPattern;
1431       const char *zDesc;
1432     } aTrans[] = {
1433       { "rchar: ",                  "Bytes received by read():" },
1434       { "wchar: ",                  "Bytes sent to write():"    },
1435       { "syscr: ",                  "Read() system calls:"      },
1436       { "syscw: ",                  "Write() system calls:"     },
1437       { "read_bytes: ",             "Bytes read from storage:"  },
1438       { "write_bytes: ",            "Bytes written to storage:" },
1439       { "cancelled_write_bytes: ",  "Cancelled write bytes:"    },
1440     };
1441     int i;
1442     for(i=0; i<ArraySize(aTrans); i++){
1443       int n = (int)strlen(aTrans[i].zPattern);
1444       if( strncmp(aTrans[i].zPattern, z, n)==0 ){
1445         raw_printf(out, "%-36s %s", aTrans[i].zDesc, &z[n]);
1446         break;
1447       }
1448     }
1449   }
1450   fclose(in);
1451 }
1452 #endif
1453 
1454 
1455 /*
1456 ** Display memory stats.
1457 */
1458 static int display_stats(
1459   sqlite3 *db,                /* Database to query */
1460   ShellState *pArg,           /* Pointer to ShellState */
1461   int bReset                  /* True to reset the stats */
1462 ){
1463   int iCur;
1464   int iHiwtr;
1465 
1466   if( pArg && pArg->out ){
1467 
1468     iHiwtr = iCur = -1;
1469     sqlite3_status(SQLITE_STATUS_MEMORY_USED, &iCur, &iHiwtr, bReset);
1470     raw_printf(pArg->out,
1471             "Memory Used:                         %d (max %d) bytes\n",
1472             iCur, iHiwtr);
1473     iHiwtr = iCur = -1;
1474     sqlite3_status(SQLITE_STATUS_MALLOC_COUNT, &iCur, &iHiwtr, bReset);
1475     raw_printf(pArg->out, "Number of Outstanding Allocations:   %d (max %d)\n",
1476             iCur, iHiwtr);
1477     if( pArg->shellFlgs & SHFLG_Pagecache ){
1478       iHiwtr = iCur = -1;
1479       sqlite3_status(SQLITE_STATUS_PAGECACHE_USED, &iCur, &iHiwtr, bReset);
1480       raw_printf(pArg->out,
1481               "Number of Pcache Pages Used:         %d (max %d) pages\n",
1482               iCur, iHiwtr);
1483     }
1484     iHiwtr = iCur = -1;
1485     sqlite3_status(SQLITE_STATUS_PAGECACHE_OVERFLOW, &iCur, &iHiwtr, bReset);
1486     raw_printf(pArg->out,
1487             "Number of Pcache Overflow Bytes:     %d (max %d) bytes\n",
1488             iCur, iHiwtr);
1489     if( pArg->shellFlgs & SHFLG_Scratch ){
1490       iHiwtr = iCur = -1;
1491       sqlite3_status(SQLITE_STATUS_SCRATCH_USED, &iCur, &iHiwtr, bReset);
1492       raw_printf(pArg->out,
1493               "Number of Scratch Allocations Used:  %d (max %d)\n",
1494               iCur, iHiwtr);
1495     }
1496     iHiwtr = iCur = -1;
1497     sqlite3_status(SQLITE_STATUS_SCRATCH_OVERFLOW, &iCur, &iHiwtr, bReset);
1498     raw_printf(pArg->out,
1499             "Number of Scratch Overflow Bytes:    %d (max %d) bytes\n",
1500             iCur, iHiwtr);
1501     iHiwtr = iCur = -1;
1502     sqlite3_status(SQLITE_STATUS_MALLOC_SIZE, &iCur, &iHiwtr, bReset);
1503     raw_printf(pArg->out, "Largest Allocation:                  %d bytes\n",
1504             iHiwtr);
1505     iHiwtr = iCur = -1;
1506     sqlite3_status(SQLITE_STATUS_PAGECACHE_SIZE, &iCur, &iHiwtr, bReset);
1507     raw_printf(pArg->out, "Largest Pcache Allocation:           %d bytes\n",
1508             iHiwtr);
1509     iHiwtr = iCur = -1;
1510     sqlite3_status(SQLITE_STATUS_SCRATCH_SIZE, &iCur, &iHiwtr, bReset);
1511     raw_printf(pArg->out, "Largest Scratch Allocation:          %d bytes\n",
1512             iHiwtr);
1513 #ifdef YYTRACKMAXSTACKDEPTH
1514     iHiwtr = iCur = -1;
1515     sqlite3_status(SQLITE_STATUS_PARSER_STACK, &iCur, &iHiwtr, bReset);
1516     raw_printf(pArg->out, "Deepest Parser Stack:                %d (max %d)\n",
1517             iCur, iHiwtr);
1518 #endif
1519   }
1520 
1521   if( pArg && pArg->out && db ){
1522     if( pArg->shellFlgs & SHFLG_Lookaside ){
1523       iHiwtr = iCur = -1;
1524       sqlite3_db_status(db, SQLITE_DBSTATUS_LOOKASIDE_USED,
1525                         &iCur, &iHiwtr, bReset);
1526       raw_printf(pArg->out,
1527               "Lookaside Slots Used:                %d (max %d)\n",
1528               iCur, iHiwtr);
1529       sqlite3_db_status(db, SQLITE_DBSTATUS_LOOKASIDE_HIT,
1530                         &iCur, &iHiwtr, bReset);
1531       raw_printf(pArg->out, "Successful lookaside attempts:       %d\n",
1532               iHiwtr);
1533       sqlite3_db_status(db, SQLITE_DBSTATUS_LOOKASIDE_MISS_SIZE,
1534                         &iCur, &iHiwtr, bReset);
1535       raw_printf(pArg->out, "Lookaside failures due to size:      %d\n",
1536               iHiwtr);
1537       sqlite3_db_status(db, SQLITE_DBSTATUS_LOOKASIDE_MISS_FULL,
1538                         &iCur, &iHiwtr, bReset);
1539       raw_printf(pArg->out, "Lookaside failures due to OOM:       %d\n",
1540               iHiwtr);
1541     }
1542     iHiwtr = iCur = -1;
1543     sqlite3_db_status(db, SQLITE_DBSTATUS_CACHE_USED, &iCur, &iHiwtr, bReset);
1544     raw_printf(pArg->out, "Pager Heap Usage:                    %d bytes\n",
1545             iCur);
1546     iHiwtr = iCur = -1;
1547     sqlite3_db_status(db, SQLITE_DBSTATUS_CACHE_HIT, &iCur, &iHiwtr, 1);
1548     raw_printf(pArg->out, "Page cache hits:                     %d\n", iCur);
1549     iHiwtr = iCur = -1;
1550     sqlite3_db_status(db, SQLITE_DBSTATUS_CACHE_MISS, &iCur, &iHiwtr, 1);
1551     raw_printf(pArg->out, "Page cache misses:                   %d\n", iCur);
1552     iHiwtr = iCur = -1;
1553     sqlite3_db_status(db, SQLITE_DBSTATUS_CACHE_WRITE, &iCur, &iHiwtr, 1);
1554     raw_printf(pArg->out, "Page cache writes:                   %d\n", iCur);
1555     iHiwtr = iCur = -1;
1556     sqlite3_db_status(db, SQLITE_DBSTATUS_SCHEMA_USED, &iCur, &iHiwtr, bReset);
1557     raw_printf(pArg->out, "Schema Heap Usage:                   %d bytes\n",
1558             iCur);
1559     iHiwtr = iCur = -1;
1560     sqlite3_db_status(db, SQLITE_DBSTATUS_STMT_USED, &iCur, &iHiwtr, bReset);
1561     raw_printf(pArg->out, "Statement Heap/Lookaside Usage:      %d bytes\n",
1562             iCur);
1563   }
1564 
1565   if( pArg && pArg->out && db && pArg->pStmt ){
1566     iCur = sqlite3_stmt_status(pArg->pStmt, SQLITE_STMTSTATUS_FULLSCAN_STEP,
1567                                bReset);
1568     raw_printf(pArg->out, "Fullscan Steps:                      %d\n", iCur);
1569     iCur = sqlite3_stmt_status(pArg->pStmt, SQLITE_STMTSTATUS_SORT, bReset);
1570     raw_printf(pArg->out, "Sort Operations:                     %d\n", iCur);
1571     iCur = sqlite3_stmt_status(pArg->pStmt, SQLITE_STMTSTATUS_AUTOINDEX,bReset);
1572     raw_printf(pArg->out, "Autoindex Inserts:                   %d\n", iCur);
1573     iCur = sqlite3_stmt_status(pArg->pStmt, SQLITE_STMTSTATUS_VM_STEP, bReset);
1574     raw_printf(pArg->out, "Virtual Machine Steps:               %d\n", iCur);
1575   }
1576 
1577 #ifdef __linux__
1578   displayLinuxIoStats(pArg->out);
1579 #endif
1580 
1581   /* Do not remove this machine readable comment: extra-stats-output-here */
1582 
1583   return 0;
1584 }
1585 
1586 /*
1587 ** Display scan stats.
1588 */
1589 static void display_scanstats(
1590   sqlite3 *db,                    /* Database to query */
1591   ShellState *pArg                /* Pointer to ShellState */
1592 ){
1593 #ifndef SQLITE_ENABLE_STMT_SCANSTATUS
1594   UNUSED_PARAMETER(db);
1595   UNUSED_PARAMETER(pArg);
1596 #else
1597   int i, k, n, mx;
1598   raw_printf(pArg->out, "-------- scanstats --------\n");
1599   mx = 0;
1600   for(k=0; k<=mx; k++){
1601     double rEstLoop = 1.0;
1602     for(i=n=0; 1; i++){
1603       sqlite3_stmt *p = pArg->pStmt;
1604       sqlite3_int64 nLoop, nVisit;
1605       double rEst;
1606       int iSid;
1607       const char *zExplain;
1608       if( sqlite3_stmt_scanstatus(p, i, SQLITE_SCANSTAT_NLOOP, (void*)&nLoop) ){
1609         break;
1610       }
1611       sqlite3_stmt_scanstatus(p, i, SQLITE_SCANSTAT_SELECTID, (void*)&iSid);
1612       if( iSid>mx ) mx = iSid;
1613       if( iSid!=k ) continue;
1614       if( n==0 ){
1615         rEstLoop = (double)nLoop;
1616         if( k>0 ) raw_printf(pArg->out, "-------- subquery %d -------\n", k);
1617       }
1618       n++;
1619       sqlite3_stmt_scanstatus(p, i, SQLITE_SCANSTAT_NVISIT, (void*)&nVisit);
1620       sqlite3_stmt_scanstatus(p, i, SQLITE_SCANSTAT_EST, (void*)&rEst);
1621       sqlite3_stmt_scanstatus(p, i, SQLITE_SCANSTAT_EXPLAIN, (void*)&zExplain);
1622       utf8_printf(pArg->out, "Loop %2d: %s\n", n, zExplain);
1623       rEstLoop *= rEst;
1624       raw_printf(pArg->out,
1625           "         nLoop=%-8lld nRow=%-8lld estRow=%-8lld estRow/Loop=%-8g\n",
1626           nLoop, nVisit, (sqlite3_int64)(rEstLoop+0.5), rEst
1627       );
1628     }
1629   }
1630   raw_printf(pArg->out, "---------------------------\n");
1631 #endif
1632 }
1633 
1634 /*
1635 ** Parameter azArray points to a zero-terminated array of strings. zStr
1636 ** points to a single nul-terminated string. Return non-zero if zStr
1637 ** is equal, according to strcmp(), to any of the strings in the array.
1638 ** Otherwise, return zero.
1639 */
1640 static int str_in_array(const char *zStr, const char **azArray){
1641   int i;
1642   for(i=0; azArray[i]; i++){
1643     if( 0==strcmp(zStr, azArray[i]) ) return 1;
1644   }
1645   return 0;
1646 }
1647 
1648 /*
1649 ** If compiled statement pSql appears to be an EXPLAIN statement, allocate
1650 ** and populate the ShellState.aiIndent[] array with the number of
1651 ** spaces each opcode should be indented before it is output.
1652 **
1653 ** The indenting rules are:
1654 **
1655 **     * For each "Next", "Prev", "VNext" or "VPrev" instruction, indent
1656 **       all opcodes that occur between the p2 jump destination and the opcode
1657 **       itself by 2 spaces.
1658 **
1659 **     * For each "Goto", if the jump destination is earlier in the program
1660 **       and ends on one of:
1661 **          Yield  SeekGt  SeekLt  RowSetRead  Rewind
1662 **       or if the P1 parameter is one instead of zero,
1663 **       then indent all opcodes between the earlier instruction
1664 **       and "Goto" by 2 spaces.
1665 */
1666 static void explain_data_prepare(ShellState *p, sqlite3_stmt *pSql){
1667   const char *zSql;               /* The text of the SQL statement */
1668   const char *z;                  /* Used to check if this is an EXPLAIN */
1669   int *abYield = 0;               /* True if op is an OP_Yield */
1670   int nAlloc = 0;                 /* Allocated size of p->aiIndent[], abYield */
1671   int iOp;                        /* Index of operation in p->aiIndent[] */
1672 
1673   const char *azNext[] = { "Next", "Prev", "VPrev", "VNext", "SorterNext",
1674                            "NextIfOpen", "PrevIfOpen", 0 };
1675   const char *azYield[] = { "Yield", "SeekLT", "SeekGT", "RowSetRead",
1676                             "Rewind", 0 };
1677   const char *azGoto[] = { "Goto", 0 };
1678 
1679   /* Try to figure out if this is really an EXPLAIN statement. If this
1680   ** cannot be verified, return early.  */
1681   if( sqlite3_column_count(pSql)!=8 ){
1682     p->cMode = p->mode;
1683     return;
1684   }
1685   zSql = sqlite3_sql(pSql);
1686   if( zSql==0 ) return;
1687   for(z=zSql; *z==' ' || *z=='\t' || *z=='\n' || *z=='\f' || *z=='\r'; z++);
1688   if( sqlite3_strnicmp(z, "explain", 7) ){
1689     p->cMode = p->mode;
1690     return;
1691   }
1692 
1693   for(iOp=0; SQLITE_ROW==sqlite3_step(pSql); iOp++){
1694     int i;
1695     int iAddr = sqlite3_column_int(pSql, 0);
1696     const char *zOp = (const char*)sqlite3_column_text(pSql, 1);
1697 
1698     /* Set p2 to the P2 field of the current opcode. Then, assuming that
1699     ** p2 is an instruction address, set variable p2op to the index of that
1700     ** instruction in the aiIndent[] array. p2 and p2op may be different if
1701     ** the current instruction is part of a sub-program generated by an
1702     ** SQL trigger or foreign key.  */
1703     int p2 = sqlite3_column_int(pSql, 3);
1704     int p2op = (p2 + (iOp-iAddr));
1705 
1706     /* Grow the p->aiIndent array as required */
1707     if( iOp>=nAlloc ){
1708       if( iOp==0 ){
1709         /* Do further verfication that this is explain output.  Abort if
1710         ** it is not */
1711         static const char *explainCols[] = {
1712            "addr", "opcode", "p1", "p2", "p3", "p4", "p5", "comment" };
1713         int jj;
1714         for(jj=0; jj<ArraySize(explainCols); jj++){
1715           if( strcmp(sqlite3_column_name(pSql,jj),explainCols[jj])!=0 ){
1716             p->cMode = p->mode;
1717             sqlite3_reset(pSql);
1718             return;
1719           }
1720         }
1721       }
1722       nAlloc += 100;
1723       p->aiIndent = (int*)sqlite3_realloc64(p->aiIndent, nAlloc*sizeof(int));
1724       abYield = (int*)sqlite3_realloc64(abYield, nAlloc*sizeof(int));
1725     }
1726     abYield[iOp] = str_in_array(zOp, azYield);
1727     p->aiIndent[iOp] = 0;
1728     p->nIndent = iOp+1;
1729 
1730     if( str_in_array(zOp, azNext) ){
1731       for(i=p2op; i<iOp; i++) p->aiIndent[i] += 2;
1732     }
1733     if( str_in_array(zOp, azGoto) && p2op<p->nIndent
1734      && (abYield[p2op] || sqlite3_column_int(pSql, 2))
1735     ){
1736       for(i=p2op; i<iOp; i++) p->aiIndent[i] += 2;
1737     }
1738   }
1739 
1740   p->iIndent = 0;
1741   sqlite3_free(abYield);
1742   sqlite3_reset(pSql);
1743 }
1744 
1745 /*
1746 ** Free the array allocated by explain_data_prepare().
1747 */
1748 static void explain_data_delete(ShellState *p){
1749   sqlite3_free(p->aiIndent);
1750   p->aiIndent = 0;
1751   p->nIndent = 0;
1752   p->iIndent = 0;
1753 }
1754 
1755 /*
1756 ** Disable and restore .wheretrace and .selecttrace settings.
1757 */
1758 #if defined(SQLITE_DEBUG) && defined(SQLITE_ENABLE_SELECTTRACE)
1759 extern int sqlite3SelectTrace;
1760 static int savedSelectTrace;
1761 #endif
1762 #if defined(SQLITE_DEBUG) && defined(SQLITE_ENABLE_WHERETRACE)
1763 extern int sqlite3WhereTrace;
1764 static int savedWhereTrace;
1765 #endif
1766 static void disable_debug_trace_modes(void){
1767 #if defined(SQLITE_DEBUG) && defined(SQLITE_ENABLE_SELECTTRACE)
1768   savedSelectTrace = sqlite3SelectTrace;
1769   sqlite3SelectTrace = 0;
1770 #endif
1771 #if defined(SQLITE_DEBUG) && defined(SQLITE_ENABLE_WHERETRACE)
1772   savedWhereTrace = sqlite3WhereTrace;
1773   sqlite3WhereTrace = 0;
1774 #endif
1775 }
1776 static void restore_debug_trace_modes(void){
1777 #if defined(SQLITE_DEBUG) && defined(SQLITE_ENABLE_SELECTTRACE)
1778   sqlite3SelectTrace = savedSelectTrace;
1779 #endif
1780 #if defined(SQLITE_DEBUG) && defined(SQLITE_ENABLE_WHERETRACE)
1781   sqlite3WhereTrace = savedWhereTrace;
1782 #endif
1783 }
1784 
1785 /*
1786 ** Run a prepared statement
1787 */
1788 static void exec_prepared_stmt(
1789   ShellState *pArg,                                /* Pointer to ShellState */
1790   sqlite3_stmt *pStmt,                             /* Statment to run */
1791   int (*xCallback)(void*,int,char**,char**,int*)   /* Callback function */
1792 ){
1793   int rc;
1794 
1795   /* perform the first step.  this will tell us if we
1796   ** have a result set or not and how wide it is.
1797   */
1798   rc = sqlite3_step(pStmt);
1799   /* if we have a result set... */
1800   if( SQLITE_ROW == rc ){
1801     /* if we have a callback... */
1802     if( xCallback ){
1803       /* allocate space for col name ptr, value ptr, and type */
1804       int nCol = sqlite3_column_count(pStmt);
1805       void *pData = sqlite3_malloc64(3*nCol*sizeof(const char*) + 1);
1806       if( !pData ){
1807         rc = SQLITE_NOMEM;
1808       }else{
1809         char **azCols = (char **)pData;      /* Names of result columns */
1810         char **azVals = &azCols[nCol];       /* Results */
1811         int *aiTypes = (int *)&azVals[nCol]; /* Result types */
1812         int i, x;
1813         assert(sizeof(int) <= sizeof(char *));
1814         /* save off ptrs to column names */
1815         for(i=0; i<nCol; i++){
1816           azCols[i] = (char *)sqlite3_column_name(pStmt, i);
1817         }
1818         do{
1819           /* extract the data and data types */
1820           for(i=0; i<nCol; i++){
1821             aiTypes[i] = x = sqlite3_column_type(pStmt, i);
1822             if( x==SQLITE_BLOB && pArg && pArg->cMode==MODE_Insert ){
1823               azVals[i] = "";
1824             }else{
1825               azVals[i] = (char*)sqlite3_column_text(pStmt, i);
1826             }
1827             if( !azVals[i] && (aiTypes[i]!=SQLITE_NULL) ){
1828               rc = SQLITE_NOMEM;
1829               break; /* from for */
1830             }
1831           } /* end for */
1832 
1833           /* if data and types extracted successfully... */
1834           if( SQLITE_ROW == rc ){
1835             /* call the supplied callback with the result row data */
1836             if( xCallback(pArg, nCol, azVals, azCols, aiTypes) ){
1837               rc = SQLITE_ABORT;
1838             }else{
1839               rc = sqlite3_step(pStmt);
1840             }
1841           }
1842         } while( SQLITE_ROW == rc );
1843         sqlite3_free(pData);
1844       }
1845     }else{
1846       do{
1847         rc = sqlite3_step(pStmt);
1848       } while( rc == SQLITE_ROW );
1849     }
1850   }
1851 }
1852 
1853 /*
1854 ** Execute a statement or set of statements.  Print
1855 ** any result rows/columns depending on the current mode
1856 ** set via the supplied callback.
1857 **
1858 ** This is very similar to SQLite's built-in sqlite3_exec()
1859 ** function except it takes a slightly different callback
1860 ** and callback data argument.
1861 */
1862 static int shell_exec(
1863   sqlite3 *db,                              /* An open database */
1864   const char *zSql,                         /* SQL to be evaluated */
1865   int (*xCallback)(void*,int,char**,char**,int*),   /* Callback function */
1866                                             /* (not the same as sqlite3_exec) */
1867   ShellState *pArg,                         /* Pointer to ShellState */
1868   char **pzErrMsg                           /* Error msg written here */
1869 ){
1870   sqlite3_stmt *pStmt = NULL;     /* Statement to execute. */
1871   int rc = SQLITE_OK;             /* Return Code */
1872   int rc2;
1873   const char *zLeftover;          /* Tail of unprocessed SQL */
1874 
1875   if( pzErrMsg ){
1876     *pzErrMsg = NULL;
1877   }
1878 
1879   while( zSql[0] && (SQLITE_OK == rc) ){
1880     static const char *zStmtSql;
1881     rc = sqlite3_prepare_v2(db, zSql, -1, &pStmt, &zLeftover);
1882     if( SQLITE_OK != rc ){
1883       if( pzErrMsg ){
1884         *pzErrMsg = save_err_msg(db);
1885       }
1886     }else{
1887       if( !pStmt ){
1888         /* this happens for a comment or white-space */
1889         zSql = zLeftover;
1890         while( IsSpace(zSql[0]) ) zSql++;
1891         continue;
1892       }
1893       zStmtSql = sqlite3_sql(pStmt);
1894       while( IsSpace(zStmtSql[0]) ) zStmtSql++;
1895 
1896       /* save off the prepared statment handle and reset row count */
1897       if( pArg ){
1898         pArg->pStmt = pStmt;
1899         pArg->cnt = 0;
1900       }
1901 
1902       /* echo the sql statement if echo on */
1903       if( pArg && pArg->echoOn ){
1904         utf8_printf(pArg->out, "%s\n", zStmtSql ? zStmtSql : zSql);
1905       }
1906 
1907       /* Show the EXPLAIN QUERY PLAN if .eqp is on */
1908       if( pArg && pArg->autoEQP && sqlite3_strlike("EXPLAIN%",zStmtSql,0)!=0 ){
1909         sqlite3_stmt *pExplain;
1910         char *zEQP;
1911         disable_debug_trace_modes();
1912         zEQP = sqlite3_mprintf("EXPLAIN QUERY PLAN %s", zStmtSql);
1913         rc = sqlite3_prepare_v2(db, zEQP, -1, &pExplain, 0);
1914         if( rc==SQLITE_OK ){
1915           while( sqlite3_step(pExplain)==SQLITE_ROW ){
1916             raw_printf(pArg->out,"--EQP-- %d,",sqlite3_column_int(pExplain, 0));
1917             raw_printf(pArg->out,"%d,", sqlite3_column_int(pExplain, 1));
1918             raw_printf(pArg->out,"%d,", sqlite3_column_int(pExplain, 2));
1919             utf8_printf(pArg->out,"%s\n", sqlite3_column_text(pExplain, 3));
1920           }
1921         }
1922         sqlite3_finalize(pExplain);
1923         sqlite3_free(zEQP);
1924         if( pArg->autoEQP>=2 ){
1925           /* Also do an EXPLAIN for ".eqp full" mode */
1926           zEQP = sqlite3_mprintf("EXPLAIN %s", zStmtSql);
1927           rc = sqlite3_prepare_v2(db, zEQP, -1, &pExplain, 0);
1928           if( rc==SQLITE_OK ){
1929             pArg->cMode = MODE_Explain;
1930             explain_data_prepare(pArg, pExplain);
1931             exec_prepared_stmt(pArg, pExplain, xCallback);
1932             explain_data_delete(pArg);
1933           }
1934           sqlite3_finalize(pExplain);
1935           sqlite3_free(zEQP);
1936         }
1937         restore_debug_trace_modes();
1938       }
1939 
1940       if( pArg ){
1941         pArg->cMode = pArg->mode;
1942         if( pArg->autoExplain
1943          && sqlite3_column_count(pStmt)==8
1944          && sqlite3_strlike("EXPLAIN%", zStmtSql,0)==0
1945         ){
1946           pArg->cMode = MODE_Explain;
1947         }
1948 
1949         /* If the shell is currently in ".explain" mode, gather the extra
1950         ** data required to add indents to the output.*/
1951         if( pArg->cMode==MODE_Explain ){
1952           explain_data_prepare(pArg, pStmt);
1953         }
1954       }
1955 
1956       exec_prepared_stmt(pArg, pStmt, xCallback);
1957       explain_data_delete(pArg);
1958 
1959       /* print usage stats if stats on */
1960       if( pArg && pArg->statsOn ){
1961         display_stats(db, pArg, 0);
1962       }
1963 
1964       /* print loop-counters if required */
1965       if( pArg && pArg->scanstatsOn ){
1966         display_scanstats(db, pArg);
1967       }
1968 
1969       /* Finalize the statement just executed. If this fails, save a
1970       ** copy of the error message. Otherwise, set zSql to point to the
1971       ** next statement to execute. */
1972       rc2 = sqlite3_finalize(pStmt);
1973       if( rc!=SQLITE_NOMEM ) rc = rc2;
1974       if( rc==SQLITE_OK ){
1975         zSql = zLeftover;
1976         while( IsSpace(zSql[0]) ) zSql++;
1977       }else if( pzErrMsg ){
1978         *pzErrMsg = save_err_msg(db);
1979       }
1980 
1981       /* clear saved stmt handle */
1982       if( pArg ){
1983         pArg->pStmt = NULL;
1984       }
1985     }
1986   } /* end while */
1987 
1988   return rc;
1989 }
1990 
1991 
1992 /*
1993 ** This is a different callback routine used for dumping the database.
1994 ** Each row received by this callback consists of a table name,
1995 ** the table type ("index" or "table") and SQL to create the table.
1996 ** This routine should print text sufficient to recreate the table.
1997 */
1998 static int dump_callback(void *pArg, int nArg, char **azArg, char **azCol){
1999   int rc;
2000   const char *zTable;
2001   const char *zType;
2002   const char *zSql;
2003   const char *zPrepStmt = 0;
2004   ShellState *p = (ShellState *)pArg;
2005 
2006   UNUSED_PARAMETER(azCol);
2007   if( nArg!=3 ) return 1;
2008   zTable = azArg[0];
2009   zType = azArg[1];
2010   zSql = azArg[2];
2011 
2012   if( strcmp(zTable, "sqlite_sequence")==0 ){
2013     zPrepStmt = "DELETE FROM sqlite_sequence;\n";
2014   }else if( sqlite3_strglob("sqlite_stat?", zTable)==0 ){
2015     raw_printf(p->out, "ANALYZE sqlite_master;\n");
2016   }else if( strncmp(zTable, "sqlite_", 7)==0 ){
2017     return 0;
2018   }else if( strncmp(zSql, "CREATE VIRTUAL TABLE", 20)==0 ){
2019     char *zIns;
2020     if( !p->writableSchema ){
2021       raw_printf(p->out, "PRAGMA writable_schema=ON;\n");
2022       p->writableSchema = 1;
2023     }
2024     zIns = sqlite3_mprintf(
2025        "INSERT INTO sqlite_master(type,name,tbl_name,rootpage,sql)"
2026        "VALUES('table','%q','%q',0,'%q');",
2027        zTable, zTable, zSql);
2028     utf8_printf(p->out, "%s\n", zIns);
2029     sqlite3_free(zIns);
2030     return 0;
2031   }else{
2032     utf8_printf(p->out, "%s;\n", zSql);
2033   }
2034 
2035   if( strcmp(zType, "table")==0 ){
2036     sqlite3_stmt *pTableInfo = 0;
2037     char *zSelect = 0;
2038     char *zTableInfo = 0;
2039     char *zTmp = 0;
2040     int nRow = 0;
2041 
2042     zTableInfo = appendText(zTableInfo, "PRAGMA table_info(", 0);
2043     zTableInfo = appendText(zTableInfo, zTable, '"');
2044     zTableInfo = appendText(zTableInfo, ");", 0);
2045 
2046     rc = sqlite3_prepare_v2(p->db, zTableInfo, -1, &pTableInfo, 0);
2047     free(zTableInfo);
2048     if( rc!=SQLITE_OK || !pTableInfo ){
2049       return 1;
2050     }
2051 
2052     zSelect = appendText(zSelect, "SELECT 'INSERT INTO ' || ", 0);
2053     /* Always quote the table name, even if it appears to be pure ascii,
2054     ** in case it is a keyword. Ex:  INSERT INTO "table" ... */
2055     zTmp = appendText(zTmp, zTable, '"');
2056     if( zTmp ){
2057       zSelect = appendText(zSelect, zTmp, '\'');
2058       free(zTmp);
2059     }
2060     zSelect = appendText(zSelect, " || ' VALUES(' || ", 0);
2061     rc = sqlite3_step(pTableInfo);
2062     while( rc==SQLITE_ROW ){
2063       const char *zText = (const char *)sqlite3_column_text(pTableInfo, 1);
2064       zSelect = appendText(zSelect, "quote(", 0);
2065       zSelect = appendText(zSelect, zText, '"');
2066       rc = sqlite3_step(pTableInfo);
2067       if( rc==SQLITE_ROW ){
2068         zSelect = appendText(zSelect, "), ", 0);
2069       }else{
2070         zSelect = appendText(zSelect, ") ", 0);
2071       }
2072       nRow++;
2073     }
2074     rc = sqlite3_finalize(pTableInfo);
2075     if( rc!=SQLITE_OK || nRow==0 ){
2076       free(zSelect);
2077       return 1;
2078     }
2079     zSelect = appendText(zSelect, "|| ')' FROM  ", 0);
2080     zSelect = appendText(zSelect, zTable, '"');
2081 
2082     rc = run_table_dump_query(p, zSelect, zPrepStmt);
2083     if( rc==SQLITE_CORRUPT ){
2084       zSelect = appendText(zSelect, " ORDER BY rowid DESC", 0);
2085       run_table_dump_query(p, zSelect, 0);
2086     }
2087     free(zSelect);
2088   }
2089   return 0;
2090 }
2091 
2092 /*
2093 ** Run zQuery.  Use dump_callback() as the callback routine so that
2094 ** the contents of the query are output as SQL statements.
2095 **
2096 ** If we get a SQLITE_CORRUPT error, rerun the query after appending
2097 ** "ORDER BY rowid DESC" to the end.
2098 */
2099 static int run_schema_dump_query(
2100   ShellState *p,
2101   const char *zQuery
2102 ){
2103   int rc;
2104   char *zErr = 0;
2105   rc = sqlite3_exec(p->db, zQuery, dump_callback, p, &zErr);
2106   if( rc==SQLITE_CORRUPT ){
2107     char *zQ2;
2108     int len = strlen30(zQuery);
2109     raw_printf(p->out, "/****** CORRUPTION ERROR *******/\n");
2110     if( zErr ){
2111       utf8_printf(p->out, "/****** %s ******/\n", zErr);
2112       sqlite3_free(zErr);
2113       zErr = 0;
2114     }
2115     zQ2 = malloc( len+100 );
2116     if( zQ2==0 ) return rc;
2117     sqlite3_snprintf(len+100, zQ2, "%s ORDER BY rowid DESC", zQuery);
2118     rc = sqlite3_exec(p->db, zQ2, dump_callback, p, &zErr);
2119     if( rc ){
2120       utf8_printf(p->out, "/****** ERROR: %s ******/\n", zErr);
2121     }else{
2122       rc = SQLITE_CORRUPT;
2123     }
2124     sqlite3_free(zErr);
2125     free(zQ2);
2126   }
2127   return rc;
2128 }
2129 
2130 /*
2131 ** Text of a help message
2132 */
2133 static char zHelp[] =
2134   ".auth ON|OFF           Show authorizer callbacks\n"
2135   ".backup ?DB? FILE      Backup DB (default \"main\") to FILE\n"
2136   ".bail on|off           Stop after hitting an error.  Default OFF\n"
2137   ".binary on|off         Turn binary output on or off.  Default OFF\n"
2138   ".changes on|off        Show number of rows changed by SQL\n"
2139   ".clone NEWDB           Clone data into NEWDB from the existing database\n"
2140   ".databases             List names and files of attached databases\n"
2141   ".dbinfo ?DB?           Show status information about the database\n"
2142   ".dump ?TABLE? ...      Dump the database in an SQL text format\n"
2143   "                         If TABLE specified, only dump tables matching\n"
2144   "                         LIKE pattern TABLE.\n"
2145   ".echo on|off           Turn command echo on or off\n"
2146   ".eqp on|off|full       Enable or disable automatic EXPLAIN QUERY PLAN\n"
2147   ".exit                  Exit this program\n"
2148   ".explain ?on|off|auto? Turn EXPLAIN output mode on or off or to automatic\n"
2149   ".fullschema ?--indent? Show schema and the content of sqlite_stat tables\n"
2150   ".headers on|off        Turn display of headers on or off\n"
2151   ".help                  Show this message\n"
2152   ".import FILE TABLE     Import data from FILE into TABLE\n"
2153   ".indexes ?TABLE?       Show names of all indexes\n"
2154   "                         If TABLE specified, only show indexes for tables\n"
2155   "                         matching LIKE pattern TABLE.\n"
2156 #ifdef SQLITE_ENABLE_IOTRACE
2157   ".iotrace FILE          Enable I/O diagnostic logging to FILE\n"
2158 #endif
2159   ".limit ?LIMIT? ?VAL?   Display or change the value of an SQLITE_LIMIT\n"
2160 #ifndef SQLITE_OMIT_LOAD_EXTENSION
2161   ".load FILE ?ENTRY?     Load an extension library\n"
2162 #endif
2163   ".log FILE|off          Turn logging on or off.  FILE can be stderr/stdout\n"
2164   ".mode MODE ?TABLE?     Set output mode where MODE is one of:\n"
2165   "                         ascii    Columns/rows delimited by 0x1F and 0x1E\n"
2166   "                         csv      Comma-separated values\n"
2167   "                         column   Left-aligned columns.  (See .width)\n"
2168   "                         html     HTML <table> code\n"
2169   "                         insert   SQL insert statements for TABLE\n"
2170   "                         line     One value per line\n"
2171   "                         list     Values delimited by .separator strings\n"
2172   "                         tabs     Tab-separated values\n"
2173   "                         tcl      TCL list elements\n"
2174   ".nullvalue STRING      Use STRING in place of NULL values\n"
2175   ".once FILENAME         Output for the next SQL command only to FILENAME\n"
2176   ".open ?FILENAME?       Close existing database and reopen FILENAME\n"
2177   ".output ?FILENAME?     Send output to FILENAME or stdout\n"
2178   ".print STRING...       Print literal STRING\n"
2179   ".prompt MAIN CONTINUE  Replace the standard prompts\n"
2180   ".quit                  Exit this program\n"
2181   ".read FILENAME         Execute SQL in FILENAME\n"
2182   ".restore ?DB? FILE     Restore content of DB (default \"main\") from FILE\n"
2183   ".save FILE             Write in-memory database into FILE\n"
2184   ".scanstats on|off      Turn sqlite3_stmt_scanstatus() metrics on or off\n"
2185   ".schema ?PATTERN?      Show the CREATE statements matching PATTERN\n"
2186   "                          Add --indent for pretty-printing\n"
2187   ".separator COL ?ROW?   Change the column separator and optionally the row\n"
2188   "                         separator for both the output mode and .import\n"
2189 #if defined(SQLITE_ENABLE_SESSION)
2190   ".session CMD ...       Create or control sessions\n"
2191 #endif
2192   ".shell CMD ARGS...     Run CMD ARGS... in a system shell\n"
2193   ".show                  Show the current values for various settings\n"
2194   ".stats ?on|off?        Show stats or turn stats on or off\n"
2195   ".system CMD ARGS...    Run CMD ARGS... in a system shell\n"
2196   ".tables ?TABLE?        List names of tables\n"
2197   "                         If TABLE specified, only list tables matching\n"
2198   "                         LIKE pattern TABLE.\n"
2199   ".timeout MS            Try opening locked tables for MS milliseconds\n"
2200   ".timer on|off          Turn SQL timer on or off\n"
2201   ".trace FILE|off        Output each SQL statement as it is run\n"
2202   ".vfsinfo ?AUX?         Information about the top-level VFS\n"
2203   ".vfslist               List all available VFSes\n"
2204   ".vfsname ?AUX?         Print the name of the VFS stack\n"
2205   ".width NUM1 NUM2 ...   Set column widths for \"column\" mode\n"
2206   "                         Negative values right-justify\n"
2207 ;
2208 
2209 #if defined(SQLITE_ENABLE_SESSION)
2210 /*
2211 ** Print help information for the ".sessions" command
2212 */
2213 void session_help(ShellState *p){
2214   raw_printf(p->out,
2215     ".session ?NAME? SUBCOMMAND ?ARGS...?\n"
2216     "If ?NAME? is omitted, the first defined session is used.\n"
2217     "Subcommands:\n"
2218     "   attach TABLE             Attach TABLE\n"
2219     "   changeset FILE           Write a changeset into FILE\n"
2220     "   close                    Close one session\n"
2221     "   enable ?BOOLEAN?         Set or query the enable bit\n"
2222     "   filter GLOB...           Reject tables matching GLOBs\n"
2223     "   indirect ?BOOLEAN?       Mark or query the indirect status\n"
2224     "   isempty                  Query whether the session is empty\n"
2225     "   list                     List currently open session names\n"
2226     "   open DB NAME             Open a new session on DB\n"
2227     "   patchset FILE            Write a patchset into FILE\n"
2228   );
2229 }
2230 #endif
2231 
2232 
2233 /* Forward reference */
2234 static int process_input(ShellState *p, FILE *in);
2235 /*
2236 ** Implementation of the "readfile(X)" SQL function.  The entire content
2237 ** of the file named X is read and returned as a BLOB.  NULL is returned
2238 ** if the file does not exist or is unreadable.
2239 */
2240 static void readfileFunc(
2241   sqlite3_context *context,
2242   int argc,
2243   sqlite3_value **argv
2244 ){
2245   const char *zName;
2246   FILE *in;
2247   long nIn;
2248   void *pBuf;
2249 
2250   UNUSED_PARAMETER(argc);
2251   zName = (const char*)sqlite3_value_text(argv[0]);
2252   if( zName==0 ) return;
2253   in = fopen(zName, "rb");
2254   if( in==0 ) return;
2255   fseek(in, 0, SEEK_END);
2256   nIn = ftell(in);
2257   rewind(in);
2258   pBuf = sqlite3_malloc64( nIn );
2259   if( pBuf && 1==fread(pBuf, nIn, 1, in) ){
2260     sqlite3_result_blob(context, pBuf, nIn, sqlite3_free);
2261   }else{
2262     sqlite3_free(pBuf);
2263   }
2264   fclose(in);
2265 }
2266 
2267 /*
2268 ** Implementation of the "writefile(X,Y)" SQL function.  The argument Y
2269 ** is written into file X.  The number of bytes written is returned.  Or
2270 ** NULL is returned if something goes wrong, such as being unable to open
2271 ** file X for writing.
2272 */
2273 static void writefileFunc(
2274   sqlite3_context *context,
2275   int argc,
2276   sqlite3_value **argv
2277 ){
2278   FILE *out;
2279   const char *z;
2280   sqlite3_int64 rc;
2281   const char *zFile;
2282 
2283   UNUSED_PARAMETER(argc);
2284   zFile = (const char*)sqlite3_value_text(argv[0]);
2285   if( zFile==0 ) return;
2286   out = fopen(zFile, "wb");
2287   if( out==0 ) return;
2288   z = (const char*)sqlite3_value_blob(argv[1]);
2289   if( z==0 ){
2290     rc = 0;
2291   }else{
2292     rc = fwrite(z, 1, sqlite3_value_bytes(argv[1]), out);
2293   }
2294   fclose(out);
2295   sqlite3_result_int64(context, rc);
2296 }
2297 
2298 #if defined(SQLITE_ENABLE_SESSION)
2299 /*
2300 ** Close a single OpenSession object and release all of its associated
2301 ** resources.
2302 */
2303 static void session_close(OpenSession *pSession){
2304   int i;
2305   sqlite3session_delete(pSession->p);
2306   sqlite3_free(pSession->zName);
2307   for(i=0; i<pSession->nFilter; i++){
2308     sqlite3_free(pSession->azFilter[i]);
2309   }
2310   sqlite3_free(pSession->azFilter);
2311   memset(pSession, 0, sizeof(OpenSession));
2312 }
2313 #endif
2314 
2315 /*
2316 ** Close all OpenSession objects and release all associated resources.
2317 */
2318 #if defined(SQLITE_ENABLE_SESSION)
2319 static void session_close_all(ShellState *p){
2320   int i;
2321   for(i=0; i<p->nSession; i++){
2322     session_close(&p->aSession[i]);
2323   }
2324   p->nSession = 0;
2325 }
2326 #else
2327 # define session_close_all(X)
2328 #endif
2329 
2330 /*
2331 ** Implementation of the xFilter function for an open session.  Omit
2332 ** any tables named by ".session filter" but let all other table through.
2333 */
2334 #if defined(SQLITE_ENABLE_SESSION)
2335 static int session_filter(void *pCtx, const char *zTab){
2336   OpenSession *pSession = (OpenSession*)pCtx;
2337   int i;
2338   for(i=0; i<pSession->nFilter; i++){
2339     if( sqlite3_strglob(pSession->azFilter[i], zTab)==0 ) return 0;
2340   }
2341   return 1;
2342 }
2343 #endif
2344 
2345 /*
2346 ** Make sure the database is open.  If it is not, then open it.  If
2347 ** the database fails to open, print an error message and exit.
2348 */
2349 static void open_db(ShellState *p, int keepAlive){
2350   if( p->db==0 ){
2351     sqlite3_initialize();
2352     sqlite3_open(p->zDbFilename, &p->db);
2353     globalDb = p->db;
2354     if( p->db && sqlite3_errcode(p->db)==SQLITE_OK ){
2355       sqlite3_create_function(p->db, "shellstatic", 0, SQLITE_UTF8, 0,
2356           shellstaticFunc, 0, 0);
2357     }
2358     if( p->db==0 || SQLITE_OK!=sqlite3_errcode(p->db) ){
2359       utf8_printf(stderr,"Error: unable to open database \"%s\": %s\n",
2360           p->zDbFilename, sqlite3_errmsg(p->db));
2361       if( keepAlive ) return;
2362       exit(1);
2363     }
2364 #ifndef SQLITE_OMIT_LOAD_EXTENSION
2365     sqlite3_enable_load_extension(p->db, 1);
2366 #endif
2367     sqlite3_create_function(p->db, "readfile", 1, SQLITE_UTF8, 0,
2368                             readfileFunc, 0, 0);
2369     sqlite3_create_function(p->db, "writefile", 2, SQLITE_UTF8, 0,
2370                             writefileFunc, 0, 0);
2371   }
2372 }
2373 
2374 /*
2375 ** Do C-language style dequoting.
2376 **
2377 **    \a    -> alarm
2378 **    \b    -> backspace
2379 **    \t    -> tab
2380 **    \n    -> newline
2381 **    \v    -> vertical tab
2382 **    \f    -> form feed
2383 **    \r    -> carriage return
2384 **    \s    -> space
2385 **    \"    -> "
2386 **    \'    -> '
2387 **    \\    -> backslash
2388 **    \NNN  -> ascii character NNN in octal
2389 */
2390 static void resolve_backslashes(char *z){
2391   int i, j;
2392   char c;
2393   while( *z && *z!='\\' ) z++;
2394   for(i=j=0; (c = z[i])!=0; i++, j++){
2395     if( c=='\\' && z[i+1]!=0 ){
2396       c = z[++i];
2397       if( c=='a' ){
2398         c = '\a';
2399       }else if( c=='b' ){
2400         c = '\b';
2401       }else if( c=='t' ){
2402         c = '\t';
2403       }else if( c=='n' ){
2404         c = '\n';
2405       }else if( c=='v' ){
2406         c = '\v';
2407       }else if( c=='f' ){
2408         c = '\f';
2409       }else if( c=='r' ){
2410         c = '\r';
2411       }else if( c=='"' ){
2412         c = '"';
2413       }else if( c=='\'' ){
2414         c = '\'';
2415       }else if( c=='\\' ){
2416         c = '\\';
2417       }else if( c>='0' && c<='7' ){
2418         c -= '0';
2419         if( z[i+1]>='0' && z[i+1]<='7' ){
2420           i++;
2421           c = (c<<3) + z[i] - '0';
2422           if( z[i+1]>='0' && z[i+1]<='7' ){
2423             i++;
2424             c = (c<<3) + z[i] - '0';
2425           }
2426         }
2427       }
2428     }
2429     z[j] = c;
2430   }
2431   if( j<i ) z[j] = 0;
2432 }
2433 
2434 /*
2435 ** Return the value of a hexadecimal digit.  Return -1 if the input
2436 ** is not a hex digit.
2437 */
2438 static int hexDigitValue(char c){
2439   if( c>='0' && c<='9' ) return c - '0';
2440   if( c>='a' && c<='f' ) return c - 'a' + 10;
2441   if( c>='A' && c<='F' ) return c - 'A' + 10;
2442   return -1;
2443 }
2444 
2445 /*
2446 ** Interpret zArg as an integer value, possibly with suffixes.
2447 */
2448 static sqlite3_int64 integerValue(const char *zArg){
2449   sqlite3_int64 v = 0;
2450   static const struct { char *zSuffix; int iMult; } aMult[] = {
2451     { "KiB", 1024 },
2452     { "MiB", 1024*1024 },
2453     { "GiB", 1024*1024*1024 },
2454     { "KB",  1000 },
2455     { "MB",  1000000 },
2456     { "GB",  1000000000 },
2457     { "K",   1000 },
2458     { "M",   1000000 },
2459     { "G",   1000000000 },
2460   };
2461   int i;
2462   int isNeg = 0;
2463   if( zArg[0]=='-' ){
2464     isNeg = 1;
2465     zArg++;
2466   }else if( zArg[0]=='+' ){
2467     zArg++;
2468   }
2469   if( zArg[0]=='0' && zArg[1]=='x' ){
2470     int x;
2471     zArg += 2;
2472     while( (x = hexDigitValue(zArg[0]))>=0 ){
2473       v = (v<<4) + x;
2474       zArg++;
2475     }
2476   }else{
2477     while( IsDigit(zArg[0]) ){
2478       v = v*10 + zArg[0] - '0';
2479       zArg++;
2480     }
2481   }
2482   for(i=0; i<ArraySize(aMult); i++){
2483     if( sqlite3_stricmp(aMult[i].zSuffix, zArg)==0 ){
2484       v *= aMult[i].iMult;
2485       break;
2486     }
2487   }
2488   return isNeg? -v : v;
2489 }
2490 
2491 /*
2492 ** Interpret zArg as either an integer or a boolean value.  Return 1 or 0
2493 ** for TRUE and FALSE.  Return the integer value if appropriate.
2494 */
2495 static int booleanValue(char *zArg){
2496   int i;
2497   if( zArg[0]=='0' && zArg[1]=='x' ){
2498     for(i=2; hexDigitValue(zArg[i])>=0; i++){}
2499   }else{
2500     for(i=0; zArg[i]>='0' && zArg[i]<='9'; i++){}
2501   }
2502   if( i>0 && zArg[i]==0 ) return (int)(integerValue(zArg) & 0xffffffff);
2503   if( sqlite3_stricmp(zArg, "on")==0 || sqlite3_stricmp(zArg,"yes")==0 ){
2504     return 1;
2505   }
2506   if( sqlite3_stricmp(zArg, "off")==0 || sqlite3_stricmp(zArg,"no")==0 ){
2507     return 0;
2508   }
2509   utf8_printf(stderr, "ERROR: Not a boolean value: \"%s\". Assuming \"no\".\n",
2510           zArg);
2511   return 0;
2512 }
2513 
2514 /*
2515 ** Close an output file, assuming it is not stderr or stdout
2516 */
2517 static void output_file_close(FILE *f){
2518   if( f && f!=stdout && f!=stderr ) fclose(f);
2519 }
2520 
2521 /*
2522 ** Try to open an output file.   The names "stdout" and "stderr" are
2523 ** recognized and do the right thing.  NULL is returned if the output
2524 ** filename is "off".
2525 */
2526 static FILE *output_file_open(const char *zFile){
2527   FILE *f;
2528   if( strcmp(zFile,"stdout")==0 ){
2529     f = stdout;
2530   }else if( strcmp(zFile, "stderr")==0 ){
2531     f = stderr;
2532   }else if( strcmp(zFile, "off")==0 ){
2533     f = 0;
2534   }else{
2535     f = fopen(zFile, "wb");
2536     if( f==0 ){
2537       utf8_printf(stderr, "Error: cannot open \"%s\"\n", zFile);
2538     }
2539   }
2540   return f;
2541 }
2542 
2543 /*
2544 ** A routine for handling output from sqlite3_trace().
2545 */
2546 static int sql_trace_callback(
2547   unsigned mType,
2548   void *pArg,
2549   void *pP,
2550   void *pX
2551 ){
2552   FILE *f = (FILE*)pArg;
2553   UNUSED_PARAMETER(mType);
2554   UNUSED_PARAMETER(pP);
2555   if( f ){
2556     const char *z = (const char*)pX;
2557     int i = (int)strlen(z);
2558     while( i>0 && z[i-1]==';' ){ i--; }
2559     utf8_printf(f, "%.*s;\n", i, z);
2560   }
2561   return 0;
2562 }
2563 
2564 /*
2565 ** A no-op routine that runs with the ".breakpoint" doc-command.  This is
2566 ** a useful spot to set a debugger breakpoint.
2567 */
2568 static void test_breakpoint(void){
2569   static int nCall = 0;
2570   nCall++;
2571 }
2572 
2573 /*
2574 ** An object used to read a CSV and other files for import.
2575 */
2576 typedef struct ImportCtx ImportCtx;
2577 struct ImportCtx {
2578   const char *zFile;  /* Name of the input file */
2579   FILE *in;           /* Read the CSV text from this input stream */
2580   char *z;            /* Accumulated text for a field */
2581   int n;              /* Number of bytes in z */
2582   int nAlloc;         /* Space allocated for z[] */
2583   int nLine;          /* Current line number */
2584   int cTerm;          /* Character that terminated the most recent field */
2585   int cColSep;        /* The column separator character.  (Usually ",") */
2586   int cRowSep;        /* The row separator character.  (Usually "\n") */
2587 };
2588 
2589 /* Append a single byte to z[] */
2590 static void import_append_char(ImportCtx *p, int c){
2591   if( p->n+1>=p->nAlloc ){
2592     p->nAlloc += p->nAlloc + 100;
2593     p->z = sqlite3_realloc64(p->z, p->nAlloc);
2594     if( p->z==0 ){
2595       raw_printf(stderr, "out of memory\n");
2596       exit(1);
2597     }
2598   }
2599   p->z[p->n++] = (char)c;
2600 }
2601 
2602 /* Read a single field of CSV text.  Compatible with rfc4180 and extended
2603 ** with the option of having a separator other than ",".
2604 **
2605 **   +  Input comes from p->in.
2606 **   +  Store results in p->z of length p->n.  Space to hold p->z comes
2607 **      from sqlite3_malloc64().
2608 **   +  Use p->cSep as the column separator.  The default is ",".
2609 **   +  Use p->rSep as the row separator.  The default is "\n".
2610 **   +  Keep track of the line number in p->nLine.
2611 **   +  Store the character that terminates the field in p->cTerm.  Store
2612 **      EOF on end-of-file.
2613 **   +  Report syntax errors on stderr
2614 */
2615 static char *SQLITE_CDECL csv_read_one_field(ImportCtx *p){
2616   int c;
2617   int cSep = p->cColSep;
2618   int rSep = p->cRowSep;
2619   p->n = 0;
2620   c = fgetc(p->in);
2621   if( c==EOF || seenInterrupt ){
2622     p->cTerm = EOF;
2623     return 0;
2624   }
2625   if( c=='"' ){
2626     int pc, ppc;
2627     int startLine = p->nLine;
2628     int cQuote = c;
2629     pc = ppc = 0;
2630     while( 1 ){
2631       c = fgetc(p->in);
2632       if( c==rSep ) p->nLine++;
2633       if( c==cQuote ){
2634         if( pc==cQuote ){
2635           pc = 0;
2636           continue;
2637         }
2638       }
2639       if( (c==cSep && pc==cQuote)
2640        || (c==rSep && pc==cQuote)
2641        || (c==rSep && pc=='\r' && ppc==cQuote)
2642        || (c==EOF && pc==cQuote)
2643       ){
2644         do{ p->n--; }while( p->z[p->n]!=cQuote );
2645         p->cTerm = c;
2646         break;
2647       }
2648       if( pc==cQuote && c!='\r' ){
2649         utf8_printf(stderr, "%s:%d: unescaped %c character\n",
2650                 p->zFile, p->nLine, cQuote);
2651       }
2652       if( c==EOF ){
2653         utf8_printf(stderr, "%s:%d: unterminated %c-quoted field\n",
2654                 p->zFile, startLine, cQuote);
2655         p->cTerm = c;
2656         break;
2657       }
2658       import_append_char(p, c);
2659       ppc = pc;
2660       pc = c;
2661     }
2662   }else{
2663     while( c!=EOF && c!=cSep && c!=rSep ){
2664       import_append_char(p, c);
2665       c = fgetc(p->in);
2666     }
2667     if( c==rSep ){
2668       p->nLine++;
2669       if( p->n>0 && p->z[p->n-1]=='\r' ) p->n--;
2670     }
2671     p->cTerm = c;
2672   }
2673   if( p->z ) p->z[p->n] = 0;
2674   return p->z;
2675 }
2676 
2677 /* Read a single field of ASCII delimited text.
2678 **
2679 **   +  Input comes from p->in.
2680 **   +  Store results in p->z of length p->n.  Space to hold p->z comes
2681 **      from sqlite3_malloc64().
2682 **   +  Use p->cSep as the column separator.  The default is "\x1F".
2683 **   +  Use p->rSep as the row separator.  The default is "\x1E".
2684 **   +  Keep track of the row number in p->nLine.
2685 **   +  Store the character that terminates the field in p->cTerm.  Store
2686 **      EOF on end-of-file.
2687 **   +  Report syntax errors on stderr
2688 */
2689 static char *SQLITE_CDECL ascii_read_one_field(ImportCtx *p){
2690   int c;
2691   int cSep = p->cColSep;
2692   int rSep = p->cRowSep;
2693   p->n = 0;
2694   c = fgetc(p->in);
2695   if( c==EOF || seenInterrupt ){
2696     p->cTerm = EOF;
2697     return 0;
2698   }
2699   while( c!=EOF && c!=cSep && c!=rSep ){
2700     import_append_char(p, c);
2701     c = fgetc(p->in);
2702   }
2703   if( c==rSep ){
2704     p->nLine++;
2705   }
2706   p->cTerm = c;
2707   if( p->z ) p->z[p->n] = 0;
2708   return p->z;
2709 }
2710 
2711 /*
2712 ** Try to transfer data for table zTable.  If an error is seen while
2713 ** moving forward, try to go backwards.  The backwards movement won't
2714 ** work for WITHOUT ROWID tables.
2715 */
2716 static void tryToCloneData(
2717   ShellState *p,
2718   sqlite3 *newDb,
2719   const char *zTable
2720 ){
2721   sqlite3_stmt *pQuery = 0;
2722   sqlite3_stmt *pInsert = 0;
2723   char *zQuery = 0;
2724   char *zInsert = 0;
2725   int rc;
2726   int i, j, n;
2727   int nTable = (int)strlen(zTable);
2728   int k = 0;
2729   int cnt = 0;
2730   const int spinRate = 10000;
2731 
2732   zQuery = sqlite3_mprintf("SELECT * FROM \"%w\"", zTable);
2733   rc = sqlite3_prepare_v2(p->db, zQuery, -1, &pQuery, 0);
2734   if( rc ){
2735     utf8_printf(stderr, "Error %d: %s on [%s]\n",
2736             sqlite3_extended_errcode(p->db), sqlite3_errmsg(p->db),
2737             zQuery);
2738     goto end_data_xfer;
2739   }
2740   n = sqlite3_column_count(pQuery);
2741   zInsert = sqlite3_malloc64(200 + nTable + n*3);
2742   if( zInsert==0 ){
2743     raw_printf(stderr, "out of memory\n");
2744     goto end_data_xfer;
2745   }
2746   sqlite3_snprintf(200+nTable,zInsert,
2747                    "INSERT OR IGNORE INTO \"%s\" VALUES(?", zTable);
2748   i = (int)strlen(zInsert);
2749   for(j=1; j<n; j++){
2750     memcpy(zInsert+i, ",?", 2);
2751     i += 2;
2752   }
2753   memcpy(zInsert+i, ");", 3);
2754   rc = sqlite3_prepare_v2(newDb, zInsert, -1, &pInsert, 0);
2755   if( rc ){
2756     utf8_printf(stderr, "Error %d: %s on [%s]\n",
2757             sqlite3_extended_errcode(newDb), sqlite3_errmsg(newDb),
2758             zQuery);
2759     goto end_data_xfer;
2760   }
2761   for(k=0; k<2; k++){
2762     while( (rc = sqlite3_step(pQuery))==SQLITE_ROW ){
2763       for(i=0; i<n; i++){
2764         switch( sqlite3_column_type(pQuery, i) ){
2765           case SQLITE_NULL: {
2766             sqlite3_bind_null(pInsert, i+1);
2767             break;
2768           }
2769           case SQLITE_INTEGER: {
2770             sqlite3_bind_int64(pInsert, i+1, sqlite3_column_int64(pQuery,i));
2771             break;
2772           }
2773           case SQLITE_FLOAT: {
2774             sqlite3_bind_double(pInsert, i+1, sqlite3_column_double(pQuery,i));
2775             break;
2776           }
2777           case SQLITE_TEXT: {
2778             sqlite3_bind_text(pInsert, i+1,
2779                              (const char*)sqlite3_column_text(pQuery,i),
2780                              -1, SQLITE_STATIC);
2781             break;
2782           }
2783           case SQLITE_BLOB: {
2784             sqlite3_bind_blob(pInsert, i+1, sqlite3_column_blob(pQuery,i),
2785                                             sqlite3_column_bytes(pQuery,i),
2786                                             SQLITE_STATIC);
2787             break;
2788           }
2789         }
2790       } /* End for */
2791       rc = sqlite3_step(pInsert);
2792       if( rc!=SQLITE_OK && rc!=SQLITE_ROW && rc!=SQLITE_DONE ){
2793         utf8_printf(stderr, "Error %d: %s\n", sqlite3_extended_errcode(newDb),
2794                         sqlite3_errmsg(newDb));
2795       }
2796       sqlite3_reset(pInsert);
2797       cnt++;
2798       if( (cnt%spinRate)==0 ){
2799         printf("%c\b", "|/-\\"[(cnt/spinRate)%4]);
2800         fflush(stdout);
2801       }
2802     } /* End while */
2803     if( rc==SQLITE_DONE ) break;
2804     sqlite3_finalize(pQuery);
2805     sqlite3_free(zQuery);
2806     zQuery = sqlite3_mprintf("SELECT * FROM \"%w\" ORDER BY rowid DESC;",
2807                              zTable);
2808     rc = sqlite3_prepare_v2(p->db, zQuery, -1, &pQuery, 0);
2809     if( rc ){
2810       utf8_printf(stderr, "Warning: cannot step \"%s\" backwards", zTable);
2811       break;
2812     }
2813   } /* End for(k=0...) */
2814 
2815 end_data_xfer:
2816   sqlite3_finalize(pQuery);
2817   sqlite3_finalize(pInsert);
2818   sqlite3_free(zQuery);
2819   sqlite3_free(zInsert);
2820 }
2821 
2822 
2823 /*
2824 ** Try to transfer all rows of the schema that match zWhere.  For
2825 ** each row, invoke xForEach() on the object defined by that row.
2826 ** If an error is encountered while moving forward through the
2827 ** sqlite_master table, try again moving backwards.
2828 */
2829 static void tryToCloneSchema(
2830   ShellState *p,
2831   sqlite3 *newDb,
2832   const char *zWhere,
2833   void (*xForEach)(ShellState*,sqlite3*,const char*)
2834 ){
2835   sqlite3_stmt *pQuery = 0;
2836   char *zQuery = 0;
2837   int rc;
2838   const unsigned char *zName;
2839   const unsigned char *zSql;
2840   char *zErrMsg = 0;
2841 
2842   zQuery = sqlite3_mprintf("SELECT name, sql FROM sqlite_master"
2843                            " WHERE %s", zWhere);
2844   rc = sqlite3_prepare_v2(p->db, zQuery, -1, &pQuery, 0);
2845   if( rc ){
2846     utf8_printf(stderr, "Error: (%d) %s on [%s]\n",
2847                     sqlite3_extended_errcode(p->db), sqlite3_errmsg(p->db),
2848                     zQuery);
2849     goto end_schema_xfer;
2850   }
2851   while( (rc = sqlite3_step(pQuery))==SQLITE_ROW ){
2852     zName = sqlite3_column_text(pQuery, 0);
2853     zSql = sqlite3_column_text(pQuery, 1);
2854     printf("%s... ", zName); fflush(stdout);
2855     sqlite3_exec(newDb, (const char*)zSql, 0, 0, &zErrMsg);
2856     if( zErrMsg ){
2857       utf8_printf(stderr, "Error: %s\nSQL: [%s]\n", zErrMsg, zSql);
2858       sqlite3_free(zErrMsg);
2859       zErrMsg = 0;
2860     }
2861     if( xForEach ){
2862       xForEach(p, newDb, (const char*)zName);
2863     }
2864     printf("done\n");
2865   }
2866   if( rc!=SQLITE_DONE ){
2867     sqlite3_finalize(pQuery);
2868     sqlite3_free(zQuery);
2869     zQuery = sqlite3_mprintf("SELECT name, sql FROM sqlite_master"
2870                              " WHERE %s ORDER BY rowid DESC", zWhere);
2871     rc = sqlite3_prepare_v2(p->db, zQuery, -1, &pQuery, 0);
2872     if( rc ){
2873       utf8_printf(stderr, "Error: (%d) %s on [%s]\n",
2874                       sqlite3_extended_errcode(p->db), sqlite3_errmsg(p->db),
2875                       zQuery);
2876       goto end_schema_xfer;
2877     }
2878     while( (rc = sqlite3_step(pQuery))==SQLITE_ROW ){
2879       zName = sqlite3_column_text(pQuery, 0);
2880       zSql = sqlite3_column_text(pQuery, 1);
2881       printf("%s... ", zName); fflush(stdout);
2882       sqlite3_exec(newDb, (const char*)zSql, 0, 0, &zErrMsg);
2883       if( zErrMsg ){
2884         utf8_printf(stderr, "Error: %s\nSQL: [%s]\n", zErrMsg, zSql);
2885         sqlite3_free(zErrMsg);
2886         zErrMsg = 0;
2887       }
2888       if( xForEach ){
2889         xForEach(p, newDb, (const char*)zName);
2890       }
2891       printf("done\n");
2892     }
2893   }
2894 end_schema_xfer:
2895   sqlite3_finalize(pQuery);
2896   sqlite3_free(zQuery);
2897 }
2898 
2899 /*
2900 ** Open a new database file named "zNewDb".  Try to recover as much information
2901 ** as possible out of the main database (which might be corrupt) and write it
2902 ** into zNewDb.
2903 */
2904 static void tryToClone(ShellState *p, const char *zNewDb){
2905   int rc;
2906   sqlite3 *newDb = 0;
2907   if( access(zNewDb,0)==0 ){
2908     utf8_printf(stderr, "File \"%s\" already exists.\n", zNewDb);
2909     return;
2910   }
2911   rc = sqlite3_open(zNewDb, &newDb);
2912   if( rc ){
2913     utf8_printf(stderr, "Cannot create output database: %s\n",
2914             sqlite3_errmsg(newDb));
2915   }else{
2916     sqlite3_exec(p->db, "PRAGMA writable_schema=ON;", 0, 0, 0);
2917     sqlite3_exec(newDb, "BEGIN EXCLUSIVE;", 0, 0, 0);
2918     tryToCloneSchema(p, newDb, "type='table'", tryToCloneData);
2919     tryToCloneSchema(p, newDb, "type!='table'", 0);
2920     sqlite3_exec(newDb, "COMMIT;", 0, 0, 0);
2921     sqlite3_exec(p->db, "PRAGMA writable_schema=OFF;", 0, 0, 0);
2922   }
2923   sqlite3_close(newDb);
2924 }
2925 
2926 /*
2927 ** Change the output file back to stdout
2928 */
2929 static void output_reset(ShellState *p){
2930   if( p->outfile[0]=='|' ){
2931 #ifndef SQLITE_OMIT_POPEN
2932     pclose(p->out);
2933 #endif
2934   }else{
2935     output_file_close(p->out);
2936   }
2937   p->outfile[0] = 0;
2938   p->out = stdout;
2939 }
2940 
2941 /*
2942 ** Run an SQL command and return the single integer result.
2943 */
2944 static int db_int(ShellState *p, const char *zSql){
2945   sqlite3_stmt *pStmt;
2946   int res = 0;
2947   sqlite3_prepare_v2(p->db, zSql, -1, &pStmt, 0);
2948   if( pStmt && sqlite3_step(pStmt)==SQLITE_ROW ){
2949     res = sqlite3_column_int(pStmt,0);
2950   }
2951   sqlite3_finalize(pStmt);
2952   return res;
2953 }
2954 
2955 /*
2956 ** Convert a 2-byte or 4-byte big-endian integer into a native integer
2957 */
2958 static unsigned int get2byteInt(unsigned char *a){
2959   return (a[0]<<8) + a[1];
2960 }
2961 static unsigned int get4byteInt(unsigned char *a){
2962   return (a[0]<<24) + (a[1]<<16) + (a[2]<<8) + a[3];
2963 }
2964 
2965 /*
2966 ** Implementation of the ".info" command.
2967 **
2968 ** Return 1 on error, 2 to exit, and 0 otherwise.
2969 */
2970 static int shell_dbinfo_command(ShellState *p, int nArg, char **azArg){
2971   static const struct { const char *zName; int ofst; } aField[] = {
2972      { "file change counter:",  24  },
2973      { "database page count:",  28  },
2974      { "freelist page count:",  36  },
2975      { "schema cookie:",        40  },
2976      { "schema format:",        44  },
2977      { "default cache size:",   48  },
2978      { "autovacuum top root:",  52  },
2979      { "incremental vacuum:",   64  },
2980      { "text encoding:",        56  },
2981      { "user version:",         60  },
2982      { "application id:",       68  },
2983      { "software version:",     96  },
2984   };
2985   static const struct { const char *zName; const char *zSql; } aQuery[] = {
2986      { "number of tables:",
2987        "SELECT count(*) FROM %s WHERE type='table'" },
2988      { "number of indexes:",
2989        "SELECT count(*) FROM %s WHERE type='index'" },
2990      { "number of triggers:",
2991        "SELECT count(*) FROM %s WHERE type='trigger'" },
2992      { "number of views:",
2993        "SELECT count(*) FROM %s WHERE type='view'" },
2994      { "schema size:",
2995        "SELECT total(length(sql)) FROM %s" },
2996   };
2997   sqlite3_file *pFile = 0;
2998   int i;
2999   char *zSchemaTab;
3000   char *zDb = nArg>=2 ? azArg[1] : "main";
3001   unsigned char aHdr[100];
3002   open_db(p, 0);
3003   if( p->db==0 ) return 1;
3004   sqlite3_file_control(p->db, zDb, SQLITE_FCNTL_FILE_POINTER, &pFile);
3005   if( pFile==0 || pFile->pMethods==0 || pFile->pMethods->xRead==0 ){
3006     return 1;
3007   }
3008   i = pFile->pMethods->xRead(pFile, aHdr, 100, 0);
3009   if( i!=SQLITE_OK ){
3010     raw_printf(stderr, "unable to read database header\n");
3011     return 1;
3012   }
3013   i = get2byteInt(aHdr+16);
3014   if( i==1 ) i = 65536;
3015   utf8_printf(p->out, "%-20s %d\n", "database page size:", i);
3016   utf8_printf(p->out, "%-20s %d\n", "write format:", aHdr[18]);
3017   utf8_printf(p->out, "%-20s %d\n", "read format:", aHdr[19]);
3018   utf8_printf(p->out, "%-20s %d\n", "reserved bytes:", aHdr[20]);
3019   for(i=0; i<ArraySize(aField); i++){
3020     int ofst = aField[i].ofst;
3021     unsigned int val = get4byteInt(aHdr + ofst);
3022     utf8_printf(p->out, "%-20s %u", aField[i].zName, val);
3023     switch( ofst ){
3024       case 56: {
3025         if( val==1 ) raw_printf(p->out, " (utf8)");
3026         if( val==2 ) raw_printf(p->out, " (utf16le)");
3027         if( val==3 ) raw_printf(p->out, " (utf16be)");
3028       }
3029     }
3030     raw_printf(p->out, "\n");
3031   }
3032   if( zDb==0 ){
3033     zSchemaTab = sqlite3_mprintf("main.sqlite_master");
3034   }else if( strcmp(zDb,"temp")==0 ){
3035     zSchemaTab = sqlite3_mprintf("%s", "sqlite_temp_master");
3036   }else{
3037     zSchemaTab = sqlite3_mprintf("\"%w\".sqlite_master", zDb);
3038   }
3039   for(i=0; i<ArraySize(aQuery); i++){
3040     char *zSql = sqlite3_mprintf(aQuery[i].zSql, zSchemaTab);
3041     int val = db_int(p, zSql);
3042     sqlite3_free(zSql);
3043     utf8_printf(p->out, "%-20s %d\n", aQuery[i].zName, val);
3044   }
3045   sqlite3_free(zSchemaTab);
3046   return 0;
3047 }
3048 
3049 /*
3050 ** Print the current sqlite3_errmsg() value to stderr and return 1.
3051 */
3052 static int shellDatabaseError(sqlite3 *db){
3053   const char *zErr = sqlite3_errmsg(db);
3054   utf8_printf(stderr, "Error: %s\n", zErr);
3055   return 1;
3056 }
3057 
3058 /*
3059 ** Print an out-of-memory message to stderr and return 1.
3060 */
3061 static int shellNomemError(void){
3062   raw_printf(stderr, "Error: out of memory\n");
3063   return 1;
3064 }
3065 
3066 /*
3067 ** Compare the string as a command-line option with either one or two
3068 ** initial "-" characters.
3069 */
3070 static int optionMatch(const char *zStr, const char *zOpt){
3071   if( zStr[0]!='-' ) return 0;
3072   zStr++;
3073   if( zStr[0]=='-' ) zStr++;
3074   return strcmp(zStr, zOpt)==0;
3075 }
3076 
3077 /*
3078 ** If an input line begins with "." then invoke this routine to
3079 ** process that line.
3080 **
3081 ** Return 1 on error, 2 to exit, and 0 otherwise.
3082 */
3083 static int do_meta_command(char *zLine, ShellState *p){
3084   int h = 1;
3085   int nArg = 0;
3086   int n, c;
3087   int rc = 0;
3088   char *azArg[50];
3089 
3090   /* Parse the input line into tokens.
3091   */
3092   while( zLine[h] && nArg<ArraySize(azArg) ){
3093     while( IsSpace(zLine[h]) ){ h++; }
3094     if( zLine[h]==0 ) break;
3095     if( zLine[h]=='\'' || zLine[h]=='"' ){
3096       int delim = zLine[h++];
3097       azArg[nArg++] = &zLine[h];
3098       while( zLine[h] && zLine[h]!=delim ){
3099         if( zLine[h]=='\\' && delim=='"' && zLine[h+1]!=0 ) h++;
3100         h++;
3101       }
3102       if( zLine[h]==delim ){
3103         zLine[h++] = 0;
3104       }
3105       if( delim=='"' ) resolve_backslashes(azArg[nArg-1]);
3106     }else{
3107       azArg[nArg++] = &zLine[h];
3108       while( zLine[h] && !IsSpace(zLine[h]) ){ h++; }
3109       if( zLine[h] ) zLine[h++] = 0;
3110       resolve_backslashes(azArg[nArg-1]);
3111     }
3112   }
3113 
3114   /* Process the input line.
3115   */
3116   if( nArg==0 ) return 0; /* no tokens, no error */
3117   n = strlen30(azArg[0]);
3118   c = azArg[0][0];
3119 
3120   if( c=='a' && strncmp(azArg[0], "auth", n)==0 ){
3121     if( nArg!=2 ){
3122       raw_printf(stderr, "Usage: .auth ON|OFF\n");
3123       rc = 1;
3124       goto meta_command_exit;
3125     }
3126     open_db(p, 0);
3127     if( booleanValue(azArg[1]) ){
3128       sqlite3_set_authorizer(p->db, shellAuth, p);
3129     }else{
3130       sqlite3_set_authorizer(p->db, 0, 0);
3131     }
3132   }else
3133 
3134   if( (c=='b' && n>=3 && strncmp(azArg[0], "backup", n)==0)
3135    || (c=='s' && n>=3 && strncmp(azArg[0], "save", n)==0)
3136   ){
3137     const char *zDestFile = 0;
3138     const char *zDb = 0;
3139     sqlite3 *pDest;
3140     sqlite3_backup *pBackup;
3141     int j;
3142     for(j=1; j<nArg; j++){
3143       const char *z = azArg[j];
3144       if( z[0]=='-' ){
3145         while( z[0]=='-' ) z++;
3146         /* No options to process at this time */
3147         {
3148           utf8_printf(stderr, "unknown option: %s\n", azArg[j]);
3149           return 1;
3150         }
3151       }else if( zDestFile==0 ){
3152         zDestFile = azArg[j];
3153       }else if( zDb==0 ){
3154         zDb = zDestFile;
3155         zDestFile = azArg[j];
3156       }else{
3157         raw_printf(stderr, "too many arguments to .backup\n");
3158         return 1;
3159       }
3160     }
3161     if( zDestFile==0 ){
3162       raw_printf(stderr, "missing FILENAME argument on .backup\n");
3163       return 1;
3164     }
3165     if( zDb==0 ) zDb = "main";
3166     rc = sqlite3_open(zDestFile, &pDest);
3167     if( rc!=SQLITE_OK ){
3168       utf8_printf(stderr, "Error: cannot open \"%s\"\n", zDestFile);
3169       sqlite3_close(pDest);
3170       return 1;
3171     }
3172     open_db(p, 0);
3173     pBackup = sqlite3_backup_init(pDest, "main", p->db, zDb);
3174     if( pBackup==0 ){
3175       utf8_printf(stderr, "Error: %s\n", sqlite3_errmsg(pDest));
3176       sqlite3_close(pDest);
3177       return 1;
3178     }
3179     while(  (rc = sqlite3_backup_step(pBackup,100))==SQLITE_OK ){}
3180     sqlite3_backup_finish(pBackup);
3181     if( rc==SQLITE_DONE ){
3182       rc = 0;
3183     }else{
3184       utf8_printf(stderr, "Error: %s\n", sqlite3_errmsg(pDest));
3185       rc = 1;
3186     }
3187     sqlite3_close(pDest);
3188   }else
3189 
3190   if( c=='b' && n>=3 && strncmp(azArg[0], "bail", n)==0 ){
3191     if( nArg==2 ){
3192       bail_on_error = booleanValue(azArg[1]);
3193     }else{
3194       raw_printf(stderr, "Usage: .bail on|off\n");
3195       rc = 1;
3196     }
3197   }else
3198 
3199   if( c=='b' && n>=3 && strncmp(azArg[0], "binary", n)==0 ){
3200     if( nArg==2 ){
3201       if( booleanValue(azArg[1]) ){
3202         setBinaryMode(p->out, 1);
3203       }else{
3204         setTextMode(p->out, 1);
3205       }
3206     }else{
3207       raw_printf(stderr, "Usage: .binary on|off\n");
3208       rc = 1;
3209     }
3210   }else
3211 
3212   /* The undocumented ".breakpoint" command causes a call to the no-op
3213   ** routine named test_breakpoint().
3214   */
3215   if( c=='b' && n>=3 && strncmp(azArg[0], "breakpoint", n)==0 ){
3216     test_breakpoint();
3217   }else
3218 
3219   if( c=='c' && n>=3 && strncmp(azArg[0], "changes", n)==0 ){
3220     if( nArg==2 ){
3221       p->countChanges = booleanValue(azArg[1]);
3222     }else{
3223       raw_printf(stderr, "Usage: .changes on|off\n");
3224       rc = 1;
3225     }
3226   }else
3227 
3228   if( c=='c' && strncmp(azArg[0], "clone", n)==0 ){
3229     if( nArg==2 ){
3230       tryToClone(p, azArg[1]);
3231     }else{
3232       raw_printf(stderr, "Usage: .clone FILENAME\n");
3233       rc = 1;
3234     }
3235   }else
3236 
3237   if( c=='d' && n>1 && strncmp(azArg[0], "databases", n)==0 ){
3238     ShellState data;
3239     char *zErrMsg = 0;
3240     open_db(p, 0);
3241     memcpy(&data, p, sizeof(data));
3242     data.showHeader = 1;
3243     data.cMode = data.mode = MODE_Column;
3244     data.colWidth[0] = 3;
3245     data.colWidth[1] = 15;
3246     data.colWidth[2] = 58;
3247     data.cnt = 0;
3248     sqlite3_exec(p->db, "PRAGMA database_list; ", callback, &data, &zErrMsg);
3249     if( zErrMsg ){
3250       utf8_printf(stderr,"Error: %s\n", zErrMsg);
3251       sqlite3_free(zErrMsg);
3252       rc = 1;
3253     }
3254   }else
3255 
3256   if( c=='d' && strncmp(azArg[0], "dbinfo", n)==0 ){
3257     rc = shell_dbinfo_command(p, nArg, azArg);
3258   }else
3259 
3260   if( c=='d' && strncmp(azArg[0], "dump", n)==0 ){
3261     open_db(p, 0);
3262     /* When playing back a "dump", the content might appear in an order
3263     ** which causes immediate foreign key constraints to be violated.
3264     ** So disable foreign-key constraint enforcement to prevent problems. */
3265     if( nArg!=1 && nArg!=2 ){
3266       raw_printf(stderr, "Usage: .dump ?LIKE-PATTERN?\n");
3267       rc = 1;
3268       goto meta_command_exit;
3269     }
3270     raw_printf(p->out, "PRAGMA foreign_keys=OFF;\n");
3271     raw_printf(p->out, "BEGIN TRANSACTION;\n");
3272     p->writableSchema = 0;
3273     sqlite3_exec(p->db, "SAVEPOINT dump; PRAGMA writable_schema=ON", 0, 0, 0);
3274     p->nErr = 0;
3275     if( nArg==1 ){
3276       run_schema_dump_query(p,
3277         "SELECT name, type, sql FROM sqlite_master "
3278         "WHERE sql NOT NULL AND type=='table' AND name!='sqlite_sequence'"
3279       );
3280       run_schema_dump_query(p,
3281         "SELECT name, type, sql FROM sqlite_master "
3282         "WHERE name=='sqlite_sequence'"
3283       );
3284       run_table_dump_query(p,
3285         "SELECT sql FROM sqlite_master "
3286         "WHERE sql NOT NULL AND type IN ('index','trigger','view')", 0
3287       );
3288     }else{
3289       int i;
3290       for(i=1; i<nArg; i++){
3291         zShellStatic = azArg[i];
3292         run_schema_dump_query(p,
3293           "SELECT name, type, sql FROM sqlite_master "
3294           "WHERE tbl_name LIKE shellstatic() AND type=='table'"
3295           "  AND sql NOT NULL");
3296         run_table_dump_query(p,
3297           "SELECT sql FROM sqlite_master "
3298           "WHERE sql NOT NULL"
3299           "  AND type IN ('index','trigger','view')"
3300           "  AND tbl_name LIKE shellstatic()", 0
3301         );
3302         zShellStatic = 0;
3303       }
3304     }
3305     if( p->writableSchema ){
3306       raw_printf(p->out, "PRAGMA writable_schema=OFF;\n");
3307       p->writableSchema = 0;
3308     }
3309     sqlite3_exec(p->db, "PRAGMA writable_schema=OFF;", 0, 0, 0);
3310     sqlite3_exec(p->db, "RELEASE dump;", 0, 0, 0);
3311     raw_printf(p->out, p->nErr ? "ROLLBACK; -- due to errors\n" : "COMMIT;\n");
3312   }else
3313 
3314   if( c=='e' && strncmp(azArg[0], "echo", n)==0 ){
3315     if( nArg==2 ){
3316       p->echoOn = booleanValue(azArg[1]);
3317     }else{
3318       raw_printf(stderr, "Usage: .echo on|off\n");
3319       rc = 1;
3320     }
3321   }else
3322 
3323   if( c=='e' && strncmp(azArg[0], "eqp", n)==0 ){
3324     if( nArg==2 ){
3325       if( strcmp(azArg[1],"full")==0 ){
3326         p->autoEQP = 2;
3327       }else{
3328         p->autoEQP = booleanValue(azArg[1]);
3329       }
3330     }else{
3331       raw_printf(stderr, "Usage: .eqp on|off|full\n");
3332       rc = 1;
3333     }
3334   }else
3335 
3336   if( c=='e' && strncmp(azArg[0], "exit", n)==0 ){
3337     if( nArg>1 && (rc = (int)integerValue(azArg[1]))!=0 ) exit(rc);
3338     rc = 2;
3339   }else
3340 
3341   if( c=='e' && strncmp(azArg[0], "explain", n)==0 ){
3342     int val = 1;
3343     if( nArg>=2 ){
3344       if( strcmp(azArg[1],"auto")==0 ){
3345         val = 99;
3346       }else{
3347         val =  booleanValue(azArg[1]);
3348       }
3349     }
3350     if( val==1 && p->mode!=MODE_Explain ){
3351       p->normalMode = p->mode;
3352       p->mode = MODE_Explain;
3353       p->autoExplain = 0;
3354     }else if( val==0 ){
3355       if( p->mode==MODE_Explain ) p->mode = p->normalMode;
3356       p->autoExplain = 0;
3357     }else if( val==99 ){
3358       if( p->mode==MODE_Explain ) p->mode = p->normalMode;
3359       p->autoExplain = 1;
3360     }
3361   }else
3362 
3363   if( c=='f' && strncmp(azArg[0], "fullschema", n)==0 ){
3364     ShellState data;
3365     char *zErrMsg = 0;
3366     int doStats = 0;
3367     memcpy(&data, p, sizeof(data));
3368     data.showHeader = 0;
3369     data.cMode = data.mode = MODE_Semi;
3370     if( nArg==2 && optionMatch(azArg[1], "indent") ){
3371       data.cMode = data.mode = MODE_Pretty;
3372       nArg = 1;
3373     }
3374     if( nArg!=1 ){
3375       raw_printf(stderr, "Usage: .fullschema ?--indent?\n");
3376       rc = 1;
3377       goto meta_command_exit;
3378     }
3379     open_db(p, 0);
3380     rc = sqlite3_exec(p->db,
3381        "SELECT sql FROM"
3382        "  (SELECT sql sql, type type, tbl_name tbl_name, name name, rowid x"
3383        "     FROM sqlite_master UNION ALL"
3384        "   SELECT sql, type, tbl_name, name, rowid FROM sqlite_temp_master) "
3385        "WHERE type!='meta' AND sql NOTNULL AND name NOT LIKE 'sqlite_%' "
3386        "ORDER BY rowid",
3387        callback, &data, &zErrMsg
3388     );
3389     if( rc==SQLITE_OK ){
3390       sqlite3_stmt *pStmt;
3391       rc = sqlite3_prepare_v2(p->db,
3392                "SELECT rowid FROM sqlite_master"
3393                " WHERE name GLOB 'sqlite_stat[134]'",
3394                -1, &pStmt, 0);
3395       doStats = sqlite3_step(pStmt)==SQLITE_ROW;
3396       sqlite3_finalize(pStmt);
3397     }
3398     if( doStats==0 ){
3399       raw_printf(p->out, "/* No STAT tables available */\n");
3400     }else{
3401       raw_printf(p->out, "ANALYZE sqlite_master;\n");
3402       sqlite3_exec(p->db, "SELECT 'ANALYZE sqlite_master'",
3403                    callback, &data, &zErrMsg);
3404       data.cMode = data.mode = MODE_Insert;
3405       data.zDestTable = "sqlite_stat1";
3406       shell_exec(p->db, "SELECT * FROM sqlite_stat1",
3407                  shell_callback, &data,&zErrMsg);
3408       data.zDestTable = "sqlite_stat3";
3409       shell_exec(p->db, "SELECT * FROM sqlite_stat3",
3410                  shell_callback, &data,&zErrMsg);
3411       data.zDestTable = "sqlite_stat4";
3412       shell_exec(p->db, "SELECT * FROM sqlite_stat4",
3413                  shell_callback, &data, &zErrMsg);
3414       raw_printf(p->out, "ANALYZE sqlite_master;\n");
3415     }
3416   }else
3417 
3418   if( c=='h' && strncmp(azArg[0], "headers", n)==0 ){
3419     if( nArg==2 ){
3420       p->showHeader = booleanValue(azArg[1]);
3421     }else{
3422       raw_printf(stderr, "Usage: .headers on|off\n");
3423       rc = 1;
3424     }
3425   }else
3426 
3427   if( c=='h' && strncmp(azArg[0], "help", n)==0 ){
3428     utf8_printf(p->out, "%s", zHelp);
3429   }else
3430 
3431   if( c=='i' && strncmp(azArg[0], "import", n)==0 ){
3432     char *zTable;               /* Insert data into this table */
3433     char *zFile;                /* Name of file to extra content from */
3434     sqlite3_stmt *pStmt = NULL; /* A statement */
3435     int nCol;                   /* Number of columns in the table */
3436     int nByte;                  /* Number of bytes in an SQL string */
3437     int i, j;                   /* Loop counters */
3438     int needCommit;             /* True to COMMIT or ROLLBACK at end */
3439     int nSep;                   /* Number of bytes in p->colSeparator[] */
3440     char *zSql;                 /* An SQL statement */
3441     ImportCtx sCtx;             /* Reader context */
3442     char *(SQLITE_CDECL *xRead)(ImportCtx*); /* Func to read one value */
3443     int (SQLITE_CDECL *xCloser)(FILE*);      /* Func to close file */
3444 
3445     if( nArg!=3 ){
3446       raw_printf(stderr, "Usage: .import FILE TABLE\n");
3447       goto meta_command_exit;
3448     }
3449     zFile = azArg[1];
3450     zTable = azArg[2];
3451     seenInterrupt = 0;
3452     memset(&sCtx, 0, sizeof(sCtx));
3453     open_db(p, 0);
3454     nSep = strlen30(p->colSeparator);
3455     if( nSep==0 ){
3456       raw_printf(stderr,
3457                  "Error: non-null column separator required for import\n");
3458       return 1;
3459     }
3460     if( nSep>1 ){
3461       raw_printf(stderr, "Error: multi-character column separators not allowed"
3462                       " for import\n");
3463       return 1;
3464     }
3465     nSep = strlen30(p->rowSeparator);
3466     if( nSep==0 ){
3467       raw_printf(stderr, "Error: non-null row separator required for import\n");
3468       return 1;
3469     }
3470     if( nSep==2 && p->mode==MODE_Csv && strcmp(p->rowSeparator, SEP_CrLf)==0 ){
3471       /* When importing CSV (only), if the row separator is set to the
3472       ** default output row separator, change it to the default input
3473       ** row separator.  This avoids having to maintain different input
3474       ** and output row separators. */
3475       sqlite3_snprintf(sizeof(p->rowSeparator), p->rowSeparator, SEP_Row);
3476       nSep = strlen30(p->rowSeparator);
3477     }
3478     if( nSep>1 ){
3479       raw_printf(stderr, "Error: multi-character row separators not allowed"
3480                       " for import\n");
3481       return 1;
3482     }
3483     sCtx.zFile = zFile;
3484     sCtx.nLine = 1;
3485     if( sCtx.zFile[0]=='|' ){
3486 #ifdef SQLITE_OMIT_POPEN
3487       raw_printf(stderr, "Error: pipes are not supported in this OS\n");
3488       return 1;
3489 #else
3490       sCtx.in = popen(sCtx.zFile+1, "r");
3491       sCtx.zFile = "<pipe>";
3492       xCloser = pclose;
3493 #endif
3494     }else{
3495       sCtx.in = fopen(sCtx.zFile, "rb");
3496       xCloser = fclose;
3497     }
3498     if( p->mode==MODE_Ascii ){
3499       xRead = ascii_read_one_field;
3500     }else{
3501       xRead = csv_read_one_field;
3502     }
3503     if( sCtx.in==0 ){
3504       utf8_printf(stderr, "Error: cannot open \"%s\"\n", zFile);
3505       return 1;
3506     }
3507     sCtx.cColSep = p->colSeparator[0];
3508     sCtx.cRowSep = p->rowSeparator[0];
3509     zSql = sqlite3_mprintf("SELECT * FROM %s", zTable);
3510     if( zSql==0 ){
3511       raw_printf(stderr, "Error: out of memory\n");
3512       xCloser(sCtx.in);
3513       return 1;
3514     }
3515     nByte = strlen30(zSql);
3516     rc = sqlite3_prepare_v2(p->db, zSql, -1, &pStmt, 0);
3517     import_append_char(&sCtx, 0);    /* To ensure sCtx.z is allocated */
3518     if( rc && sqlite3_strglob("no such table: *", sqlite3_errmsg(p->db))==0 ){
3519       char *zCreate = sqlite3_mprintf("CREATE TABLE %s", zTable);
3520       char cSep = '(';
3521       while( xRead(&sCtx) ){
3522         zCreate = sqlite3_mprintf("%z%c\n  \"%w\" TEXT", zCreate, cSep, sCtx.z);
3523         cSep = ',';
3524         if( sCtx.cTerm!=sCtx.cColSep ) break;
3525       }
3526       if( cSep=='(' ){
3527         sqlite3_free(zCreate);
3528         sqlite3_free(sCtx.z);
3529         xCloser(sCtx.in);
3530         utf8_printf(stderr,"%s: empty file\n", sCtx.zFile);
3531         return 1;
3532       }
3533       zCreate = sqlite3_mprintf("%z\n)", zCreate);
3534       rc = sqlite3_exec(p->db, zCreate, 0, 0, 0);
3535       sqlite3_free(zCreate);
3536       if( rc ){
3537         utf8_printf(stderr, "CREATE TABLE %s(...) failed: %s\n", zTable,
3538                 sqlite3_errmsg(p->db));
3539         sqlite3_free(sCtx.z);
3540         xCloser(sCtx.in);
3541         return 1;
3542       }
3543       rc = sqlite3_prepare_v2(p->db, zSql, -1, &pStmt, 0);
3544     }
3545     sqlite3_free(zSql);
3546     if( rc ){
3547       if (pStmt) sqlite3_finalize(pStmt);
3548       utf8_printf(stderr,"Error: %s\n", sqlite3_errmsg(p->db));
3549       xCloser(sCtx.in);
3550       return 1;
3551     }
3552     nCol = sqlite3_column_count(pStmt);
3553     sqlite3_finalize(pStmt);
3554     pStmt = 0;
3555     if( nCol==0 ) return 0; /* no columns, no error */
3556     zSql = sqlite3_malloc64( nByte*2 + 20 + nCol*2 );
3557     if( zSql==0 ){
3558       raw_printf(stderr, "Error: out of memory\n");
3559       xCloser(sCtx.in);
3560       return 1;
3561     }
3562     sqlite3_snprintf(nByte+20, zSql, "INSERT INTO \"%w\" VALUES(?", zTable);
3563     j = strlen30(zSql);
3564     for(i=1; i<nCol; i++){
3565       zSql[j++] = ',';
3566       zSql[j++] = '?';
3567     }
3568     zSql[j++] = ')';
3569     zSql[j] = 0;
3570     rc = sqlite3_prepare_v2(p->db, zSql, -1, &pStmt, 0);
3571     sqlite3_free(zSql);
3572     if( rc ){
3573       utf8_printf(stderr, "Error: %s\n", sqlite3_errmsg(p->db));
3574       if (pStmt) sqlite3_finalize(pStmt);
3575       xCloser(sCtx.in);
3576       return 1;
3577     }
3578     needCommit = sqlite3_get_autocommit(p->db);
3579     if( needCommit ) sqlite3_exec(p->db, "BEGIN", 0, 0, 0);
3580     do{
3581       int startLine = sCtx.nLine;
3582       for(i=0; i<nCol; i++){
3583         char *z = xRead(&sCtx);
3584         /*
3585         ** Did we reach end-of-file before finding any columns?
3586         ** If so, stop instead of NULL filling the remaining columns.
3587         */
3588         if( z==0 && i==0 ) break;
3589         /*
3590         ** Did we reach end-of-file OR end-of-line before finding any
3591         ** columns in ASCII mode?  If so, stop instead of NULL filling
3592         ** the remaining columns.
3593         */
3594         if( p->mode==MODE_Ascii && (z==0 || z[0]==0) && i==0 ) break;
3595         sqlite3_bind_text(pStmt, i+1, z, -1, SQLITE_TRANSIENT);
3596         if( i<nCol-1 && sCtx.cTerm!=sCtx.cColSep ){
3597           utf8_printf(stderr, "%s:%d: expected %d columns but found %d - "
3598                           "filling the rest with NULL\n",
3599                           sCtx.zFile, startLine, nCol, i+1);
3600           i += 2;
3601           while( i<=nCol ){ sqlite3_bind_null(pStmt, i); i++; }
3602         }
3603       }
3604       if( sCtx.cTerm==sCtx.cColSep ){
3605         do{
3606           xRead(&sCtx);
3607           i++;
3608         }while( sCtx.cTerm==sCtx.cColSep );
3609         utf8_printf(stderr, "%s:%d: expected %d columns but found %d - "
3610                         "extras ignored\n",
3611                         sCtx.zFile, startLine, nCol, i);
3612       }
3613       if( i>=nCol ){
3614         sqlite3_step(pStmt);
3615         rc = sqlite3_reset(pStmt);
3616         if( rc!=SQLITE_OK ){
3617           utf8_printf(stderr, "%s:%d: INSERT failed: %s\n", sCtx.zFile,
3618                       startLine, sqlite3_errmsg(p->db));
3619         }
3620       }
3621     }while( sCtx.cTerm!=EOF );
3622 
3623     xCloser(sCtx.in);
3624     sqlite3_free(sCtx.z);
3625     sqlite3_finalize(pStmt);
3626     if( needCommit ) sqlite3_exec(p->db, "COMMIT", 0, 0, 0);
3627   }else
3628 
3629   if( c=='i' && (strncmp(azArg[0], "indices", n)==0
3630                  || strncmp(azArg[0], "indexes", n)==0) ){
3631     ShellState data;
3632     char *zErrMsg = 0;
3633     open_db(p, 0);
3634     memcpy(&data, p, sizeof(data));
3635     data.showHeader = 0;
3636     data.cMode = data.mode = MODE_List;
3637     if( nArg==1 ){
3638       rc = sqlite3_exec(p->db,
3639         "SELECT name FROM sqlite_master "
3640         "WHERE type='index' AND name NOT LIKE 'sqlite_%' "
3641         "UNION ALL "
3642         "SELECT name FROM sqlite_temp_master "
3643         "WHERE type='index' "
3644         "ORDER BY 1",
3645         callback, &data, &zErrMsg
3646       );
3647     }else if( nArg==2 ){
3648       zShellStatic = azArg[1];
3649       rc = sqlite3_exec(p->db,
3650         "SELECT name FROM sqlite_master "
3651         "WHERE type='index' AND tbl_name LIKE shellstatic() "
3652         "UNION ALL "
3653         "SELECT name FROM sqlite_temp_master "
3654         "WHERE type='index' AND tbl_name LIKE shellstatic() "
3655         "ORDER BY 1",
3656         callback, &data, &zErrMsg
3657       );
3658       zShellStatic = 0;
3659     }else{
3660       raw_printf(stderr, "Usage: .indexes ?LIKE-PATTERN?\n");
3661       rc = 1;
3662       goto meta_command_exit;
3663     }
3664     if( zErrMsg ){
3665       utf8_printf(stderr,"Error: %s\n", zErrMsg);
3666       sqlite3_free(zErrMsg);
3667       rc = 1;
3668     }else if( rc != SQLITE_OK ){
3669       raw_printf(stderr,
3670                  "Error: querying sqlite_master and sqlite_temp_master\n");
3671       rc = 1;
3672     }
3673   }else
3674 
3675 #ifdef SQLITE_ENABLE_IOTRACE
3676   if( c=='i' && strncmp(azArg[0], "iotrace", n)==0 ){
3677     SQLITE_API extern void (SQLITE_CDECL *sqlite3IoTrace)(const char*, ...);
3678     if( iotrace && iotrace!=stdout ) fclose(iotrace);
3679     iotrace = 0;
3680     if( nArg<2 ){
3681       sqlite3IoTrace = 0;
3682     }else if( strcmp(azArg[1], "-")==0 ){
3683       sqlite3IoTrace = iotracePrintf;
3684       iotrace = stdout;
3685     }else{
3686       iotrace = fopen(azArg[1], "w");
3687       if( iotrace==0 ){
3688         utf8_printf(stderr, "Error: cannot open \"%s\"\n", azArg[1]);
3689         sqlite3IoTrace = 0;
3690         rc = 1;
3691       }else{
3692         sqlite3IoTrace = iotracePrintf;
3693       }
3694     }
3695   }else
3696 #endif
3697   if( c=='l' && n>=5 && strncmp(azArg[0], "limits", n)==0 ){
3698     static const struct {
3699        const char *zLimitName;   /* Name of a limit */
3700        int limitCode;            /* Integer code for that limit */
3701     } aLimit[] = {
3702       { "length",                SQLITE_LIMIT_LENGTH                    },
3703       { "sql_length",            SQLITE_LIMIT_SQL_LENGTH                },
3704       { "column",                SQLITE_LIMIT_COLUMN                    },
3705       { "expr_depth",            SQLITE_LIMIT_EXPR_DEPTH                },
3706       { "compound_select",       SQLITE_LIMIT_COMPOUND_SELECT           },
3707       { "vdbe_op",               SQLITE_LIMIT_VDBE_OP                   },
3708       { "function_arg",          SQLITE_LIMIT_FUNCTION_ARG              },
3709       { "attached",              SQLITE_LIMIT_ATTACHED                  },
3710       { "like_pattern_length",   SQLITE_LIMIT_LIKE_PATTERN_LENGTH       },
3711       { "variable_number",       SQLITE_LIMIT_VARIABLE_NUMBER           },
3712       { "trigger_depth",         SQLITE_LIMIT_TRIGGER_DEPTH             },
3713       { "worker_threads",        SQLITE_LIMIT_WORKER_THREADS            },
3714     };
3715     int i, n2;
3716     open_db(p, 0);
3717     if( nArg==1 ){
3718       for(i=0; i<ArraySize(aLimit); i++){
3719         printf("%20s %d\n", aLimit[i].zLimitName,
3720                sqlite3_limit(p->db, aLimit[i].limitCode, -1));
3721       }
3722     }else if( nArg>3 ){
3723       raw_printf(stderr, "Usage: .limit NAME ?NEW-VALUE?\n");
3724       rc = 1;
3725       goto meta_command_exit;
3726     }else{
3727       int iLimit = -1;
3728       n2 = strlen30(azArg[1]);
3729       for(i=0; i<ArraySize(aLimit); i++){
3730         if( sqlite3_strnicmp(aLimit[i].zLimitName, azArg[1], n2)==0 ){
3731           if( iLimit<0 ){
3732             iLimit = i;
3733           }else{
3734             utf8_printf(stderr, "ambiguous limit: \"%s\"\n", azArg[1]);
3735             rc = 1;
3736             goto meta_command_exit;
3737           }
3738         }
3739       }
3740       if( iLimit<0 ){
3741         utf8_printf(stderr, "unknown limit: \"%s\"\n"
3742                         "enter \".limits\" with no arguments for a list.\n",
3743                          azArg[1]);
3744         rc = 1;
3745         goto meta_command_exit;
3746       }
3747       if( nArg==3 ){
3748         sqlite3_limit(p->db, aLimit[iLimit].limitCode,
3749                       (int)integerValue(azArg[2]));
3750       }
3751       printf("%20s %d\n", aLimit[iLimit].zLimitName,
3752              sqlite3_limit(p->db, aLimit[iLimit].limitCode, -1));
3753     }
3754   }else
3755 
3756 #ifndef SQLITE_OMIT_LOAD_EXTENSION
3757   if( c=='l' && strncmp(azArg[0], "load", n)==0 ){
3758     const char *zFile, *zProc;
3759     char *zErrMsg = 0;
3760     if( nArg<2 ){
3761       raw_printf(stderr, "Usage: .load FILE ?ENTRYPOINT?\n");
3762       rc = 1;
3763       goto meta_command_exit;
3764     }
3765     zFile = azArg[1];
3766     zProc = nArg>=3 ? azArg[2] : 0;
3767     open_db(p, 0);
3768     rc = sqlite3_load_extension(p->db, zFile, zProc, &zErrMsg);
3769     if( rc!=SQLITE_OK ){
3770       utf8_printf(stderr, "Error: %s\n", zErrMsg);
3771       sqlite3_free(zErrMsg);
3772       rc = 1;
3773     }
3774   }else
3775 #endif
3776 
3777   if( c=='l' && strncmp(azArg[0], "log", n)==0 ){
3778     if( nArg!=2 ){
3779       raw_printf(stderr, "Usage: .log FILENAME\n");
3780       rc = 1;
3781     }else{
3782       const char *zFile = azArg[1];
3783       output_file_close(p->pLog);
3784       p->pLog = output_file_open(zFile);
3785     }
3786   }else
3787 
3788   if( c=='m' && strncmp(azArg[0], "mode", n)==0 ){
3789     const char *zMode = nArg>=2 ? azArg[1] : "";
3790     int n2 = (int)strlen(zMode);
3791     int c2 = zMode[0];
3792     if( c2=='l' && n2>2 && strncmp(azArg[1],"lines",n2)==0 ){
3793       p->mode = MODE_Line;
3794     }else if( c2=='c' && strncmp(azArg[1],"columns",n2)==0 ){
3795       p->mode = MODE_Column;
3796     }else if( c2=='l' && n2>2 && strncmp(azArg[1],"list",n2)==0 ){
3797       p->mode = MODE_List;
3798     }else if( c2=='h' && strncmp(azArg[1],"html",n2)==0 ){
3799       p->mode = MODE_Html;
3800     }else if( c2=='t' && strncmp(azArg[1],"tcl",n2)==0 ){
3801       p->mode = MODE_Tcl;
3802       sqlite3_snprintf(sizeof(p->colSeparator), p->colSeparator, SEP_Space);
3803     }else if( c2=='c' && strncmp(azArg[1],"csv",n2)==0 ){
3804       p->mode = MODE_Csv;
3805       sqlite3_snprintf(sizeof(p->colSeparator), p->colSeparator, SEP_Comma);
3806       sqlite3_snprintf(sizeof(p->rowSeparator), p->rowSeparator, SEP_CrLf);
3807     }else if( c2=='t' && strncmp(azArg[1],"tabs",n2)==0 ){
3808       p->mode = MODE_List;
3809       sqlite3_snprintf(sizeof(p->colSeparator), p->colSeparator, SEP_Tab);
3810     }else if( c2=='i' && strncmp(azArg[1],"insert",n2)==0 ){
3811       p->mode = MODE_Insert;
3812       set_table_name(p, nArg>=3 ? azArg[2] : "table");
3813     }else if( c2=='a' && strncmp(azArg[1],"ascii",n2)==0 ){
3814       p->mode = MODE_Ascii;
3815       sqlite3_snprintf(sizeof(p->colSeparator), p->colSeparator, SEP_Unit);
3816       sqlite3_snprintf(sizeof(p->rowSeparator), p->rowSeparator, SEP_Record);
3817     }else {
3818       raw_printf(stderr, "Error: mode should be one of: "
3819          "ascii column csv html insert line list tabs tcl\n");
3820       rc = 1;
3821     }
3822     p->cMode = p->mode;
3823   }else
3824 
3825   if( c=='n' && strncmp(azArg[0], "nullvalue", n)==0 ){
3826     if( nArg==2 ){
3827       sqlite3_snprintf(sizeof(p->nullValue), p->nullValue,
3828                        "%.*s", (int)ArraySize(p->nullValue)-1, azArg[1]);
3829     }else{
3830       raw_printf(stderr, "Usage: .nullvalue STRING\n");
3831       rc = 1;
3832     }
3833   }else
3834 
3835   if( c=='o' && strncmp(azArg[0], "open", n)==0 && n>=2 ){
3836     sqlite3 *savedDb = p->db;
3837     const char *zSavedFilename = p->zDbFilename;
3838     char *zNewFilename = 0;
3839     p->db = 0;
3840     if( nArg>=2 ) zNewFilename = sqlite3_mprintf("%s", azArg[1]);
3841     p->zDbFilename = zNewFilename;
3842     open_db(p, 1);
3843     if( p->db!=0 ){
3844       session_close_all(p);
3845       sqlite3_close(savedDb);
3846       sqlite3_free(p->zFreeOnClose);
3847       p->zFreeOnClose = zNewFilename;
3848     }else{
3849       sqlite3_free(zNewFilename);
3850       p->db = savedDb;
3851       p->zDbFilename = zSavedFilename;
3852     }
3853   }else
3854 
3855   if( c=='o'
3856    && (strncmp(azArg[0], "output", n)==0 || strncmp(azArg[0], "once", n)==0)
3857   ){
3858     const char *zFile = nArg>=2 ? azArg[1] : "stdout";
3859     if( nArg>2 ){
3860       utf8_printf(stderr, "Usage: .%s FILE\n", azArg[0]);
3861       rc = 1;
3862       goto meta_command_exit;
3863     }
3864     if( n>1 && strncmp(azArg[0], "once", n)==0 ){
3865       if( nArg<2 ){
3866         raw_printf(stderr, "Usage: .once FILE\n");
3867         rc = 1;
3868         goto meta_command_exit;
3869       }
3870       p->outCount = 2;
3871     }else{
3872       p->outCount = 0;
3873     }
3874     output_reset(p);
3875     if( zFile[0]=='|' ){
3876 #ifdef SQLITE_OMIT_POPEN
3877       raw_printf(stderr, "Error: pipes are not supported in this OS\n");
3878       rc = 1;
3879       p->out = stdout;
3880 #else
3881       p->out = popen(zFile + 1, "w");
3882       if( p->out==0 ){
3883         utf8_printf(stderr,"Error: cannot open pipe \"%s\"\n", zFile + 1);
3884         p->out = stdout;
3885         rc = 1;
3886       }else{
3887         sqlite3_snprintf(sizeof(p->outfile), p->outfile, "%s", zFile);
3888       }
3889 #endif
3890     }else{
3891       p->out = output_file_open(zFile);
3892       if( p->out==0 ){
3893         if( strcmp(zFile,"off")!=0 ){
3894           utf8_printf(stderr,"Error: cannot write to \"%s\"\n", zFile);
3895         }
3896         p->out = stdout;
3897         rc = 1;
3898       } else {
3899         sqlite3_snprintf(sizeof(p->outfile), p->outfile, "%s", zFile);
3900       }
3901     }
3902   }else
3903 
3904   if( c=='p' && n>=3 && strncmp(azArg[0], "print", n)==0 ){
3905     int i;
3906     for(i=1; i<nArg; i++){
3907       if( i>1 ) raw_printf(p->out, " ");
3908       utf8_printf(p->out, "%s", azArg[i]);
3909     }
3910     raw_printf(p->out, "\n");
3911   }else
3912 
3913   if( c=='p' && strncmp(azArg[0], "prompt", n)==0 ){
3914     if( nArg >= 2) {
3915       strncpy(mainPrompt,azArg[1],(int)ArraySize(mainPrompt)-1);
3916     }
3917     if( nArg >= 3) {
3918       strncpy(continuePrompt,azArg[2],(int)ArraySize(continuePrompt)-1);
3919     }
3920   }else
3921 
3922   if( c=='q' && strncmp(azArg[0], "quit", n)==0 ){
3923     rc = 2;
3924   }else
3925 
3926   if( c=='r' && n>=3 && strncmp(azArg[0], "read", n)==0 ){
3927     FILE *alt;
3928     if( nArg!=2 ){
3929       raw_printf(stderr, "Usage: .read FILE\n");
3930       rc = 1;
3931       goto meta_command_exit;
3932     }
3933     alt = fopen(azArg[1], "rb");
3934     if( alt==0 ){
3935       utf8_printf(stderr,"Error: cannot open \"%s\"\n", azArg[1]);
3936       rc = 1;
3937     }else{
3938       rc = process_input(p, alt);
3939       fclose(alt);
3940     }
3941   }else
3942 
3943   if( c=='r' && n>=3 && strncmp(azArg[0], "restore", n)==0 ){
3944     const char *zSrcFile;
3945     const char *zDb;
3946     sqlite3 *pSrc;
3947     sqlite3_backup *pBackup;
3948     int nTimeout = 0;
3949 
3950     if( nArg==2 ){
3951       zSrcFile = azArg[1];
3952       zDb = "main";
3953     }else if( nArg==3 ){
3954       zSrcFile = azArg[2];
3955       zDb = azArg[1];
3956     }else{
3957       raw_printf(stderr, "Usage: .restore ?DB? FILE\n");
3958       rc = 1;
3959       goto meta_command_exit;
3960     }
3961     rc = sqlite3_open(zSrcFile, &pSrc);
3962     if( rc!=SQLITE_OK ){
3963       utf8_printf(stderr, "Error: cannot open \"%s\"\n", zSrcFile);
3964       sqlite3_close(pSrc);
3965       return 1;
3966     }
3967     open_db(p, 0);
3968     pBackup = sqlite3_backup_init(p->db, zDb, pSrc, "main");
3969     if( pBackup==0 ){
3970       utf8_printf(stderr, "Error: %s\n", sqlite3_errmsg(p->db));
3971       sqlite3_close(pSrc);
3972       return 1;
3973     }
3974     while( (rc = sqlite3_backup_step(pBackup,100))==SQLITE_OK
3975           || rc==SQLITE_BUSY  ){
3976       if( rc==SQLITE_BUSY ){
3977         if( nTimeout++ >= 3 ) break;
3978         sqlite3_sleep(100);
3979       }
3980     }
3981     sqlite3_backup_finish(pBackup);
3982     if( rc==SQLITE_DONE ){
3983       rc = 0;
3984     }else if( rc==SQLITE_BUSY || rc==SQLITE_LOCKED ){
3985       raw_printf(stderr, "Error: source database is busy\n");
3986       rc = 1;
3987     }else{
3988       utf8_printf(stderr, "Error: %s\n", sqlite3_errmsg(p->db));
3989       rc = 1;
3990     }
3991     sqlite3_close(pSrc);
3992   }else
3993 
3994 
3995   if( c=='s' && strncmp(azArg[0], "scanstats", n)==0 ){
3996     if( nArg==2 ){
3997       p->scanstatsOn = booleanValue(azArg[1]);
3998 #ifndef SQLITE_ENABLE_STMT_SCANSTATUS
3999       raw_printf(stderr, "Warning: .scanstats not available in this build.\n");
4000 #endif
4001     }else{
4002       raw_printf(stderr, "Usage: .scanstats on|off\n");
4003       rc = 1;
4004     }
4005   }else
4006 
4007   if( c=='s' && strncmp(azArg[0], "schema", n)==0 ){
4008     ShellState data;
4009     char *zErrMsg = 0;
4010     open_db(p, 0);
4011     memcpy(&data, p, sizeof(data));
4012     data.showHeader = 0;
4013     data.cMode = data.mode = MODE_Semi;
4014     if( nArg>=2 && optionMatch(azArg[1], "indent") ){
4015       data.cMode = data.mode = MODE_Pretty;
4016       nArg--;
4017       if( nArg==2 ) azArg[1] = azArg[2];
4018     }
4019     if( nArg==2 && azArg[1][0]!='-' ){
4020       int i;
4021       for(i=0; azArg[1][i]; i++) azArg[1][i] = ToLower(azArg[1][i]);
4022       if( strcmp(azArg[1],"sqlite_master")==0 ){
4023         char *new_argv[2], *new_colv[2];
4024         new_argv[0] = "CREATE TABLE sqlite_master (\n"
4025                       "  type text,\n"
4026                       "  name text,\n"
4027                       "  tbl_name text,\n"
4028                       "  rootpage integer,\n"
4029                       "  sql text\n"
4030                       ")";
4031         new_argv[1] = 0;
4032         new_colv[0] = "sql";
4033         new_colv[1] = 0;
4034         callback(&data, 1, new_argv, new_colv);
4035         rc = SQLITE_OK;
4036       }else if( strcmp(azArg[1],"sqlite_temp_master")==0 ){
4037         char *new_argv[2], *new_colv[2];
4038         new_argv[0] = "CREATE TEMP TABLE sqlite_temp_master (\n"
4039                       "  type text,\n"
4040                       "  name text,\n"
4041                       "  tbl_name text,\n"
4042                       "  rootpage integer,\n"
4043                       "  sql text\n"
4044                       ")";
4045         new_argv[1] = 0;
4046         new_colv[0] = "sql";
4047         new_colv[1] = 0;
4048         callback(&data, 1, new_argv, new_colv);
4049         rc = SQLITE_OK;
4050       }else{
4051         zShellStatic = azArg[1];
4052         rc = sqlite3_exec(p->db,
4053           "SELECT sql FROM "
4054           "  (SELECT sql sql, type type, tbl_name tbl_name, name name, rowid x"
4055           "     FROM sqlite_master UNION ALL"
4056           "   SELECT sql, type, tbl_name, name, rowid FROM sqlite_temp_master) "
4057           "WHERE lower(tbl_name) LIKE shellstatic()"
4058           "  AND type!='meta' AND sql NOTNULL "
4059           "ORDER BY rowid",
4060           callback, &data, &zErrMsg);
4061         zShellStatic = 0;
4062       }
4063     }else if( nArg==1 ){
4064       rc = sqlite3_exec(p->db,
4065          "SELECT sql FROM "
4066          "  (SELECT sql sql, type type, tbl_name tbl_name, name name, rowid x"
4067          "     FROM sqlite_master UNION ALL"
4068          "   SELECT sql, type, tbl_name, name, rowid FROM sqlite_temp_master) "
4069          "WHERE type!='meta' AND sql NOTNULL AND name NOT LIKE 'sqlite_%' "
4070          "ORDER BY rowid",
4071          callback, &data, &zErrMsg
4072       );
4073     }else{
4074       raw_printf(stderr, "Usage: .schema ?--indent? ?LIKE-PATTERN?\n");
4075       rc = 1;
4076       goto meta_command_exit;
4077     }
4078     if( zErrMsg ){
4079       utf8_printf(stderr,"Error: %s\n", zErrMsg);
4080       sqlite3_free(zErrMsg);
4081       rc = 1;
4082     }else if( rc != SQLITE_OK ){
4083       raw_printf(stderr,"Error: querying schema information\n");
4084       rc = 1;
4085     }else{
4086       rc = 0;
4087     }
4088   }else
4089 
4090 #if defined(SQLITE_DEBUG) && defined(SQLITE_ENABLE_SELECTTRACE)
4091   if( c=='s' && n==11 && strncmp(azArg[0], "selecttrace", n)==0 ){
4092     sqlite3SelectTrace = integerValue(azArg[1]);
4093   }else
4094 #endif
4095 
4096 #if defined(SQLITE_ENABLE_SESSION)
4097   if( c=='s' && strncmp(azArg[0],"session",n)==0 && n>=3 ){
4098     OpenSession *pSession = &p->aSession[0];
4099     char **azCmd = &azArg[1];
4100     int iSes = 0;
4101     int nCmd = nArg - 1;
4102     int i;
4103     if( nArg<=1 ) goto session_syntax_error;
4104     open_db(p, 0);
4105     if( nArg>=3 ){
4106       for(iSes=0; iSes<p->nSession; iSes++){
4107         if( strcmp(p->aSession[iSes].zName, azArg[1])==0 ) break;
4108       }
4109       if( iSes<p->nSession ){
4110         pSession = &p->aSession[iSes];
4111         azCmd++;
4112         nCmd--;
4113       }else{
4114         pSession = &p->aSession[0];
4115         iSes = 0;
4116       }
4117     }
4118 
4119     /* .session attach TABLE
4120     ** Invoke the sqlite3session_attach() interface to attach a particular
4121     ** table so that it is never filtered.
4122     */
4123     if( strcmp(azCmd[0],"attach")==0 ){
4124       if( nCmd!=2 ) goto session_syntax_error;
4125       if( pSession->p==0 ){
4126         session_not_open:
4127         raw_printf(stderr, "ERROR: No sessions are open\n");
4128       }else{
4129         rc = sqlite3session_attach(pSession->p, azCmd[1]);
4130         if( rc ){
4131           raw_printf(stderr, "ERROR: sqlite3session_attach() returns %d\n", rc);
4132           rc = 0;
4133         }
4134       }
4135     }else
4136 
4137     /* .session changeset FILE
4138     ** .session patchset FILE
4139     ** Write a changeset or patchset into a file.  The file is overwritten.
4140     */
4141     if( strcmp(azCmd[0],"changeset")==0 || strcmp(azCmd[0],"patchset")==0 ){
4142       FILE *out = 0;
4143       if( nCmd!=2 ) goto session_syntax_error;
4144       if( pSession->p==0 ) goto session_not_open;
4145       out = fopen(azCmd[1], "wb");
4146       if( out==0 ){
4147         utf8_printf(stderr, "ERROR: cannot open \"%s\" for writing\n", azCmd[1]);
4148       }else{
4149         int szChng;
4150         void *pChng;
4151         if( azCmd[0][0]=='c' ){
4152           rc = sqlite3session_changeset(pSession->p, &szChng, &pChng);
4153         }else{
4154           rc = sqlite3session_patchset(pSession->p, &szChng, &pChng);
4155         }
4156         if( rc ){
4157           printf("Error: error code %d\n", rc);
4158           rc = 0;
4159         }
4160         if( pChng
4161           && fwrite(pChng, szChng, 1, out)!=1 ){
4162           raw_printf(stderr, "ERROR: Failed to write entire %d-byte output\n",
4163                   szChng);
4164         }
4165         sqlite3_free(pChng);
4166         fclose(out);
4167       }
4168     }else
4169 
4170     /* .session close
4171     ** Close the identified session
4172     */
4173     if( strcmp(azCmd[0], "close")==0 ){
4174       if( nCmd!=1 ) goto session_syntax_error;
4175       if( p->nSession ){
4176         session_close(pSession);
4177         p->aSession[iSes] = p->aSession[--p->nSession];
4178       }
4179     }else
4180 
4181     /* .session enable ?BOOLEAN?
4182     ** Query or set the enable flag
4183     */
4184     if( strcmp(azCmd[0], "enable")==0 ){
4185       int ii;
4186       if( nCmd>2 ) goto session_syntax_error;
4187       ii = nCmd==1 ? -1 : booleanValue(azCmd[1]);
4188       if( p->nSession ){
4189         ii = sqlite3session_enable(pSession->p, ii);
4190         utf8_printf(p->out, "session %s enable flag = %d\n",
4191                     pSession->zName, ii);
4192       }
4193     }else
4194 
4195     /* .session filter GLOB ....
4196     ** Set a list of GLOB patterns of table names to be excluded.
4197     */
4198     if( strcmp(azCmd[0], "filter")==0 ){
4199       int ii, nByte;
4200       if( nCmd<2 ) goto session_syntax_error;
4201       if( p->nSession ){
4202         for(ii=0; ii<pSession->nFilter; ii++){
4203           sqlite3_free(pSession->azFilter[ii]);
4204         }
4205         sqlite3_free(pSession->azFilter);
4206         nByte = sizeof(pSession->azFilter[0])*(nCmd-1);
4207         pSession->azFilter = sqlite3_malloc( nByte );
4208         if( pSession->azFilter==0 ){
4209           raw_printf(stderr, "Error: out or memory\n");
4210           exit(1);
4211         }
4212         for(ii=1; ii<nCmd; ii++){
4213           pSession->azFilter[ii-1] = sqlite3_mprintf("%s", azCmd[ii]);
4214         }
4215         pSession->nFilter = ii-1;
4216       }
4217     }else
4218 
4219     /* .session indirect ?BOOLEAN?
4220     ** Query or set the indirect flag
4221     */
4222     if( strcmp(azCmd[0], "indirect")==0 ){
4223       int ii;
4224       if( nCmd>2 ) goto session_syntax_error;
4225       ii = nCmd==1 ? -1 : booleanValue(azCmd[1]);
4226       if( p->nSession ){
4227         ii = sqlite3session_indirect(pSession->p, ii);
4228         utf8_printf(p->out, "session %s indirect flag = %d\n",
4229                     pSession->zName, ii);
4230       }
4231     }else
4232 
4233     /* .session isempty
4234     ** Determine if the session is empty
4235     */
4236     if( strcmp(azCmd[0], "isempty")==0 ){
4237       int ii;
4238       if( nCmd!=1 ) goto session_syntax_error;
4239       if( p->nSession ){
4240         ii = sqlite3session_isempty(pSession->p);
4241         utf8_printf(p->out, "session %s isempty flag = %d\n",
4242                     pSession->zName, ii);
4243       }
4244     }else
4245 
4246     /* .session list
4247     ** List all currently open sessions
4248     */
4249     if( strcmp(azCmd[0],"list")==0 ){
4250       for(i=0; i<p->nSession; i++){
4251         utf8_printf(p->out, "%d %s\n", i, p->aSession[i].zName);
4252       }
4253     }else
4254 
4255     /* .session open DB NAME
4256     ** Open a new session called NAME on the attached database DB.
4257     ** DB is normally "main".
4258     */
4259     if( strcmp(azCmd[0],"open")==0 ){
4260       char *zName;
4261       if( nCmd!=3 ) goto session_syntax_error;
4262       zName = azCmd[2];
4263       if( zName[0]==0 ) goto session_syntax_error;
4264       for(i=0; i<p->nSession; i++){
4265         if( strcmp(p->aSession[i].zName,zName)==0 ){
4266           utf8_printf(stderr, "Session \"%s\" already exists\n", zName);
4267           goto meta_command_exit;
4268         }
4269       }
4270       if( p->nSession>=ArraySize(p->aSession) ){
4271         raw_printf(stderr, "Maximum of %d sessions\n", ArraySize(p->aSession));
4272         goto meta_command_exit;
4273       }
4274       pSession = &p->aSession[p->nSession];
4275       rc = sqlite3session_create(p->db, azCmd[1], &pSession->p);
4276       if( rc ){
4277         raw_printf(stderr, "Cannot open session: error code=%d\n", rc);
4278         rc = 0;
4279         goto meta_command_exit;
4280       }
4281       pSession->nFilter = 0;
4282       sqlite3session_table_filter(pSession->p, session_filter, pSession);
4283       p->nSession++;
4284       pSession->zName = sqlite3_mprintf("%s", zName);
4285     }else
4286     /* If no command name matches, show a syntax error */
4287     session_syntax_error:
4288     session_help(p);
4289   }else
4290 #endif
4291 
4292 #ifdef SQLITE_DEBUG
4293   /* Undocumented commands for internal testing.  Subject to change
4294   ** without notice. */
4295   if( c=='s' && n>=10 && strncmp(azArg[0], "selftest-", 9)==0 ){
4296     if( strncmp(azArg[0]+9, "boolean", n-9)==0 ){
4297       int i, v;
4298       for(i=1; i<nArg; i++){
4299         v = booleanValue(azArg[i]);
4300         utf8_printf(p->out, "%s: %d 0x%x\n", azArg[i], v, v);
4301       }
4302     }
4303     if( strncmp(azArg[0]+9, "integer", n-9)==0 ){
4304       int i; sqlite3_int64 v;
4305       for(i=1; i<nArg; i++){
4306         char zBuf[200];
4307         v = integerValue(azArg[i]);
4308         sqlite3_snprintf(sizeof(zBuf),zBuf,"%s: %lld 0x%llx\n", azArg[i],v,v);
4309         utf8_printf(p->out, "%s", zBuf);
4310       }
4311     }
4312   }else
4313 #endif
4314 
4315   if( c=='s' && strncmp(azArg[0], "separator", n)==0 ){
4316     if( nArg<2 || nArg>3 ){
4317       raw_printf(stderr, "Usage: .separator COL ?ROW?\n");
4318       rc = 1;
4319     }
4320     if( nArg>=2 ){
4321       sqlite3_snprintf(sizeof(p->colSeparator), p->colSeparator,
4322                        "%.*s", (int)ArraySize(p->colSeparator)-1, azArg[1]);
4323     }
4324     if( nArg>=3 ){
4325       sqlite3_snprintf(sizeof(p->rowSeparator), p->rowSeparator,
4326                        "%.*s", (int)ArraySize(p->rowSeparator)-1, azArg[2]);
4327     }
4328   }else
4329 
4330   if( c=='s'
4331    && (strncmp(azArg[0], "shell", n)==0 || strncmp(azArg[0],"system",n)==0)
4332   ){
4333     char *zCmd;
4334     int i, x;
4335     if( nArg<2 ){
4336       raw_printf(stderr, "Usage: .system COMMAND\n");
4337       rc = 1;
4338       goto meta_command_exit;
4339     }
4340     zCmd = sqlite3_mprintf(strchr(azArg[1],' ')==0?"%s":"\"%s\"", azArg[1]);
4341     for(i=2; i<nArg; i++){
4342       zCmd = sqlite3_mprintf(strchr(azArg[i],' ')==0?"%z %s":"%z \"%s\"",
4343                              zCmd, azArg[i]);
4344     }
4345     x = system(zCmd);
4346     sqlite3_free(zCmd);
4347     if( x ) raw_printf(stderr, "System command returns %d\n", x);
4348   }else
4349 
4350   if( c=='s' && strncmp(azArg[0], "show", n)==0 ){
4351     static const char *azBool[] = { "off", "on", "full", "unk" };
4352     int i;
4353     if( nArg!=1 ){
4354       raw_printf(stderr, "Usage: .show\n");
4355       rc = 1;
4356       goto meta_command_exit;
4357     }
4358     utf8_printf(p->out, "%12.12s: %s\n","echo", azBool[p->echoOn!=0]);
4359     utf8_printf(p->out, "%12.12s: %s\n","eqp", azBool[p->autoEQP&3]);
4360     utf8_printf(p->out, "%12.12s: %s\n","explain",
4361          p->mode==MODE_Explain ? "on" : p->autoExplain ? "auto" : "off");
4362     utf8_printf(p->out,"%12.12s: %s\n","headers", azBool[p->showHeader!=0]);
4363     utf8_printf(p->out, "%12.12s: %s\n","mode", modeDescr[p->mode]);
4364     utf8_printf(p->out, "%12.12s: ", "nullvalue");
4365       output_c_string(p->out, p->nullValue);
4366       raw_printf(p->out, "\n");
4367     utf8_printf(p->out,"%12.12s: %s\n","output",
4368             strlen30(p->outfile) ? p->outfile : "stdout");
4369     utf8_printf(p->out,"%12.12s: ", "colseparator");
4370       output_c_string(p->out, p->colSeparator);
4371       raw_printf(p->out, "\n");
4372     utf8_printf(p->out,"%12.12s: ", "rowseparator");
4373       output_c_string(p->out, p->rowSeparator);
4374       raw_printf(p->out, "\n");
4375     utf8_printf(p->out, "%12.12s: %s\n","stats", azBool[p->statsOn!=0]);
4376     utf8_printf(p->out, "%12.12s: ", "width");
4377     for (i=0;i<(int)ArraySize(p->colWidth) && p->colWidth[i] != 0;i++) {
4378       raw_printf(p->out, "%d ", p->colWidth[i]);
4379     }
4380     raw_printf(p->out, "\n");
4381   }else
4382 
4383   if( c=='s' && strncmp(azArg[0], "stats", n)==0 ){
4384     if( nArg==2 ){
4385       p->statsOn = booleanValue(azArg[1]);
4386     }else if( nArg==1 ){
4387       display_stats(p->db, p, 0);
4388     }else{
4389       raw_printf(stderr, "Usage: .stats ?on|off?\n");
4390       rc = 1;
4391     }
4392   }else
4393 
4394   if( c=='t' && n>1 && strncmp(azArg[0], "tables", n)==0 ){
4395     sqlite3_stmt *pStmt;
4396     char **azResult;
4397     int nRow, nAlloc;
4398     char *zSql = 0;
4399     int ii;
4400     open_db(p, 0);
4401     rc = sqlite3_prepare_v2(p->db, "PRAGMA database_list", -1, &pStmt, 0);
4402     if( rc ) return shellDatabaseError(p->db);
4403 
4404     /* Create an SQL statement to query for the list of tables in the
4405     ** main and all attached databases where the table name matches the
4406     ** LIKE pattern bound to variable "?1". */
4407     zSql = sqlite3_mprintf(
4408         "SELECT name FROM sqlite_master"
4409         " WHERE type IN ('table','view')"
4410         "   AND name NOT LIKE 'sqlite_%%'"
4411         "   AND name LIKE ?1");
4412     while( zSql && sqlite3_step(pStmt)==SQLITE_ROW ){
4413       const char *zDbName = (const char*)sqlite3_column_text(pStmt, 1);
4414       if( zDbName==0 || strcmp(zDbName,"main")==0 ) continue;
4415       if( strcmp(zDbName,"temp")==0 ){
4416         zSql = sqlite3_mprintf(
4417                  "%z UNION ALL "
4418                  "SELECT 'temp.' || name FROM sqlite_temp_master"
4419                  " WHERE type IN ('table','view')"
4420                  "   AND name NOT LIKE 'sqlite_%%'"
4421                  "   AND name LIKE ?1", zSql);
4422       }else{
4423         zSql = sqlite3_mprintf(
4424                  "%z UNION ALL "
4425                  "SELECT '%q.' || name FROM \"%w\".sqlite_master"
4426                  " WHERE type IN ('table','view')"
4427                  "   AND name NOT LIKE 'sqlite_%%'"
4428                  "   AND name LIKE ?1", zSql, zDbName, zDbName);
4429       }
4430     }
4431     rc = sqlite3_finalize(pStmt);
4432     if( zSql && rc==SQLITE_OK ){
4433       zSql = sqlite3_mprintf("%z ORDER BY 1", zSql);
4434       if( zSql ) rc = sqlite3_prepare_v2(p->db, zSql, -1, &pStmt, 0);
4435     }
4436     sqlite3_free(zSql);
4437     if( !zSql ) return shellNomemError();
4438     if( rc ) return shellDatabaseError(p->db);
4439 
4440     /* Run the SQL statement prepared by the above block. Store the results
4441     ** as an array of nul-terminated strings in azResult[].  */
4442     nRow = nAlloc = 0;
4443     azResult = 0;
4444     if( nArg>1 ){
4445       sqlite3_bind_text(pStmt, 1, azArg[1], -1, SQLITE_TRANSIENT);
4446     }else{
4447       sqlite3_bind_text(pStmt, 1, "%", -1, SQLITE_STATIC);
4448     }
4449     while( sqlite3_step(pStmt)==SQLITE_ROW ){
4450       if( nRow>=nAlloc ){
4451         char **azNew;
4452         int n2 = nAlloc*2 + 10;
4453         azNew = sqlite3_realloc64(azResult, sizeof(azResult[0])*n2);
4454         if( azNew==0 ){
4455           rc = shellNomemError();
4456           break;
4457         }
4458         nAlloc = n2;
4459         azResult = azNew;
4460       }
4461       azResult[nRow] = sqlite3_mprintf("%s", sqlite3_column_text(pStmt, 0));
4462       if( 0==azResult[nRow] ){
4463         rc = shellNomemError();
4464         break;
4465       }
4466       nRow++;
4467     }
4468     if( sqlite3_finalize(pStmt)!=SQLITE_OK ){
4469       rc = shellDatabaseError(p->db);
4470     }
4471 
4472     /* Pretty-print the contents of array azResult[] to the output */
4473     if( rc==0 && nRow>0 ){
4474       int len, maxlen = 0;
4475       int i, j;
4476       int nPrintCol, nPrintRow;
4477       for(i=0; i<nRow; i++){
4478         len = strlen30(azResult[i]);
4479         if( len>maxlen ) maxlen = len;
4480       }
4481       nPrintCol = 80/(maxlen+2);
4482       if( nPrintCol<1 ) nPrintCol = 1;
4483       nPrintRow = (nRow + nPrintCol - 1)/nPrintCol;
4484       for(i=0; i<nPrintRow; i++){
4485         for(j=i; j<nRow; j+=nPrintRow){
4486           char *zSp = j<nPrintRow ? "" : "  ";
4487           utf8_printf(p->out, "%s%-*s", zSp, maxlen,
4488                       azResult[j] ? azResult[j]:"");
4489         }
4490         raw_printf(p->out, "\n");
4491       }
4492     }
4493 
4494     for(ii=0; ii<nRow; ii++) sqlite3_free(azResult[ii]);
4495     sqlite3_free(azResult);
4496   }else
4497 
4498   if( c=='t' && n>=8 && strncmp(azArg[0], "testctrl", n)==0 && nArg>=2 ){
4499     static const struct {
4500        const char *zCtrlName;   /* Name of a test-control option */
4501        int ctrlCode;            /* Integer code for that option */
4502     } aCtrl[] = {
4503       { "prng_save",             SQLITE_TESTCTRL_PRNG_SAVE              },
4504       { "prng_restore",          SQLITE_TESTCTRL_PRNG_RESTORE           },
4505       { "prng_reset",            SQLITE_TESTCTRL_PRNG_RESET             },
4506       { "bitvec_test",           SQLITE_TESTCTRL_BITVEC_TEST            },
4507       { "fault_install",         SQLITE_TESTCTRL_FAULT_INSTALL          },
4508       { "benign_malloc_hooks",   SQLITE_TESTCTRL_BENIGN_MALLOC_HOOKS    },
4509       { "pending_byte",          SQLITE_TESTCTRL_PENDING_BYTE           },
4510       { "assert",                SQLITE_TESTCTRL_ASSERT                 },
4511       { "always",                SQLITE_TESTCTRL_ALWAYS                 },
4512       { "reserve",               SQLITE_TESTCTRL_RESERVE                },
4513       { "optimizations",         SQLITE_TESTCTRL_OPTIMIZATIONS          },
4514       { "iskeyword",             SQLITE_TESTCTRL_ISKEYWORD              },
4515       { "scratchmalloc",         SQLITE_TESTCTRL_SCRATCHMALLOC          },
4516       { "byteorder",             SQLITE_TESTCTRL_BYTEORDER              },
4517       { "never_corrupt",         SQLITE_TESTCTRL_NEVER_CORRUPT          },
4518       { "imposter",              SQLITE_TESTCTRL_IMPOSTER               },
4519     };
4520     int testctrl = -1;
4521     int rc2 = 0;
4522     int i, n2;
4523     open_db(p, 0);
4524 
4525     /* convert testctrl text option to value. allow any unique prefix
4526     ** of the option name, or a numerical value. */
4527     n2 = strlen30(azArg[1]);
4528     for(i=0; i<ArraySize(aCtrl); i++){
4529       if( strncmp(azArg[1], aCtrl[i].zCtrlName, n2)==0 ){
4530         if( testctrl<0 ){
4531           testctrl = aCtrl[i].ctrlCode;
4532         }else{
4533           utf8_printf(stderr, "ambiguous option name: \"%s\"\n", azArg[1]);
4534           testctrl = -1;
4535           break;
4536         }
4537       }
4538     }
4539     if( testctrl<0 ) testctrl = (int)integerValue(azArg[1]);
4540     if( (testctrl<SQLITE_TESTCTRL_FIRST) || (testctrl>SQLITE_TESTCTRL_LAST) ){
4541       utf8_printf(stderr,"Error: invalid testctrl option: %s\n", azArg[1]);
4542     }else{
4543       switch(testctrl){
4544 
4545         /* sqlite3_test_control(int, db, int) */
4546         case SQLITE_TESTCTRL_OPTIMIZATIONS:
4547         case SQLITE_TESTCTRL_RESERVE:
4548           if( nArg==3 ){
4549             int opt = (int)strtol(azArg[2], 0, 0);
4550             rc2 = sqlite3_test_control(testctrl, p->db, opt);
4551             raw_printf(p->out, "%d (0x%08x)\n", rc2, rc2);
4552           } else {
4553             utf8_printf(stderr,"Error: testctrl %s takes a single int option\n",
4554                     azArg[1]);
4555           }
4556           break;
4557 
4558         /* sqlite3_test_control(int) */
4559         case SQLITE_TESTCTRL_PRNG_SAVE:
4560         case SQLITE_TESTCTRL_PRNG_RESTORE:
4561         case SQLITE_TESTCTRL_PRNG_RESET:
4562         case SQLITE_TESTCTRL_BYTEORDER:
4563           if( nArg==2 ){
4564             rc2 = sqlite3_test_control(testctrl);
4565             raw_printf(p->out, "%d (0x%08x)\n", rc2, rc2);
4566           } else {
4567             utf8_printf(stderr,"Error: testctrl %s takes no options\n",
4568                         azArg[1]);
4569           }
4570           break;
4571 
4572         /* sqlite3_test_control(int, uint) */
4573         case SQLITE_TESTCTRL_PENDING_BYTE:
4574           if( nArg==3 ){
4575             unsigned int opt = (unsigned int)integerValue(azArg[2]);
4576             rc2 = sqlite3_test_control(testctrl, opt);
4577             raw_printf(p->out, "%d (0x%08x)\n", rc2, rc2);
4578           } else {
4579             utf8_printf(stderr,"Error: testctrl %s takes a single unsigned"
4580                            " int option\n", azArg[1]);
4581           }
4582           break;
4583 
4584         /* sqlite3_test_control(int, int) */
4585         case SQLITE_TESTCTRL_ASSERT:
4586         case SQLITE_TESTCTRL_ALWAYS:
4587         case SQLITE_TESTCTRL_NEVER_CORRUPT:
4588           if( nArg==3 ){
4589             int opt = booleanValue(azArg[2]);
4590             rc2 = sqlite3_test_control(testctrl, opt);
4591             raw_printf(p->out, "%d (0x%08x)\n", rc2, rc2);
4592           } else {
4593             utf8_printf(stderr,"Error: testctrl %s takes a single int option\n",
4594                             azArg[1]);
4595           }
4596           break;
4597 
4598         /* sqlite3_test_control(int, char *) */
4599 #ifdef SQLITE_N_KEYWORD
4600         case SQLITE_TESTCTRL_ISKEYWORD:
4601           if( nArg==3 ){
4602             const char *opt = azArg[2];
4603             rc2 = sqlite3_test_control(testctrl, opt);
4604             raw_printf(p->out, "%d (0x%08x)\n", rc2, rc2);
4605           } else {
4606             utf8_printf(stderr,
4607                         "Error: testctrl %s takes a single char * option\n",
4608                         azArg[1]);
4609           }
4610           break;
4611 #endif
4612 
4613         case SQLITE_TESTCTRL_IMPOSTER:
4614           if( nArg==5 ){
4615             rc2 = sqlite3_test_control(testctrl, p->db,
4616                           azArg[2],
4617                           integerValue(azArg[3]),
4618                           integerValue(azArg[4]));
4619             raw_printf(p->out, "%d (0x%08x)\n", rc2, rc2);
4620           }else{
4621             raw_printf(stderr,"Usage: .testctrl imposter dbName onoff tnum\n");
4622           }
4623           break;
4624 
4625         case SQLITE_TESTCTRL_BITVEC_TEST:
4626         case SQLITE_TESTCTRL_FAULT_INSTALL:
4627         case SQLITE_TESTCTRL_BENIGN_MALLOC_HOOKS:
4628         case SQLITE_TESTCTRL_SCRATCHMALLOC:
4629         default:
4630           utf8_printf(stderr,
4631                       "Error: CLI support for testctrl %s not implemented\n",
4632                       azArg[1]);
4633           break;
4634       }
4635     }
4636   }else
4637 
4638   if( c=='t' && n>4 && strncmp(azArg[0], "timeout", n)==0 ){
4639     open_db(p, 0);
4640     sqlite3_busy_timeout(p->db, nArg>=2 ? (int)integerValue(azArg[1]) : 0);
4641   }else
4642 
4643   if( c=='t' && n>=5 && strncmp(azArg[0], "timer", n)==0 ){
4644     if( nArg==2 ){
4645       enableTimer = booleanValue(azArg[1]);
4646       if( enableTimer && !HAS_TIMER ){
4647         raw_printf(stderr, "Error: timer not available on this system.\n");
4648         enableTimer = 0;
4649       }
4650     }else{
4651       raw_printf(stderr, "Usage: .timer on|off\n");
4652       rc = 1;
4653     }
4654   }else
4655 
4656   if( c=='t' && strncmp(azArg[0], "trace", n)==0 ){
4657     open_db(p, 0);
4658     if( nArg!=2 ){
4659       raw_printf(stderr, "Usage: .trace FILE|off\n");
4660       rc = 1;
4661       goto meta_command_exit;
4662     }
4663     output_file_close(p->traceOut);
4664     p->traceOut = output_file_open(azArg[1]);
4665 #if !defined(SQLITE_OMIT_TRACE) && !defined(SQLITE_OMIT_FLOATING_POINT)
4666     if( p->traceOut==0 ){
4667       sqlite3_trace_v2(p->db, 0, 0, 0);
4668     }else{
4669       sqlite3_trace_v2(p->db, SQLITE_TRACE_STMT, sql_trace_callback,p->traceOut);
4670     }
4671 #endif
4672   }else
4673 
4674 #if SQLITE_USER_AUTHENTICATION
4675   if( c=='u' && strncmp(azArg[0], "user", n)==0 ){
4676     if( nArg<2 ){
4677       raw_printf(stderr, "Usage: .user SUBCOMMAND ...\n");
4678       rc = 1;
4679       goto meta_command_exit;
4680     }
4681     open_db(p, 0);
4682     if( strcmp(azArg[1],"login")==0 ){
4683       if( nArg!=4 ){
4684         raw_printf(stderr, "Usage: .user login USER PASSWORD\n");
4685         rc = 1;
4686         goto meta_command_exit;
4687       }
4688       rc = sqlite3_user_authenticate(p->db, azArg[2], azArg[3],
4689                                     (int)strlen(azArg[3]));
4690       if( rc ){
4691         utf8_printf(stderr, "Authentication failed for user %s\n", azArg[2]);
4692         rc = 1;
4693       }
4694     }else if( strcmp(azArg[1],"add")==0 ){
4695       if( nArg!=5 ){
4696         raw_printf(stderr, "Usage: .user add USER PASSWORD ISADMIN\n");
4697         rc = 1;
4698         goto meta_command_exit;
4699       }
4700       rc = sqlite3_user_add(p->db, azArg[2],
4701                             azArg[3], (int)strlen(azArg[3]),
4702                             booleanValue(azArg[4]));
4703       if( rc ){
4704         raw_printf(stderr, "User-Add failed: %d\n", rc);
4705         rc = 1;
4706       }
4707     }else if( strcmp(azArg[1],"edit")==0 ){
4708       if( nArg!=5 ){
4709         raw_printf(stderr, "Usage: .user edit USER PASSWORD ISADMIN\n");
4710         rc = 1;
4711         goto meta_command_exit;
4712       }
4713       rc = sqlite3_user_change(p->db, azArg[2],
4714                               azArg[3], (int)strlen(azArg[3]),
4715                               booleanValue(azArg[4]));
4716       if( rc ){
4717         raw_printf(stderr, "User-Edit failed: %d\n", rc);
4718         rc = 1;
4719       }
4720     }else if( strcmp(azArg[1],"delete")==0 ){
4721       if( nArg!=3 ){
4722         raw_printf(stderr, "Usage: .user delete USER\n");
4723         rc = 1;
4724         goto meta_command_exit;
4725       }
4726       rc = sqlite3_user_delete(p->db, azArg[2]);
4727       if( rc ){
4728         raw_printf(stderr, "User-Delete failed: %d\n", rc);
4729         rc = 1;
4730       }
4731     }else{
4732       raw_printf(stderr, "Usage: .user login|add|edit|delete ...\n");
4733       rc = 1;
4734       goto meta_command_exit;
4735     }
4736   }else
4737 #endif /* SQLITE_USER_AUTHENTICATION */
4738 
4739   if( c=='v' && strncmp(azArg[0], "version", n)==0 ){
4740     utf8_printf(p->out, "SQLite %s %s\n" /*extra-version-info*/,
4741         sqlite3_libversion(), sqlite3_sourceid());
4742   }else
4743 
4744   if( c=='v' && strncmp(azArg[0], "vfsinfo", n)==0 ){
4745     const char *zDbName = nArg==2 ? azArg[1] : "main";
4746     sqlite3_vfs *pVfs;
4747     if( p->db ){
4748       sqlite3_file_control(p->db, zDbName, SQLITE_FCNTL_VFS_POINTER, &pVfs);
4749       if( pVfs ){
4750         utf8_printf(p->out, "vfs.zName      = \"%s\"\n", pVfs->zName);
4751         raw_printf(p->out, "vfs.iVersion   = %d\n", pVfs->iVersion);
4752         raw_printf(p->out, "vfs.szOsFile   = %d\n", pVfs->szOsFile);
4753         raw_printf(p->out, "vfs.mxPathname = %d\n", pVfs->mxPathname);
4754       }
4755     }
4756   }else
4757 
4758   if( c=='v' && strncmp(azArg[0], "vfslist", n)==0 ){
4759     sqlite3_vfs *pVfs;
4760     sqlite3_vfs *pCurrent = 0;
4761     if( p->db ){
4762       sqlite3_file_control(p->db, "main", SQLITE_FCNTL_VFS_POINTER, &pCurrent);
4763     }
4764     for(pVfs=sqlite3_vfs_find(0); pVfs; pVfs=pVfs->pNext){
4765       utf8_printf(p->out, "vfs.zName      = \"%s\"%s\n", pVfs->zName,
4766            pVfs==pCurrent ? "  <--- CURRENT" : "");
4767       raw_printf(p->out, "vfs.iVersion   = %d\n", pVfs->iVersion);
4768       raw_printf(p->out, "vfs.szOsFile   = %d\n", pVfs->szOsFile);
4769       raw_printf(p->out, "vfs.mxPathname = %d\n", pVfs->mxPathname);
4770       if( pVfs->pNext ){
4771         raw_printf(p->out, "-----------------------------------\n");
4772       }
4773     }
4774   }else
4775 
4776   if( c=='v' && strncmp(azArg[0], "vfsname", n)==0 ){
4777     const char *zDbName = nArg==2 ? azArg[1] : "main";
4778     char *zVfsName = 0;
4779     if( p->db ){
4780       sqlite3_file_control(p->db, zDbName, SQLITE_FCNTL_VFSNAME, &zVfsName);
4781       if( zVfsName ){
4782         utf8_printf(p->out, "%s\n", zVfsName);
4783         sqlite3_free(zVfsName);
4784       }
4785     }
4786   }else
4787 
4788 #if defined(SQLITE_DEBUG) && defined(SQLITE_ENABLE_WHERETRACE)
4789   if( c=='w' && strncmp(azArg[0], "wheretrace", n)==0 ){
4790     sqlite3WhereTrace = nArg>=2 ? booleanValue(azArg[1]) : 0xff;
4791   }else
4792 #endif
4793 
4794   if( c=='w' && strncmp(azArg[0], "width", n)==0 ){
4795     int j;
4796     assert( nArg<=ArraySize(azArg) );
4797     for(j=1; j<nArg && j<ArraySize(p->colWidth); j++){
4798       p->colWidth[j-1] = (int)integerValue(azArg[j]);
4799     }
4800   }else
4801 
4802   {
4803     utf8_printf(stderr, "Error: unknown command or invalid arguments: "
4804       " \"%s\". Enter \".help\" for help\n", azArg[0]);
4805     rc = 1;
4806   }
4807 
4808 meta_command_exit:
4809   if( p->outCount ){
4810     p->outCount--;
4811     if( p->outCount==0 ) output_reset(p);
4812   }
4813   return rc;
4814 }
4815 
4816 /*
4817 ** Return TRUE if a semicolon occurs anywhere in the first N characters
4818 ** of string z[].
4819 */
4820 static int line_contains_semicolon(const char *z, int N){
4821   int i;
4822   for(i=0; i<N; i++){  if( z[i]==';' ) return 1; }
4823   return 0;
4824 }
4825 
4826 /*
4827 ** Test to see if a line consists entirely of whitespace.
4828 */
4829 static int _all_whitespace(const char *z){
4830   for(; *z; z++){
4831     if( IsSpace(z[0]) ) continue;
4832     if( *z=='/' && z[1]=='*' ){
4833       z += 2;
4834       while( *z && (*z!='*' || z[1]!='/') ){ z++; }
4835       if( *z==0 ) return 0;
4836       z++;
4837       continue;
4838     }
4839     if( *z=='-' && z[1]=='-' ){
4840       z += 2;
4841       while( *z && *z!='\n' ){ z++; }
4842       if( *z==0 ) return 1;
4843       continue;
4844     }
4845     return 0;
4846   }
4847   return 1;
4848 }
4849 
4850 /*
4851 ** Return TRUE if the line typed in is an SQL command terminator other
4852 ** than a semi-colon.  The SQL Server style "go" command is understood
4853 ** as is the Oracle "/".
4854 */
4855 static int line_is_command_terminator(const char *zLine){
4856   while( IsSpace(zLine[0]) ){ zLine++; };
4857   if( zLine[0]=='/' && _all_whitespace(&zLine[1]) ){
4858     return 1;  /* Oracle */
4859   }
4860   if( ToLower(zLine[0])=='g' && ToLower(zLine[1])=='o'
4861          && _all_whitespace(&zLine[2]) ){
4862     return 1;  /* SQL Server */
4863   }
4864   return 0;
4865 }
4866 
4867 /*
4868 ** Return true if zSql is a complete SQL statement.  Return false if it
4869 ** ends in the middle of a string literal or C-style comment.
4870 */
4871 static int line_is_complete(char *zSql, int nSql){
4872   int rc;
4873   if( zSql==0 ) return 1;
4874   zSql[nSql] = ';';
4875   zSql[nSql+1] = 0;
4876   rc = sqlite3_complete(zSql);
4877   zSql[nSql] = 0;
4878   return rc;
4879 }
4880 
4881 /*
4882 ** Read input from *in and process it.  If *in==0 then input
4883 ** is interactive - the user is typing it it.  Otherwise, input
4884 ** is coming from a file or device.  A prompt is issued and history
4885 ** is saved only if input is interactive.  An interrupt signal will
4886 ** cause this routine to exit immediately, unless input is interactive.
4887 **
4888 ** Return the number of errors.
4889 */
4890 static int process_input(ShellState *p, FILE *in){
4891   char *zLine = 0;          /* A single input line */
4892   char *zSql = 0;           /* Accumulated SQL text */
4893   int nLine;                /* Length of current line */
4894   int nSql = 0;             /* Bytes of zSql[] used */
4895   int nAlloc = 0;           /* Allocated zSql[] space */
4896   int nSqlPrior = 0;        /* Bytes of zSql[] used by prior line */
4897   char *zErrMsg;            /* Error message returned */
4898   int rc;                   /* Error code */
4899   int errCnt = 0;           /* Number of errors seen */
4900   int lineno = 0;           /* Current line number */
4901   int startline = 0;        /* Line number for start of current input */
4902 
4903   while( errCnt==0 || !bail_on_error || (in==0 && stdin_is_interactive) ){
4904     fflush(p->out);
4905     zLine = one_input_line(in, zLine, nSql>0);
4906     if( zLine==0 ){
4907       /* End of input */
4908       if( stdin_is_interactive ) printf("\n");
4909       break;
4910     }
4911     if( seenInterrupt ){
4912       if( in!=0 ) break;
4913       seenInterrupt = 0;
4914     }
4915     lineno++;
4916     if( nSql==0 && _all_whitespace(zLine) ){
4917       if( p->echoOn ) printf("%s\n", zLine);
4918       continue;
4919     }
4920     if( zLine && zLine[0]=='.' && nSql==0 ){
4921       if( p->echoOn ) printf("%s\n", zLine);
4922       rc = do_meta_command(zLine, p);
4923       if( rc==2 ){ /* exit requested */
4924         break;
4925       }else if( rc ){
4926         errCnt++;
4927       }
4928       continue;
4929     }
4930     if( line_is_command_terminator(zLine) && line_is_complete(zSql, nSql) ){
4931       memcpy(zLine,";",2);
4932     }
4933     nLine = strlen30(zLine);
4934     if( nSql+nLine+2>=nAlloc ){
4935       nAlloc = nSql+nLine+100;
4936       zSql = realloc(zSql, nAlloc);
4937       if( zSql==0 ){
4938         raw_printf(stderr, "Error: out of memory\n");
4939         exit(1);
4940       }
4941     }
4942     nSqlPrior = nSql;
4943     if( nSql==0 ){
4944       int i;
4945       for(i=0; zLine[i] && IsSpace(zLine[i]); i++){}
4946       assert( nAlloc>0 && zSql!=0 );
4947       memcpy(zSql, zLine+i, nLine+1-i);
4948       startline = lineno;
4949       nSql = nLine-i;
4950     }else{
4951       zSql[nSql++] = '\n';
4952       memcpy(zSql+nSql, zLine, nLine+1);
4953       nSql += nLine;
4954     }
4955     if( nSql && line_contains_semicolon(&zSql[nSqlPrior], nSql-nSqlPrior)
4956                 && sqlite3_complete(zSql) ){
4957       p->cnt = 0;
4958       open_db(p, 0);
4959       if( p->backslashOn ) resolve_backslashes(zSql);
4960       BEGIN_TIMER;
4961       rc = shell_exec(p->db, zSql, shell_callback, p, &zErrMsg);
4962       END_TIMER;
4963       if( rc || zErrMsg ){
4964         char zPrefix[100];
4965         if( in!=0 || !stdin_is_interactive ){
4966           sqlite3_snprintf(sizeof(zPrefix), zPrefix,
4967                            "Error: near line %d:", startline);
4968         }else{
4969           sqlite3_snprintf(sizeof(zPrefix), zPrefix, "Error:");
4970         }
4971         if( zErrMsg!=0 ){
4972           utf8_printf(stderr, "%s %s\n", zPrefix, zErrMsg);
4973           sqlite3_free(zErrMsg);
4974           zErrMsg = 0;
4975         }else{
4976           utf8_printf(stderr, "%s %s\n", zPrefix, sqlite3_errmsg(p->db));
4977         }
4978         errCnt++;
4979       }else if( p->countChanges ){
4980         raw_printf(p->out, "changes: %3d   total_changes: %d\n",
4981                 sqlite3_changes(p->db), sqlite3_total_changes(p->db));
4982       }
4983       nSql = 0;
4984       if( p->outCount ){
4985         output_reset(p);
4986         p->outCount = 0;
4987       }
4988     }else if( nSql && _all_whitespace(zSql) ){
4989       if( p->echoOn ) printf("%s\n", zSql);
4990       nSql = 0;
4991     }
4992   }
4993   if( nSql ){
4994     if( !_all_whitespace(zSql) ){
4995       utf8_printf(stderr, "Error: incomplete SQL: %s\n", zSql);
4996       errCnt++;
4997     }
4998   }
4999   free(zSql);
5000   free(zLine);
5001   return errCnt>0;
5002 }
5003 
5004 /*
5005 ** Return a pathname which is the user's home directory.  A
5006 ** 0 return indicates an error of some kind.
5007 */
5008 static char *find_home_dir(void){
5009   static char *home_dir = NULL;
5010   if( home_dir ) return home_dir;
5011 
5012 #if !defined(_WIN32) && !defined(WIN32) && !defined(_WIN32_WCE) \
5013      && !defined(__RTP__) && !defined(_WRS_KERNEL)
5014   {
5015     struct passwd *pwent;
5016     uid_t uid = getuid();
5017     if( (pwent=getpwuid(uid)) != NULL) {
5018       home_dir = pwent->pw_dir;
5019     }
5020   }
5021 #endif
5022 
5023 #if defined(_WIN32_WCE)
5024   /* Windows CE (arm-wince-mingw32ce-gcc) does not provide getenv()
5025    */
5026   home_dir = "/";
5027 #else
5028 
5029 #if defined(_WIN32) || defined(WIN32)
5030   if (!home_dir) {
5031     home_dir = getenv("USERPROFILE");
5032   }
5033 #endif
5034 
5035   if (!home_dir) {
5036     home_dir = getenv("HOME");
5037   }
5038 
5039 #if defined(_WIN32) || defined(WIN32)
5040   if (!home_dir) {
5041     char *zDrive, *zPath;
5042     int n;
5043     zDrive = getenv("HOMEDRIVE");
5044     zPath = getenv("HOMEPATH");
5045     if( zDrive && zPath ){
5046       n = strlen30(zDrive) + strlen30(zPath) + 1;
5047       home_dir = malloc( n );
5048       if( home_dir==0 ) return 0;
5049       sqlite3_snprintf(n, home_dir, "%s%s", zDrive, zPath);
5050       return home_dir;
5051     }
5052     home_dir = "c:\\";
5053   }
5054 #endif
5055 
5056 #endif /* !_WIN32_WCE */
5057 
5058   if( home_dir ){
5059     int n = strlen30(home_dir) + 1;
5060     char *z = malloc( n );
5061     if( z ) memcpy(z, home_dir, n);
5062     home_dir = z;
5063   }
5064 
5065   return home_dir;
5066 }
5067 
5068 /*
5069 ** Read input from the file given by sqliterc_override.  Or if that
5070 ** parameter is NULL, take input from ~/.sqliterc
5071 **
5072 ** Returns the number of errors.
5073 */
5074 static void process_sqliterc(
5075   ShellState *p,                  /* Configuration data */
5076   const char *sqliterc_override   /* Name of config file. NULL to use default */
5077 ){
5078   char *home_dir = NULL;
5079   const char *sqliterc = sqliterc_override;
5080   char *zBuf = 0;
5081   FILE *in = NULL;
5082 
5083   if (sqliterc == NULL) {
5084     home_dir = find_home_dir();
5085     if( home_dir==0 ){
5086       raw_printf(stderr, "-- warning: cannot find home directory;"
5087                       " cannot read ~/.sqliterc\n");
5088       return;
5089     }
5090     sqlite3_initialize();
5091     zBuf = sqlite3_mprintf("%s/.sqliterc",home_dir);
5092     sqliterc = zBuf;
5093   }
5094   in = fopen(sqliterc,"rb");
5095   if( in ){
5096     if( stdin_is_interactive ){
5097       utf8_printf(stderr,"-- Loading resources from %s\n",sqliterc);
5098     }
5099     process_input(p,in);
5100     fclose(in);
5101   }
5102   sqlite3_free(zBuf);
5103 }
5104 
5105 /*
5106 ** Show available command line options
5107 */
5108 static const char zOptions[] =
5109   "   -ascii               set output mode to 'ascii'\n"
5110   "   -bail                stop after hitting an error\n"
5111   "   -batch               force batch I/O\n"
5112   "   -column              set output mode to 'column'\n"
5113   "   -cmd COMMAND         run \"COMMAND\" before reading stdin\n"
5114   "   -csv                 set output mode to 'csv'\n"
5115   "   -echo                print commands before execution\n"
5116   "   -init FILENAME       read/process named file\n"
5117   "   -[no]header          turn headers on or off\n"
5118 #if defined(SQLITE_ENABLE_MEMSYS3) || defined(SQLITE_ENABLE_MEMSYS5)
5119   "   -heap SIZE           Size of heap for memsys3 or memsys5\n"
5120 #endif
5121   "   -help                show this message\n"
5122   "   -html                set output mode to HTML\n"
5123   "   -interactive         force interactive I/O\n"
5124   "   -line                set output mode to 'line'\n"
5125   "   -list                set output mode to 'list'\n"
5126   "   -lookaside SIZE N    use N entries of SZ bytes for lookaside memory\n"
5127   "   -mmap N              default mmap size set to N\n"
5128 #ifdef SQLITE_ENABLE_MULTIPLEX
5129   "   -multiplex           enable the multiplexor VFS\n"
5130 #endif
5131   "   -newline SEP         set output row separator. Default: '\\n'\n"
5132   "   -nullvalue TEXT      set text string for NULL values. Default ''\n"
5133   "   -pagecache SIZE N    use N slots of SZ bytes each for page cache memory\n"
5134   "   -scratch SIZE N      use N slots of SZ bytes each for scratch memory\n"
5135   "   -separator SEP       set output column separator. Default: '|'\n"
5136   "   -stats               print memory stats before each finalize\n"
5137   "   -version             show SQLite version\n"
5138   "   -vfs NAME            use NAME as the default VFS\n"
5139 #ifdef SQLITE_ENABLE_VFSTRACE
5140   "   -vfstrace            enable tracing of all VFS calls\n"
5141 #endif
5142 ;
5143 static void usage(int showDetail){
5144   utf8_printf(stderr,
5145       "Usage: %s [OPTIONS] FILENAME [SQL]\n"
5146       "FILENAME is the name of an SQLite database. A new database is created\n"
5147       "if the file does not previously exist.\n", Argv0);
5148   if( showDetail ){
5149     utf8_printf(stderr, "OPTIONS include:\n%s", zOptions);
5150   }else{
5151     raw_printf(stderr, "Use the -help option for additional information\n");
5152   }
5153   exit(1);
5154 }
5155 
5156 /*
5157 ** Initialize the state information in data
5158 */
5159 static void main_init(ShellState *data) {
5160   memset(data, 0, sizeof(*data));
5161   data->normalMode = data->cMode = data->mode = MODE_List;
5162   data->autoExplain = 1;
5163   memcpy(data->colSeparator,SEP_Column, 2);
5164   memcpy(data->rowSeparator,SEP_Row, 2);
5165   data->showHeader = 0;
5166   data->shellFlgs = SHFLG_Lookaside;
5167   sqlite3_config(SQLITE_CONFIG_URI, 1);
5168   sqlite3_config(SQLITE_CONFIG_LOG, shellLog, data);
5169   sqlite3_config(SQLITE_CONFIG_MULTITHREAD);
5170   sqlite3_snprintf(sizeof(mainPrompt), mainPrompt,"sqlite> ");
5171   sqlite3_snprintf(sizeof(continuePrompt), continuePrompt,"   ...> ");
5172 }
5173 
5174 /*
5175 ** Output text to the console in a font that attracts extra attention.
5176 */
5177 #ifdef _WIN32
5178 static void printBold(const char *zText){
5179   HANDLE out = GetStdHandle(STD_OUTPUT_HANDLE);
5180   CONSOLE_SCREEN_BUFFER_INFO defaultScreenInfo;
5181   GetConsoleScreenBufferInfo(out, &defaultScreenInfo);
5182   SetConsoleTextAttribute(out,
5183          FOREGROUND_RED|FOREGROUND_INTENSITY
5184   );
5185   printf("%s", zText);
5186   SetConsoleTextAttribute(out, defaultScreenInfo.wAttributes);
5187 }
5188 #else
5189 static void printBold(const char *zText){
5190   printf("\033[1m%s\033[0m", zText);
5191 }
5192 #endif
5193 
5194 /*
5195 ** Get the argument to an --option.  Throw an error and die if no argument
5196 ** is available.
5197 */
5198 static char *cmdline_option_value(int argc, char **argv, int i){
5199   if( i==argc ){
5200     utf8_printf(stderr, "%s: Error: missing argument to %s\n",
5201             argv[0], argv[argc-1]);
5202     exit(1);
5203   }
5204   return argv[i];
5205 }
5206 
5207 #ifndef SQLITE_SHELL_IS_UTF8
5208 #  if (defined(_WIN32) || defined(WIN32)) && defined(_MSC_VER)
5209 #    define SQLITE_SHELL_IS_UTF8          (0)
5210 #  else
5211 #    define SQLITE_SHELL_IS_UTF8          (1)
5212 #  endif
5213 #endif
5214 
5215 #if SQLITE_SHELL_IS_UTF8
5216 int SQLITE_CDECL main(int argc, char **argv){
5217 #else
5218 int SQLITE_CDECL wmain(int argc, wchar_t **wargv){
5219   char **argv;
5220 #endif
5221   char *zErrMsg = 0;
5222   ShellState data;
5223   const char *zInitFile = 0;
5224   int i;
5225   int rc = 0;
5226   int warnInmemoryDb = 0;
5227   int readStdin = 1;
5228   int nCmd = 0;
5229   char **azCmd = 0;
5230 
5231   setBinaryMode(stdin, 0);
5232   setvbuf(stderr, 0, _IONBF, 0); /* Make sure stderr is unbuffered */
5233   stdin_is_interactive = isatty(0);
5234   stdout_is_console = isatty(1);
5235 
5236 #if USE_SYSTEM_SQLITE+0!=1
5237   if( strcmp(sqlite3_sourceid(),SQLITE_SOURCE_ID)!=0 ){
5238     utf8_printf(stderr, "SQLite header and source version mismatch\n%s\n%s\n",
5239             sqlite3_sourceid(), SQLITE_SOURCE_ID);
5240     exit(1);
5241   }
5242 #endif
5243   main_init(&data);
5244 #if !SQLITE_SHELL_IS_UTF8
5245   sqlite3_initialize();
5246   argv = sqlite3_malloc64(sizeof(argv[0])*argc);
5247   if( argv==0 ){
5248     raw_printf(stderr, "out of memory\n");
5249     exit(1);
5250   }
5251   for(i=0; i<argc; i++){
5252     argv[i] = sqlite3_win32_unicode_to_utf8(wargv[i]);
5253     if( argv[i]==0 ){
5254       raw_printf(stderr, "out of memory\n");
5255       exit(1);
5256     }
5257   }
5258 #endif
5259   assert( argc>=1 && argv && argv[0] );
5260   Argv0 = argv[0];
5261 
5262   /* Make sure we have a valid signal handler early, before anything
5263   ** else is done.
5264   */
5265 #ifdef SIGINT
5266   signal(SIGINT, interrupt_handler);
5267 #endif
5268 
5269 #ifdef SQLITE_SHELL_DBNAME_PROC
5270   {
5271     /* If the SQLITE_SHELL_DBNAME_PROC macro is defined, then it is the name
5272     ** of a C-function that will provide the name of the database file.  Use
5273     ** this compile-time option to embed this shell program in larger
5274     ** applications. */
5275     extern void SQLITE_SHELL_DBNAME_PROC(const char**);
5276     SQLITE_SHELL_DBNAME_PROC(&data.zDbFilename);
5277     warnInmemoryDb = 0;
5278   }
5279 #endif
5280 
5281   /* Do an initial pass through the command-line argument to locate
5282   ** the name of the database file, the name of the initialization file,
5283   ** the size of the alternative malloc heap,
5284   ** and the first command to execute.
5285   */
5286   for(i=1; i<argc; i++){
5287     char *z;
5288     z = argv[i];
5289     if( z[0]!='-' ){
5290       if( data.zDbFilename==0 ){
5291         data.zDbFilename = z;
5292       }else{
5293         /* Excesss arguments are interpreted as SQL (or dot-commands) and
5294         ** mean that nothing is read from stdin */
5295         readStdin = 0;
5296         nCmd++;
5297         azCmd = realloc(azCmd, sizeof(azCmd[0])*nCmd);
5298         if( azCmd==0 ){
5299           raw_printf(stderr, "out of memory\n");
5300           exit(1);
5301         }
5302         azCmd[nCmd-1] = z;
5303       }
5304     }
5305     if( z[1]=='-' ) z++;
5306     if( strcmp(z,"-separator")==0
5307      || strcmp(z,"-nullvalue")==0
5308      || strcmp(z,"-newline")==0
5309      || strcmp(z,"-cmd")==0
5310     ){
5311       (void)cmdline_option_value(argc, argv, ++i);
5312     }else if( strcmp(z,"-init")==0 ){
5313       zInitFile = cmdline_option_value(argc, argv, ++i);
5314     }else if( strcmp(z,"-batch")==0 ){
5315       /* Need to check for batch mode here to so we can avoid printing
5316       ** informational messages (like from process_sqliterc) before
5317       ** we do the actual processing of arguments later in a second pass.
5318       */
5319       stdin_is_interactive = 0;
5320     }else if( strcmp(z,"-heap")==0 ){
5321 #if defined(SQLITE_ENABLE_MEMSYS3) || defined(SQLITE_ENABLE_MEMSYS5)
5322       const char *zSize;
5323       sqlite3_int64 szHeap;
5324 
5325       zSize = cmdline_option_value(argc, argv, ++i);
5326       szHeap = integerValue(zSize);
5327       if( szHeap>0x7fff0000 ) szHeap = 0x7fff0000;
5328       sqlite3_config(SQLITE_CONFIG_HEAP, malloc((int)szHeap), (int)szHeap, 64);
5329 #else
5330       (void)cmdline_option_value(argc, argv, ++i);
5331 #endif
5332     }else if( strcmp(z,"-scratch")==0 ){
5333       int n, sz;
5334       sz = (int)integerValue(cmdline_option_value(argc,argv,++i));
5335       if( sz>400000 ) sz = 400000;
5336       if( sz<2500 ) sz = 2500;
5337       n = (int)integerValue(cmdline_option_value(argc,argv,++i));
5338       if( n>10 ) n = 10;
5339       if( n<1 ) n = 1;
5340       sqlite3_config(SQLITE_CONFIG_SCRATCH, malloc(n*sz+1), sz, n);
5341       data.shellFlgs |= SHFLG_Scratch;
5342     }else if( strcmp(z,"-pagecache")==0 ){
5343       int n, sz;
5344       sz = (int)integerValue(cmdline_option_value(argc,argv,++i));
5345       if( sz>70000 ) sz = 70000;
5346       if( sz<0 ) sz = 0;
5347       n = (int)integerValue(cmdline_option_value(argc,argv,++i));
5348       sqlite3_config(SQLITE_CONFIG_PAGECACHE,
5349                     (n>0 && sz>0) ? malloc(n*sz) : 0, sz, n);
5350       data.shellFlgs |= SHFLG_Pagecache;
5351     }else if( strcmp(z,"-lookaside")==0 ){
5352       int n, sz;
5353       sz = (int)integerValue(cmdline_option_value(argc,argv,++i));
5354       if( sz<0 ) sz = 0;
5355       n = (int)integerValue(cmdline_option_value(argc,argv,++i));
5356       if( n<0 ) n = 0;
5357       sqlite3_config(SQLITE_CONFIG_LOOKASIDE, sz, n);
5358       if( sz*n==0 ) data.shellFlgs &= ~SHFLG_Lookaside;
5359 #ifdef SQLITE_ENABLE_VFSTRACE
5360     }else if( strcmp(z,"-vfstrace")==0 ){
5361       extern int vfstrace_register(
5362          const char *zTraceName,
5363          const char *zOldVfsName,
5364          int (*xOut)(const char*,void*),
5365          void *pOutArg,
5366          int makeDefault
5367       );
5368       vfstrace_register("trace",0,(int(*)(const char*,void*))fputs,stderr,1);
5369 #endif
5370 #ifdef SQLITE_ENABLE_MULTIPLEX
5371     }else if( strcmp(z,"-multiplex")==0 ){
5372       extern int sqlite3_multiple_initialize(const char*,int);
5373       sqlite3_multiplex_initialize(0, 1);
5374 #endif
5375     }else if( strcmp(z,"-mmap")==0 ){
5376       sqlite3_int64 sz = integerValue(cmdline_option_value(argc,argv,++i));
5377       sqlite3_config(SQLITE_CONFIG_MMAP_SIZE, sz, sz);
5378     }else if( strcmp(z,"-vfs")==0 ){
5379       sqlite3_vfs *pVfs = sqlite3_vfs_find(cmdline_option_value(argc,argv,++i));
5380       if( pVfs ){
5381         sqlite3_vfs_register(pVfs, 1);
5382       }else{
5383         utf8_printf(stderr, "no such VFS: \"%s\"\n", argv[i]);
5384         exit(1);
5385       }
5386     }
5387   }
5388   if( data.zDbFilename==0 ){
5389 #ifndef SQLITE_OMIT_MEMORYDB
5390     data.zDbFilename = ":memory:";
5391     warnInmemoryDb = argc==1;
5392 #else
5393     utf8_printf(stderr,"%s: Error: no database filename specified\n", Argv0);
5394     return 1;
5395 #endif
5396   }
5397   data.out = stdout;
5398 
5399   /* Go ahead and open the database file if it already exists.  If the
5400   ** file does not exist, delay opening it.  This prevents empty database
5401   ** files from being created if a user mistypes the database name argument
5402   ** to the sqlite command-line tool.
5403   */
5404   if( access(data.zDbFilename, 0)==0 ){
5405     open_db(&data, 0);
5406   }
5407 
5408   /* Process the initialization file if there is one.  If no -init option
5409   ** is given on the command line, look for a file named ~/.sqliterc and
5410   ** try to process it.
5411   */
5412   process_sqliterc(&data,zInitFile);
5413 
5414   /* Make a second pass through the command-line argument and set
5415   ** options.  This second pass is delayed until after the initialization
5416   ** file is processed so that the command-line arguments will override
5417   ** settings in the initialization file.
5418   */
5419   for(i=1; i<argc; i++){
5420     char *z = argv[i];
5421     if( z[0]!='-' ) continue;
5422     if( z[1]=='-' ){ z++; }
5423     if( strcmp(z,"-init")==0 ){
5424       i++;
5425     }else if( strcmp(z,"-html")==0 ){
5426       data.mode = MODE_Html;
5427     }else if( strcmp(z,"-list")==0 ){
5428       data.mode = MODE_List;
5429     }else if( strcmp(z,"-line")==0 ){
5430       data.mode = MODE_Line;
5431     }else if( strcmp(z,"-column")==0 ){
5432       data.mode = MODE_Column;
5433     }else if( strcmp(z,"-csv")==0 ){
5434       data.mode = MODE_Csv;
5435       memcpy(data.colSeparator,",",2);
5436     }else if( strcmp(z,"-ascii")==0 ){
5437       data.mode = MODE_Ascii;
5438       sqlite3_snprintf(sizeof(data.colSeparator), data.colSeparator,
5439                        SEP_Unit);
5440       sqlite3_snprintf(sizeof(data.rowSeparator), data.rowSeparator,
5441                        SEP_Record);
5442     }else if( strcmp(z,"-separator")==0 ){
5443       sqlite3_snprintf(sizeof(data.colSeparator), data.colSeparator,
5444                        "%s",cmdline_option_value(argc,argv,++i));
5445     }else if( strcmp(z,"-newline")==0 ){
5446       sqlite3_snprintf(sizeof(data.rowSeparator), data.rowSeparator,
5447                        "%s",cmdline_option_value(argc,argv,++i));
5448     }else if( strcmp(z,"-nullvalue")==0 ){
5449       sqlite3_snprintf(sizeof(data.nullValue), data.nullValue,
5450                        "%s",cmdline_option_value(argc,argv,++i));
5451     }else if( strcmp(z,"-header")==0 ){
5452       data.showHeader = 1;
5453     }else if( strcmp(z,"-noheader")==0 ){
5454       data.showHeader = 0;
5455     }else if( strcmp(z,"-echo")==0 ){
5456       data.echoOn = 1;
5457     }else if( strcmp(z,"-eqp")==0 ){
5458       data.autoEQP = 1;
5459     }else if( strcmp(z,"-eqpfull")==0 ){
5460       data.autoEQP = 2;
5461     }else if( strcmp(z,"-stats")==0 ){
5462       data.statsOn = 1;
5463     }else if( strcmp(z,"-scanstats")==0 ){
5464       data.scanstatsOn = 1;
5465     }else if( strcmp(z,"-backslash")==0 ){
5466       /* Undocumented command-line option: -backslash
5467       ** Causes C-style backslash escapes to be evaluated in SQL statements
5468       ** prior to sending the SQL into SQLite.  Useful for injecting
5469       ** crazy bytes in the middle of SQL statements for testing and debugging.
5470       */
5471       data.backslashOn = 1;
5472     }else if( strcmp(z,"-bail")==0 ){
5473       bail_on_error = 1;
5474     }else if( strcmp(z,"-version")==0 ){
5475       printf("%s %s\n", sqlite3_libversion(), sqlite3_sourceid());
5476       return 0;
5477     }else if( strcmp(z,"-interactive")==0 ){
5478       stdin_is_interactive = 1;
5479     }else if( strcmp(z,"-batch")==0 ){
5480       stdin_is_interactive = 0;
5481     }else if( strcmp(z,"-heap")==0 ){
5482       i++;
5483     }else if( strcmp(z,"-scratch")==0 ){
5484       i+=2;
5485     }else if( strcmp(z,"-pagecache")==0 ){
5486       i+=2;
5487     }else if( strcmp(z,"-lookaside")==0 ){
5488       i+=2;
5489     }else if( strcmp(z,"-mmap")==0 ){
5490       i++;
5491     }else if( strcmp(z,"-vfs")==0 ){
5492       i++;
5493 #ifdef SQLITE_ENABLE_VFSTRACE
5494     }else if( strcmp(z,"-vfstrace")==0 ){
5495       i++;
5496 #endif
5497 #ifdef SQLITE_ENABLE_MULTIPLEX
5498     }else if( strcmp(z,"-multiplex")==0 ){
5499       i++;
5500 #endif
5501     }else if( strcmp(z,"-help")==0 ){
5502       usage(1);
5503     }else if( strcmp(z,"-cmd")==0 ){
5504       /* Run commands that follow -cmd first and separately from commands
5505       ** that simply appear on the command-line.  This seems goofy.  It would
5506       ** be better if all commands ran in the order that they appear.  But
5507       ** we retain the goofy behavior for historical compatibility. */
5508       if( i==argc-1 ) break;
5509       z = cmdline_option_value(argc,argv,++i);
5510       if( z[0]=='.' ){
5511         rc = do_meta_command(z, &data);
5512         if( rc && bail_on_error ) return rc==2 ? 0 : rc;
5513       }else{
5514         open_db(&data, 0);
5515         rc = shell_exec(data.db, z, shell_callback, &data, &zErrMsg);
5516         if( zErrMsg!=0 ){
5517           utf8_printf(stderr,"Error: %s\n", zErrMsg);
5518           if( bail_on_error ) return rc!=0 ? rc : 1;
5519         }else if( rc!=0 ){
5520           utf8_printf(stderr,"Error: unable to process SQL \"%s\"\n", z);
5521           if( bail_on_error ) return rc;
5522         }
5523       }
5524     }else{
5525       utf8_printf(stderr,"%s: Error: unknown option: %s\n", Argv0, z);
5526       raw_printf(stderr,"Use -help for a list of options.\n");
5527       return 1;
5528     }
5529     data.cMode = data.mode;
5530   }
5531 
5532   if( !readStdin ){
5533     /* Run all arguments that do not begin with '-' as if they were separate
5534     ** command-line inputs, except for the argToSkip argument which contains
5535     ** the database filename.
5536     */
5537     for(i=0; i<nCmd; i++){
5538       if( azCmd[i][0]=='.' ){
5539         rc = do_meta_command(azCmd[i], &data);
5540         if( rc ) return rc==2 ? 0 : rc;
5541       }else{
5542         open_db(&data, 0);
5543         rc = shell_exec(data.db, azCmd[i], shell_callback, &data, &zErrMsg);
5544         if( zErrMsg!=0 ){
5545           utf8_printf(stderr,"Error: %s\n", zErrMsg);
5546           return rc!=0 ? rc : 1;
5547         }else if( rc!=0 ){
5548           utf8_printf(stderr,"Error: unable to process SQL: %s\n", azCmd[i]);
5549           return rc;
5550         }
5551       }
5552     }
5553     free(azCmd);
5554   }else{
5555     /* Run commands received from standard input
5556     */
5557     if( stdin_is_interactive ){
5558       char *zHome;
5559       char *zHistory = 0;
5560       int nHistory;
5561       printf(
5562         "SQLite version %s %.19s\n" /*extra-version-info*/
5563         "Enter \".help\" for usage hints.\n",
5564         sqlite3_libversion(), sqlite3_sourceid()
5565       );
5566       if( warnInmemoryDb ){
5567         printf("Connected to a ");
5568         printBold("transient in-memory database");
5569         printf(".\nUse \".open FILENAME\" to reopen on a "
5570                "persistent database.\n");
5571       }
5572       zHome = find_home_dir();
5573       if( zHome ){
5574         nHistory = strlen30(zHome) + 20;
5575         if( (zHistory = malloc(nHistory))!=0 ){
5576           sqlite3_snprintf(nHistory, zHistory,"%s/.sqlite_history", zHome);
5577         }
5578       }
5579       if( zHistory ){ shell_read_history(zHistory); }
5580       rc = process_input(&data, 0);
5581       if( zHistory ){
5582         shell_stifle_history(100);
5583         shell_write_history(zHistory);
5584         free(zHistory);
5585       }
5586     }else{
5587       rc = process_input(&data, stdin);
5588     }
5589   }
5590   set_table_name(&data, 0);
5591   if( data.db ){
5592     session_close_all(&data);
5593     sqlite3_close(data.db);
5594   }
5595   sqlite3_free(data.zFreeOnClose);
5596 #if !SQLITE_SHELL_IS_UTF8
5597   for(i=0; i<argc; i++) sqlite3_free(argv[i]);
5598   sqlite3_free(argv);
5599 #endif
5600   return rc;
5601 }
5602