LCOV - code coverage report
Current view: top level - src/bin/psql - command.c (source / functions) Hit Total Coverage
Test: PostgreSQL 19devel Lines: 1700 2595 65.5 %
Date: 2025-11-16 12:17:48 Functions: 100 109 91.7 %
Legend: Lines: hit not hit

          Line data    Source code
       1             : /*
       2             :  * psql - the PostgreSQL interactive terminal
       3             :  *
       4             :  * Copyright (c) 2000-2025, PostgreSQL Global Development Group
       5             :  *
       6             :  * src/bin/psql/command.c
       7             :  */
       8             : #include "postgres_fe.h"
       9             : 
      10             : #include <ctype.h>
      11             : #include <time.h>
      12             : #include <pwd.h>
      13             : #include <utime.h>
      14             : #ifndef WIN32
      15             : #include <sys/stat.h>         /* for stat() */
      16             : #include <sys/time.h>         /* for setitimer() */
      17             : #include <fcntl.h>                /* open() flags */
      18             : #include <unistd.h>               /* for geteuid(), getpid(), stat() */
      19             : #else
      20             : #include <win32.h>
      21             : #include <io.h>
      22             : #include <fcntl.h>
      23             : #include <direct.h>
      24             : #include <sys/stat.h>         /* for stat() */
      25             : #endif
      26             : 
      27             : #include "catalog/pg_class_d.h"
      28             : #include "command.h"
      29             : #include "common.h"
      30             : #include "common/logging.h"
      31             : #include "common/string.h"
      32             : #include "copy.h"
      33             : #include "describe.h"
      34             : #include "fe_utils/cancel.h"
      35             : #include "fe_utils/print.h"
      36             : #include "fe_utils/string_utils.h"
      37             : #include "help.h"
      38             : #include "input.h"
      39             : #include "large_obj.h"
      40             : #include "libpq/pqcomm.h"
      41             : #include "mainloop.h"
      42             : #include "pqexpbuffer.h"
      43             : #include "psqlscanslash.h"
      44             : #include "settings.h"
      45             : #include "variables.h"
      46             : 
      47             : /*
      48             :  * Editable database object types.
      49             :  */
      50             : typedef enum EditableObjectType
      51             : {
      52             :     EditableFunction,
      53             :     EditableView,
      54             : } EditableObjectType;
      55             : 
      56             : /* local function declarations */
      57             : static backslashResult exec_command(const char *cmd,
      58             :                                     PsqlScanState scan_state,
      59             :                                     ConditionalStack cstack,
      60             :                                     PQExpBuffer query_buf,
      61             :                                     PQExpBuffer previous_buf);
      62             : static backslashResult exec_command_a(PsqlScanState scan_state, bool active_branch);
      63             : static backslashResult exec_command_bind(PsqlScanState scan_state, bool active_branch);
      64             : static backslashResult exec_command_bind_named(PsqlScanState scan_state, bool active_branch,
      65             :                                                const char *cmd);
      66             : static backslashResult exec_command_C(PsqlScanState scan_state, bool active_branch);
      67             : static backslashResult exec_command_connect(PsqlScanState scan_state, bool active_branch);
      68             : static backslashResult exec_command_cd(PsqlScanState scan_state, bool active_branch,
      69             :                                        const char *cmd);
      70             : static backslashResult exec_command_close_prepared(PsqlScanState scan_state,
      71             :                                                    bool active_branch, const char *cmd);
      72             : static backslashResult exec_command_conninfo(PsqlScanState scan_state, bool active_branch);
      73             : static backslashResult exec_command_copy(PsqlScanState scan_state, bool active_branch);
      74             : static backslashResult exec_command_copyright(PsqlScanState scan_state, bool active_branch);
      75             : static backslashResult exec_command_crosstabview(PsqlScanState scan_state, bool active_branch);
      76             : static backslashResult exec_command_d(PsqlScanState scan_state, bool active_branch,
      77             :                                       const char *cmd);
      78             : static bool exec_command_dfo(PsqlScanState scan_state, const char *cmd,
      79             :                              const char *pattern,
      80             :                              bool show_verbose, bool show_system);
      81             : static backslashResult exec_command_edit(PsqlScanState scan_state, bool active_branch,
      82             :                                          PQExpBuffer query_buf, PQExpBuffer previous_buf);
      83             : static backslashResult exec_command_ef_ev(PsqlScanState scan_state, bool active_branch,
      84             :                                           PQExpBuffer query_buf, bool is_func);
      85             : static backslashResult exec_command_echo(PsqlScanState scan_state, bool active_branch,
      86             :                                          const char *cmd);
      87             : static backslashResult exec_command_elif(PsqlScanState scan_state, ConditionalStack cstack,
      88             :                                          PQExpBuffer query_buf);
      89             : static backslashResult exec_command_else(PsqlScanState scan_state, ConditionalStack cstack,
      90             :                                          PQExpBuffer query_buf);
      91             : static backslashResult exec_command_endif(PsqlScanState scan_state, ConditionalStack cstack,
      92             :                                           PQExpBuffer query_buf);
      93             : static backslashResult exec_command_endpipeline(PsqlScanState scan_state, bool active_branch);
      94             : static backslashResult exec_command_encoding(PsqlScanState scan_state, bool active_branch);
      95             : static backslashResult exec_command_errverbose(PsqlScanState scan_state, bool active_branch);
      96             : static backslashResult exec_command_f(PsqlScanState scan_state, bool active_branch);
      97             : static backslashResult exec_command_flush(PsqlScanState scan_state, bool active_branch);
      98             : static backslashResult exec_command_flushrequest(PsqlScanState scan_state, bool active_branch);
      99             : static backslashResult exec_command_g(PsqlScanState scan_state, bool active_branch,
     100             :                                       const char *cmd);
     101             : static backslashResult process_command_g_options(char *first_option,
     102             :                                                  PsqlScanState scan_state,
     103             :                                                  bool active_branch,
     104             :                                                  const char *cmd);
     105             : static backslashResult exec_command_gdesc(PsqlScanState scan_state, bool active_branch);
     106             : static backslashResult exec_command_getenv(PsqlScanState scan_state, bool active_branch,
     107             :                                            const char *cmd);
     108             : static backslashResult exec_command_gexec(PsqlScanState scan_state, bool active_branch);
     109             : static backslashResult exec_command_getresults(PsqlScanState scan_state, bool active_branch);
     110             : static backslashResult exec_command_gset(PsqlScanState scan_state, bool active_branch);
     111             : static backslashResult exec_command_help(PsqlScanState scan_state, bool active_branch);
     112             : static backslashResult exec_command_html(PsqlScanState scan_state, bool active_branch);
     113             : static backslashResult exec_command_include(PsqlScanState scan_state, bool active_branch,
     114             :                                             const char *cmd);
     115             : static backslashResult exec_command_if(PsqlScanState scan_state, ConditionalStack cstack,
     116             :                                        PQExpBuffer query_buf);
     117             : static backslashResult exec_command_list(PsqlScanState scan_state, bool active_branch,
     118             :                                          const char *cmd);
     119             : static backslashResult exec_command_lo(PsqlScanState scan_state, bool active_branch,
     120             :                                        const char *cmd);
     121             : static backslashResult exec_command_out(PsqlScanState scan_state, bool active_branch);
     122             : static backslashResult exec_command_print(PsqlScanState scan_state, bool active_branch,
     123             :                                           PQExpBuffer query_buf, PQExpBuffer previous_buf);
     124             : static backslashResult exec_command_parse(PsqlScanState scan_state, bool active_branch,
     125             :                                           const char *cmd);
     126             : static backslashResult exec_command_password(PsqlScanState scan_state, bool active_branch);
     127             : static backslashResult exec_command_prompt(PsqlScanState scan_state, bool active_branch,
     128             :                                            const char *cmd);
     129             : static backslashResult exec_command_pset(PsqlScanState scan_state, bool active_branch);
     130             : static backslashResult exec_command_quit(PsqlScanState scan_state, bool active_branch);
     131             : static backslashResult exec_command_reset(PsqlScanState scan_state, bool active_branch,
     132             :                                           PQExpBuffer query_buf);
     133             : static backslashResult exec_command_restrict(PsqlScanState scan_state, bool active_branch,
     134             :                                              const char *cmd);
     135             : static backslashResult exec_command_s(PsqlScanState scan_state, bool active_branch);
     136             : static backslashResult exec_command_sendpipeline(PsqlScanState scan_state, bool active_branch);
     137             : static backslashResult exec_command_set(PsqlScanState scan_state, bool active_branch);
     138             : static backslashResult exec_command_setenv(PsqlScanState scan_state, bool active_branch,
     139             :                                            const char *cmd);
     140             : static backslashResult exec_command_sf_sv(PsqlScanState scan_state, bool active_branch,
     141             :                                           const char *cmd, bool is_func);
     142             : static backslashResult exec_command_startpipeline(PsqlScanState scan_state, bool active_branch);
     143             : static backslashResult exec_command_syncpipeline(PsqlScanState scan_state, bool active_branch);
     144             : static backslashResult exec_command_t(PsqlScanState scan_state, bool active_branch);
     145             : static backslashResult exec_command_T(PsqlScanState scan_state, bool active_branch);
     146             : static backslashResult exec_command_timing(PsqlScanState scan_state, bool active_branch);
     147             : static backslashResult exec_command_unrestrict(PsqlScanState scan_state, bool active_branch,
     148             :                                                const char *cmd);
     149             : static backslashResult exec_command_unset(PsqlScanState scan_state, bool active_branch,
     150             :                                           const char *cmd);
     151             : static backslashResult exec_command_write(PsqlScanState scan_state, bool active_branch,
     152             :                                           const char *cmd,
     153             :                                           PQExpBuffer query_buf, PQExpBuffer previous_buf);
     154             : static backslashResult exec_command_watch(PsqlScanState scan_state, bool active_branch,
     155             :                                           PQExpBuffer query_buf, PQExpBuffer previous_buf);
     156             : static backslashResult exec_command_x(PsqlScanState scan_state, bool active_branch);
     157             : static backslashResult exec_command_z(PsqlScanState scan_state, bool active_branch,
     158             :                                       const char *cmd);
     159             : static backslashResult exec_command_shell_escape(PsqlScanState scan_state, bool active_branch);
     160             : static backslashResult exec_command_slash_command_help(PsqlScanState scan_state, bool active_branch);
     161             : static char *read_connect_arg(PsqlScanState scan_state);
     162             : static PQExpBuffer gather_boolean_expression(PsqlScanState scan_state);
     163             : static bool is_true_boolean_expression(PsqlScanState scan_state, const char *name);
     164             : static void ignore_boolean_expression(PsqlScanState scan_state);
     165             : static void ignore_slash_options(PsqlScanState scan_state);
     166             : static void ignore_slash_filepipe(PsqlScanState scan_state);
     167             : static void ignore_slash_whole_line(PsqlScanState scan_state);
     168             : static bool is_branching_command(const char *cmd);
     169             : static void save_query_text_state(PsqlScanState scan_state, ConditionalStack cstack,
     170             :                                   PQExpBuffer query_buf);
     171             : static void discard_query_text(PsqlScanState scan_state, ConditionalStack cstack,
     172             :                                PQExpBuffer query_buf);
     173             : static bool copy_previous_query(PQExpBuffer query_buf, PQExpBuffer previous_buf);
     174             : static bool do_connect(enum trivalue reuse_previous_specification,
     175             :                        char *dbname, char *user, char *host, char *port);
     176             : static void wait_until_connected(PGconn *conn);
     177             : static bool do_edit(const char *filename_arg, PQExpBuffer query_buf,
     178             :                     int lineno, bool discard_on_quit, bool *edited);
     179             : static bool do_shell(const char *command);
     180             : static bool do_watch(PQExpBuffer query_buf, double sleep, int iter, int min_rows);
     181             : static bool lookup_object_oid(EditableObjectType obj_type, const char *desc,
     182             :                               Oid *obj_oid);
     183             : static bool get_create_object_cmd(EditableObjectType obj_type, Oid oid,
     184             :                                   PQExpBuffer buf);
     185             : static int  strip_lineno_from_objdesc(char *obj);
     186             : static int  count_lines_in_buf(PQExpBuffer buf);
     187             : static void print_with_linenumbers(FILE *output, char *lines, bool is_func);
     188             : static void minimal_error_message(PGresult *res);
     189             : 
     190             : static void printSSLInfo(void);
     191             : static void printGSSInfo(void);
     192             : static bool printPsetInfo(const char *param, printQueryOpt *popt);
     193             : static char *pset_value_string(const char *param, printQueryOpt *popt);
     194             : 
     195             : #ifdef WIN32
     196             : static void checkWin32Codepage(void);
     197             : #endif
     198             : 
     199             : static bool restricted;
     200             : static char *restrict_key;
     201             : 
     202             : 
     203             : /*----------
     204             :  * HandleSlashCmds:
     205             :  *
     206             :  * Handles all the different commands that start with '\'.
     207             :  * Ordinarily called by MainLoop().
     208             :  *
     209             :  * scan_state is a lexer working state that is set to continue scanning
     210             :  * just after the '\'.  The lexer is advanced past the command and all
     211             :  * arguments on return.
     212             :  *
     213             :  * cstack is the current \if stack state.  This will be examined, and
     214             :  * possibly modified by conditional commands.
     215             :  *
     216             :  * query_buf contains the query-so-far, which may be modified by
     217             :  * execution of the backslash command (for example, \r clears it).
     218             :  *
     219             :  * previous_buf contains the query most recently sent to the server
     220             :  * (empty if none yet).  This should not be modified here, but some
     221             :  * commands copy its content into query_buf.
     222             :  *
     223             :  * query_buf and previous_buf will be NULL when executing a "-c"
     224             :  * command-line option.
     225             :  *
     226             :  * Returns a status code indicating what action is desired, see command.h.
     227             :  *----------
     228             :  */
     229             : 
     230             : backslashResult
     231       19152 : HandleSlashCmds(PsqlScanState scan_state,
     232             :                 ConditionalStack cstack,
     233             :                 PQExpBuffer query_buf,
     234             :                 PQExpBuffer previous_buf)
     235             : {
     236             :     backslashResult status;
     237             :     char       *cmd;
     238             :     char       *arg;
     239             : 
     240             :     Assert(scan_state != NULL);
     241             :     Assert(cstack != NULL);
     242             : 
     243             :     /* Parse off the command name */
     244       19152 :     cmd = psql_scan_slash_command(scan_state);
     245             : 
     246             :     /*
     247             :      * And try to execute it.
     248             :      *
     249             :      * If we are in "restricted" mode, the only allowable backslash command is
     250             :      * \unrestrict (to exit restricted mode).
     251             :      */
     252       19152 :     if (restricted && strcmp(cmd, "unrestrict") != 0)
     253             :     {
     254           2 :         pg_log_error("backslash commands are restricted; only \\unrestrict is allowed");
     255           2 :         status = PSQL_CMD_ERROR;
     256             :     }
     257             :     else
     258       19150 :         status = exec_command(cmd, scan_state, cstack, query_buf, previous_buf);
     259             : 
     260       19148 :     if (status == PSQL_CMD_UNKNOWN)
     261             :     {
     262          18 :         pg_log_error("invalid command \\%s", cmd);
     263          18 :         if (pset.cur_cmd_interactive)
     264           0 :             pg_log_error_hint("Try \\? for help.");
     265          18 :         status = PSQL_CMD_ERROR;
     266             :     }
     267             : 
     268       19148 :     if (status != PSQL_CMD_ERROR)
     269             :     {
     270             :         /*
     271             :          * Eat any remaining arguments after a valid command.  We want to
     272             :          * suppress evaluation of backticks in this situation, so transiently
     273             :          * push an inactive conditional-stack entry.
     274             :          */
     275       17950 :         bool        active_branch = conditional_active(cstack);
     276             : 
     277       17950 :         conditional_stack_push(cstack, IFSTATE_IGNORED);
     278       17980 :         while ((arg = psql_scan_slash_option(scan_state,
     279             :                                              OT_NORMAL, NULL, false)))
     280             :         {
     281          30 :             if (active_branch)
     282          30 :                 pg_log_warning("\\%s: extra argument \"%s\" ignored", cmd, arg);
     283          30 :             free(arg);
     284             :         }
     285       17950 :         conditional_stack_pop(cstack);
     286             :     }
     287             :     else
     288             :     {
     289             :         /* silently throw away rest of line after an erroneous command */
     290        1218 :         while ((arg = psql_scan_slash_option(scan_state,
     291             :                                              OT_WHOLE_LINE, NULL, false)))
     292          20 :             free(arg);
     293             :     }
     294             : 
     295             :     /* if there is a trailing \\, swallow it */
     296       19148 :     psql_scan_slash_command_end(scan_state);
     297             : 
     298       19148 :     free(cmd);
     299             : 
     300             :     /* some commands write to queryFout, so make sure output is sent */
     301       19148 :     fflush(pset.queryFout);
     302             : 
     303       19148 :     return status;
     304             : }
     305             : 
     306             : 
     307             : /*
     308             :  * Subroutine to actually try to execute a backslash command.
     309             :  *
     310             :  * The typical "success" result code is PSQL_CMD_SKIP_LINE, although some
     311             :  * commands return something else.  Failure result code is PSQL_CMD_ERROR,
     312             :  * unless PSQL_CMD_UNKNOWN is more appropriate.
     313             :  */
     314             : static backslashResult
     315       19150 : exec_command(const char *cmd,
     316             :              PsqlScanState scan_state,
     317             :              ConditionalStack cstack,
     318             :              PQExpBuffer query_buf,
     319             :              PQExpBuffer previous_buf)
     320             : {
     321             :     backslashResult status;
     322       19150 :     bool        active_branch = conditional_active(cstack);
     323             : 
     324             :     /*
     325             :      * In interactive mode, warn when we're ignoring a command within a false
     326             :      * \if-branch.  But we continue on, so as to parse and discard the right
     327             :      * amount of parameter text.  Each individual backslash command subroutine
     328             :      * is responsible for doing nothing after discarding appropriate
     329             :      * arguments, if !active_branch.
     330             :      */
     331       19150 :     if (pset.cur_cmd_interactive && !active_branch &&
     332           0 :         !is_branching_command(cmd))
     333             :     {
     334           0 :         pg_log_warning("\\%s command ignored; use \\endif or Ctrl-C to exit current \\if block",
     335             :                        cmd);
     336             :     }
     337             : 
     338       19150 :     if (strcmp(cmd, "a") == 0)
     339          54 :         status = exec_command_a(scan_state, active_branch);
     340       19096 :     else if (strcmp(cmd, "bind") == 0)
     341         670 :         status = exec_command_bind(scan_state, active_branch);
     342       18426 :     else if (strcmp(cmd, "bind_named") == 0)
     343         176 :         status = exec_command_bind_named(scan_state, active_branch, cmd);
     344       18250 :     else if (strcmp(cmd, "C") == 0)
     345           6 :         status = exec_command_C(scan_state, active_branch);
     346       18244 :     else if (strcmp(cmd, "c") == 0 || strcmp(cmd, "connect") == 0)
     347         344 :         status = exec_command_connect(scan_state, active_branch);
     348       17900 :     else if (strcmp(cmd, "cd") == 0)
     349           6 :         status = exec_command_cd(scan_state, active_branch, cmd);
     350       17894 :     else if (strcmp(cmd, "close_prepared") == 0)
     351          50 :         status = exec_command_close_prepared(scan_state, active_branch, cmd);
     352       17844 :     else if (strcmp(cmd, "conninfo") == 0)
     353           6 :         status = exec_command_conninfo(scan_state, active_branch);
     354       17838 :     else if (pg_strcasecmp(cmd, "copy") == 0)
     355         172 :         status = exec_command_copy(scan_state, active_branch);
     356       17666 :     else if (strcmp(cmd, "copyright") == 0)
     357           8 :         status = exec_command_copyright(scan_state, active_branch);
     358       17658 :     else if (strcmp(cmd, "crosstabview") == 0)
     359         138 :         status = exec_command_crosstabview(scan_state, active_branch);
     360       17520 :     else if (cmd[0] == 'd')
     361        6828 :         status = exec_command_d(scan_state, active_branch, cmd);
     362       10692 :     else if (strcmp(cmd, "e") == 0 || strcmp(cmd, "edit") == 0)
     363           6 :         status = exec_command_edit(scan_state, active_branch,
     364             :                                    query_buf, previous_buf);
     365       10686 :     else if (strcmp(cmd, "ef") == 0)
     366           6 :         status = exec_command_ef_ev(scan_state, active_branch, query_buf, true);
     367       10680 :     else if (strcmp(cmd, "ev") == 0)
     368           6 :         status = exec_command_ef_ev(scan_state, active_branch, query_buf, false);
     369       10674 :     else if (strcmp(cmd, "echo") == 0 || strcmp(cmd, "qecho") == 0 ||
     370        8876 :              strcmp(cmd, "warn") == 0)
     371        2786 :         status = exec_command_echo(scan_state, active_branch, cmd);
     372        7888 :     else if (strcmp(cmd, "elif") == 0)
     373          48 :         status = exec_command_elif(scan_state, cstack, query_buf);
     374        7840 :     else if (strcmp(cmd, "else") == 0)
     375         132 :         status = exec_command_else(scan_state, cstack, query_buf);
     376        7708 :     else if (strcmp(cmd, "endif") == 0)
     377         186 :         status = exec_command_endif(scan_state, cstack, query_buf);
     378        7522 :     else if (strcmp(cmd, "endpipeline") == 0)
     379         298 :         status = exec_command_endpipeline(scan_state, active_branch);
     380        7224 :     else if (strcmp(cmd, "encoding") == 0)
     381          22 :         status = exec_command_encoding(scan_state, active_branch);
     382        7202 :     else if (strcmp(cmd, "errverbose") == 0)
     383          14 :         status = exec_command_errverbose(scan_state, active_branch);
     384        7188 :     else if (strcmp(cmd, "f") == 0)
     385           6 :         status = exec_command_f(scan_state, active_branch);
     386        7182 :     else if (strcmp(cmd, "flush") == 0)
     387          24 :         status = exec_command_flush(scan_state, active_branch);
     388        7158 :     else if (strcmp(cmd, "flushrequest") == 0)
     389          60 :         status = exec_command_flushrequest(scan_state, active_branch);
     390        7098 :     else if (strcmp(cmd, "g") == 0 || strcmp(cmd, "gx") == 0)
     391         360 :         status = exec_command_g(scan_state, active_branch, cmd);
     392        6738 :     else if (strcmp(cmd, "gdesc") == 0)
     393          86 :         status = exec_command_gdesc(scan_state, active_branch);
     394        6652 :     else if (strcmp(cmd, "getenv") == 0)
     395         298 :         status = exec_command_getenv(scan_state, active_branch, cmd);
     396        6354 :     else if (strcmp(cmd, "getresults") == 0)
     397         156 :         status = exec_command_getresults(scan_state, active_branch);
     398        6198 :     else if (strcmp(cmd, "gexec") == 0)
     399          58 :         status = exec_command_gexec(scan_state, active_branch);
     400        6140 :     else if (strcmp(cmd, "gset") == 0)
     401         806 :         status = exec_command_gset(scan_state, active_branch);
     402        5334 :     else if (strcmp(cmd, "h") == 0 || strcmp(cmd, "help") == 0)
     403          10 :         status = exec_command_help(scan_state, active_branch);
     404        5324 :     else if (strcmp(cmd, "H") == 0 || strcmp(cmd, "html") == 0)
     405           6 :         status = exec_command_html(scan_state, active_branch);
     406        5318 :     else if (strcmp(cmd, "i") == 0 || strcmp(cmd, "include") == 0 ||
     407        5312 :              strcmp(cmd, "ir") == 0 || strcmp(cmd, "include_relative") == 0)
     408          12 :         status = exec_command_include(scan_state, active_branch, cmd);
     409        5306 :     else if (strcmp(cmd, "if") == 0)
     410         200 :         status = exec_command_if(scan_state, cstack, query_buf);
     411        5106 :     else if (strcmp(cmd, "l") == 0 || strcmp(cmd, "list") == 0 ||
     412        5100 :              strcmp(cmd, "lx") == 0 || strcmp(cmd, "listx") == 0 ||
     413        5100 :              strcmp(cmd, "l+") == 0 || strcmp(cmd, "list+") == 0 ||
     414        5100 :              strcmp(cmd, "lx+") == 0 || strcmp(cmd, "listx+") == 0 ||
     415        5100 :              strcmp(cmd, "l+x") == 0 || strcmp(cmd, "list+x") == 0)
     416           6 :         status = exec_command_list(scan_state, active_branch, cmd);
     417        5100 :     else if (strncmp(cmd, "lo_", 3) == 0)
     418          62 :         status = exec_command_lo(scan_state, active_branch, cmd);
     419        5038 :     else if (strcmp(cmd, "o") == 0 || strcmp(cmd, "out") == 0)
     420          42 :         status = exec_command_out(scan_state, active_branch);
     421        4996 :     else if (strcmp(cmd, "p") == 0 || strcmp(cmd, "print") == 0)
     422          42 :         status = exec_command_print(scan_state, active_branch,
     423             :                                     query_buf, previous_buf);
     424        4954 :     else if (strcmp(cmd, "parse") == 0)
     425         114 :         status = exec_command_parse(scan_state, active_branch, cmd);
     426        4840 :     else if (strcmp(cmd, "password") == 0)
     427           8 :         status = exec_command_password(scan_state, active_branch);
     428        4832 :     else if (strcmp(cmd, "prompt") == 0)
     429           6 :         status = exec_command_prompt(scan_state, active_branch, cmd);
     430        4826 :     else if (strcmp(cmd, "pset") == 0)
     431        1798 :         status = exec_command_pset(scan_state, active_branch);
     432        3028 :     else if (strcmp(cmd, "q") == 0 || strcmp(cmd, "quit") == 0)
     433         264 :         status = exec_command_quit(scan_state, active_branch);
     434        2764 :     else if (strcmp(cmd, "r") == 0 || strcmp(cmd, "reset") == 0)
     435          96 :         status = exec_command_reset(scan_state, active_branch, query_buf);
     436        2668 :     else if (strcmp(cmd, "restrict") == 0)
     437          68 :         status = exec_command_restrict(scan_state, active_branch, cmd);
     438        2600 :     else if (strcmp(cmd, "s") == 0)
     439           6 :         status = exec_command_s(scan_state, active_branch);
     440        2594 :     else if (strcmp(cmd, "sendpipeline") == 0)
     441         590 :         status = exec_command_sendpipeline(scan_state, active_branch);
     442        2004 :     else if (strcmp(cmd, "set") == 0)
     443         984 :         status = exec_command_set(scan_state, active_branch);
     444        1020 :     else if (strcmp(cmd, "setenv") == 0)
     445          18 :         status = exec_command_setenv(scan_state, active_branch, cmd);
     446        1002 :     else if (strcmp(cmd, "sf") == 0 || strcmp(cmd, "sf+") == 0)
     447          66 :         status = exec_command_sf_sv(scan_state, active_branch, cmd, true);
     448         936 :     else if (strcmp(cmd, "sv") == 0 || strcmp(cmd, "sv+") == 0)
     449         132 :         status = exec_command_sf_sv(scan_state, active_branch, cmd, false);
     450         804 :     else if (strcmp(cmd, "startpipeline") == 0)
     451         298 :         status = exec_command_startpipeline(scan_state, active_branch);
     452         506 :     else if (strcmp(cmd, "syncpipeline") == 0)
     453         114 :         status = exec_command_syncpipeline(scan_state, active_branch);
     454         392 :     else if (strcmp(cmd, "t") == 0)
     455          70 :         status = exec_command_t(scan_state, active_branch);
     456         322 :     else if (strcmp(cmd, "T") == 0)
     457           6 :         status = exec_command_T(scan_state, active_branch);
     458         316 :     else if (strcmp(cmd, "timing") == 0)
     459          10 :         status = exec_command_timing(scan_state, active_branch);
     460         306 :     else if (strcmp(cmd, "unrestrict") == 0)
     461          66 :         status = exec_command_unrestrict(scan_state, active_branch, cmd);
     462         240 :     else if (strcmp(cmd, "unset") == 0)
     463          52 :         status = exec_command_unset(scan_state, active_branch, cmd);
     464         188 :     else if (strcmp(cmd, "w") == 0 || strcmp(cmd, "write") == 0)
     465          12 :         status = exec_command_write(scan_state, active_branch, cmd,
     466             :                                     query_buf, previous_buf);
     467         176 :     else if (strcmp(cmd, "watch") == 0)
     468          40 :         status = exec_command_watch(scan_state, active_branch,
     469             :                                     query_buf, previous_buf);
     470         136 :     else if (strcmp(cmd, "x") == 0)
     471          76 :         status = exec_command_x(scan_state, active_branch);
     472          60 :     else if (strcmp(cmd, "z") == 0 ||
     473          36 :              strcmp(cmd, "zS") == 0 || strcmp(cmd, "zx") == 0 ||
     474          30 :              strcmp(cmd, "zSx") == 0 || strcmp(cmd, "zxS") == 0)
     475          30 :         status = exec_command_z(scan_state, active_branch, cmd);
     476          30 :     else if (strcmp(cmd, "!") == 0)
     477           6 :         status = exec_command_shell_escape(scan_state, active_branch);
     478          24 :     else if (strcmp(cmd, "?") == 0)
     479           6 :         status = exec_command_slash_command_help(scan_state, active_branch);
     480             :     else
     481          18 :         status = PSQL_CMD_UNKNOWN;
     482             : 
     483             :     /*
     484             :      * All the commands that return PSQL_CMD_SEND want to execute previous_buf
     485             :      * if query_buf is empty.  For convenience we implement that here, not in
     486             :      * the individual command subroutines.
     487             :      */
     488       19146 :     if (status == PSQL_CMD_SEND)
     489        2960 :         (void) copy_previous_query(query_buf, previous_buf);
     490             : 
     491       19146 :     return status;
     492             : }
     493             : 
     494             : 
     495             : /*
     496             :  * \a -- toggle field alignment
     497             :  *
     498             :  * This makes little sense but we keep it around.
     499             :  */
     500             : static backslashResult
     501          54 : exec_command_a(PsqlScanState scan_state, bool active_branch)
     502             : {
     503          54 :     bool        success = true;
     504             : 
     505          54 :     if (active_branch)
     506             :     {
     507          48 :         if (pset.popt.topt.format != PRINT_ALIGNED)
     508          24 :             success = do_pset("format", "aligned", &pset.popt, pset.quiet);
     509             :         else
     510          24 :             success = do_pset("format", "unaligned", &pset.popt, pset.quiet);
     511             :     }
     512             : 
     513          54 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
     514             : }
     515             : 
     516             : /*
     517             :  * \bind -- set query parameters
     518             :  */
     519             : static backslashResult
     520         670 : exec_command_bind(PsqlScanState scan_state, bool active_branch)
     521             : {
     522         670 :     backslashResult status = PSQL_CMD_SKIP_LINE;
     523             : 
     524         670 :     if (active_branch)
     525             :     {
     526             :         char       *opt;
     527         664 :         int         nparams = 0;
     528         664 :         int         nalloc = 0;
     529             : 
     530         664 :         clean_extended_state();
     531             : 
     532        1204 :         while ((opt = psql_scan_slash_option(scan_state, OT_NORMAL, NULL, false)))
     533             :         {
     534         540 :             nparams++;
     535         540 :             if (nparams > nalloc)
     536             :             {
     537         532 :                 nalloc = nalloc ? nalloc * 2 : 1;
     538         532 :                 pset.bind_params = pg_realloc_array(pset.bind_params, char *, nalloc);
     539             :             }
     540         540 :             pset.bind_params[nparams - 1] = opt;
     541             :         }
     542             : 
     543         664 :         pset.bind_nparams = nparams;
     544         664 :         pset.send_mode = PSQL_SEND_EXTENDED_QUERY_PARAMS;
     545             :     }
     546             :     else
     547           6 :         ignore_slash_options(scan_state);
     548             : 
     549         670 :     return status;
     550             : }
     551             : 
     552             : /*
     553             :  * \bind_named -- set query parameters for an existing prepared statement
     554             :  */
     555             : static backslashResult
     556         176 : exec_command_bind_named(PsqlScanState scan_state, bool active_branch,
     557             :                         const char *cmd)
     558             : {
     559         176 :     backslashResult status = PSQL_CMD_SKIP_LINE;
     560             : 
     561         176 :     if (active_branch)
     562             :     {
     563             :         char       *opt;
     564         170 :         int         nparams = 0;
     565         170 :         int         nalloc = 0;
     566             : 
     567         170 :         clean_extended_state();
     568             : 
     569             :         /* get the mandatory prepared statement name */
     570         170 :         opt = psql_scan_slash_option(scan_state, OT_NORMAL, NULL, false);
     571         170 :         if (!opt)
     572             :         {
     573          12 :             pg_log_error("\\%s: missing required argument", cmd);
     574          12 :             status = PSQL_CMD_ERROR;
     575             :         }
     576             :         else
     577             :         {
     578         158 :             pset.stmtName = opt;
     579         158 :             pset.send_mode = PSQL_SEND_EXTENDED_QUERY_PREPARED;
     580             : 
     581             :             /* set of parameters */
     582         334 :             while ((opt = psql_scan_slash_option(scan_state, OT_NORMAL, NULL, false)))
     583             :             {
     584         176 :                 nparams++;
     585         176 :                 if (nparams > nalloc)
     586             :                 {
     587         176 :                     nalloc = nalloc ? nalloc * 2 : 1;
     588         176 :                     pset.bind_params = pg_realloc_array(pset.bind_params, char *, nalloc);
     589             :                 }
     590         176 :                 pset.bind_params[nparams - 1] = opt;
     591             :             }
     592         158 :             pset.bind_nparams = nparams;
     593             :         }
     594             :     }
     595             :     else
     596           6 :         ignore_slash_options(scan_state);
     597             : 
     598         176 :     return status;
     599             : }
     600             : 
     601             : /*
     602             :  * \C -- override table title (formerly change HTML caption)
     603             :  */
     604             : static backslashResult
     605           6 : exec_command_C(PsqlScanState scan_state, bool active_branch)
     606             : {
     607           6 :     bool        success = true;
     608             : 
     609           6 :     if (active_branch)
     610             :     {
     611           0 :         char       *opt = psql_scan_slash_option(scan_state,
     612             :                                                  OT_NORMAL, NULL, true);
     613             : 
     614           0 :         success = do_pset("title", opt, &pset.popt, pset.quiet);
     615           0 :         free(opt);
     616             :     }
     617             :     else
     618           6 :         ignore_slash_options(scan_state);
     619             : 
     620           6 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
     621             : }
     622             : 
     623             : /*
     624             :  * \c or \connect -- connect to database using the specified parameters.
     625             :  *
     626             :  * \c [-reuse-previous=BOOL] dbname user host port
     627             :  *
     628             :  * Specifying a parameter as '-' is equivalent to omitting it.  Examples:
     629             :  *
     630             :  * \c - - hst       Connect to current database on current port of
     631             :  *                  host "hst" as current user.
     632             :  * \c - usr - prt   Connect to current database on port "prt" of current host
     633             :  *                  as user "usr".
     634             :  * \c dbs           Connect to database "dbs" on current port of current host
     635             :  *                  as current user.
     636             :  */
     637             : static backslashResult
     638         344 : exec_command_connect(PsqlScanState scan_state, bool active_branch)
     639             : {
     640         344 :     bool        success = true;
     641             : 
     642         344 :     if (active_branch)
     643             :     {
     644             :         static const char prefix[] = "-reuse-previous=";
     645             :         char       *opt1,
     646             :                    *opt2,
     647             :                    *opt3,
     648             :                    *opt4;
     649         338 :         enum trivalue reuse_previous = TRI_DEFAULT;
     650             : 
     651         338 :         opt1 = read_connect_arg(scan_state);
     652         338 :         if (opt1 != NULL && strncmp(opt1, prefix, sizeof(prefix) - 1) == 0)
     653             :         {
     654             :             bool        on_off;
     655             : 
     656          22 :             success = ParseVariableBool(opt1 + sizeof(prefix) - 1,
     657             :                                         "-reuse-previous",
     658             :                                         &on_off);
     659          22 :             if (success)
     660             :             {
     661          22 :                 reuse_previous = on_off ? TRI_YES : TRI_NO;
     662          22 :                 free(opt1);
     663          22 :                 opt1 = read_connect_arg(scan_state);
     664             :             }
     665             :         }
     666             : 
     667         338 :         if (success)            /* give up if reuse_previous was invalid */
     668             :         {
     669         338 :             opt2 = read_connect_arg(scan_state);
     670         338 :             opt3 = read_connect_arg(scan_state);
     671         338 :             opt4 = read_connect_arg(scan_state);
     672             : 
     673         338 :             success = do_connect(reuse_previous, opt1, opt2, opt3, opt4);
     674             : 
     675         338 :             free(opt2);
     676         338 :             free(opt3);
     677         338 :             free(opt4);
     678             :         }
     679         338 :         free(opt1);
     680             :     }
     681             :     else
     682           6 :         ignore_slash_options(scan_state);
     683             : 
     684         344 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
     685             : }
     686             : 
     687             : /*
     688             :  * \cd -- change directory
     689             :  */
     690             : static backslashResult
     691           6 : exec_command_cd(PsqlScanState scan_state, bool active_branch, const char *cmd)
     692             : {
     693           6 :     bool        success = true;
     694             : 
     695           6 :     if (active_branch)
     696             :     {
     697           0 :         char       *opt = psql_scan_slash_option(scan_state,
     698             :                                                  OT_NORMAL, NULL, true);
     699             :         char       *dir;
     700             : 
     701           0 :         if (opt)
     702           0 :             dir = opt;
     703             :         else
     704             :         {
     705             : #ifndef WIN32
     706             :             /* This should match get_home_path() */
     707           0 :             dir = getenv("HOME");
     708           0 :             if (dir == NULL || dir[0] == '\0')
     709             :             {
     710           0 :                 uid_t       user_id = geteuid();
     711             :                 struct passwd *pw;
     712             : 
     713           0 :                 errno = 0;      /* clear errno before call */
     714           0 :                 pw = getpwuid(user_id);
     715           0 :                 if (pw)
     716           0 :                     dir = pw->pw_dir;
     717             :                 else
     718             :                 {
     719           0 :                     pg_log_error("could not get home directory for user ID %ld: %s",
     720             :                                  (long) user_id,
     721             :                                  errno ? strerror(errno) : _("user does not exist"));
     722           0 :                     success = false;
     723             :                 }
     724             :             }
     725             : #else                           /* WIN32 */
     726             : 
     727             :             /*
     728             :              * On Windows, 'cd' without arguments prints the current
     729             :              * directory, so if someone wants to code this here instead...
     730             :              */
     731             :             dir = "/";
     732             : #endif                          /* WIN32 */
     733             :         }
     734             : 
     735           0 :         if (success &&
     736           0 :             chdir(dir) < 0)
     737             :         {
     738           0 :             pg_log_error("\\%s: could not change directory to \"%s\": %m",
     739             :                          cmd, dir);
     740           0 :             success = false;
     741             :         }
     742             : 
     743           0 :         free(opt);
     744             :     }
     745             :     else
     746           6 :         ignore_slash_options(scan_state);
     747             : 
     748           6 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
     749             : }
     750             : 
     751             : /*
     752             :  * \close_prepared -- close a previously prepared statement
     753             :  */
     754             : static backslashResult
     755          50 : exec_command_close_prepared(PsqlScanState scan_state, bool active_branch, const char *cmd)
     756             : {
     757          50 :     backslashResult status = PSQL_CMD_SKIP_LINE;
     758             : 
     759          50 :     if (active_branch)
     760             :     {
     761          44 :         char       *opt = psql_scan_slash_option(scan_state,
     762             :                                                  OT_NORMAL, NULL, false);
     763             : 
     764          44 :         clean_extended_state();
     765             : 
     766          44 :         if (!opt)
     767             :         {
     768           6 :             pg_log_error("\\%s: missing required argument", cmd);
     769           6 :             status = PSQL_CMD_ERROR;
     770             :         }
     771             :         else
     772             :         {
     773          38 :             pset.stmtName = opt;
     774          38 :             pset.send_mode = PSQL_SEND_EXTENDED_CLOSE;
     775          38 :             status = PSQL_CMD_SEND;
     776             :         }
     777             :     }
     778             :     else
     779           6 :         ignore_slash_options(scan_state);
     780             : 
     781          50 :     return status;
     782             : }
     783             : 
     784             : /*
     785             :  * \conninfo -- display information about the current connection
     786             :  */
     787             : static backslashResult
     788           6 : exec_command_conninfo(PsqlScanState scan_state, bool active_branch)
     789             : {
     790             :     printTableContent cont;
     791             :     int         rows,
     792             :                 cols;
     793             :     char       *db;
     794             :     char       *host;
     795             :     bool        print_hostaddr;
     796             :     char       *hostaddr;
     797             :     char       *protocol_version,
     798             :                *backend_pid;
     799             :     int         ssl_in_use,
     800             :                 password_used,
     801             :                 gssapi_used;
     802             :     int         version_num;
     803             :     char       *paramval;
     804             : 
     805           6 :     if (!active_branch)
     806           6 :         return PSQL_CMD_SKIP_LINE;
     807             : 
     808           0 :     db = PQdb(pset.db);
     809           0 :     if (db == NULL)
     810             :     {
     811           0 :         printf(_("You are currently not connected to a database.\n"));
     812           0 :         return PSQL_CMD_SKIP_LINE;
     813             :     }
     814             : 
     815             :     /* Get values for the parameters */
     816           0 :     host = PQhost(pset.db);
     817           0 :     hostaddr = PQhostaddr(pset.db);
     818           0 :     version_num = PQfullProtocolVersion(pset.db);
     819           0 :     protocol_version = psprintf("%d.%d", version_num / 10000,
     820             :                                 version_num % 10000);
     821           0 :     ssl_in_use = PQsslInUse(pset.db);
     822           0 :     password_used = PQconnectionUsedPassword(pset.db);
     823           0 :     gssapi_used = PQconnectionUsedGSSAPI(pset.db);
     824           0 :     backend_pid = psprintf("%d", PQbackendPID(pset.db));
     825             : 
     826             :     /* Only print hostaddr if it differs from host, and not if unixsock */
     827           0 :     print_hostaddr = (!is_unixsock_path(host) &&
     828           0 :                       hostaddr && *hostaddr && strcmp(host, hostaddr) != 0);
     829             : 
     830             :     /* Determine the exact number of rows to print */
     831           0 :     rows = 12;
     832           0 :     cols = 2;
     833           0 :     if (ssl_in_use)
     834           0 :         rows += 6;
     835           0 :     if (print_hostaddr)
     836           0 :         rows++;
     837             : 
     838             :     /* Set it all up */
     839           0 :     printTableInit(&cont, &pset.popt.topt, _("Connection Information"), cols, rows);
     840           0 :     printTableAddHeader(&cont, _("Parameter"), true, 'l');
     841           0 :     printTableAddHeader(&cont, _("Value"), true, 'l');
     842             : 
     843             :     /* Database */
     844           0 :     printTableAddCell(&cont, _("Database"), false, false);
     845           0 :     printTableAddCell(&cont, db, false, false);
     846             : 
     847             :     /* Client User */
     848           0 :     printTableAddCell(&cont, _("Client User"), false, false);
     849           0 :     printTableAddCell(&cont, PQuser(pset.db), false, false);
     850             : 
     851             :     /* Host/hostaddr/socket */
     852           0 :     if (is_unixsock_path(host))
     853             :     {
     854             :         /* hostaddr if specified overrides socket, so suppress the latter */
     855           0 :         if (hostaddr && *hostaddr)
     856             :         {
     857           0 :             printTableAddCell(&cont, _("Host Address"), false, false);
     858           0 :             printTableAddCell(&cont, hostaddr, false, false);
     859             :         }
     860             :         else
     861             :         {
     862           0 :             printTableAddCell(&cont, _("Socket Directory"), false, false);
     863           0 :             printTableAddCell(&cont, host, false, false);
     864             :         }
     865             :     }
     866             :     else
     867             :     {
     868           0 :         printTableAddCell(&cont, _("Host"), false, false);
     869           0 :         printTableAddCell(&cont, host, false, false);
     870           0 :         if (print_hostaddr)
     871             :         {
     872           0 :             printTableAddCell(&cont, _("Host Address"), false, false);
     873           0 :             printTableAddCell(&cont, hostaddr, false, false);
     874             :         }
     875             :     }
     876             : 
     877             :     /* Server Port */
     878           0 :     printTableAddCell(&cont, _("Server Port"), false, false);
     879           0 :     printTableAddCell(&cont, PQport(pset.db), false, false);
     880             : 
     881             :     /* Options */
     882           0 :     printTableAddCell(&cont, _("Options"), false, false);
     883           0 :     printTableAddCell(&cont, PQoptions(pset.db), false, false);
     884             : 
     885             :     /* Protocol Version */
     886           0 :     printTableAddCell(&cont, _("Protocol Version"), false, false);
     887           0 :     printTableAddCell(&cont, protocol_version, false, false);
     888             : 
     889             :     /* Password Used */
     890           0 :     printTableAddCell(&cont, _("Password Used"), false, false);
     891           0 :     printTableAddCell(&cont, password_used ? _("true") : _("false"), false, false);
     892             : 
     893             :     /* GSSAPI Authenticated */
     894           0 :     printTableAddCell(&cont, _("GSSAPI Authenticated"), false, false);
     895           0 :     printTableAddCell(&cont, gssapi_used ? _("true") : _("false"), false, false);
     896             : 
     897             :     /* Backend PID */
     898           0 :     printTableAddCell(&cont, _("Backend PID"), false, false);
     899           0 :     printTableAddCell(&cont, backend_pid, false, false);
     900             : 
     901             :     /* SSL Connection */
     902           0 :     printTableAddCell(&cont, _("SSL Connection"), false, false);
     903           0 :     printTableAddCell(&cont, ssl_in_use ? _("true") : _("false"), false, false);
     904             : 
     905             :     /* SSL Information */
     906           0 :     if (ssl_in_use)
     907             :     {
     908             :         char       *library,
     909             :                    *protocol,
     910             :                    *key_bits,
     911             :                    *cipher,
     912             :                    *compression,
     913             :                    *alpn;
     914             : 
     915           0 :         library = (char *) PQsslAttribute(pset.db, "library");
     916           0 :         protocol = (char *) PQsslAttribute(pset.db, "protocol");
     917           0 :         key_bits = (char *) PQsslAttribute(pset.db, "key_bits");
     918           0 :         cipher = (char *) PQsslAttribute(pset.db, "cipher");
     919           0 :         compression = (char *) PQsslAttribute(pset.db, "compression");
     920           0 :         alpn = (char *) PQsslAttribute(pset.db, "alpn");
     921             : 
     922           0 :         printTableAddCell(&cont, _("SSL Library"), false, false);
     923           0 :         printTableAddCell(&cont, library ? library : _("unknown"), false, false);
     924             : 
     925           0 :         printTableAddCell(&cont, _("SSL Protocol"), false, false);
     926           0 :         printTableAddCell(&cont, protocol ? protocol : _("unknown"), false, false);
     927             : 
     928           0 :         printTableAddCell(&cont, _("SSL Key Bits"), false, false);
     929           0 :         printTableAddCell(&cont, key_bits ? key_bits : _("unknown"), false, false);
     930             : 
     931           0 :         printTableAddCell(&cont, _("SSL Cipher"), false, false);
     932           0 :         printTableAddCell(&cont, cipher ? cipher : _("unknown"), false, false);
     933             : 
     934           0 :         printTableAddCell(&cont, _("SSL Compression"), false, false);
     935           0 :         printTableAddCell(&cont, (compression && strcmp(compression, "off") != 0) ?
     936           0 :                           _("true") : _("false"), false, false);
     937             : 
     938           0 :         printTableAddCell(&cont, _("ALPN"), false, false);
     939           0 :         printTableAddCell(&cont, (alpn && alpn[0] != '\0') ? alpn : _("none"), false, false);
     940             :     }
     941             : 
     942           0 :     paramval = (char *) PQparameterStatus(pset.db, "is_superuser");
     943           0 :     printTableAddCell(&cont, "Superuser", false, false);
     944           0 :     printTableAddCell(&cont, paramval ? paramval : _("unknown"), false, false);
     945             : 
     946           0 :     paramval = (char *) PQparameterStatus(pset.db, "in_hot_standby");
     947           0 :     printTableAddCell(&cont, "Hot Standby", false, false);
     948           0 :     printTableAddCell(&cont, paramval ? paramval : _("unknown"), false, false);
     949             : 
     950           0 :     printTable(&cont, pset.queryFout, false, pset.logfile);
     951           0 :     printTableCleanup(&cont);
     952             : 
     953           0 :     pfree(protocol_version);
     954           0 :     pfree(backend_pid);
     955             : 
     956           0 :     return PSQL_CMD_SKIP_LINE;
     957             : }
     958             : 
     959             : /*
     960             :  * \copy -- run a COPY command
     961             :  */
     962             : static backslashResult
     963         172 : exec_command_copy(PsqlScanState scan_state, bool active_branch)
     964             : {
     965         172 :     bool        success = true;
     966             : 
     967         172 :     if (active_branch)
     968             :     {
     969         166 :         char       *opt = psql_scan_slash_option(scan_state,
     970             :                                                  OT_WHOLE_LINE, NULL, false);
     971             : 
     972         166 :         success = do_copy(opt);
     973         166 :         free(opt);
     974             :     }
     975             :     else
     976           6 :         ignore_slash_whole_line(scan_state);
     977             : 
     978         172 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
     979             : }
     980             : 
     981             : /*
     982             :  * \copyright -- print copyright notice
     983             :  */
     984             : static backslashResult
     985           8 : exec_command_copyright(PsqlScanState scan_state, bool active_branch)
     986             : {
     987           8 :     if (active_branch)
     988           2 :         print_copyright();
     989             : 
     990           8 :     return PSQL_CMD_SKIP_LINE;
     991             : }
     992             : 
     993             : /*
     994             :  * \crosstabview -- execute a query and display result in crosstab
     995             :  */
     996             : static backslashResult
     997         138 : exec_command_crosstabview(PsqlScanState scan_state, bool active_branch)
     998             : {
     999         138 :     backslashResult status = PSQL_CMD_SKIP_LINE;
    1000             : 
    1001         138 :     if (active_branch)
    1002             :     {
    1003             :         int         i;
    1004             : 
    1005         660 :         for (i = 0; i < lengthof(pset.ctv_args); i++)
    1006         528 :             pset.ctv_args[i] = psql_scan_slash_option(scan_state,
    1007             :                                                       OT_NORMAL, NULL, true);
    1008         132 :         pset.crosstab_flag = true;
    1009         132 :         status = PSQL_CMD_SEND;
    1010             :     }
    1011             :     else
    1012           6 :         ignore_slash_options(scan_state);
    1013             : 
    1014         138 :     return status;
    1015             : }
    1016             : 
    1017             : /*
    1018             :  * \d* commands
    1019             :  */
    1020             : static backslashResult
    1021        6828 : exec_command_d(PsqlScanState scan_state, bool active_branch, const char *cmd)
    1022             : {
    1023        6828 :     backslashResult status = PSQL_CMD_SKIP_LINE;
    1024        6828 :     bool        success = true;
    1025             : 
    1026        6828 :     if (active_branch)
    1027             :     {
    1028             :         char       *pattern;
    1029             :         bool        show_verbose,
    1030             :                     show_system;
    1031             :         unsigned short int save_expanded;
    1032             : 
    1033             :         /* We don't do SQLID reduction on the pattern yet */
    1034        6822 :         pattern = psql_scan_slash_option(scan_state,
    1035             :                                          OT_NORMAL, NULL, true);
    1036             : 
    1037        6822 :         show_verbose = strchr(cmd, '+') ? true : false;
    1038        6822 :         show_system = strchr(cmd, 'S') ? true : false;
    1039             : 
    1040             :         /*
    1041             :          * The 'x' option turns expanded mode on for this command only. This
    1042             :          * is allowed in all \d* commands, except \d by itself, since \dx is a
    1043             :          * separate command. So the 'x' option cannot appear immediately after
    1044             :          * \d, but it can appear after \d followed by other options.
    1045             :          */
    1046        6822 :         save_expanded = pset.popt.topt.expanded;
    1047        6822 :         if (cmd[1] != '\0' && strchr(&cmd[2], 'x'))
    1048          24 :             pset.popt.topt.expanded = 1;
    1049             : 
    1050        6822 :         switch (cmd[1])
    1051             :         {
    1052        4008 :             case '\0':
    1053             :             case '+':
    1054             :             case 'S':
    1055        4008 :                 if (pattern)
    1056        3990 :                     success = describeTableDetails(pattern, show_verbose, show_system);
    1057             :                 else
    1058             :                     /* standard listing of interesting things */
    1059          18 :                     success = listTables("tvmsE", NULL, show_verbose, show_system);
    1060        4008 :                 break;
    1061         222 :             case 'A':
    1062             :                 {
    1063         222 :                     char       *pattern2 = NULL;
    1064             : 
    1065         222 :                     if (pattern && cmd[2] != '\0' && cmd[2] != '+' && cmd[2] != 'x')
    1066         144 :                         pattern2 = psql_scan_slash_option(scan_state, OT_NORMAL, NULL, true);
    1067             : 
    1068         222 :                     switch (cmd[2])
    1069             :                     {
    1070          78 :                         case '\0':
    1071             :                         case '+':
    1072             :                         case 'x':
    1073          78 :                             success = describeAccessMethods(pattern, show_verbose);
    1074          78 :                             break;
    1075          30 :                         case 'c':
    1076          30 :                             success = listOperatorClasses(pattern, pattern2, show_verbose);
    1077          30 :                             break;
    1078          36 :                         case 'f':
    1079          36 :                             success = listOperatorFamilies(pattern, pattern2, show_verbose);
    1080          36 :                             break;
    1081          36 :                         case 'o':
    1082          36 :                             success = listOpFamilyOperators(pattern, pattern2, show_verbose);
    1083          36 :                             break;
    1084          42 :                         case 'p':
    1085          42 :                             success = listOpFamilyFunctions(pattern, pattern2, show_verbose);
    1086          42 :                             break;
    1087           0 :                         default:
    1088           0 :                             status = PSQL_CMD_UNKNOWN;
    1089           0 :                             break;
    1090             :                     }
    1091             : 
    1092         222 :                     free(pattern2);
    1093             :                 }
    1094         222 :                 break;
    1095          48 :             case 'a':
    1096          48 :                 success = describeAggregates(pattern, show_verbose, show_system);
    1097          48 :                 break;
    1098          24 :             case 'b':
    1099          24 :                 success = describeTablespaces(pattern, show_verbose);
    1100          24 :                 break;
    1101          54 :             case 'c':
    1102          54 :                 if (strncmp(cmd, "dconfig", 7) == 0)
    1103          12 :                     success = describeConfigurationParameters(pattern,
    1104             :                                                               show_verbose,
    1105             :                                                               show_system);
    1106             :                 else
    1107          42 :                     success = listConversions(pattern,
    1108             :                                               show_verbose,
    1109             :                                               show_system);
    1110          54 :                 break;
    1111          42 :             case 'C':
    1112          42 :                 success = listCasts(pattern, show_verbose);
    1113          42 :                 break;
    1114          78 :             case 'd':
    1115          78 :                 if (strncmp(cmd, "ddp", 3) == 0)
    1116          36 :                     success = listDefaultACLs(pattern);
    1117             :                 else
    1118          42 :                     success = objectDescription(pattern, show_system);
    1119          78 :                 break;
    1120          60 :             case 'D':
    1121          60 :                 success = listDomains(pattern, show_verbose, show_system);
    1122          60 :                 break;
    1123         298 :             case 'f':           /* function subsystem */
    1124         298 :                 switch (cmd[2])
    1125             :                 {
    1126         298 :                     case '\0':
    1127             :                     case '+':
    1128             :                     case 'S':
    1129             :                     case 'a':
    1130             :                     case 'n':
    1131             :                     case 'p':
    1132             :                     case 't':
    1133             :                     case 'w':
    1134             :                     case 'x':
    1135         298 :                         success = exec_command_dfo(scan_state, cmd, pattern,
    1136             :                                                    show_verbose, show_system);
    1137         298 :                         break;
    1138           0 :                     default:
    1139           0 :                         status = PSQL_CMD_UNKNOWN;
    1140           0 :                         break;
    1141             :                 }
    1142         298 :                 break;
    1143          24 :             case 'g':
    1144             :                 /* no longer distinct from \du */
    1145          24 :                 success = describeRoles(pattern, show_verbose, show_system);
    1146          24 :                 break;
    1147           6 :             case 'l':
    1148           6 :                 success = listLargeObjects(show_verbose);
    1149           6 :                 break;
    1150          30 :             case 'L':
    1151          30 :                 success = listLanguages(pattern, show_verbose, show_system);
    1152          30 :                 break;
    1153          24 :             case 'n':
    1154          24 :                 success = listSchemas(pattern, show_verbose, show_system);
    1155          24 :                 break;
    1156          62 :             case 'o':
    1157          62 :                 success = exec_command_dfo(scan_state, cmd, pattern,
    1158             :                                            show_verbose, show_system);
    1159          62 :                 break;
    1160          42 :             case 'O':
    1161          42 :                 success = listCollations(pattern, show_verbose, show_system);
    1162          42 :                 break;
    1163          72 :             case 'p':
    1164          72 :                 success = permissionsList(pattern, show_system);
    1165          72 :                 break;
    1166         108 :             case 'P':
    1167             :                 {
    1168         108 :                     switch (cmd[2])
    1169             :                     {
    1170         108 :                         case '\0':
    1171             :                         case '+':
    1172             :                         case 't':
    1173             :                         case 'i':
    1174             :                         case 'n':
    1175             :                         case 'x':
    1176         108 :                             success = listPartitionedTables(&cmd[2], pattern, show_verbose);
    1177         108 :                             break;
    1178           0 :                         default:
    1179           0 :                             status = PSQL_CMD_UNKNOWN;
    1180           0 :                             break;
    1181             :                     }
    1182             :                 }
    1183         108 :                 break;
    1184          68 :             case 'T':
    1185          68 :                 success = describeTypes(pattern, show_verbose, show_system);
    1186          68 :                 break;
    1187         294 :             case 't':
    1188             :             case 'v':
    1189             :             case 'm':
    1190             :             case 'i':
    1191             :             case 's':
    1192             :             case 'E':
    1193         294 :                 success = listTables(&cmd[1], pattern, show_verbose, show_system);
    1194         294 :                 break;
    1195          32 :             case 'r':
    1196          32 :                 if (cmd[2] == 'd' && cmd[3] == 's')
    1197          26 :                 {
    1198          26 :                     char       *pattern2 = NULL;
    1199             : 
    1200          26 :                     if (pattern)
    1201          24 :                         pattern2 = psql_scan_slash_option(scan_state,
    1202             :                                                           OT_NORMAL, NULL, true);
    1203          26 :                     success = listDbRoleSettings(pattern, pattern2);
    1204             : 
    1205          26 :                     free(pattern2);
    1206             :                 }
    1207           6 :                 else if (cmd[2] == 'g')
    1208           6 :                     success = describeRoleGrants(pattern, show_system);
    1209             :                 else
    1210           0 :                     status = PSQL_CMD_UNKNOWN;
    1211          32 :                 break;
    1212         558 :             case 'R':
    1213         558 :                 switch (cmd[2])
    1214             :                 {
    1215         390 :                     case 'p':
    1216         390 :                         if (show_verbose)
    1217         342 :                             success = describePublications(pattern);
    1218             :                         else
    1219          48 :                             success = listPublications(pattern);
    1220         390 :                         break;
    1221         168 :                     case 's':
    1222         168 :                         success = describeSubscriptions(pattern, show_verbose);
    1223         168 :                         break;
    1224           0 :                     default:
    1225           0 :                         status = PSQL_CMD_UNKNOWN;
    1226             :                 }
    1227         558 :                 break;
    1228           6 :             case 'u':
    1229           6 :                 success = describeRoles(pattern, show_verbose, show_system);
    1230           6 :                 break;
    1231         168 :             case 'F':           /* text search subsystem */
    1232         168 :                 switch (cmd[2])
    1233             :                 {
    1234          42 :                     case '\0':
    1235             :                     case '+':
    1236             :                     case 'x':
    1237          42 :                         success = listTSConfigs(pattern, show_verbose);
    1238          42 :                         break;
    1239          42 :                     case 'p':
    1240          42 :                         success = listTSParsers(pattern, show_verbose);
    1241          42 :                         break;
    1242          42 :                     case 'd':
    1243          42 :                         success = listTSDictionaries(pattern, show_verbose);
    1244          42 :                         break;
    1245          42 :                     case 't':
    1246          42 :                         success = listTSTemplates(pattern, show_verbose);
    1247          42 :                         break;
    1248           0 :                     default:
    1249           0 :                         status = PSQL_CMD_UNKNOWN;
    1250           0 :                         break;
    1251             :                 }
    1252         168 :                 break;
    1253         312 :             case 'e':           /* SQL/MED subsystem */
    1254         312 :                 switch (cmd[2])
    1255             :                 {
    1256         120 :                     case 's':
    1257         120 :                         success = listForeignServers(pattern, show_verbose);
    1258         120 :                         break;
    1259          60 :                     case 'u':
    1260          60 :                         success = listUserMappings(pattern, show_verbose);
    1261          60 :                         break;
    1262         114 :                     case 'w':
    1263         114 :                         success = listForeignDataWrappers(pattern, show_verbose);
    1264         114 :                         break;
    1265          18 :                     case 't':
    1266          18 :                         success = listForeignTables(pattern, show_verbose);
    1267          18 :                         break;
    1268           0 :                     default:
    1269           0 :                         status = PSQL_CMD_UNKNOWN;
    1270           0 :                         break;
    1271             :                 }
    1272         312 :                 break;
    1273          56 :             case 'x':           /* Extensions */
    1274          56 :                 if (show_verbose)
    1275          32 :                     success = listExtensionContents(pattern);
    1276             :                 else
    1277          24 :                     success = listExtensions(pattern);
    1278          56 :                 break;
    1279         102 :             case 'X':           /* Extended Statistics */
    1280         102 :                 success = listExtendedStats(pattern);
    1281         102 :                 break;
    1282          24 :             case 'y':           /* Event Triggers */
    1283          24 :                 success = listEventTriggers(pattern, show_verbose);
    1284          24 :                 break;
    1285           0 :             default:
    1286           0 :                 status = PSQL_CMD_UNKNOWN;
    1287             :         }
    1288             : 
    1289             :         /* Restore original expanded mode */
    1290        6822 :         pset.popt.topt.expanded = save_expanded;
    1291             : 
    1292        6822 :         free(pattern);
    1293             :     }
    1294             :     else
    1295           6 :         ignore_slash_options(scan_state);
    1296             : 
    1297        6828 :     if (!success)
    1298         932 :         status = PSQL_CMD_ERROR;
    1299             : 
    1300        6828 :     return status;
    1301             : }
    1302             : 
    1303             : /* \df and \do; messy enough to split out of exec_command_d */
    1304             : static bool
    1305         360 : exec_command_dfo(PsqlScanState scan_state, const char *cmd,
    1306             :                  const char *pattern,
    1307             :                  bool show_verbose, bool show_system)
    1308             : {
    1309             :     bool        success;
    1310             :     char       *arg_patterns[FUNC_MAX_ARGS];
    1311         360 :     int         num_arg_patterns = 0;
    1312             : 
    1313             :     /* Collect argument-type patterns too */
    1314         360 :     if (pattern)                /* otherwise it was just \df or \do */
    1315             :     {
    1316             :         char       *ap;
    1317             : 
    1318         440 :         while ((ap = psql_scan_slash_option(scan_state,
    1319         440 :                                             OT_NORMAL, NULL, true)) != NULL)
    1320             :         {
    1321          84 :             arg_patterns[num_arg_patterns++] = ap;
    1322          84 :             if (num_arg_patterns >= FUNC_MAX_ARGS)
    1323           0 :                 break;          /* protect limited-size array */
    1324             :         }
    1325             :     }
    1326             : 
    1327         360 :     if (cmd[1] == 'f')
    1328         298 :         success = describeFunctions(&cmd[2], pattern,
    1329             :                                     arg_patterns, num_arg_patterns,
    1330             :                                     show_verbose, show_system);
    1331             :     else
    1332          62 :         success = describeOperators(pattern,
    1333             :                                     arg_patterns, num_arg_patterns,
    1334             :                                     show_verbose, show_system);
    1335             : 
    1336         444 :     while (--num_arg_patterns >= 0)
    1337          84 :         free(arg_patterns[num_arg_patterns]);
    1338             : 
    1339         360 :     return success;
    1340             : }
    1341             : 
    1342             : /*
    1343             :  * \e or \edit -- edit the current query buffer, or edit a file and
    1344             :  * make it the query buffer
    1345             :  */
    1346             : static backslashResult
    1347           6 : exec_command_edit(PsqlScanState scan_state, bool active_branch,
    1348             :                   PQExpBuffer query_buf, PQExpBuffer previous_buf)
    1349             : {
    1350           6 :     backslashResult status = PSQL_CMD_SKIP_LINE;
    1351             : 
    1352           6 :     if (active_branch)
    1353             :     {
    1354           0 :         if (!query_buf)
    1355             :         {
    1356           0 :             pg_log_error("no query buffer");
    1357           0 :             status = PSQL_CMD_ERROR;
    1358             :         }
    1359             :         else
    1360             :         {
    1361             :             char       *fname;
    1362           0 :             char       *ln = NULL;
    1363           0 :             int         lineno = -1;
    1364             : 
    1365           0 :             fname = psql_scan_slash_option(scan_state,
    1366             :                                            OT_NORMAL, NULL, true);
    1367           0 :             if (fname)
    1368             :             {
    1369             :                 /* try to get separate lineno arg */
    1370           0 :                 ln = psql_scan_slash_option(scan_state,
    1371             :                                             OT_NORMAL, NULL, true);
    1372           0 :                 if (ln == NULL)
    1373             :                 {
    1374             :                     /* only one arg; maybe it is lineno not fname */
    1375           0 :                     if (fname[0] &&
    1376           0 :                         strspn(fname, "0123456789") == strlen(fname))
    1377             :                     {
    1378             :                         /* all digits, so assume it is lineno */
    1379           0 :                         ln = fname;
    1380           0 :                         fname = NULL;
    1381             :                     }
    1382             :                 }
    1383             :             }
    1384           0 :             if (ln)
    1385             :             {
    1386           0 :                 lineno = atoi(ln);
    1387           0 :                 if (lineno < 1)
    1388             :                 {
    1389           0 :                     pg_log_error("invalid line number: %s", ln);
    1390           0 :                     status = PSQL_CMD_ERROR;
    1391             :                 }
    1392             :             }
    1393           0 :             if (status != PSQL_CMD_ERROR)
    1394             :             {
    1395             :                 bool        discard_on_quit;
    1396             : 
    1397           0 :                 expand_tilde(&fname);
    1398           0 :                 if (fname)
    1399             :                 {
    1400           0 :                     canonicalize_path_enc(fname, pset.encoding);
    1401             :                     /* Always clear buffer if the file isn't modified */
    1402           0 :                     discard_on_quit = true;
    1403             :                 }
    1404             :                 else
    1405             :                 {
    1406             :                     /*
    1407             :                      * If query_buf is empty, recall previous query for
    1408             :                      * editing.  But in that case, the query buffer should be
    1409             :                      * emptied if editing doesn't modify the file.
    1410             :                      */
    1411           0 :                     discard_on_quit = copy_previous_query(query_buf,
    1412             :                                                           previous_buf);
    1413             :                 }
    1414             : 
    1415           0 :                 if (do_edit(fname, query_buf, lineno, discard_on_quit, NULL))
    1416           0 :                     status = PSQL_CMD_NEWEDIT;
    1417             :                 else
    1418           0 :                     status = PSQL_CMD_ERROR;
    1419             :             }
    1420             : 
    1421             :             /*
    1422             :              * On error while editing or if specifying an incorrect line
    1423             :              * number, reset the query buffer.
    1424             :              */
    1425           0 :             if (status == PSQL_CMD_ERROR)
    1426           0 :                 resetPQExpBuffer(query_buf);
    1427             : 
    1428           0 :             free(fname);
    1429           0 :             free(ln);
    1430             :         }
    1431             :     }
    1432             :     else
    1433           6 :         ignore_slash_options(scan_state);
    1434             : 
    1435           6 :     return status;
    1436             : }
    1437             : 
    1438             : /*
    1439             :  * \ef/\ev -- edit the named function/view, or
    1440             :  * present a blank CREATE FUNCTION/VIEW template if no argument is given
    1441             :  */
    1442             : static backslashResult
    1443          12 : exec_command_ef_ev(PsqlScanState scan_state, bool active_branch,
    1444             :                    PQExpBuffer query_buf, bool is_func)
    1445             : {
    1446          12 :     backslashResult status = PSQL_CMD_SKIP_LINE;
    1447             : 
    1448          12 :     if (active_branch)
    1449             :     {
    1450           0 :         char       *obj_desc = psql_scan_slash_option(scan_state,
    1451             :                                                       OT_WHOLE_LINE,
    1452             :                                                       NULL, true);
    1453           0 :         int         lineno = -1;
    1454             : 
    1455           0 :         if (!query_buf)
    1456             :         {
    1457           0 :             pg_log_error("no query buffer");
    1458           0 :             status = PSQL_CMD_ERROR;
    1459             :         }
    1460             :         else
    1461             :         {
    1462           0 :             Oid         obj_oid = InvalidOid;
    1463           0 :             EditableObjectType eot = is_func ? EditableFunction : EditableView;
    1464             : 
    1465           0 :             lineno = strip_lineno_from_objdesc(obj_desc);
    1466           0 :             if (lineno == 0)
    1467             :             {
    1468             :                 /* error already reported */
    1469           0 :                 status = PSQL_CMD_ERROR;
    1470             :             }
    1471           0 :             else if (!obj_desc)
    1472             :             {
    1473             :                 /* set up an empty command to fill in */
    1474           0 :                 resetPQExpBuffer(query_buf);
    1475           0 :                 if (is_func)
    1476           0 :                     appendPQExpBufferStr(query_buf,
    1477             :                                          "CREATE FUNCTION ( )\n"
    1478             :                                          " RETURNS \n"
    1479             :                                          " LANGUAGE \n"
    1480             :                                          " -- common options:  IMMUTABLE  STABLE  STRICT  SECURITY DEFINER\n"
    1481             :                                          "AS $function$\n"
    1482             :                                          "\n$function$\n");
    1483             :                 else
    1484           0 :                     appendPQExpBufferStr(query_buf,
    1485             :                                          "CREATE VIEW  AS\n"
    1486             :                                          " SELECT \n"
    1487             :                                          "  -- something...\n");
    1488             :             }
    1489           0 :             else if (!lookup_object_oid(eot, obj_desc, &obj_oid))
    1490             :             {
    1491             :                 /* error already reported */
    1492           0 :                 status = PSQL_CMD_ERROR;
    1493             :             }
    1494           0 :             else if (!get_create_object_cmd(eot, obj_oid, query_buf))
    1495             :             {
    1496             :                 /* error already reported */
    1497           0 :                 status = PSQL_CMD_ERROR;
    1498             :             }
    1499           0 :             else if (is_func && lineno > 0)
    1500             :             {
    1501             :                 /*
    1502             :                  * lineno "1" should correspond to the first line of the
    1503             :                  * function body.  We expect that pg_get_functiondef() will
    1504             :                  * emit that on a line beginning with "AS ", "BEGIN ", or
    1505             :                  * "RETURN ", and that there can be no such line before the
    1506             :                  * real start of the function body.  Increment lineno by the
    1507             :                  * number of lines before that line, so that it becomes
    1508             :                  * relative to the first line of the function definition.
    1509             :                  */
    1510           0 :                 const char *lines = query_buf->data;
    1511             : 
    1512           0 :                 while (*lines != '\0')
    1513             :                 {
    1514           0 :                     if (strncmp(lines, "AS ", 3) == 0 ||
    1515           0 :                         strncmp(lines, "BEGIN ", 6) == 0 ||
    1516           0 :                         strncmp(lines, "RETURN ", 7) == 0)
    1517             :                         break;
    1518           0 :                     lineno++;
    1519             :                     /* find start of next line */
    1520           0 :                     lines = strchr(lines, '\n');
    1521           0 :                     if (!lines)
    1522           0 :                         break;
    1523           0 :                     lines++;
    1524             :                 }
    1525             :             }
    1526             :         }
    1527             : 
    1528           0 :         if (status != PSQL_CMD_ERROR)
    1529             :         {
    1530           0 :             bool        edited = false;
    1531             : 
    1532           0 :             if (!do_edit(NULL, query_buf, lineno, true, &edited))
    1533           0 :                 status = PSQL_CMD_ERROR;
    1534           0 :             else if (!edited)
    1535           0 :                 puts(_("No changes"));
    1536             :             else
    1537           0 :                 status = PSQL_CMD_NEWEDIT;
    1538             :         }
    1539             : 
    1540             :         /*
    1541             :          * On error while doing object lookup or while editing, or if
    1542             :          * specifying an incorrect line number, reset the query buffer.
    1543             :          */
    1544           0 :         if (status == PSQL_CMD_ERROR)
    1545           0 :             resetPQExpBuffer(query_buf);
    1546             : 
    1547           0 :         free(obj_desc);
    1548             :     }
    1549             :     else
    1550          12 :         ignore_slash_whole_line(scan_state);
    1551             : 
    1552          12 :     return status;
    1553             : }
    1554             : 
    1555             : /*
    1556             :  * \echo, \qecho, and \warn -- echo arguments to stdout, query output, or stderr
    1557             :  */
    1558             : static backslashResult
    1559        2786 : exec_command_echo(PsqlScanState scan_state, bool active_branch, const char *cmd)
    1560             : {
    1561        2786 :     if (active_branch)
    1562             :     {
    1563             :         char       *value;
    1564             :         char        quoted;
    1565        2642 :         bool        no_newline = false;
    1566        2642 :         bool        first = true;
    1567             :         FILE       *fout;
    1568             : 
    1569        2642 :         if (strcmp(cmd, "qecho") == 0)
    1570          30 :             fout = pset.queryFout;
    1571        2612 :         else if (strcmp(cmd, "warn") == 0)
    1572         988 :             fout = stderr;
    1573             :         else
    1574        1624 :             fout = stdout;
    1575             : 
    1576        9294 :         while ((value = psql_scan_slash_option(scan_state,
    1577             :                                                OT_NORMAL, &quoted, false)))
    1578             :         {
    1579        6652 :             if (first && !no_newline && !quoted && strcmp(value, "-n") == 0)
    1580           6 :                 no_newline = true;
    1581             :             else
    1582             :             {
    1583        6646 :                 if (first)
    1584        2642 :                     first = false;
    1585             :                 else
    1586        4004 :                     fputc(' ', fout);
    1587        6646 :                 fputs(value, fout);
    1588             :             }
    1589        6652 :             free(value);
    1590             :         }
    1591        2642 :         if (!no_newline)
    1592        2636 :             fputs("\n", fout);
    1593             :     }
    1594             :     else
    1595         144 :         ignore_slash_options(scan_state);
    1596             : 
    1597        2786 :     return PSQL_CMD_SKIP_LINE;
    1598             : }
    1599             : 
    1600             : /*
    1601             :  * \encoding -- set/show client side encoding
    1602             :  */
    1603             : static backslashResult
    1604          22 : exec_command_encoding(PsqlScanState scan_state, bool active_branch)
    1605             : {
    1606          22 :     if (active_branch)
    1607             :     {
    1608          16 :         char       *encoding = psql_scan_slash_option(scan_state,
    1609             :                                                       OT_NORMAL, NULL, false);
    1610             : 
    1611          16 :         if (!encoding)
    1612             :         {
    1613             :             /* show encoding */
    1614           0 :             puts(pg_encoding_to_char(pset.encoding));
    1615             :         }
    1616             :         else
    1617             :         {
    1618             :             /* set encoding */
    1619          16 :             if (PQsetClientEncoding(pset.db, encoding) == -1)
    1620           0 :                 pg_log_error("%s: invalid encoding name or conversion procedure not found", encoding);
    1621             :             else
    1622             :             {
    1623             :                 /* save encoding info into psql internal data */
    1624          16 :                 pset.encoding = PQclientEncoding(pset.db);
    1625          16 :                 pset.popt.topt.encoding = pset.encoding;
    1626          16 :                 setFmtEncoding(pset.encoding);
    1627          16 :                 SetVariable(pset.vars, "ENCODING",
    1628             :                             pg_encoding_to_char(pset.encoding));
    1629             :             }
    1630          16 :             free(encoding);
    1631             :         }
    1632             :     }
    1633             :     else
    1634           6 :         ignore_slash_options(scan_state);
    1635             : 
    1636          22 :     return PSQL_CMD_SKIP_LINE;
    1637             : }
    1638             : 
    1639             : /*
    1640             :  * \errverbose -- display verbose message from last failed query
    1641             :  */
    1642             : static backslashResult
    1643          14 : exec_command_errverbose(PsqlScanState scan_state, bool active_branch)
    1644             : {
    1645          14 :     if (active_branch)
    1646             :     {
    1647           8 :         if (pset.last_error_result)
    1648             :         {
    1649             :             char       *msg;
    1650             : 
    1651           6 :             msg = PQresultVerboseErrorMessage(pset.last_error_result,
    1652             :                                               PQERRORS_VERBOSE,
    1653             :                                               PQSHOW_CONTEXT_ALWAYS);
    1654           6 :             if (msg)
    1655             :             {
    1656           6 :                 pg_log_error("%s", msg);
    1657           6 :                 PQfreemem(msg);
    1658             :             }
    1659             :             else
    1660           0 :                 puts(_("out of memory"));
    1661             :         }
    1662             :         else
    1663           2 :             puts(_("There is no previous error."));
    1664             :     }
    1665             : 
    1666          14 :     return PSQL_CMD_SKIP_LINE;
    1667             : }
    1668             : 
    1669             : /*
    1670             :  * \f -- change field separator
    1671             :  */
    1672             : static backslashResult
    1673           6 : exec_command_f(PsqlScanState scan_state, bool active_branch)
    1674             : {
    1675           6 :     bool        success = true;
    1676             : 
    1677           6 :     if (active_branch)
    1678             :     {
    1679           0 :         char       *fname = psql_scan_slash_option(scan_state,
    1680             :                                                    OT_NORMAL, NULL, false);
    1681             : 
    1682           0 :         success = do_pset("fieldsep", fname, &pset.popt, pset.quiet);
    1683           0 :         free(fname);
    1684             :     }
    1685             :     else
    1686           6 :         ignore_slash_options(scan_state);
    1687             : 
    1688           6 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
    1689             : }
    1690             : 
    1691             : /*
    1692             :  * \flush -- call PQflush() on the connection
    1693             :  */
    1694             : static backslashResult
    1695          24 : exec_command_flush(PsqlScanState scan_state, bool active_branch)
    1696             : {
    1697          24 :     backslashResult status = PSQL_CMD_SKIP_LINE;
    1698             : 
    1699          24 :     if (active_branch)
    1700             :     {
    1701          18 :         pset.send_mode = PSQL_SEND_FLUSH;
    1702          18 :         status = PSQL_CMD_SEND;
    1703             :     }
    1704             :     else
    1705           6 :         ignore_slash_options(scan_state);
    1706             : 
    1707          24 :     return status;
    1708             : }
    1709             : 
    1710             : /*
    1711             :  * \flushrequest -- call PQsendFlushRequest() on the connection
    1712             :  */
    1713             : static backslashResult
    1714          60 : exec_command_flushrequest(PsqlScanState scan_state, bool active_branch)
    1715             : {
    1716          60 :     backslashResult status = PSQL_CMD_SKIP_LINE;
    1717             : 
    1718          60 :     if (active_branch)
    1719             :     {
    1720          54 :         pset.send_mode = PSQL_SEND_FLUSH_REQUEST;
    1721          54 :         status = PSQL_CMD_SEND;
    1722             :     }
    1723             :     else
    1724           6 :         ignore_slash_options(scan_state);
    1725             : 
    1726          60 :     return status;
    1727             : }
    1728             : 
    1729             : /*
    1730             :  * \g  [(pset-option[=pset-value] ...)] [filename/shell-command]
    1731             :  * \gx [(pset-option[=pset-value] ...)] [filename/shell-command]
    1732             :  *
    1733             :  * Send the current query.  If pset options are specified, they are made
    1734             :  * active just for this query.  If a filename or pipe command is given,
    1735             :  * the query output goes there.  \gx implicitly sets "expanded=on" along
    1736             :  * with any other pset options that are specified.
    1737             :  */
    1738             : static backslashResult
    1739         360 : exec_command_g(PsqlScanState scan_state, bool active_branch, const char *cmd)
    1740             : {
    1741         360 :     backslashResult status = PSQL_CMD_SKIP_LINE;
    1742             :     char       *fname;
    1743             : 
    1744             :     /*
    1745             :      * Because the option processing for this is fairly complicated, we do it
    1746             :      * and then decide whether the branch is active.
    1747             :      */
    1748         360 :     fname = psql_scan_slash_option(scan_state,
    1749             :                                    OT_FILEPIPE, NULL, false);
    1750             : 
    1751         360 :     if (fname && fname[0] == '(')
    1752             :     {
    1753             :         /* Consume pset options through trailing ')' ... */
    1754          24 :         status = process_command_g_options(fname + 1, scan_state,
    1755             :                                            active_branch, cmd);
    1756          24 :         free(fname);
    1757             :         /* ... and again attempt to scan the filename. */
    1758          24 :         fname = psql_scan_slash_option(scan_state,
    1759             :                                        OT_FILEPIPE, NULL, false);
    1760             :     }
    1761             : 
    1762         360 :     if (status == PSQL_CMD_SKIP_LINE && active_branch)
    1763             :     {
    1764         336 :         if (PQpipelineStatus(pset.db) != PQ_PIPELINE_OFF)
    1765             :         {
    1766          36 :             pg_log_error("\\%s not allowed in pipeline mode", cmd);
    1767          36 :             clean_extended_state();
    1768          36 :             free(fname);
    1769          36 :             return PSQL_CMD_ERROR;
    1770             :         }
    1771             : 
    1772         300 :         if (!fname)
    1773         268 :             pset.gfname = NULL;
    1774             :         else
    1775             :         {
    1776          32 :             expand_tilde(&fname);
    1777          32 :             pset.gfname = pg_strdup(fname);
    1778             :         }
    1779         300 :         if (strcmp(cmd, "gx") == 0)
    1780             :         {
    1781             :             /* save settings if not done already, then force expanded=on */
    1782          30 :             if (pset.gsavepopt == NULL)
    1783          24 :                 pset.gsavepopt = savePsetInfo(&pset.popt);
    1784          30 :             pset.popt.topt.expanded = 1;
    1785             :         }
    1786         300 :         status = PSQL_CMD_SEND;
    1787             :     }
    1788             : 
    1789         324 :     free(fname);
    1790             : 
    1791         324 :     return status;
    1792             : }
    1793             : 
    1794             : /*
    1795             :  * Process parenthesized pset options for \g
    1796             :  *
    1797             :  * Note: okay to modify first_option, but not to free it; caller does that
    1798             :  */
    1799             : static backslashResult
    1800          24 : process_command_g_options(char *first_option, PsqlScanState scan_state,
    1801             :                           bool active_branch, const char *cmd)
    1802             : {
    1803          24 :     bool        success = true;
    1804          24 :     bool        found_r_paren = false;
    1805             : 
    1806             :     do
    1807             :     {
    1808             :         char       *option;
    1809             :         size_t      optlen;
    1810             : 
    1811             :         /* If not first time through, collect a new option */
    1812          42 :         if (first_option)
    1813          24 :             option = first_option;
    1814             :         else
    1815             :         {
    1816          18 :             option = psql_scan_slash_option(scan_state,
    1817             :                                             OT_NORMAL, NULL, false);
    1818          18 :             if (!option)
    1819             :             {
    1820           0 :                 if (active_branch)
    1821             :                 {
    1822           0 :                     pg_log_error("\\%s: missing right parenthesis", cmd);
    1823           0 :                     success = false;
    1824             :                 }
    1825           0 :                 break;
    1826             :             }
    1827             :         }
    1828             : 
    1829             :         /* Check for terminating right paren, and remove it from string */
    1830          42 :         optlen = strlen(option);
    1831          42 :         if (optlen > 0 && option[optlen - 1] == ')')
    1832             :         {
    1833          24 :             option[--optlen] = '\0';
    1834          24 :             found_r_paren = true;
    1835             :         }
    1836             : 
    1837             :         /* If there was anything besides parentheses, parse/execute it */
    1838          42 :         if (optlen > 0)
    1839             :         {
    1840             :             /* We can have either "name" or "name=value" */
    1841          42 :             char       *valptr = strchr(option, '=');
    1842             : 
    1843          42 :             if (valptr)
    1844          42 :                 *valptr++ = '\0';
    1845          42 :             if (active_branch)
    1846             :             {
    1847             :                 /* save settings if not done already, then apply option */
    1848          42 :                 if (pset.gsavepopt == NULL)
    1849          18 :                     pset.gsavepopt = savePsetInfo(&pset.popt);
    1850          42 :                 success &= do_pset(option, valptr, &pset.popt, true);
    1851             :             }
    1852             :         }
    1853             : 
    1854             :         /* Clean up after this option.  We should not free first_option. */
    1855          42 :         if (first_option)
    1856          24 :             first_option = NULL;
    1857             :         else
    1858          18 :             free(option);
    1859          42 :     } while (!found_r_paren);
    1860             : 
    1861             :     /* If we failed after already changing some options, undo side-effects */
    1862          24 :     if (!success && active_branch && pset.gsavepopt)
    1863             :     {
    1864           0 :         restorePsetInfo(&pset.popt, pset.gsavepopt);
    1865           0 :         pset.gsavepopt = NULL;
    1866             :     }
    1867             : 
    1868          24 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
    1869             : }
    1870             : 
    1871             : /*
    1872             :  * \gdesc -- describe query result
    1873             :  */
    1874             : static backslashResult
    1875          86 : exec_command_gdesc(PsqlScanState scan_state, bool active_branch)
    1876             : {
    1877          86 :     backslashResult status = PSQL_CMD_SKIP_LINE;
    1878             : 
    1879          86 :     if (active_branch)
    1880             :     {
    1881          86 :         pset.gdesc_flag = true;
    1882          86 :         status = PSQL_CMD_SEND;
    1883             :     }
    1884             : 
    1885          86 :     return status;
    1886             : }
    1887             : 
    1888             : /*
    1889             :  * \getenv -- set variable from environment variable
    1890             :  */
    1891             : static backslashResult
    1892         298 : exec_command_getenv(PsqlScanState scan_state, bool active_branch,
    1893             :                     const char *cmd)
    1894             : {
    1895         298 :     bool        success = true;
    1896             : 
    1897         298 :     if (active_branch)
    1898             :     {
    1899         298 :         char       *myvar = psql_scan_slash_option(scan_state,
    1900             :                                                    OT_NORMAL, NULL, false);
    1901         298 :         char       *envvar = psql_scan_slash_option(scan_state,
    1902             :                                                     OT_NORMAL, NULL, false);
    1903             : 
    1904         298 :         if (!myvar || !envvar)
    1905             :         {
    1906           0 :             pg_log_error("\\%s: missing required argument", cmd);
    1907           0 :             success = false;
    1908             :         }
    1909             :         else
    1910             :         {
    1911         298 :             char       *envval = getenv(envvar);
    1912             : 
    1913         298 :             if (envval && !SetVariable(pset.vars, myvar, envval))
    1914           0 :                 success = false;
    1915             :         }
    1916         298 :         free(myvar);
    1917         298 :         free(envvar);
    1918             :     }
    1919             :     else
    1920           0 :         ignore_slash_options(scan_state);
    1921             : 
    1922         298 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
    1923             : }
    1924             : 
    1925             : /*
    1926             :  * \getresults -- read results
    1927             :  */
    1928             : static backslashResult
    1929         156 : exec_command_getresults(PsqlScanState scan_state, bool active_branch)
    1930             : {
    1931         156 :     backslashResult status = PSQL_CMD_SKIP_LINE;
    1932             : 
    1933         156 :     if (active_branch)
    1934             :     {
    1935             :         char       *opt;
    1936             :         int         num_results;
    1937             : 
    1938         150 :         pset.send_mode = PSQL_SEND_GET_RESULTS;
    1939         150 :         status = PSQL_CMD_SEND;
    1940         150 :         opt = psql_scan_slash_option(scan_state, OT_NORMAL, NULL, false);
    1941             : 
    1942         150 :         pset.requested_results = 0;
    1943         150 :         if (opt != NULL)
    1944             :         {
    1945          72 :             num_results = atoi(opt);
    1946          72 :             if (num_results < 0)
    1947             :             {
    1948           6 :                 pg_log_error("\\getresults: invalid number of requested results");
    1949           6 :                 return PSQL_CMD_ERROR;
    1950             :             }
    1951          66 :             pset.requested_results = num_results;
    1952             :         }
    1953             :     }
    1954             :     else
    1955           6 :         ignore_slash_options(scan_state);
    1956             : 
    1957         150 :     return status;
    1958             : }
    1959             : 
    1960             : 
    1961             : /*
    1962             :  * \gexec -- send query and execute each field of result
    1963             :  */
    1964             : static backslashResult
    1965          58 : exec_command_gexec(PsqlScanState scan_state, bool active_branch)
    1966             : {
    1967          58 :     backslashResult status = PSQL_CMD_SKIP_LINE;
    1968             : 
    1969          58 :     if (active_branch)
    1970             :     {
    1971          52 :         if (PQpipelineStatus(pset.db) != PQ_PIPELINE_OFF)
    1972             :         {
    1973           6 :             pg_log_error("\\%s not allowed in pipeline mode", "gexec");
    1974           6 :             clean_extended_state();
    1975           6 :             return PSQL_CMD_ERROR;
    1976             :         }
    1977          46 :         pset.gexec_flag = true;
    1978          46 :         status = PSQL_CMD_SEND;
    1979             :     }
    1980             : 
    1981          52 :     return status;
    1982             : }
    1983             : 
    1984             : /*
    1985             :  * \gset [prefix] -- send query and store result into variables
    1986             :  */
    1987             : static backslashResult
    1988         806 : exec_command_gset(PsqlScanState scan_state, bool active_branch)
    1989             : {
    1990         806 :     backslashResult status = PSQL_CMD_SKIP_LINE;
    1991             : 
    1992         806 :     if (active_branch)
    1993             :     {
    1994         800 :         char       *prefix = psql_scan_slash_option(scan_state,
    1995             :                                                     OT_NORMAL, NULL, false);
    1996             : 
    1997         800 :         if (PQpipelineStatus(pset.db) != PQ_PIPELINE_OFF)
    1998             :         {
    1999          12 :             pg_log_error("\\%s not allowed in pipeline mode", "gset");
    2000          12 :             clean_extended_state();
    2001          12 :             return PSQL_CMD_ERROR;
    2002             :         }
    2003             : 
    2004         788 :         if (prefix)
    2005         108 :             pset.gset_prefix = prefix;
    2006             :         else
    2007             :         {
    2008             :             /* we must set a non-NULL prefix to trigger storing */
    2009         680 :             pset.gset_prefix = pg_strdup("");
    2010             :         }
    2011             :         /* gset_prefix is freed later */
    2012         788 :         status = PSQL_CMD_SEND;
    2013             :     }
    2014             :     else
    2015           6 :         ignore_slash_options(scan_state);
    2016             : 
    2017         794 :     return status;
    2018             : }
    2019             : 
    2020             : /*
    2021             :  * \help [topic] -- print help about SQL commands
    2022             :  */
    2023             : static backslashResult
    2024          10 : exec_command_help(PsqlScanState scan_state, bool active_branch)
    2025             : {
    2026          10 :     if (active_branch)
    2027             :     {
    2028           4 :         char       *opt = psql_scan_slash_option(scan_state,
    2029             :                                                  OT_WHOLE_LINE, NULL, true);
    2030             : 
    2031           4 :         helpSQL(opt, pset.popt.topt.pager);
    2032           4 :         free(opt);
    2033             :     }
    2034             :     else
    2035           6 :         ignore_slash_whole_line(scan_state);
    2036             : 
    2037          10 :     return PSQL_CMD_SKIP_LINE;
    2038             : }
    2039             : 
    2040             : /*
    2041             :  * \H and \html -- toggle HTML formatting
    2042             :  */
    2043             : static backslashResult
    2044           6 : exec_command_html(PsqlScanState scan_state, bool active_branch)
    2045             : {
    2046           6 :     bool        success = true;
    2047             : 
    2048           6 :     if (active_branch)
    2049             :     {
    2050           0 :         if (pset.popt.topt.format != PRINT_HTML)
    2051           0 :             success = do_pset("format", "html", &pset.popt, pset.quiet);
    2052             :         else
    2053           0 :             success = do_pset("format", "aligned", &pset.popt, pset.quiet);
    2054             :     }
    2055             : 
    2056           6 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
    2057             : }
    2058             : 
    2059             : /*
    2060             :  * \i and \ir -- include a file
    2061             :  */
    2062             : static backslashResult
    2063          12 : exec_command_include(PsqlScanState scan_state, bool active_branch, const char *cmd)
    2064             : {
    2065          12 :     bool        success = true;
    2066             : 
    2067          12 :     if (active_branch)
    2068             :     {
    2069           0 :         char       *fname = psql_scan_slash_option(scan_state,
    2070             :                                                    OT_NORMAL, NULL, true);
    2071             : 
    2072           0 :         if (!fname)
    2073             :         {
    2074           0 :             pg_log_error("\\%s: missing required argument", cmd);
    2075           0 :             success = false;
    2076             :         }
    2077             :         else
    2078             :         {
    2079             :             bool        include_relative;
    2080             : 
    2081           0 :             include_relative = (strcmp(cmd, "ir") == 0
    2082           0 :                                 || strcmp(cmd, "include_relative") == 0);
    2083           0 :             expand_tilde(&fname);
    2084           0 :             success = (process_file(fname, include_relative) == EXIT_SUCCESS);
    2085           0 :             free(fname);
    2086             :         }
    2087             :     }
    2088             :     else
    2089          12 :         ignore_slash_options(scan_state);
    2090             : 
    2091          12 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
    2092             : }
    2093             : 
    2094             : /*
    2095             :  * \if <expr> -- beginning of an \if..\endif block
    2096             :  *
    2097             :  * <expr> is parsed as a boolean expression.  Invalid expressions will emit a
    2098             :  * warning and be treated as false.  Statements that follow a false expression
    2099             :  * will be parsed but ignored.  Note that in the case where an \if statement
    2100             :  * is itself within an inactive section of a block, then the entire inner
    2101             :  * \if..\endif block will be parsed but ignored.
    2102             :  */
    2103             : static backslashResult
    2104         200 : exec_command_if(PsqlScanState scan_state, ConditionalStack cstack,
    2105             :                 PQExpBuffer query_buf)
    2106             : {
    2107         200 :     if (conditional_active(cstack))
    2108             :     {
    2109             :         /*
    2110             :          * First, push a new active stack entry; this ensures that the lexer
    2111             :          * will perform variable substitution and backtick evaluation while
    2112             :          * scanning the expression.  (That should happen anyway, since we know
    2113             :          * we're in an active outer branch, but let's be sure.)
    2114             :          */
    2115         194 :         conditional_stack_push(cstack, IFSTATE_TRUE);
    2116             : 
    2117             :         /* Remember current query state in case we need to restore later */
    2118         194 :         save_query_text_state(scan_state, cstack, query_buf);
    2119             : 
    2120             :         /*
    2121             :          * Evaluate the expression; if it's false, change to inactive state.
    2122             :          */
    2123         194 :         if (!is_true_boolean_expression(scan_state, "\\if expression"))
    2124         114 :             conditional_stack_poke(cstack, IFSTATE_FALSE);
    2125             :     }
    2126             :     else
    2127             :     {
    2128             :         /*
    2129             :          * We're within an inactive outer branch, so this entire \if block
    2130             :          * will be ignored.  We don't want to evaluate the expression, so push
    2131             :          * the "ignored" stack state before scanning it.
    2132             :          */
    2133           6 :         conditional_stack_push(cstack, IFSTATE_IGNORED);
    2134             : 
    2135             :         /* Remember current query state in case we need to restore later */
    2136           6 :         save_query_text_state(scan_state, cstack, query_buf);
    2137             : 
    2138           6 :         ignore_boolean_expression(scan_state);
    2139             :     }
    2140             : 
    2141         200 :     return PSQL_CMD_SKIP_LINE;
    2142             : }
    2143             : 
    2144             : /*
    2145             :  * \elif <expr> -- alternative branch in an \if..\endif block
    2146             :  *
    2147             :  * <expr> is evaluated the same as in \if <expr>.
    2148             :  */
    2149             : static backslashResult
    2150          48 : exec_command_elif(PsqlScanState scan_state, ConditionalStack cstack,
    2151             :                   PQExpBuffer query_buf)
    2152             : {
    2153          48 :     bool        success = true;
    2154             : 
    2155          48 :     switch (conditional_stack_peek(cstack))
    2156             :     {
    2157           6 :         case IFSTATE_TRUE:
    2158             : 
    2159             :             /*
    2160             :              * Just finished active branch of this \if block.  Update saved
    2161             :              * state so we will keep whatever data was put in query_buf by the
    2162             :              * active branch.
    2163             :              */
    2164           6 :             save_query_text_state(scan_state, cstack, query_buf);
    2165             : 
    2166             :             /*
    2167             :              * Discard \elif expression and ignore the rest until \endif.
    2168             :              * Switch state before reading expression to ensure proper lexer
    2169             :              * behavior.
    2170             :              */
    2171           6 :             conditional_stack_poke(cstack, IFSTATE_IGNORED);
    2172           6 :             ignore_boolean_expression(scan_state);
    2173           6 :             break;
    2174          24 :         case IFSTATE_FALSE:
    2175             : 
    2176             :             /*
    2177             :              * Discard any query text added by the just-skipped branch.
    2178             :              */
    2179          24 :             discard_query_text(scan_state, cstack, query_buf);
    2180             : 
    2181             :             /*
    2182             :              * Have not yet found a true expression in this \if block, so this
    2183             :              * might be the first.  We have to change state before examining
    2184             :              * the expression, or the lexer won't do the right thing.
    2185             :              */
    2186          24 :             conditional_stack_poke(cstack, IFSTATE_TRUE);
    2187          24 :             if (!is_true_boolean_expression(scan_state, "\\elif expression"))
    2188          18 :                 conditional_stack_poke(cstack, IFSTATE_FALSE);
    2189          24 :             break;
    2190           6 :         case IFSTATE_IGNORED:
    2191             : 
    2192             :             /*
    2193             :              * Discard any query text added by the just-skipped branch.
    2194             :              */
    2195           6 :             discard_query_text(scan_state, cstack, query_buf);
    2196             : 
    2197             :             /*
    2198             :              * Skip expression and move on.  Either the \if block already had
    2199             :              * an active section, or whole block is being skipped.
    2200             :              */
    2201           6 :             ignore_boolean_expression(scan_state);
    2202           6 :             break;
    2203           6 :         case IFSTATE_ELSE_TRUE:
    2204             :         case IFSTATE_ELSE_FALSE:
    2205           6 :             pg_log_error("\\elif: cannot occur after \\else");
    2206           6 :             success = false;
    2207           6 :             break;
    2208           6 :         case IFSTATE_NONE:
    2209             :             /* no \if to elif from */
    2210           6 :             pg_log_error("\\elif: no matching \\if");
    2211           6 :             success = false;
    2212           6 :             break;
    2213             :     }
    2214             : 
    2215          48 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
    2216             : }
    2217             : 
    2218             : /*
    2219             :  * \else -- final alternative in an \if..\endif block
    2220             :  *
    2221             :  * Statements within an \else branch will only be executed if
    2222             :  * all previous \if and \elif expressions evaluated to false
    2223             :  * and the block was not itself being ignored.
    2224             :  */
    2225             : static backslashResult
    2226         132 : exec_command_else(PsqlScanState scan_state, ConditionalStack cstack,
    2227             :                   PQExpBuffer query_buf)
    2228             : {
    2229         132 :     bool        success = true;
    2230             : 
    2231         132 :     switch (conditional_stack_peek(cstack))
    2232             :     {
    2233          60 :         case IFSTATE_TRUE:
    2234             : 
    2235             :             /*
    2236             :              * Just finished active branch of this \if block.  Update saved
    2237             :              * state so we will keep whatever data was put in query_buf by the
    2238             :              * active branch.
    2239             :              */
    2240          60 :             save_query_text_state(scan_state, cstack, query_buf);
    2241             : 
    2242             :             /* Now skip the \else branch */
    2243          60 :             conditional_stack_poke(cstack, IFSTATE_ELSE_FALSE);
    2244          60 :             break;
    2245          48 :         case IFSTATE_FALSE:
    2246             : 
    2247             :             /*
    2248             :              * Discard any query text added by the just-skipped branch.
    2249             :              */
    2250          48 :             discard_query_text(scan_state, cstack, query_buf);
    2251             : 
    2252             :             /*
    2253             :              * We've not found any true \if or \elif expression, so execute
    2254             :              * the \else branch.
    2255             :              */
    2256          48 :             conditional_stack_poke(cstack, IFSTATE_ELSE_TRUE);
    2257          48 :             break;
    2258          12 :         case IFSTATE_IGNORED:
    2259             : 
    2260             :             /*
    2261             :              * Discard any query text added by the just-skipped branch.
    2262             :              */
    2263          12 :             discard_query_text(scan_state, cstack, query_buf);
    2264             : 
    2265             :             /*
    2266             :              * Either we previously processed the active branch of this \if,
    2267             :              * or the whole \if block is being skipped.  Either way, skip the
    2268             :              * \else branch.
    2269             :              */
    2270          12 :             conditional_stack_poke(cstack, IFSTATE_ELSE_FALSE);
    2271          12 :             break;
    2272           6 :         case IFSTATE_ELSE_TRUE:
    2273             :         case IFSTATE_ELSE_FALSE:
    2274           6 :             pg_log_error("\\else: cannot occur after \\else");
    2275           6 :             success = false;
    2276           6 :             break;
    2277           6 :         case IFSTATE_NONE:
    2278             :             /* no \if to else from */
    2279           6 :             pg_log_error("\\else: no matching \\if");
    2280           6 :             success = false;
    2281           6 :             break;
    2282             :     }
    2283             : 
    2284         132 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
    2285             : }
    2286             : 
    2287             : /*
    2288             :  * \endif -- ends an \if...\endif block
    2289             :  */
    2290             : static backslashResult
    2291         186 : exec_command_endif(PsqlScanState scan_state, ConditionalStack cstack,
    2292             :                    PQExpBuffer query_buf)
    2293             : {
    2294         186 :     bool        success = true;
    2295             : 
    2296         186 :     switch (conditional_stack_peek(cstack))
    2297             :     {
    2298          48 :         case IFSTATE_TRUE:
    2299             :         case IFSTATE_ELSE_TRUE:
    2300             :             /* Close the \if block, keeping the query text */
    2301          48 :             success = conditional_stack_pop(cstack);
    2302             :             Assert(success);
    2303          48 :             break;
    2304         132 :         case IFSTATE_FALSE:
    2305             :         case IFSTATE_IGNORED:
    2306             :         case IFSTATE_ELSE_FALSE:
    2307             : 
    2308             :             /*
    2309             :              * Discard any query text added by the just-skipped branch.
    2310             :              */
    2311         132 :             discard_query_text(scan_state, cstack, query_buf);
    2312             : 
    2313             :             /* Close the \if block */
    2314         132 :             success = conditional_stack_pop(cstack);
    2315             :             Assert(success);
    2316         132 :             break;
    2317           6 :         case IFSTATE_NONE:
    2318             :             /* no \if to end */
    2319           6 :             pg_log_error("\\endif: no matching \\if");
    2320           6 :             success = false;
    2321           6 :             break;
    2322             :     }
    2323             : 
    2324         186 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
    2325             : }
    2326             : 
    2327             : /*
    2328             :  * \l -- list databases
    2329             :  */
    2330             : static backslashResult
    2331           6 : exec_command_list(PsqlScanState scan_state, bool active_branch, const char *cmd)
    2332             : {
    2333           6 :     bool        success = true;
    2334             : 
    2335           6 :     if (active_branch)
    2336             :     {
    2337             :         char       *pattern;
    2338             :         bool        show_verbose;
    2339             :         unsigned short int save_expanded;
    2340             : 
    2341           0 :         pattern = psql_scan_slash_option(scan_state,
    2342             :                                          OT_NORMAL, NULL, true);
    2343             : 
    2344           0 :         show_verbose = strchr(cmd, '+') ? true : false;
    2345             : 
    2346             :         /* if 'x' option specified, force expanded mode */
    2347           0 :         save_expanded = pset.popt.topt.expanded;
    2348           0 :         if (strchr(cmd, 'x'))
    2349           0 :             pset.popt.topt.expanded = 1;
    2350             : 
    2351           0 :         success = listAllDbs(pattern, show_verbose);
    2352             : 
    2353             :         /* restore original expanded mode */
    2354           0 :         pset.popt.topt.expanded = save_expanded;
    2355             : 
    2356           0 :         free(pattern);
    2357             :     }
    2358             :     else
    2359           6 :         ignore_slash_options(scan_state);
    2360             : 
    2361           6 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
    2362             : }
    2363             : 
    2364             : /*
    2365             :  * \lo_* -- large object operations
    2366             :  */
    2367             : static backslashResult
    2368          62 : exec_command_lo(PsqlScanState scan_state, bool active_branch, const char *cmd)
    2369             : {
    2370          62 :     backslashResult status = PSQL_CMD_SKIP_LINE;
    2371          62 :     bool        success = true;
    2372             : 
    2373          62 :     if (active_branch)
    2374             :     {
    2375             :         char       *opt1,
    2376             :                    *opt2;
    2377             : 
    2378          56 :         opt1 = psql_scan_slash_option(scan_state,
    2379             :                                       OT_NORMAL, NULL, true);
    2380          56 :         opt2 = psql_scan_slash_option(scan_state,
    2381             :                                       OT_NORMAL, NULL, true);
    2382             : 
    2383          56 :         if (strcmp(cmd + 3, "export") == 0)
    2384             :         {
    2385           6 :             if (!opt2)
    2386             :             {
    2387           0 :                 pg_log_error("\\%s: missing required argument", cmd);
    2388           0 :                 success = false;
    2389             :             }
    2390             :             else
    2391             :             {
    2392           6 :                 expand_tilde(&opt2);
    2393           6 :                 success = do_lo_export(opt1, opt2);
    2394             :             }
    2395             :         }
    2396             : 
    2397          50 :         else if (strcmp(cmd + 3, "import") == 0)
    2398             :         {
    2399          14 :             if (!opt1)
    2400             :             {
    2401           0 :                 pg_log_error("\\%s: missing required argument", cmd);
    2402           0 :                 success = false;
    2403             :             }
    2404             :             else
    2405             :             {
    2406          14 :                 expand_tilde(&opt1);
    2407          14 :                 success = do_lo_import(opt1, opt2);
    2408             :             }
    2409             :         }
    2410             : 
    2411          36 :         else if (strncmp(cmd + 3, "list", 4) == 0)
    2412             :         {
    2413             :             bool        show_verbose;
    2414             :             unsigned short int save_expanded;
    2415             : 
    2416          12 :             show_verbose = strchr(cmd, '+') ? true : false;
    2417             : 
    2418             :             /* if 'x' option specified, force expanded mode */
    2419          12 :             save_expanded = pset.popt.topt.expanded;
    2420          12 :             if (strchr(cmd, 'x'))
    2421           0 :                 pset.popt.topt.expanded = 1;
    2422             : 
    2423          12 :             success = listLargeObjects(show_verbose);
    2424             : 
    2425             :             /* restore original expanded mode */
    2426          12 :             pset.popt.topt.expanded = save_expanded;
    2427             :         }
    2428             : 
    2429          24 :         else if (strcmp(cmd + 3, "unlink") == 0)
    2430             :         {
    2431          24 :             if (!opt1)
    2432             :             {
    2433           0 :                 pg_log_error("\\%s: missing required argument", cmd);
    2434           0 :                 success = false;
    2435             :             }
    2436             :             else
    2437          24 :                 success = do_lo_unlink(opt1);
    2438             :         }
    2439             : 
    2440             :         else
    2441           0 :             status = PSQL_CMD_UNKNOWN;
    2442             : 
    2443          56 :         free(opt1);
    2444          56 :         free(opt2);
    2445             :     }
    2446             :     else
    2447           6 :         ignore_slash_options(scan_state);
    2448             : 
    2449          62 :     if (!success)
    2450           0 :         status = PSQL_CMD_ERROR;
    2451             : 
    2452          62 :     return status;
    2453             : }
    2454             : 
    2455             : /*
    2456             :  * \o -- set query output
    2457             :  */
    2458             : static backslashResult
    2459          42 : exec_command_out(PsqlScanState scan_state, bool active_branch)
    2460             : {
    2461          42 :     bool        success = true;
    2462             : 
    2463          42 :     if (active_branch)
    2464             :     {
    2465          36 :         char       *fname = psql_scan_slash_option(scan_state,
    2466             :                                                    OT_FILEPIPE, NULL, true);
    2467             : 
    2468          36 :         expand_tilde(&fname);
    2469          36 :         success = setQFout(fname);
    2470          36 :         free(fname);
    2471             :     }
    2472             :     else
    2473           6 :         ignore_slash_filepipe(scan_state);
    2474             : 
    2475          42 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
    2476             : }
    2477             : 
    2478             : /*
    2479             :  * \p -- print the current query buffer
    2480             :  */
    2481             : static backslashResult
    2482          42 : exec_command_print(PsqlScanState scan_state, bool active_branch,
    2483             :                    PQExpBuffer query_buf, PQExpBuffer previous_buf)
    2484             : {
    2485          42 :     if (active_branch)
    2486             :     {
    2487             :         /*
    2488             :          * We want to print the same thing \g would execute, but not to change
    2489             :          * the query buffer state; so we can't use copy_previous_query().
    2490             :          * Also, beware of possibility that buffer pointers are NULL.
    2491             :          */
    2492          36 :         if (query_buf && query_buf->len > 0)
    2493          18 :             puts(query_buf->data);
    2494          18 :         else if (previous_buf && previous_buf->len > 0)
    2495          18 :             puts(previous_buf->data);
    2496           0 :         else if (!pset.quiet)
    2497           0 :             puts(_("Query buffer is empty."));
    2498          36 :         fflush(stdout);
    2499             :     }
    2500             : 
    2501          42 :     return PSQL_CMD_SKIP_LINE;
    2502             : }
    2503             : 
    2504             : /*
    2505             :  * \parse -- parse query
    2506             :  */
    2507             : static backslashResult
    2508         114 : exec_command_parse(PsqlScanState scan_state, bool active_branch,
    2509             :                    const char *cmd)
    2510             : {
    2511         114 :     backslashResult status = PSQL_CMD_SKIP_LINE;
    2512             : 
    2513         114 :     if (active_branch)
    2514             :     {
    2515         108 :         char       *opt = psql_scan_slash_option(scan_state,
    2516             :                                                  OT_NORMAL, NULL, false);
    2517             : 
    2518         108 :         clean_extended_state();
    2519             : 
    2520         108 :         if (!opt)
    2521             :         {
    2522           6 :             pg_log_error("\\%s: missing required argument", cmd);
    2523           6 :             status = PSQL_CMD_ERROR;
    2524             :         }
    2525             :         else
    2526             :         {
    2527         102 :             pset.stmtName = opt;
    2528         102 :             pset.send_mode = PSQL_SEND_EXTENDED_PARSE;
    2529         102 :             status = PSQL_CMD_SEND;
    2530             :         }
    2531             :     }
    2532             :     else
    2533           6 :         ignore_slash_options(scan_state);
    2534             : 
    2535         114 :     return status;
    2536             : }
    2537             : 
    2538             : /*
    2539             :  * \password -- set user password
    2540             :  */
    2541             : static backslashResult
    2542           8 : exec_command_password(PsqlScanState scan_state, bool active_branch)
    2543             : {
    2544           8 :     bool        success = true;
    2545             : 
    2546           8 :     if (active_branch)
    2547             :     {
    2548           2 :         char       *user = psql_scan_slash_option(scan_state,
    2549             :                                                   OT_SQLID, NULL, true);
    2550           2 :         char       *pw1 = NULL;
    2551           2 :         char       *pw2 = NULL;
    2552             :         PQExpBufferData buf;
    2553             :         PromptInterruptContext prompt_ctx;
    2554             : 
    2555           2 :         if (user == NULL)
    2556             :         {
    2557             :             /* By default, the command applies to CURRENT_USER */
    2558             :             PGresult   *res;
    2559             : 
    2560           0 :             res = PSQLexec("SELECT CURRENT_USER");
    2561           0 :             if (!res)
    2562           0 :                 return PSQL_CMD_ERROR;
    2563             : 
    2564           0 :             user = pg_strdup(PQgetvalue(res, 0, 0));
    2565           0 :             PQclear(res);
    2566             :         }
    2567             : 
    2568             :         /* Set up to let SIGINT cancel simple_prompt_extended() */
    2569           2 :         prompt_ctx.jmpbuf = sigint_interrupt_jmp;
    2570           2 :         prompt_ctx.enabled = &sigint_interrupt_enabled;
    2571           2 :         prompt_ctx.canceled = false;
    2572             : 
    2573           2 :         initPQExpBuffer(&buf);
    2574           2 :         printfPQExpBuffer(&buf, _("Enter new password for user \"%s\": "), user);
    2575             : 
    2576           2 :         pw1 = simple_prompt_extended(buf.data, false, &prompt_ctx);
    2577           2 :         if (!prompt_ctx.canceled)
    2578           2 :             pw2 = simple_prompt_extended("Enter it again: ", false, &prompt_ctx);
    2579             : 
    2580           2 :         if (prompt_ctx.canceled)
    2581             :         {
    2582             :             /* fail silently */
    2583           0 :             success = false;
    2584             :         }
    2585           2 :         else if (strcmp(pw1, pw2) != 0)
    2586             :         {
    2587           0 :             pg_log_error("Passwords didn't match.");
    2588           0 :             success = false;
    2589             :         }
    2590             :         else
    2591             :         {
    2592           2 :             PGresult   *res = PQchangePassword(pset.db, user, pw1);
    2593             : 
    2594           2 :             if (PQresultStatus(res) != PGRES_COMMAND_OK)
    2595             :             {
    2596           0 :                 pg_log_info("%s", PQerrorMessage(pset.db));
    2597           0 :                 success = false;
    2598             :             }
    2599             : 
    2600           2 :             PQclear(res);
    2601             :         }
    2602             : 
    2603           2 :         free(user);
    2604           2 :         free(pw1);
    2605           2 :         free(pw2);
    2606           2 :         termPQExpBuffer(&buf);
    2607             :     }
    2608             :     else
    2609           6 :         ignore_slash_options(scan_state);
    2610             : 
    2611           8 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
    2612             : }
    2613             : 
    2614             : /*
    2615             :  * \prompt -- prompt and set variable
    2616             :  */
    2617             : static backslashResult
    2618           6 : exec_command_prompt(PsqlScanState scan_state, bool active_branch,
    2619             :                     const char *cmd)
    2620             : {
    2621           6 :     bool        success = true;
    2622             : 
    2623           6 :     if (active_branch)
    2624             :     {
    2625             :         char       *opt,
    2626           0 :                    *prompt_text = NULL;
    2627             :         char       *arg1,
    2628             :                    *arg2;
    2629             : 
    2630           0 :         arg1 = psql_scan_slash_option(scan_state, OT_NORMAL, NULL, false);
    2631           0 :         arg2 = psql_scan_slash_option(scan_state, OT_NORMAL, NULL, false);
    2632             : 
    2633           0 :         if (!arg1)
    2634             :         {
    2635           0 :             pg_log_error("\\%s: missing required argument", cmd);
    2636           0 :             success = false;
    2637             :         }
    2638             :         else
    2639             :         {
    2640             :             char       *result;
    2641             :             PromptInterruptContext prompt_ctx;
    2642             : 
    2643             :             /* Set up to let SIGINT cancel simple_prompt_extended() */
    2644           0 :             prompt_ctx.jmpbuf = sigint_interrupt_jmp;
    2645           0 :             prompt_ctx.enabled = &sigint_interrupt_enabled;
    2646           0 :             prompt_ctx.canceled = false;
    2647             : 
    2648           0 :             if (arg2)
    2649             :             {
    2650           0 :                 prompt_text = arg1;
    2651           0 :                 opt = arg2;
    2652             :             }
    2653             :             else
    2654           0 :                 opt = arg1;
    2655             : 
    2656           0 :             if (!pset.inputfile)
    2657             :             {
    2658           0 :                 result = simple_prompt_extended(prompt_text, true, &prompt_ctx);
    2659             :             }
    2660             :             else
    2661             :             {
    2662           0 :                 if (prompt_text)
    2663             :                 {
    2664           0 :                     fputs(prompt_text, stdout);
    2665           0 :                     fflush(stdout);
    2666             :                 }
    2667           0 :                 result = gets_fromFile(stdin);
    2668           0 :                 if (!result)
    2669             :                 {
    2670           0 :                     pg_log_error("\\%s: could not read value for variable",
    2671             :                                  cmd);
    2672           0 :                     success = false;
    2673             :                 }
    2674             :             }
    2675             : 
    2676           0 :             if (prompt_ctx.canceled ||
    2677           0 :                 (result && !SetVariable(pset.vars, opt, result)))
    2678           0 :                 success = false;
    2679             : 
    2680           0 :             free(result);
    2681           0 :             free(prompt_text);
    2682           0 :             free(opt);
    2683             :         }
    2684             :     }
    2685             :     else
    2686           6 :         ignore_slash_options(scan_state);
    2687             : 
    2688           6 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
    2689             : }
    2690             : 
    2691             : /*
    2692             :  * \pset -- set printing parameters
    2693             :  */
    2694             : static backslashResult
    2695        1798 : exec_command_pset(PsqlScanState scan_state, bool active_branch)
    2696             : {
    2697        1798 :     bool        success = true;
    2698             : 
    2699        1798 :     if (active_branch)
    2700             :     {
    2701        1786 :         char       *opt0 = psql_scan_slash_option(scan_state,
    2702             :                                                   OT_NORMAL, NULL, false);
    2703        1786 :         char       *opt1 = psql_scan_slash_option(scan_state,
    2704             :                                                   OT_NORMAL, NULL, false);
    2705             : 
    2706        1786 :         if (!opt0)
    2707             :         {
    2708             :             /* list all variables */
    2709             : 
    2710             :             int         i;
    2711             :             static const char *const my_list[] = {
    2712             :                 "border", "columns", "csv_fieldsep",
    2713             :                 "display_false", "display_true", "expanded", "fieldsep",
    2714             :                 "fieldsep_zero", "footer", "format", "linestyle", "null",
    2715             :                 "numericlocale", "pager", "pager_min_lines",
    2716             :                 "recordsep", "recordsep_zero",
    2717             :                 "tableattr", "title", "tuples_only",
    2718             :                 "unicode_border_linestyle",
    2719             :                 "unicode_column_linestyle",
    2720             :                 "unicode_header_linestyle",
    2721             :                 "xheader_width",
    2722             :                 NULL
    2723             :             };
    2724             : 
    2725         150 :             for (i = 0; my_list[i] != NULL; i++)
    2726             :             {
    2727         144 :                 char       *val = pset_value_string(my_list[i], &pset.popt);
    2728             : 
    2729         144 :                 printf("%-24s %s\n", my_list[i], val);
    2730         144 :                 free(val);
    2731             :             }
    2732             : 
    2733           6 :             success = true;
    2734             :         }
    2735             :         else
    2736        1780 :             success = do_pset(opt0, opt1, &pset.popt, pset.quiet);
    2737             : 
    2738        1786 :         free(opt0);
    2739        1786 :         free(opt1);
    2740             :     }
    2741             :     else
    2742          12 :         ignore_slash_options(scan_state);
    2743             : 
    2744        1798 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
    2745             : }
    2746             : 
    2747             : /*
    2748             :  * \q or \quit -- exit psql
    2749             :  */
    2750             : static backslashResult
    2751         264 : exec_command_quit(PsqlScanState scan_state, bool active_branch)
    2752             : {
    2753         264 :     backslashResult status = PSQL_CMD_SKIP_LINE;
    2754             : 
    2755         264 :     if (active_branch)
    2756         198 :         status = PSQL_CMD_TERMINATE;
    2757             : 
    2758         264 :     return status;
    2759             : }
    2760             : 
    2761             : /*
    2762             :  * \r -- reset (clear) the query buffer
    2763             :  */
    2764             : static backslashResult
    2765          96 : exec_command_reset(PsqlScanState scan_state, bool active_branch,
    2766             :                    PQExpBuffer query_buf)
    2767             : {
    2768          96 :     if (active_branch)
    2769             :     {
    2770          90 :         resetPQExpBuffer(query_buf);
    2771          90 :         psql_scan_reset(scan_state);
    2772          90 :         if (!pset.quiet)
    2773          60 :             puts(_("Query buffer reset (cleared)."));
    2774             :     }
    2775             : 
    2776          96 :     return PSQL_CMD_SKIP_LINE;
    2777             : }
    2778             : 
    2779             : /*
    2780             :  * \restrict -- enter "restricted mode" with the provided key
    2781             :  */
    2782             : static backslashResult
    2783          68 : exec_command_restrict(PsqlScanState scan_state, bool active_branch,
    2784             :                       const char *cmd)
    2785             : {
    2786          68 :     if (active_branch)
    2787             :     {
    2788             :         char       *opt;
    2789             : 
    2790             :         Assert(!restricted);
    2791             : 
    2792          62 :         opt = psql_scan_slash_option(scan_state, OT_NORMAL, NULL, true);
    2793          62 :         if (opt == NULL || opt[0] == '\0')
    2794             :         {
    2795           0 :             pg_log_error("\\%s: missing required argument", cmd);
    2796           0 :             return PSQL_CMD_ERROR;
    2797             :         }
    2798             : 
    2799          62 :         restrict_key = pstrdup(opt);
    2800          62 :         restricted = true;
    2801             :     }
    2802             :     else
    2803           6 :         ignore_slash_options(scan_state);
    2804             : 
    2805          68 :     return PSQL_CMD_SKIP_LINE;
    2806             : }
    2807             : 
    2808             : /*
    2809             :  * \s -- save history in a file or show it on the screen
    2810             :  */
    2811             : static backslashResult
    2812           6 : exec_command_s(PsqlScanState scan_state, bool active_branch)
    2813             : {
    2814           6 :     bool        success = true;
    2815             : 
    2816           6 :     if (active_branch)
    2817             :     {
    2818           0 :         char       *fname = psql_scan_slash_option(scan_state,
    2819             :                                                    OT_NORMAL, NULL, true);
    2820             : 
    2821           0 :         expand_tilde(&fname);
    2822           0 :         success = printHistory(fname, pset.popt.topt.pager);
    2823           0 :         if (success && !pset.quiet && fname)
    2824           0 :             printf(_("Wrote history to file \"%s\".\n"), fname);
    2825           0 :         if (!fname)
    2826           0 :             putchar('\n');
    2827           0 :         free(fname);
    2828             :     }
    2829             :     else
    2830           6 :         ignore_slash_options(scan_state);
    2831             : 
    2832           6 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
    2833             : }
    2834             : 
    2835             : /*
    2836             :  * \sendpipeline -- send an extended query to an ongoing pipeline
    2837             :  */
    2838             : static backslashResult
    2839         590 : exec_command_sendpipeline(PsqlScanState scan_state, bool active_branch)
    2840             : {
    2841         590 :     backslashResult status = PSQL_CMD_SKIP_LINE;
    2842             : 
    2843         590 :     if (active_branch)
    2844             :     {
    2845         584 :         if (PQpipelineStatus(pset.db) != PQ_PIPELINE_OFF)
    2846             :         {
    2847         572 :             if (pset.send_mode == PSQL_SEND_EXTENDED_QUERY_PREPARED ||
    2848         524 :                 pset.send_mode == PSQL_SEND_EXTENDED_QUERY_PARAMS)
    2849             :             {
    2850         560 :                 status = PSQL_CMD_SEND;
    2851             :             }
    2852             :             else
    2853             :             {
    2854          12 :                 pg_log_error("\\sendpipeline must be used after \\bind or \\bind_named");
    2855          12 :                 clean_extended_state();
    2856          12 :                 return PSQL_CMD_ERROR;
    2857             :             }
    2858             :         }
    2859             :         else
    2860             :         {
    2861          12 :             pg_log_error("\\sendpipeline not allowed outside of pipeline mode");
    2862          12 :             clean_extended_state();
    2863          12 :             return PSQL_CMD_ERROR;
    2864             :         }
    2865             :     }
    2866             :     else
    2867           6 :         ignore_slash_options(scan_state);
    2868             : 
    2869         566 :     return status;
    2870             : }
    2871             : 
    2872             : /*
    2873             :  * \set -- set variable
    2874             :  */
    2875             : static backslashResult
    2876         984 : exec_command_set(PsqlScanState scan_state, bool active_branch)
    2877             : {
    2878         984 :     bool        success = true;
    2879             : 
    2880         984 :     if (active_branch)
    2881             :     {
    2882         978 :         char       *opt0 = psql_scan_slash_option(scan_state,
    2883             :                                                   OT_NORMAL, NULL, false);
    2884             : 
    2885         978 :         if (!opt0)
    2886             :         {
    2887             :             /* list all variables */
    2888           0 :             PrintVariables(pset.vars);
    2889           0 :             success = true;
    2890             :         }
    2891             :         else
    2892             :         {
    2893             :             /*
    2894             :              * Set variable to the concatenation of the arguments.
    2895             :              */
    2896             :             char       *newval;
    2897             :             char       *opt;
    2898             : 
    2899         978 :             opt = psql_scan_slash_option(scan_state,
    2900             :                                          OT_NORMAL, NULL, false);
    2901         978 :             newval = pg_strdup(opt ? opt : "");
    2902         978 :             free(opt);
    2903             : 
    2904        1446 :             while ((opt = psql_scan_slash_option(scan_state,
    2905             :                                                  OT_NORMAL, NULL, false)))
    2906             :             {
    2907         468 :                 newval = pg_realloc(newval, strlen(newval) + strlen(opt) + 1);
    2908         468 :                 strcat(newval, opt);
    2909         468 :                 free(opt);
    2910             :             }
    2911             : 
    2912         978 :             if (!SetVariable(pset.vars, opt0, newval))
    2913          26 :                 success = false;
    2914             : 
    2915         978 :             free(newval);
    2916             :         }
    2917         978 :         free(opt0);
    2918             :     }
    2919             :     else
    2920           6 :         ignore_slash_options(scan_state);
    2921             : 
    2922         984 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
    2923             : }
    2924             : 
    2925             : /*
    2926             :  * \setenv -- set environment variable
    2927             :  */
    2928             : static backslashResult
    2929          18 : exec_command_setenv(PsqlScanState scan_state, bool active_branch,
    2930             :                     const char *cmd)
    2931             : {
    2932          18 :     bool        success = true;
    2933             : 
    2934          18 :     if (active_branch)
    2935             :     {
    2936          12 :         char       *envvar = psql_scan_slash_option(scan_state,
    2937             :                                                     OT_NORMAL, NULL, false);
    2938          12 :         char       *envval = psql_scan_slash_option(scan_state,
    2939             :                                                     OT_NORMAL, NULL, false);
    2940             : 
    2941          12 :         if (!envvar)
    2942             :         {
    2943           0 :             pg_log_error("\\%s: missing required argument", cmd);
    2944           0 :             success = false;
    2945             :         }
    2946          12 :         else if (strchr(envvar, '=') != NULL)
    2947             :         {
    2948           0 :             pg_log_error("\\%s: environment variable name must not contain \"=\"",
    2949             :                          cmd);
    2950           0 :             success = false;
    2951             :         }
    2952          12 :         else if (!envval)
    2953             :         {
    2954             :             /* No argument - unset the environment variable */
    2955           6 :             unsetenv(envvar);
    2956           6 :             success = true;
    2957             :         }
    2958             :         else
    2959             :         {
    2960             :             /* Set variable to the value of the next argument */
    2961           6 :             setenv(envvar, envval, 1);
    2962           6 :             success = true;
    2963             :         }
    2964          12 :         free(envvar);
    2965          12 :         free(envval);
    2966             :     }
    2967             :     else
    2968           6 :         ignore_slash_options(scan_state);
    2969             : 
    2970          18 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
    2971             : }
    2972             : 
    2973             : /*
    2974             :  * \sf/\sv -- show a function/view's source code
    2975             :  */
    2976             : static backslashResult
    2977         198 : exec_command_sf_sv(PsqlScanState scan_state, bool active_branch,
    2978             :                    const char *cmd, bool is_func)
    2979             : {
    2980         198 :     backslashResult status = PSQL_CMD_SKIP_LINE;
    2981             : 
    2982         198 :     if (active_branch)
    2983             :     {
    2984         186 :         bool        show_linenumbers = (strchr(cmd, '+') != NULL);
    2985             :         PQExpBuffer buf;
    2986             :         char       *obj_desc;
    2987         186 :         Oid         obj_oid = InvalidOid;
    2988         186 :         EditableObjectType eot = is_func ? EditableFunction : EditableView;
    2989             : 
    2990         186 :         buf = createPQExpBuffer();
    2991         186 :         obj_desc = psql_scan_slash_option(scan_state,
    2992             :                                           OT_WHOLE_LINE, NULL, true);
    2993         186 :         if (!obj_desc)
    2994             :         {
    2995           0 :             if (is_func)
    2996           0 :                 pg_log_error("function name is required");
    2997             :             else
    2998           0 :                 pg_log_error("view name is required");
    2999           0 :             status = PSQL_CMD_ERROR;
    3000             :         }
    3001         186 :         else if (!lookup_object_oid(eot, obj_desc, &obj_oid))
    3002             :         {
    3003             :             /* error already reported */
    3004           0 :             status = PSQL_CMD_ERROR;
    3005             :         }
    3006         186 :         else if (!get_create_object_cmd(eot, obj_oid, buf))
    3007             :         {
    3008             :             /* error already reported */
    3009           0 :             status = PSQL_CMD_ERROR;
    3010             :         }
    3011             :         else
    3012             :         {
    3013             :             FILE       *output;
    3014             :             bool        is_pager;
    3015             : 
    3016             :             /* Select output stream: stdout, pager, or file */
    3017         186 :             if (pset.queryFout == stdout)
    3018             :             {
    3019             :                 /* count lines in function to see if pager is needed */
    3020         186 :                 int         lineno = count_lines_in_buf(buf);
    3021             : 
    3022         186 :                 output = PageOutput(lineno, &(pset.popt.topt));
    3023         186 :                 is_pager = true;
    3024             :             }
    3025             :             else
    3026             :             {
    3027             :                 /* use previously set output file, without pager */
    3028           0 :                 output = pset.queryFout;
    3029           0 :                 is_pager = false;
    3030             :             }
    3031             : 
    3032         186 :             if (show_linenumbers)
    3033             :             {
    3034             :                 /* add line numbers */
    3035          18 :                 print_with_linenumbers(output, buf->data, is_func);
    3036             :             }
    3037             :             else
    3038             :             {
    3039             :                 /* just send the definition to output */
    3040         168 :                 fputs(buf->data, output);
    3041             :             }
    3042             : 
    3043         186 :             if (is_pager)
    3044         186 :                 ClosePager(output);
    3045             :         }
    3046             : 
    3047         186 :         free(obj_desc);
    3048         186 :         destroyPQExpBuffer(buf);
    3049             :     }
    3050             :     else
    3051          12 :         ignore_slash_whole_line(scan_state);
    3052             : 
    3053         198 :     return status;
    3054             : }
    3055             : 
    3056             : /*
    3057             :  * \startpipeline -- enter pipeline mode
    3058             :  */
    3059             : static backslashResult
    3060         298 : exec_command_startpipeline(PsqlScanState scan_state, bool active_branch)
    3061             : {
    3062         298 :     backslashResult status = PSQL_CMD_SKIP_LINE;
    3063             : 
    3064         298 :     if (active_branch)
    3065             :     {
    3066         292 :         pset.send_mode = PSQL_SEND_START_PIPELINE_MODE;
    3067         292 :         status = PSQL_CMD_SEND;
    3068             :     }
    3069             :     else
    3070           6 :         ignore_slash_options(scan_state);
    3071             : 
    3072         298 :     return status;
    3073             : }
    3074             : 
    3075             : /*
    3076             :  * \syncpipeline -- send a sync message to an active pipeline
    3077             :  */
    3078             : static backslashResult
    3079         114 : exec_command_syncpipeline(PsqlScanState scan_state, bool active_branch)
    3080             : {
    3081         114 :     backslashResult status = PSQL_CMD_SKIP_LINE;
    3082             : 
    3083         114 :     if (active_branch)
    3084             :     {
    3085         108 :         pset.send_mode = PSQL_SEND_PIPELINE_SYNC;
    3086         108 :         status = PSQL_CMD_SEND;
    3087             :     }
    3088             :     else
    3089           6 :         ignore_slash_options(scan_state);
    3090             : 
    3091         114 :     return status;
    3092             : }
    3093             : 
    3094             : /*
    3095             :  * \endpipeline -- end pipeline mode
    3096             :  */
    3097             : static backslashResult
    3098         298 : exec_command_endpipeline(PsqlScanState scan_state, bool active_branch)
    3099             : {
    3100         298 :     backslashResult status = PSQL_CMD_SKIP_LINE;
    3101             : 
    3102         298 :     if (active_branch)
    3103             :     {
    3104         292 :         pset.send_mode = PSQL_SEND_END_PIPELINE_MODE;
    3105         292 :         status = PSQL_CMD_SEND;
    3106             :     }
    3107             :     else
    3108           6 :         ignore_slash_options(scan_state);
    3109             : 
    3110         298 :     return status;
    3111             : }
    3112             : 
    3113             : /*
    3114             :  * \t -- turn off table headers and row count
    3115             :  */
    3116             : static backslashResult
    3117          70 : exec_command_t(PsqlScanState scan_state, bool active_branch)
    3118             : {
    3119          70 :     bool        success = true;
    3120             : 
    3121          70 :     if (active_branch)
    3122             :     {
    3123          64 :         char       *opt = psql_scan_slash_option(scan_state,
    3124             :                                                  OT_NORMAL, NULL, true);
    3125             : 
    3126          64 :         success = do_pset("tuples_only", opt, &pset.popt, pset.quiet);
    3127          64 :         free(opt);
    3128             :     }
    3129             :     else
    3130           6 :         ignore_slash_options(scan_state);
    3131             : 
    3132          70 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
    3133             : }
    3134             : 
    3135             : /*
    3136             :  * \T -- define html <table ...> attributes
    3137             :  */
    3138             : static backslashResult
    3139           6 : exec_command_T(PsqlScanState scan_state, bool active_branch)
    3140             : {
    3141           6 :     bool        success = true;
    3142             : 
    3143           6 :     if (active_branch)
    3144             :     {
    3145           0 :         char       *value = psql_scan_slash_option(scan_state,
    3146             :                                                    OT_NORMAL, NULL, false);
    3147             : 
    3148           0 :         success = do_pset("tableattr", value, &pset.popt, pset.quiet);
    3149           0 :         free(value);
    3150             :     }
    3151             :     else
    3152           6 :         ignore_slash_options(scan_state);
    3153             : 
    3154           6 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
    3155             : }
    3156             : 
    3157             : /*
    3158             :  * \timing -- enable/disable timing of queries
    3159             :  */
    3160             : static backslashResult
    3161          10 : exec_command_timing(PsqlScanState scan_state, bool active_branch)
    3162             : {
    3163          10 :     bool        success = true;
    3164             : 
    3165          10 :     if (active_branch)
    3166             :     {
    3167           4 :         char       *opt = psql_scan_slash_option(scan_state,
    3168             :                                                  OT_NORMAL, NULL, false);
    3169             : 
    3170           4 :         if (opt)
    3171           4 :             success = ParseVariableBool(opt, "\\timing", &pset.timing);
    3172             :         else
    3173           0 :             pset.timing = !pset.timing;
    3174           4 :         if (!pset.quiet)
    3175             :         {
    3176           0 :             if (pset.timing)
    3177           0 :                 puts(_("Timing is on."));
    3178             :             else
    3179           0 :                 puts(_("Timing is off."));
    3180             :         }
    3181           4 :         free(opt);
    3182             :     }
    3183             :     else
    3184           6 :         ignore_slash_options(scan_state);
    3185             : 
    3186          10 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
    3187             : }
    3188             : 
    3189             : /*
    3190             :  * \unrestrict -- exit "restricted mode" if provided key matches
    3191             :  */
    3192             : static backslashResult
    3193          66 : exec_command_unrestrict(PsqlScanState scan_state, bool active_branch,
    3194             :                         const char *cmd)
    3195             : {
    3196          66 :     if (active_branch)
    3197             :     {
    3198             :         char       *opt;
    3199             : 
    3200          60 :         opt = psql_scan_slash_option(scan_state, OT_NORMAL, NULL, true);
    3201          60 :         if (opt == NULL || opt[0] == '\0')
    3202             :         {
    3203           0 :             pg_log_error("\\%s: missing required argument", cmd);
    3204           0 :             return PSQL_CMD_ERROR;
    3205             :         }
    3206             : 
    3207          60 :         if (!restricted)
    3208             :         {
    3209           0 :             pg_log_error("\\%s: not currently in restricted mode", cmd);
    3210           0 :             return PSQL_CMD_ERROR;
    3211             :         }
    3212          60 :         else if (strcmp(opt, restrict_key) == 0)
    3213             :         {
    3214          60 :             pfree(restrict_key);
    3215          60 :             restricted = false;
    3216             :         }
    3217             :         else
    3218             :         {
    3219           0 :             pg_log_error("\\%s: wrong key", cmd);
    3220           0 :             return PSQL_CMD_ERROR;
    3221             :         }
    3222             :     }
    3223             :     else
    3224           6 :         ignore_slash_options(scan_state);
    3225             : 
    3226          66 :     return PSQL_CMD_SKIP_LINE;
    3227             : }
    3228             : 
    3229             : /*
    3230             :  * \unset -- unset variable
    3231             :  */
    3232             : static backslashResult
    3233          52 : exec_command_unset(PsqlScanState scan_state, bool active_branch,
    3234             :                    const char *cmd)
    3235             : {
    3236          52 :     bool        success = true;
    3237             : 
    3238          52 :     if (active_branch)
    3239             :     {
    3240          46 :         char       *opt = psql_scan_slash_option(scan_state,
    3241             :                                                  OT_NORMAL, NULL, false);
    3242             : 
    3243          46 :         if (!opt)
    3244             :         {
    3245           0 :             pg_log_error("\\%s: missing required argument", cmd);
    3246           0 :             success = false;
    3247             :         }
    3248          46 :         else if (!SetVariable(pset.vars, opt, NULL))
    3249           0 :             success = false;
    3250             : 
    3251          46 :         free(opt);
    3252             :     }
    3253             :     else
    3254           6 :         ignore_slash_options(scan_state);
    3255             : 
    3256          52 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
    3257             : }
    3258             : 
    3259             : /*
    3260             :  * \w -- write query buffer to file
    3261             :  */
    3262             : static backslashResult
    3263          12 : exec_command_write(PsqlScanState scan_state, bool active_branch,
    3264             :                    const char *cmd,
    3265             :                    PQExpBuffer query_buf, PQExpBuffer previous_buf)
    3266             : {
    3267          12 :     backslashResult status = PSQL_CMD_SKIP_LINE;
    3268             : 
    3269          12 :     if (active_branch)
    3270             :     {
    3271           0 :         char       *fname = psql_scan_slash_option(scan_state,
    3272             :                                                    OT_FILEPIPE, NULL, true);
    3273           0 :         FILE       *fd = NULL;
    3274           0 :         bool        is_pipe = false;
    3275             : 
    3276           0 :         if (!query_buf)
    3277             :         {
    3278           0 :             pg_log_error("no query buffer");
    3279           0 :             status = PSQL_CMD_ERROR;
    3280             :         }
    3281             :         else
    3282             :         {
    3283           0 :             if (!fname)
    3284             :             {
    3285           0 :                 pg_log_error("\\%s: missing required argument", cmd);
    3286           0 :                 status = PSQL_CMD_ERROR;
    3287             :             }
    3288             :             else
    3289             :             {
    3290           0 :                 expand_tilde(&fname);
    3291           0 :                 if (fname[0] == '|')
    3292             :                 {
    3293           0 :                     is_pipe = true;
    3294           0 :                     fflush(NULL);
    3295           0 :                     disable_sigpipe_trap();
    3296           0 :                     fd = popen(&fname[1], "w");
    3297             :                 }
    3298             :                 else
    3299             :                 {
    3300           0 :                     canonicalize_path_enc(fname, pset.encoding);
    3301           0 :                     fd = fopen(fname, "w");
    3302             :                 }
    3303           0 :                 if (!fd)
    3304             :                 {
    3305           0 :                     pg_log_error("%s: %m", fname);
    3306           0 :                     status = PSQL_CMD_ERROR;
    3307             :                 }
    3308             :             }
    3309             :         }
    3310             : 
    3311           0 :         if (fd)
    3312             :         {
    3313             :             int         result;
    3314             : 
    3315             :             /*
    3316             :              * We want to print the same thing \g would execute, but not to
    3317             :              * change the query buffer state; so we can't use
    3318             :              * copy_previous_query().  Also, beware of possibility that buffer
    3319             :              * pointers are NULL.
    3320             :              */
    3321           0 :             if (query_buf && query_buf->len > 0)
    3322           0 :                 fprintf(fd, "%s\n", query_buf->data);
    3323           0 :             else if (previous_buf && previous_buf->len > 0)
    3324           0 :                 fprintf(fd, "%s\n", previous_buf->data);
    3325             : 
    3326           0 :             if (is_pipe)
    3327             :             {
    3328           0 :                 result = pclose(fd);
    3329             : 
    3330           0 :                 if (result != 0)
    3331             :                 {
    3332           0 :                     pg_log_error("%s: %s", fname, wait_result_to_str(result));
    3333           0 :                     status = PSQL_CMD_ERROR;
    3334             :                 }
    3335           0 :                 SetShellResultVariables(result);
    3336             :             }
    3337             :             else
    3338             :             {
    3339           0 :                 result = fclose(fd);
    3340             : 
    3341           0 :                 if (result == EOF)
    3342             :                 {
    3343           0 :                     pg_log_error("%s: %m", fname);
    3344           0 :                     status = PSQL_CMD_ERROR;
    3345             :                 }
    3346             :             }
    3347             :         }
    3348             : 
    3349           0 :         if (is_pipe)
    3350           0 :             restore_sigpipe_trap();
    3351             : 
    3352           0 :         free(fname);
    3353             :     }
    3354             :     else
    3355          12 :         ignore_slash_filepipe(scan_state);
    3356             : 
    3357          12 :     return status;
    3358             : }
    3359             : 
    3360             : /*
    3361             :  * \watch -- execute a query every N seconds.
    3362             :  * Optionally, stop after M iterations.
    3363             :  */
    3364             : static backslashResult
    3365          40 : exec_command_watch(PsqlScanState scan_state, bool active_branch,
    3366             :                    PQExpBuffer query_buf, PQExpBuffer previous_buf)
    3367             : {
    3368          40 :     bool        success = true;
    3369             : 
    3370          40 :     if (active_branch)
    3371             :     {
    3372          34 :         bool        have_sleep = false;
    3373          34 :         bool        have_iter = false;
    3374          34 :         bool        have_min_rows = false;
    3375          34 :         double      sleep = pset.watch_interval;
    3376          34 :         int         iter = 0;
    3377          34 :         int         min_rows = 0;
    3378             : 
    3379          34 :         if (PQpipelineStatus(pset.db) != PQ_PIPELINE_OFF)
    3380             :         {
    3381           6 :             pg_log_error("\\%s not allowed in pipeline mode", "watch");
    3382           6 :             clean_extended_state();
    3383           6 :             success = false;
    3384             :         }
    3385             : 
    3386             :         /*
    3387             :          * Parse arguments.  We allow either an unlabeled interval or
    3388             :          * "name=value", where name is from the set ('i', 'interval', 'c',
    3389             :          * 'count', 'm', 'min_rows').  The parsing of interval value should be
    3390             :          * kept in sync with ParseVariableDouble which is used for setting the
    3391             :          * default interval value.
    3392             :          */
    3393          74 :         while (success)
    3394             :         {
    3395          54 :             char       *opt = psql_scan_slash_option(scan_state,
    3396             :                                                      OT_NORMAL, NULL, true);
    3397             :             char       *valptr;
    3398             :             char       *opt_end;
    3399             : 
    3400          54 :             if (!opt)
    3401          14 :                 break;          /* no more arguments */
    3402             : 
    3403          40 :             valptr = strchr(opt, '=');
    3404          40 :             if (valptr)
    3405             :             {
    3406             :                 /* Labeled argument */
    3407          24 :                 valptr++;
    3408          24 :                 if (strncmp("i=", opt, strlen("i=")) == 0 ||
    3409          18 :                     strncmp("interval=", opt, strlen("interval=")) == 0)
    3410             :                 {
    3411           6 :                     if (have_sleep)
    3412             :                     {
    3413           0 :                         pg_log_error("\\watch: interval value is specified more than once");
    3414           0 :                         success = false;
    3415             :                     }
    3416             :                     else
    3417             :                     {
    3418           6 :                         have_sleep = true;
    3419           6 :                         errno = 0;
    3420           6 :                         sleep = strtod(valptr, &opt_end);
    3421           6 :                         if (sleep < 0 || *opt_end || errno == ERANGE)
    3422             :                         {
    3423           0 :                             pg_log_error("\\watch: incorrect interval value \"%s\"", valptr);
    3424           0 :                             success = false;
    3425             :                         }
    3426             :                     }
    3427             :                 }
    3428          18 :                 else if (strncmp("c=", opt, strlen("c=")) == 0 ||
    3429           8 :                          strncmp("count=", opt, strlen("count=")) == 0)
    3430             :                 {
    3431          10 :                     if (have_iter)
    3432             :                     {
    3433           2 :                         pg_log_error("\\watch: iteration count is specified more than once");
    3434           2 :                         success = false;
    3435             :                     }
    3436             :                     else
    3437             :                     {
    3438           8 :                         have_iter = true;
    3439           8 :                         errno = 0;
    3440           8 :                         iter = strtoint(valptr, &opt_end, 10);
    3441           8 :                         if (iter <= 0 || *opt_end || errno == ERANGE)
    3442             :                         {
    3443           0 :                             pg_log_error("\\watch: incorrect iteration count \"%s\"", valptr);
    3444           0 :                             success = false;
    3445             :                         }
    3446             :                     }
    3447             :                 }
    3448           8 :                 else if (strncmp("m=", opt, strlen("m=")) == 0 ||
    3449           2 :                          strncmp("min_rows=", opt, strlen("min_rows=")) == 0)
    3450             :                 {
    3451           8 :                     if (have_min_rows)
    3452             :                     {
    3453           2 :                         pg_log_error("\\watch: minimum row count specified more than once");
    3454           2 :                         success = false;
    3455             :                     }
    3456             :                     else
    3457             :                     {
    3458           6 :                         have_min_rows = true;
    3459           6 :                         errno = 0;
    3460           6 :                         min_rows = strtoint(valptr, &opt_end, 10);
    3461           6 :                         if (min_rows <= 0 || *opt_end || errno == ERANGE)
    3462             :                         {
    3463           2 :                             pg_log_error("\\watch: incorrect minimum row count \"%s\"", valptr);
    3464           2 :                             success = false;
    3465             :                         }
    3466             :                     }
    3467             :                 }
    3468             :                 else
    3469             :                 {
    3470           0 :                     pg_log_error("\\watch: unrecognized parameter \"%s\"", opt);
    3471           0 :                     success = false;
    3472             :                 }
    3473             :             }
    3474             :             else
    3475             :             {
    3476             :                 /* Unlabeled argument: take it as interval */
    3477          16 :                 if (have_sleep)
    3478             :                 {
    3479           2 :                     pg_log_error("\\watch: interval value is specified more than once");
    3480           2 :                     success = false;
    3481             :                 }
    3482             :                 else
    3483             :                 {
    3484          14 :                     have_sleep = true;
    3485          14 :                     errno = 0;
    3486          14 :                     sleep = strtod(opt, &opt_end);
    3487          14 :                     if (sleep < 0 || *opt_end || errno == ERANGE)
    3488             :                     {
    3489           6 :                         pg_log_error("\\watch: incorrect interval value \"%s\"", opt);
    3490           6 :                         success = false;
    3491             :                     }
    3492             :                 }
    3493             :             }
    3494             : 
    3495          40 :             free(opt);
    3496             :         }
    3497             : 
    3498             :         /* If we parsed arguments successfully, do the command */
    3499          34 :         if (success)
    3500             :         {
    3501             :             /* If query_buf is empty, recall and execute previous query */
    3502          14 :             (void) copy_previous_query(query_buf, previous_buf);
    3503             : 
    3504          14 :             success = do_watch(query_buf, sleep, iter, min_rows);
    3505             :         }
    3506             : 
    3507             :         /* Reset the query buffer as though for \r */
    3508          30 :         resetPQExpBuffer(query_buf);
    3509          30 :         psql_scan_reset(scan_state);
    3510             :     }
    3511             :     else
    3512           6 :         ignore_slash_options(scan_state);
    3513             : 
    3514          36 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
    3515             : }
    3516             : 
    3517             : /*
    3518             :  * \x -- set or toggle expanded table representation
    3519             :  */
    3520             : static backslashResult
    3521          76 : exec_command_x(PsqlScanState scan_state, bool active_branch)
    3522             : {
    3523          76 :     bool        success = true;
    3524             : 
    3525          76 :     if (active_branch)
    3526             :     {
    3527          70 :         char       *opt = psql_scan_slash_option(scan_state,
    3528             :                                                  OT_NORMAL, NULL, true);
    3529             : 
    3530          70 :         success = do_pset("expanded", opt, &pset.popt, pset.quiet);
    3531          70 :         free(opt);
    3532             :     }
    3533             :     else
    3534           6 :         ignore_slash_options(scan_state);
    3535             : 
    3536          76 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
    3537             : }
    3538             : 
    3539             : /*
    3540             :  * \z -- list table privileges (equivalent to \dp)
    3541             :  */
    3542             : static backslashResult
    3543          30 : exec_command_z(PsqlScanState scan_state, bool active_branch, const char *cmd)
    3544             : {
    3545          30 :     bool        success = true;
    3546             : 
    3547          30 :     if (active_branch)
    3548             :     {
    3549             :         char       *pattern;
    3550             :         bool        show_system;
    3551             :         unsigned short int save_expanded;
    3552             : 
    3553          24 :         pattern = psql_scan_slash_option(scan_state,
    3554             :                                          OT_NORMAL, NULL, true);
    3555             : 
    3556          24 :         show_system = strchr(cmd, 'S') ? true : false;
    3557             : 
    3558             :         /* if 'x' option specified, force expanded mode */
    3559          24 :         save_expanded = pset.popt.topt.expanded;
    3560          24 :         if (strchr(cmd, 'x'))
    3561           6 :             pset.popt.topt.expanded = 1;
    3562             : 
    3563          24 :         success = permissionsList(pattern, show_system);
    3564             : 
    3565             :         /* restore original expanded mode */
    3566          24 :         pset.popt.topt.expanded = save_expanded;
    3567             : 
    3568          24 :         free(pattern);
    3569             :     }
    3570             :     else
    3571           6 :         ignore_slash_options(scan_state);
    3572             : 
    3573          30 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
    3574             : }
    3575             : 
    3576             : /*
    3577             :  * \! -- execute shell command
    3578             :  */
    3579             : static backslashResult
    3580           6 : exec_command_shell_escape(PsqlScanState scan_state, bool active_branch)
    3581             : {
    3582           6 :     bool        success = true;
    3583             : 
    3584           6 :     if (active_branch)
    3585             :     {
    3586           0 :         char       *opt = psql_scan_slash_option(scan_state,
    3587             :                                                  OT_WHOLE_LINE, NULL, false);
    3588             : 
    3589           0 :         success = do_shell(opt);
    3590           0 :         free(opt);
    3591             :     }
    3592             :     else
    3593           6 :         ignore_slash_whole_line(scan_state);
    3594             : 
    3595           6 :     return success ? PSQL_CMD_SKIP_LINE : PSQL_CMD_ERROR;
    3596             : }
    3597             : 
    3598             : /*
    3599             :  * \? -- print help about backslash commands
    3600             :  */
    3601             : static backslashResult
    3602           6 : exec_command_slash_command_help(PsqlScanState scan_state, bool active_branch)
    3603             : {
    3604           6 :     if (active_branch)
    3605             :     {
    3606           0 :         char       *opt0 = psql_scan_slash_option(scan_state,
    3607             :                                                   OT_NORMAL, NULL, false);
    3608             : 
    3609           0 :         if (!opt0 || strcmp(opt0, "commands") == 0)
    3610           0 :             slashUsage(pset.popt.topt.pager);
    3611           0 :         else if (strcmp(opt0, "options") == 0)
    3612           0 :             usage(pset.popt.topt.pager);
    3613           0 :         else if (strcmp(opt0, "variables") == 0)
    3614           0 :             helpVariables(pset.popt.topt.pager);
    3615             :         else
    3616           0 :             slashUsage(pset.popt.topt.pager);
    3617             : 
    3618           0 :         free(opt0);
    3619             :     }
    3620             :     else
    3621           6 :         ignore_slash_options(scan_state);
    3622             : 
    3623           6 :     return PSQL_CMD_SKIP_LINE;
    3624             : }
    3625             : 
    3626             : 
    3627             : /*
    3628             :  * Read and interpret an argument to the \connect slash command.
    3629             :  *
    3630             :  * Returns a malloc'd string, or NULL if no/empty argument.
    3631             :  */
    3632             : static char *
    3633        1374 : read_connect_arg(PsqlScanState scan_state)
    3634             : {
    3635             :     char       *result;
    3636             :     char        quote;
    3637             : 
    3638             :     /*
    3639             :      * Ideally we should treat the arguments as SQL identifiers.  But for
    3640             :      * backwards compatibility with 7.2 and older pg_dump files, we have to
    3641             :      * take unquoted arguments verbatim (don't downcase them). For now,
    3642             :      * double-quoted arguments may be stripped of double quotes (as if SQL
    3643             :      * identifiers).  By 7.4 or so, pg_dump files can be expected to
    3644             :      * double-quote all mixed-case \connect arguments, and then we can get rid
    3645             :      * of OT_SQLIDHACK.
    3646             :      */
    3647        1374 :     result = psql_scan_slash_option(scan_state, OT_SQLIDHACK, &quote, true);
    3648             : 
    3649        1374 :     if (!result)
    3650        1104 :         return NULL;
    3651             : 
    3652         270 :     if (quote)
    3653          24 :         return result;
    3654             : 
    3655         246 :     if (*result == '\0' || strcmp(result, "-") == 0)
    3656             :     {
    3657         206 :         free(result);
    3658         206 :         return NULL;
    3659             :     }
    3660             : 
    3661          40 :     return result;
    3662             : }
    3663             : 
    3664             : /*
    3665             :  * Read a boolean expression, return it as a PQExpBuffer string.
    3666             :  *
    3667             :  * Note: anything more or less than one token will certainly fail to be
    3668             :  * parsed by ParseVariableBool, so we don't worry about complaining here.
    3669             :  * This routine's return data structure will need to be rethought anyway
    3670             :  * to support likely future extensions such as "\if defined VARNAME".
    3671             :  */
    3672             : static PQExpBuffer
    3673         236 : gather_boolean_expression(PsqlScanState scan_state)
    3674             : {
    3675         236 :     PQExpBuffer exp_buf = createPQExpBuffer();
    3676         236 :     int         num_options = 0;
    3677             :     char       *value;
    3678             : 
    3679             :     /* collect all arguments for the conditional command into exp_buf */
    3680         484 :     while ((value = psql_scan_slash_option(scan_state,
    3681         484 :                                            OT_NORMAL, NULL, false)) != NULL)
    3682             :     {
    3683             :         /* add spaces between tokens */
    3684         248 :         if (num_options > 0)
    3685          12 :             appendPQExpBufferChar(exp_buf, ' ');
    3686         248 :         appendPQExpBufferStr(exp_buf, value);
    3687         248 :         num_options++;
    3688         248 :         free(value);
    3689             :     }
    3690             : 
    3691         236 :     return exp_buf;
    3692             : }
    3693             : 
    3694             : /*
    3695             :  * Read a boolean expression, return true if the expression
    3696             :  * was a valid boolean expression that evaluated to true.
    3697             :  * Otherwise return false.
    3698             :  *
    3699             :  * Note: conditional stack's top state must be active, else lexer will
    3700             :  * fail to expand variables and backticks.
    3701             :  */
    3702             : static bool
    3703         218 : is_true_boolean_expression(PsqlScanState scan_state, const char *name)
    3704             : {
    3705         218 :     PQExpBuffer buf = gather_boolean_expression(scan_state);
    3706         218 :     bool        value = false;
    3707         218 :     bool        success = ParseVariableBool(buf->data, name, &value);
    3708             : 
    3709         218 :     destroyPQExpBuffer(buf);
    3710         218 :     return success && value;
    3711             : }
    3712             : 
    3713             : /*
    3714             :  * Read a boolean expression, but do nothing with it.
    3715             :  *
    3716             :  * Note: conditional stack's top state must be INACTIVE, else lexer will
    3717             :  * expand variables and backticks, which we do not want here.
    3718             :  */
    3719             : static void
    3720          18 : ignore_boolean_expression(PsqlScanState scan_state)
    3721             : {
    3722          18 :     PQExpBuffer buf = gather_boolean_expression(scan_state);
    3723             : 
    3724          18 :     destroyPQExpBuffer(buf);
    3725          18 : }
    3726             : 
    3727             : /*
    3728             :  * Read and discard "normal" slash command options.
    3729             :  *
    3730             :  * This should be used for inactive-branch processing of any slash command
    3731             :  * that eats one or more OT_NORMAL, OT_SQLID, or OT_SQLIDHACK parameters.
    3732             :  * We don't need to worry about exactly how many it would eat, since the
    3733             :  * cleanup logic in HandleSlashCmds would silently discard any extras anyway.
    3734             :  */
    3735             : static void
    3736         390 : ignore_slash_options(PsqlScanState scan_state)
    3737             : {
    3738             :     char       *arg;
    3739             : 
    3740         870 :     while ((arg = psql_scan_slash_option(scan_state,
    3741         870 :                                          OT_NORMAL, NULL, false)) != NULL)
    3742         480 :         free(arg);
    3743         390 : }
    3744             : 
    3745             : /*
    3746             :  * Read and discard FILEPIPE slash command argument.
    3747             :  *
    3748             :  * This *MUST* be used for inactive-branch processing of any slash command
    3749             :  * that takes an OT_FILEPIPE option.  Otherwise we might consume a different
    3750             :  * amount of option text in active and inactive cases.
    3751             :  */
    3752             : static void
    3753          18 : ignore_slash_filepipe(PsqlScanState scan_state)
    3754             : {
    3755          18 :     char       *arg = psql_scan_slash_option(scan_state,
    3756             :                                              OT_FILEPIPE, NULL, false);
    3757             : 
    3758          18 :     free(arg);
    3759          18 : }
    3760             : 
    3761             : /*
    3762             :  * Read and discard whole-line slash command argument.
    3763             :  *
    3764             :  * This *MUST* be used for inactive-branch processing of any slash command
    3765             :  * that takes an OT_WHOLE_LINE option.  Otherwise we might consume a different
    3766             :  * amount of option text in active and inactive cases.
    3767             :  *
    3768             :  * Note: although callers might pass "semicolon" as either true or false,
    3769             :  * we need not duplicate that here, since it doesn't affect the amount of
    3770             :  * input text consumed.
    3771             :  */
    3772             : static void
    3773          42 : ignore_slash_whole_line(PsqlScanState scan_state)
    3774             : {
    3775          42 :     char       *arg = psql_scan_slash_option(scan_state,
    3776             :                                              OT_WHOLE_LINE, NULL, false);
    3777             : 
    3778          42 :     free(arg);
    3779          42 : }
    3780             : 
    3781             : /*
    3782             :  * Return true if the command given is a branching command.
    3783             :  */
    3784             : static bool
    3785           0 : is_branching_command(const char *cmd)
    3786             : {
    3787           0 :     return (strcmp(cmd, "if") == 0 ||
    3788           0 :             strcmp(cmd, "elif") == 0 ||
    3789           0 :             strcmp(cmd, "else") == 0 ||
    3790           0 :             strcmp(cmd, "endif") == 0);
    3791             : }
    3792             : 
    3793             : /*
    3794             :  * Prepare to possibly restore query buffer to its current state
    3795             :  * (cf. discard_query_text).
    3796             :  *
    3797             :  * We need to remember the length of the query buffer, and the lexer's
    3798             :  * notion of the parenthesis nesting depth.
    3799             :  */
    3800             : static void
    3801         266 : save_query_text_state(PsqlScanState scan_state, ConditionalStack cstack,
    3802             :                       PQExpBuffer query_buf)
    3803             : {
    3804         266 :     if (query_buf)
    3805         266 :         conditional_stack_set_query_len(cstack, query_buf->len);
    3806         266 :     conditional_stack_set_paren_depth(cstack,
    3807             :                                       psql_scan_get_paren_depth(scan_state));
    3808         266 : }
    3809             : 
    3810             : /*
    3811             :  * Discard any query text absorbed during an inactive conditional branch.
    3812             :  *
    3813             :  * We must discard data that was appended to query_buf during an inactive
    3814             :  * \if branch.  We don't have to do anything there if there's no query_buf.
    3815             :  *
    3816             :  * Also, reset the lexer state to the same paren depth there was before.
    3817             :  * (The rest of its state doesn't need attention, since we could not be
    3818             :  * inside a comment or literal or partial token.)
    3819             :  */
    3820             : static void
    3821         222 : discard_query_text(PsqlScanState scan_state, ConditionalStack cstack,
    3822             :                    PQExpBuffer query_buf)
    3823             : {
    3824         222 :     if (query_buf)
    3825             :     {
    3826         222 :         int         new_len = conditional_stack_get_query_len(cstack);
    3827             : 
    3828             :         Assert(new_len >= 0 && new_len <= query_buf->len);
    3829         222 :         query_buf->len = new_len;
    3830         222 :         query_buf->data[new_len] = '\0';
    3831             :     }
    3832         222 :     psql_scan_set_paren_depth(scan_state,
    3833             :                               conditional_stack_get_paren_depth(cstack));
    3834         222 : }
    3835             : 
    3836             : /*
    3837             :  * If query_buf is empty, copy previous_buf into it.
    3838             :  *
    3839             :  * This is used by various slash commands for which re-execution of a
    3840             :  * previous query is a common usage.  For convenience, we allow the
    3841             :  * case of query_buf == NULL (and do nothing).
    3842             :  *
    3843             :  * Returns "true" if the previous query was copied into the query
    3844             :  * buffer, else "false".
    3845             :  */
    3846             : static bool
    3847        2974 : copy_previous_query(PQExpBuffer query_buf, PQExpBuffer previous_buf)
    3848             : {
    3849        2974 :     if (query_buf && query_buf->len == 0)
    3850             :     {
    3851        1172 :         appendPQExpBufferStr(query_buf, previous_buf->data);
    3852        1172 :         return true;
    3853             :     }
    3854        1802 :     return false;
    3855             : }
    3856             : 
    3857             : /*
    3858             :  * Ask the user for a password; 'username' is the username the
    3859             :  * password is for, if one has been explicitly specified.
    3860             :  * Returns a malloc'd string.
    3861             :  * If 'canceled' is provided, *canceled will be set to true if the prompt
    3862             :  * is canceled via SIGINT, and to false otherwise.
    3863             :  */
    3864             : static char *
    3865           0 : prompt_for_password(const char *username, bool *canceled)
    3866             : {
    3867             :     char       *result;
    3868             :     PromptInterruptContext prompt_ctx;
    3869             : 
    3870             :     /* Set up to let SIGINT cancel simple_prompt_extended() */
    3871           0 :     prompt_ctx.jmpbuf = sigint_interrupt_jmp;
    3872           0 :     prompt_ctx.enabled = &sigint_interrupt_enabled;
    3873           0 :     prompt_ctx.canceled = false;
    3874             : 
    3875           0 :     if (username == NULL || username[0] == '\0')
    3876           0 :         result = simple_prompt_extended("Password: ", false, &prompt_ctx);
    3877             :     else
    3878             :     {
    3879             :         char       *prompt_text;
    3880             : 
    3881           0 :         prompt_text = psprintf(_("Password for user %s: "), username);
    3882           0 :         result = simple_prompt_extended(prompt_text, false, &prompt_ctx);
    3883           0 :         free(prompt_text);
    3884             :     }
    3885             : 
    3886           0 :     if (canceled)
    3887           0 :         *canceled = prompt_ctx.canceled;
    3888             : 
    3889           0 :     return result;
    3890             : }
    3891             : 
    3892             : static bool
    3893          48 : param_is_newly_set(const char *old_val, const char *new_val)
    3894             : {
    3895          48 :     if (new_val == NULL)
    3896           0 :         return false;
    3897             : 
    3898          48 :     if (old_val == NULL || strcmp(old_val, new_val) != 0)
    3899           0 :         return true;
    3900             : 
    3901          48 :     return false;
    3902             : }
    3903             : 
    3904             : /*
    3905             :  * do_connect -- handler for \connect
    3906             :  *
    3907             :  * Connects to a database with given parameters.  If we are told to re-use
    3908             :  * parameters, parameters from the previous connection are used where the
    3909             :  * command's own options do not supply a value.  Otherwise, libpq defaults
    3910             :  * are used.
    3911             :  *
    3912             :  * In interactive mode, if connection fails with the given parameters,
    3913             :  * the old connection will be kept.
    3914             :  */
    3915             : static bool
    3916         338 : do_connect(enum trivalue reuse_previous_specification,
    3917             :            char *dbname, char *user, char *host, char *port)
    3918             : {
    3919         338 :     PGconn     *o_conn = pset.db,
    3920         338 :                *n_conn = NULL;
    3921             :     PQconninfoOption *cinfo;
    3922         338 :     int         nconnopts = 0;
    3923         338 :     bool        same_host = false;
    3924         338 :     char       *password = NULL;
    3925             :     char       *client_encoding;
    3926         338 :     bool        success = true;
    3927         338 :     bool        keep_password = true;
    3928             :     bool        has_connection_string;
    3929             :     bool        reuse_previous;
    3930             : 
    3931         338 :     has_connection_string = dbname ?
    3932         338 :         recognized_connection_string(dbname) : false;
    3933             : 
    3934             :     /* Complain if we have additional arguments after a connection string. */
    3935         338 :     if (has_connection_string && (user || host || port))
    3936             :     {
    3937           0 :         pg_log_error("Do not give user, host, or port separately when using a connection string");
    3938           0 :         return false;
    3939             :     }
    3940             : 
    3941         338 :     switch (reuse_previous_specification)
    3942             :     {
    3943          22 :         case TRI_YES:
    3944          22 :             reuse_previous = true;
    3945          22 :             break;
    3946           0 :         case TRI_NO:
    3947           0 :             reuse_previous = false;
    3948           0 :             break;
    3949         316 :         default:
    3950         316 :             reuse_previous = !has_connection_string;
    3951         316 :             break;
    3952             :     }
    3953             : 
    3954             :     /*
    3955             :      * If we intend to re-use connection parameters, collect them out of the
    3956             :      * old connection, then replace individual values as necessary.  (We may
    3957             :      * need to resort to looking at pset.dead_conn, if the connection died
    3958             :      * previously.)  Otherwise, obtain a PQconninfoOption array containing
    3959             :      * libpq's defaults, and modify that.  Note this function assumes that
    3960             :      * PQconninfo, PQconndefaults, and PQconninfoParse will all produce arrays
    3961             :      * containing the same options in the same order.
    3962             :      */
    3963         338 :     if (reuse_previous)
    3964             :     {
    3965         338 :         if (o_conn)
    3966         338 :             cinfo = PQconninfo(o_conn);
    3967           0 :         else if (pset.dead_conn)
    3968           0 :             cinfo = PQconninfo(pset.dead_conn);
    3969             :         else
    3970             :         {
    3971             :             /* This is reachable after a non-interactive \connect failure */
    3972           0 :             pg_log_error("No database connection exists to re-use parameters from");
    3973           0 :             return false;
    3974             :         }
    3975             :     }
    3976             :     else
    3977           0 :         cinfo = PQconndefaults();
    3978             : 
    3979         338 :     if (cinfo)
    3980             :     {
    3981         338 :         if (has_connection_string)
    3982             :         {
    3983             :             /* Parse the connstring and insert values into cinfo */
    3984             :             PQconninfoOption *replcinfo;
    3985             :             char       *errmsg;
    3986             : 
    3987          22 :             replcinfo = PQconninfoParse(dbname, &errmsg);
    3988          22 :             if (replcinfo)
    3989             :             {
    3990             :                 PQconninfoOption *ci;
    3991             :                 PQconninfoOption *replci;
    3992          22 :                 bool        have_password = false;
    3993             : 
    3994          22 :                 for (ci = cinfo, replci = replcinfo;
    3995        1144 :                      ci->keyword && replci->keyword;
    3996        1122 :                      ci++, replci++)
    3997             :                 {
    3998             :                     Assert(strcmp(ci->keyword, replci->keyword) == 0);
    3999             :                     /* Insert value from connstring if one was provided */
    4000        1122 :                     if (replci->val)
    4001             :                     {
    4002             :                         /*
    4003             :                          * We know that both val strings were allocated by
    4004             :                          * libpq, so the least messy way to avoid memory leaks
    4005             :                          * is to swap them.
    4006             :                          */
    4007          28 :                         char       *swap = replci->val;
    4008             : 
    4009          28 :                         replci->val = ci->val;
    4010          28 :                         ci->val = swap;
    4011             : 
    4012             :                         /*
    4013             :                          * Check whether connstring provides options affecting
    4014             :                          * password re-use.  While any change in user, host,
    4015             :                          * hostaddr, or port causes us to ignore the old
    4016             :                          * connection's password, we don't force that for
    4017             :                          * dbname, since passwords aren't database-specific.
    4018             :                          */
    4019          28 :                         if (replci->val == NULL ||
    4020          28 :                             strcmp(ci->val, replci->val) != 0)
    4021             :                         {
    4022          28 :                             if (strcmp(replci->keyword, "user") == 0 ||
    4023          22 :                                 strcmp(replci->keyword, "host") == 0 ||
    4024          22 :                                 strcmp(replci->keyword, "hostaddr") == 0 ||
    4025          22 :                                 strcmp(replci->keyword, "port") == 0)
    4026           6 :                                 keep_password = false;
    4027             :                         }
    4028             :                         /* Also note whether connstring contains a password. */
    4029          28 :                         if (strcmp(replci->keyword, "password") == 0)
    4030           0 :                             have_password = true;
    4031             :                     }
    4032        1094 :                     else if (!reuse_previous)
    4033             :                     {
    4034             :                         /*
    4035             :                          * When we have a connstring and are not re-using
    4036             :                          * parameters, swap *all* entries, even those not set
    4037             :                          * by the connstring.  This avoids absorbing
    4038             :                          * environment-dependent defaults from the result of
    4039             :                          * PQconndefaults().  We don't want to do that because
    4040             :                          * they'd override service-file entries if the
    4041             :                          * connstring specifies a service parameter, whereas
    4042             :                          * the priority should be the other way around.  libpq
    4043             :                          * can certainly recompute any defaults we don't pass
    4044             :                          * here.  (In this situation, it's a bit wasteful to
    4045             :                          * have called PQconndefaults() at all, but not doing
    4046             :                          * so would require yet another major code path here.)
    4047             :                          */
    4048           0 :                         replci->val = ci->val;
    4049           0 :                         ci->val = NULL;
    4050             :                     }
    4051             :                 }
    4052             :                 Assert(ci->keyword == NULL && replci->keyword == NULL);
    4053             : 
    4054             :                 /* While here, determine how many option slots there are */
    4055          22 :                 nconnopts = ci - cinfo;
    4056             : 
    4057          22 :                 PQconninfoFree(replcinfo);
    4058             : 
    4059             :                 /*
    4060             :                  * If the connstring contains a password, tell the loop below
    4061             :                  * that we may use it, regardless of other settings (i.e.,
    4062             :                  * cinfo's password is no longer an "old" password).
    4063             :                  */
    4064          22 :                 if (have_password)
    4065           0 :                     keep_password = true;
    4066             : 
    4067             :                 /* Don't let code below try to inject dbname into params. */
    4068          22 :                 dbname = NULL;
    4069             :             }
    4070             :             else
    4071             :             {
    4072             :                 /* PQconninfoParse failed */
    4073           0 :                 if (errmsg)
    4074             :                 {
    4075           0 :                     pg_log_error("%s", errmsg);
    4076           0 :                     PQfreemem(errmsg);
    4077             :                 }
    4078             :                 else
    4079           0 :                     pg_log_error("out of memory");
    4080           0 :                 success = false;
    4081             :             }
    4082             :         }
    4083             :         else
    4084             :         {
    4085             :             /*
    4086             :              * If dbname isn't a connection string, then we'll inject it and
    4087             :              * the other parameters into the keyword array below.  (We can't
    4088             :              * easily insert them into the cinfo array because of memory
    4089             :              * management issues: PQconninfoFree would misbehave on Windows.)
    4090             :              * However, to avoid dependencies on the order in which parameters
    4091             :              * appear in the array, make a preliminary scan to set
    4092             :              * keep_password and same_host correctly.
    4093             :              *
    4094             :              * While any change in user, host, or port causes us to ignore the
    4095             :              * old connection's password, we don't force that for dbname,
    4096             :              * since passwords aren't database-specific.
    4097             :              */
    4098             :             PQconninfoOption *ci;
    4099             : 
    4100       16432 :             for (ci = cinfo; ci->keyword; ci++)
    4101             :             {
    4102       16116 :                 if (user && strcmp(ci->keyword, "user") == 0)
    4103             :                 {
    4104           8 :                     if (!(ci->val && strcmp(user, ci->val) == 0))
    4105           8 :                         keep_password = false;
    4106             :                 }
    4107       16108 :                 else if (host && strcmp(ci->keyword, "host") == 0)
    4108             :                 {
    4109           0 :                     if (ci->val && strcmp(host, ci->val) == 0)
    4110           0 :                         same_host = true;
    4111             :                     else
    4112           0 :                         keep_password = false;
    4113             :                 }
    4114       16108 :                 else if (port && strcmp(ci->keyword, "port") == 0)
    4115             :                 {
    4116           0 :                     if (!(ci->val && strcmp(port, ci->val) == 0))
    4117           0 :                         keep_password = false;
    4118             :                 }
    4119             :             }
    4120             : 
    4121             :             /* While here, determine how many option slots there are */
    4122         316 :             nconnopts = ci - cinfo;
    4123             :         }
    4124             :     }
    4125             :     else
    4126             :     {
    4127             :         /* We failed to create the cinfo structure */
    4128           0 :         pg_log_error("out of memory");
    4129           0 :         success = false;
    4130             :     }
    4131             : 
    4132             :     /*
    4133             :      * If the user asked to be prompted for a password, ask for one now. If
    4134             :      * not, use the password from the old connection, provided the username
    4135             :      * etc have not changed. Otherwise, try to connect without a password
    4136             :      * first, and then ask for a password if needed.
    4137             :      *
    4138             :      * XXX: this behavior leads to spurious connection attempts recorded in
    4139             :      * the postmaster's log.  But libpq offers no API that would let us obtain
    4140             :      * a password and then continue with the first connection attempt.
    4141             :      */
    4142         338 :     if (pset.getPassword == TRI_YES && success)
    4143             :     {
    4144           0 :         bool        canceled = false;
    4145             : 
    4146             :         /*
    4147             :          * If a connstring or URI is provided, we don't know which username
    4148             :          * will be used, since we haven't dug that out of the connstring.
    4149             :          * Don't risk issuing a misleading prompt.  As in startup.c, it does
    4150             :          * not seem worth working harder, since this getPassword setting is
    4151             :          * normally only used in noninteractive cases.
    4152             :          */
    4153           0 :         password = prompt_for_password(has_connection_string ? NULL : user,
    4154             :                                        &canceled);
    4155           0 :         success = !canceled;
    4156             :     }
    4157             : 
    4158             :     /*
    4159             :      * Consider whether to force client_encoding to "auto" (overriding
    4160             :      * anything in the connection string).  We do so if we have a terminal
    4161             :      * connection and there is no PGCLIENTENCODING environment setting.
    4162             :      */
    4163         338 :     if (pset.notty || getenv("PGCLIENTENCODING"))
    4164         338 :         client_encoding = NULL;
    4165             :     else
    4166           0 :         client_encoding = "auto";
    4167             : 
    4168             :     /* Loop till we have a connection or fail, which we might've already */
    4169         338 :     while (success)
    4170             :     {
    4171         338 :         const char **keywords = pg_malloc((nconnopts + 1) * sizeof(*keywords));
    4172         338 :         const char **values = pg_malloc((nconnopts + 1) * sizeof(*values));
    4173         338 :         int         paramnum = 0;
    4174             :         PQconninfoOption *ci;
    4175             : 
    4176             :         /*
    4177             :          * Copy non-default settings into the PQconnectdbParams parameter
    4178             :          * arrays; but inject any values specified old-style, as well as any
    4179             :          * interactively-obtained password, and a couple of fields we want to
    4180             :          * set forcibly.
    4181             :          *
    4182             :          * If you change this code, see also the initial-connection code in
    4183             :          * main().
    4184             :          */
    4185       17576 :         for (ci = cinfo; ci->keyword; ci++)
    4186             :         {
    4187       17238 :             keywords[paramnum] = ci->keyword;
    4188             : 
    4189       17238 :             if (dbname && strcmp(ci->keyword, "dbname") == 0)
    4190          12 :                 values[paramnum++] = dbname;
    4191       17226 :             else if (user && strcmp(ci->keyword, "user") == 0)
    4192           8 :                 values[paramnum++] = user;
    4193       17218 :             else if (host && strcmp(ci->keyword, "host") == 0)
    4194           0 :                 values[paramnum++] = host;
    4195       17218 :             else if (host && !same_host && strcmp(ci->keyword, "hostaddr") == 0)
    4196             :             {
    4197             :                 /* If we're changing the host value, drop any old hostaddr */
    4198           0 :                 values[paramnum++] = NULL;
    4199             :             }
    4200       17218 :             else if (port && strcmp(ci->keyword, "port") == 0)
    4201           0 :                 values[paramnum++] = port;
    4202             :             /* If !keep_password, we unconditionally drop old password */
    4203       17218 :             else if ((password || !keep_password) &&
    4204         706 :                      strcmp(ci->keyword, "password") == 0)
    4205          14 :                 values[paramnum++] = password;
    4206       17204 :             else if (strcmp(ci->keyword, "fallback_application_name") == 0)
    4207         338 :                 values[paramnum++] = pset.progname;
    4208       16866 :             else if (client_encoding &&
    4209           0 :                      strcmp(ci->keyword, "client_encoding") == 0)
    4210           0 :                 values[paramnum++] = client_encoding;
    4211       16866 :             else if (ci->val)
    4212        6426 :                 values[paramnum++] = ci->val;
    4213             :             /* else, don't bother making libpq parse this keyword */
    4214             :         }
    4215             :         /* add array terminator */
    4216         338 :         keywords[paramnum] = NULL;
    4217         338 :         values[paramnum] = NULL;
    4218             : 
    4219             :         /* Note we do not want libpq to re-expand the dbname parameter */
    4220         338 :         n_conn = PQconnectStartParams(keywords, values, false);
    4221             : 
    4222         338 :         pg_free(keywords);
    4223         338 :         pg_free(values);
    4224             : 
    4225         338 :         wait_until_connected(n_conn);
    4226         338 :         if (PQstatus(n_conn) == CONNECTION_OK)
    4227         338 :             break;
    4228             : 
    4229             :         /*
    4230             :          * Connection attempt failed; either retry the connection attempt with
    4231             :          * a new password, or give up.
    4232             :          */
    4233           0 :         if (!password && PQconnectionNeedsPassword(n_conn) && pset.getPassword != TRI_NO)
    4234           0 :         {
    4235           0 :             bool        canceled = false;
    4236             : 
    4237             :             /*
    4238             :              * Prompt for password using the username we actually connected
    4239             :              * with --- it might've come out of "dbname" rather than "user".
    4240             :              */
    4241           0 :             password = prompt_for_password(PQuser(n_conn), &canceled);
    4242           0 :             PQfinish(n_conn);
    4243           0 :             n_conn = NULL;
    4244           0 :             success = !canceled;
    4245           0 :             continue;
    4246             :         }
    4247             : 
    4248             :         /*
    4249             :          * We'll report the error below ... unless n_conn is NULL, indicating
    4250             :          * that libpq didn't have enough memory to make a PGconn.
    4251             :          */
    4252           0 :         if (n_conn == NULL)
    4253           0 :             pg_log_error("out of memory");
    4254             : 
    4255           0 :         success = false;
    4256             :     }                           /* end retry loop */
    4257             : 
    4258             :     /* Release locally allocated data, whether we succeeded or not */
    4259         338 :     pg_free(password);
    4260         338 :     PQconninfoFree(cinfo);
    4261             : 
    4262         338 :     if (!success)
    4263             :     {
    4264             :         /*
    4265             :          * Failed to connect to the database. In interactive mode, keep the
    4266             :          * previous connection to the DB; in scripting mode, close our
    4267             :          * previous connection as well.
    4268             :          */
    4269           0 :         if (pset.cur_cmd_interactive)
    4270             :         {
    4271           0 :             if (n_conn)
    4272             :             {
    4273           0 :                 pg_log_info("%s", PQerrorMessage(n_conn));
    4274           0 :                 PQfinish(n_conn);
    4275             :             }
    4276             : 
    4277             :             /* pset.db is left unmodified */
    4278           0 :             if (o_conn)
    4279           0 :                 pg_log_info("Previous connection kept");
    4280             :         }
    4281             :         else
    4282             :         {
    4283           0 :             if (n_conn)
    4284             :             {
    4285           0 :                 pg_log_error("\\connect: %s", PQerrorMessage(n_conn));
    4286           0 :                 PQfinish(n_conn);
    4287             :             }
    4288             : 
    4289           0 :             if (o_conn)
    4290             :             {
    4291             :                 /*
    4292             :                  * Transition to having no connection.
    4293             :                  *
    4294             :                  * Unlike CheckConnection(), we close the old connection
    4295             :                  * immediately to prevent its parameters from being re-used.
    4296             :                  * This is so that a script cannot accidentally reuse
    4297             :                  * parameters it did not expect to.  Otherwise, the state
    4298             :                  * cleanup should be the same as in CheckConnection().
    4299             :                  */
    4300           0 :                 PQfinish(o_conn);
    4301           0 :                 pset.db = NULL;
    4302           0 :                 ResetCancelConn();
    4303           0 :                 UnsyncVariables();
    4304             :             }
    4305             : 
    4306             :             /* On the same reasoning, release any dead_conn to prevent reuse */
    4307           0 :             if (pset.dead_conn)
    4308             :             {
    4309           0 :                 PQfinish(pset.dead_conn);
    4310           0 :                 pset.dead_conn = NULL;
    4311             :             }
    4312             :         }
    4313             : 
    4314           0 :         return false;
    4315             :     }
    4316             : 
    4317             :     /*
    4318             :      * Replace the old connection with the new one, and update
    4319             :      * connection-dependent variables.  Keep the resynchronization logic in
    4320             :      * sync with CheckConnection().
    4321             :      */
    4322         338 :     PQsetNoticeProcessor(n_conn, NoticeProcessor, NULL);
    4323         338 :     pset.db = n_conn;
    4324         338 :     SyncVariables();
    4325         338 :     connection_warnings(false); /* Must be after SyncVariables */
    4326             : 
    4327             :     /* Tell the user about the new connection */
    4328         338 :     if (!pset.quiet)
    4329             :     {
    4330          48 :         if (!o_conn ||
    4331          48 :             param_is_newly_set(PQhost(o_conn), PQhost(pset.db)) ||
    4332          24 :             param_is_newly_set(PQport(o_conn), PQport(pset.db)))
    4333           0 :         {
    4334           0 :             char       *connhost = PQhost(pset.db);
    4335           0 :             char       *hostaddr = PQhostaddr(pset.db);
    4336             : 
    4337           0 :             if (is_unixsock_path(connhost))
    4338             :             {
    4339             :                 /* hostaddr overrides connhost */
    4340           0 :                 if (hostaddr && *hostaddr)
    4341           0 :                     printf(_("You are now connected to database \"%s\" as user \"%s\" on address \"%s\" at port \"%s\".\n"),
    4342             :                            PQdb(pset.db), PQuser(pset.db), hostaddr, PQport(pset.db));
    4343             :                 else
    4344           0 :                     printf(_("You are now connected to database \"%s\" as user \"%s\" via socket in \"%s\" at port \"%s\".\n"),
    4345             :                            PQdb(pset.db), PQuser(pset.db), connhost, PQport(pset.db));
    4346             :             }
    4347             :             else
    4348             :             {
    4349           0 :                 if (hostaddr && *hostaddr && strcmp(connhost, hostaddr) != 0)
    4350           0 :                     printf(_("You are now connected to database \"%s\" as user \"%s\" on host \"%s\" (address \"%s\") at port \"%s\".\n"),
    4351             :                            PQdb(pset.db), PQuser(pset.db), connhost, hostaddr, PQport(pset.db));
    4352             :                 else
    4353           0 :                     printf(_("You are now connected to database \"%s\" as user \"%s\" on host \"%s\" at port \"%s\".\n"),
    4354             :                            PQdb(pset.db), PQuser(pset.db), connhost, PQport(pset.db));
    4355             :             }
    4356             :         }
    4357             :         else
    4358          24 :             printf(_("You are now connected to database \"%s\" as user \"%s\".\n"),
    4359             :                    PQdb(pset.db), PQuser(pset.db));
    4360             :     }
    4361             : 
    4362             :     /* Drop no-longer-needed connection(s) */
    4363         338 :     if (o_conn)
    4364         338 :         PQfinish(o_conn);
    4365         338 :     if (pset.dead_conn)
    4366             :     {
    4367           0 :         PQfinish(pset.dead_conn);
    4368           0 :         pset.dead_conn = NULL;
    4369             :     }
    4370             : 
    4371         338 :     return true;
    4372             : }
    4373             : 
    4374             : /*
    4375             :  * Processes the connection sequence described by PQconnectStartParams(). Don't
    4376             :  * worry about reporting errors in this function. Our caller will check the
    4377             :  * connection's status, and report appropriately.
    4378             :  */
    4379             : static void
    4380         338 : wait_until_connected(PGconn *conn)
    4381             : {
    4382         338 :     bool        forRead = false;
    4383             : 
    4384             :     while (true)
    4385         350 :     {
    4386             :         int         rc;
    4387             :         int         sock;
    4388             :         pg_usec_time_t end_time;
    4389             : 
    4390             :         /*
    4391             :          * On every iteration of the connection sequence, let's check if the
    4392             :          * user has requested a cancellation.
    4393             :          */
    4394         688 :         if (cancel_pressed)
    4395           0 :             break;
    4396             : 
    4397             :         /*
    4398             :          * Do not assume that the socket remains the same across
    4399             :          * PQconnectPoll() calls.
    4400             :          */
    4401         688 :         sock = PQsocket(conn);
    4402         688 :         if (sock == -1)
    4403           0 :             break;
    4404             : 
    4405             :         /*
    4406             :          * If the user sends SIGINT between the cancel_pressed check, and
    4407             :          * polling of the socket, it will not be recognized. Instead, we will
    4408             :          * just wait until the next step in the connection sequence or
    4409             :          * forever, which might require users to send SIGTERM or SIGQUIT.
    4410             :          *
    4411             :          * Some solutions would include the "self-pipe trick," using
    4412             :          * pselect(2) and ppoll(2), or using a timeout.
    4413             :          *
    4414             :          * The self-pipe trick requires a bit of code to setup. pselect(2) and
    4415             :          * ppoll(2) are not on all the platforms we support. The simplest
    4416             :          * solution happens to just be adding a timeout, so let's wait for 1
    4417             :          * second and check cancel_pressed again.
    4418             :          */
    4419         688 :         end_time = PQgetCurrentTimeUSec() + 1000000;
    4420         688 :         rc = PQsocketPoll(sock, forRead, !forRead, end_time);
    4421         688 :         if (rc == -1)
    4422           0 :             return;
    4423             : 
    4424         688 :         switch (PQconnectPoll(conn))
    4425             :         {
    4426         338 :             case PGRES_POLLING_OK:
    4427             :             case PGRES_POLLING_FAILED:
    4428         338 :                 return;
    4429         350 :             case PGRES_POLLING_READING:
    4430         350 :                 forRead = true;
    4431         350 :                 continue;
    4432           0 :             case PGRES_POLLING_WRITING:
    4433           0 :                 forRead = false;
    4434           0 :                 continue;
    4435             :             case PGRES_POLLING_ACTIVE:
    4436             :                 pg_unreachable();
    4437             :         }
    4438             :     }
    4439             : }
    4440             : 
    4441             : void
    4442         344 : connection_warnings(bool in_startup)
    4443             : {
    4444         344 :     if (!pset.quiet && !pset.notty)
    4445             :     {
    4446           6 :         int         client_ver = PG_VERSION_NUM;
    4447             :         char        cverbuf[32];
    4448             :         char        sverbuf[32];
    4449             : 
    4450           6 :         if (pset.sversion != client_ver)
    4451             :         {
    4452             :             const char *server_version;
    4453             : 
    4454             :             /* Try to get full text form, might include "devel" etc */
    4455           0 :             server_version = PQparameterStatus(pset.db, "server_version");
    4456             :             /* Otherwise fall back on pset.sversion */
    4457           0 :             if (!server_version)
    4458             :             {
    4459           0 :                 formatPGVersionNumber(pset.sversion, true,
    4460             :                                       sverbuf, sizeof(sverbuf));
    4461           0 :                 server_version = sverbuf;
    4462             :             }
    4463             : 
    4464           0 :             printf(_("%s (%s, server %s)\n"),
    4465             :                    pset.progname, PG_VERSION, server_version);
    4466             :         }
    4467             :         /* For version match, only print psql banner on startup. */
    4468           6 :         else if (in_startup)
    4469           6 :             printf("%s (%s)\n", pset.progname, PG_VERSION);
    4470             : 
    4471             :         /*
    4472             :          * Warn if server's major version is newer than ours, or if server
    4473             :          * predates our support cutoff (currently 9.2).
    4474             :          */
    4475           6 :         if (pset.sversion / 100 > client_ver / 100 ||
    4476           6 :             pset.sversion < 90200)
    4477           0 :             printf(_("WARNING: %s major version %s, server major version %s.\n"
    4478             :                      "         Some psql features might not work.\n"),
    4479             :                    pset.progname,
    4480             :                    formatPGVersionNumber(client_ver, false,
    4481             :                                          cverbuf, sizeof(cverbuf)),
    4482             :                    formatPGVersionNumber(pset.sversion, false,
    4483             :                                          sverbuf, sizeof(sverbuf)));
    4484             : 
    4485             : #ifdef WIN32
    4486             :         if (in_startup)
    4487             :             checkWin32Codepage();
    4488             : #endif
    4489           6 :         printSSLInfo();
    4490           6 :         printGSSInfo();
    4491             :     }
    4492         344 : }
    4493             : 
    4494             : 
    4495             : /*
    4496             :  * printSSLInfo
    4497             :  *
    4498             :  * Prints information about the current SSL connection, if SSL is in use
    4499             :  */
    4500             : static void
    4501           6 : printSSLInfo(void)
    4502             : {
    4503             :     const char *protocol;
    4504             :     const char *cipher;
    4505             :     const char *compression;
    4506             :     const char *alpn;
    4507             : 
    4508           6 :     if (!PQsslInUse(pset.db))
    4509           6 :         return;                 /* no SSL */
    4510             : 
    4511           0 :     protocol = PQsslAttribute(pset.db, "protocol");
    4512           0 :     cipher = PQsslAttribute(pset.db, "cipher");
    4513           0 :     compression = PQsslAttribute(pset.db, "compression");
    4514           0 :     alpn = PQsslAttribute(pset.db, "alpn");
    4515             : 
    4516           0 :     printf(_("SSL connection (protocol: %s, cipher: %s, compression: %s, ALPN: %s)\n"),
    4517             :            protocol ? protocol : _("unknown"),
    4518             :            cipher ? cipher : _("unknown"),
    4519             :            (compression && strcmp(compression, "off") != 0) ? _("on") : _("off"),
    4520             :            (alpn && alpn[0] != '\0') ? alpn : _("none"));
    4521             : }
    4522             : 
    4523             : /*
    4524             :  * printGSSInfo
    4525             :  *
    4526             :  * Prints information about the current GSSAPI connection, if GSSAPI encryption is in use
    4527             :  */
    4528             : static void
    4529           6 : printGSSInfo(void)
    4530             : {
    4531           6 :     if (!PQgssEncInUse(pset.db))
    4532           6 :         return;                 /* no GSSAPI encryption in use */
    4533             : 
    4534           0 :     printf(_("GSSAPI-encrypted connection\n"));
    4535             : }
    4536             : 
    4537             : 
    4538             : /*
    4539             :  * checkWin32Codepage
    4540             :  *
    4541             :  * Prints a warning when win32 console codepage differs from Windows codepage
    4542             :  */
    4543             : #ifdef WIN32
    4544             : static void
    4545             : checkWin32Codepage(void)
    4546             : {
    4547             :     unsigned int wincp,
    4548             :                 concp;
    4549             : 
    4550             :     wincp = GetACP();
    4551             :     concp = GetConsoleCP();
    4552             :     if (wincp != concp)
    4553             :     {
    4554             :         printf(_("WARNING: Console code page (%u) differs from Windows code page (%u)\n"
    4555             :                  "         8-bit characters might not work correctly. See psql reference\n"
    4556             :                  "         page \"Notes for Windows users\" for details.\n"),
    4557             :                concp, wincp);
    4558             :     }
    4559             : }
    4560             : #endif
    4561             : 
    4562             : 
    4563             : /*
    4564             :  * SyncVariables
    4565             :  *
    4566             :  * Make psql's internal variables agree with connection state upon
    4567             :  * establishing a new connection.
    4568             :  */
    4569             : void
    4570       18776 : SyncVariables(void)
    4571             : {
    4572             :     char        vbuf[32];
    4573             :     const char *server_version;
    4574             :     char       *service_name;
    4575             :     char       *service_file;
    4576             : 
    4577             :     /* get stuff from connection */
    4578       18776 :     pset.encoding = PQclientEncoding(pset.db);
    4579       18776 :     pset.popt.topt.encoding = pset.encoding;
    4580       18776 :     pset.sversion = PQserverVersion(pset.db);
    4581             : 
    4582       18776 :     setFmtEncoding(pset.encoding);
    4583             : 
    4584       18776 :     SetVariable(pset.vars, "DBNAME", PQdb(pset.db));
    4585       18776 :     SetVariable(pset.vars, "USER", PQuser(pset.db));
    4586       18776 :     SetVariable(pset.vars, "HOST", PQhost(pset.db));
    4587       18776 :     SetVariable(pset.vars, "PORT", PQport(pset.db));
    4588       18776 :     SetVariable(pset.vars, "ENCODING", pg_encoding_to_char(pset.encoding));
    4589             : 
    4590       18776 :     service_name = get_conninfo_value("service");
    4591       18776 :     SetVariable(pset.vars, "SERVICE", service_name);
    4592       18776 :     if (service_name)
    4593          34 :         pg_free(service_name);
    4594             : 
    4595       18776 :     service_file = get_conninfo_value("servicefile");
    4596       18776 :     SetVariable(pset.vars, "SERVICEFILE", service_file);
    4597       18776 :     if (service_file)
    4598          34 :         pg_free(service_file);
    4599             : 
    4600             :     /* this bit should match connection_warnings(): */
    4601             :     /* Try to get full text form of version, might include "devel" etc */
    4602       18776 :     server_version = PQparameterStatus(pset.db, "server_version");
    4603             :     /* Otherwise fall back on pset.sversion */
    4604       18776 :     if (!server_version)
    4605             :     {
    4606           0 :         formatPGVersionNumber(pset.sversion, true, vbuf, sizeof(vbuf));
    4607           0 :         server_version = vbuf;
    4608             :     }
    4609       18776 :     SetVariable(pset.vars, "SERVER_VERSION_NAME", server_version);
    4610             : 
    4611       18776 :     snprintf(vbuf, sizeof(vbuf), "%d", pset.sversion);
    4612       18776 :     SetVariable(pset.vars, "SERVER_VERSION_NUM", vbuf);
    4613             : 
    4614             :     /* send stuff to it, too */
    4615       18776 :     PQsetErrorVerbosity(pset.db, pset.verbosity);
    4616       18776 :     PQsetErrorContextVisibility(pset.db, pset.show_context);
    4617       18776 : }
    4618             : 
    4619             : /*
    4620             :  * UnsyncVariables
    4621             :  *
    4622             :  * Clear variables that should be not be set when there is no connection.
    4623             :  */
    4624             : void
    4625           0 : UnsyncVariables(void)
    4626             : {
    4627           0 :     SetVariable(pset.vars, "DBNAME", NULL);
    4628           0 :     SetVariable(pset.vars, "SERVICE", NULL);
    4629           0 :     SetVariable(pset.vars, "SERVICEFILE", NULL);
    4630           0 :     SetVariable(pset.vars, "USER", NULL);
    4631           0 :     SetVariable(pset.vars, "HOST", NULL);
    4632           0 :     SetVariable(pset.vars, "PORT", NULL);
    4633           0 :     SetVariable(pset.vars, "ENCODING", NULL);
    4634           0 :     SetVariable(pset.vars, "SERVER_VERSION_NAME", NULL);
    4635           0 :     SetVariable(pset.vars, "SERVER_VERSION_NUM", NULL);
    4636           0 : }
    4637             : 
    4638             : 
    4639             : /*
    4640             :  * helper for do_edit(): actually invoke the editor
    4641             :  *
    4642             :  * Returns true on success, false if we failed to invoke the editor or
    4643             :  * it returned nonzero status.  (An error message is printed for failed-
    4644             :  * to-invoke cases, but not if the editor returns nonzero status.)
    4645             :  */
    4646             : static bool
    4647           0 : editFile(const char *fname, int lineno)
    4648             : {
    4649             :     const char *editorName;
    4650           0 :     const char *editor_lineno_arg = NULL;
    4651             :     char       *sys;
    4652             :     int         result;
    4653             : 
    4654             :     Assert(fname != NULL);
    4655             : 
    4656             :     /* Find an editor to use */
    4657           0 :     editorName = getenv("PSQL_EDITOR");
    4658           0 :     if (!editorName)
    4659           0 :         editorName = getenv("EDITOR");
    4660           0 :     if (!editorName)
    4661           0 :         editorName = getenv("VISUAL");
    4662           0 :     if (!editorName)
    4663           0 :         editorName = DEFAULT_EDITOR;
    4664             : 
    4665             :     /* Get line number argument, if we need it. */
    4666           0 :     if (lineno > 0)
    4667             :     {
    4668           0 :         editor_lineno_arg = getenv("PSQL_EDITOR_LINENUMBER_ARG");
    4669             : #ifdef DEFAULT_EDITOR_LINENUMBER_ARG
    4670           0 :         if (!editor_lineno_arg)
    4671           0 :             editor_lineno_arg = DEFAULT_EDITOR_LINENUMBER_ARG;
    4672             : #endif
    4673           0 :         if (!editor_lineno_arg)
    4674             :         {
    4675           0 :             pg_log_error("environment variable PSQL_EDITOR_LINENUMBER_ARG must be set to specify a line number");
    4676           0 :             return false;
    4677             :         }
    4678             :     }
    4679             : 
    4680             :     /*
    4681             :      * On Unix the EDITOR value should *not* be quoted, since it might include
    4682             :      * switches, eg, EDITOR="pico -t"; it's up to the user to put quotes in it
    4683             :      * if necessary.  But this policy is not very workable on Windows, due to
    4684             :      * severe brain damage in their command shell plus the fact that standard
    4685             :      * program paths include spaces.
    4686             :      */
    4687             : #ifndef WIN32
    4688           0 :     if (lineno > 0)
    4689           0 :         sys = psprintf("exec %s %s%d '%s'",
    4690             :                        editorName, editor_lineno_arg, lineno, fname);
    4691             :     else
    4692           0 :         sys = psprintf("exec %s '%s'",
    4693             :                        editorName, fname);
    4694             : #else
    4695             :     if (lineno > 0)
    4696             :         sys = psprintf("\"%s\" %s%d \"%s\"",
    4697             :                        editorName, editor_lineno_arg, lineno, fname);
    4698             :     else
    4699             :         sys = psprintf("\"%s\" \"%s\"",
    4700             :                        editorName, fname);
    4701             : #endif
    4702           0 :     fflush(NULL);
    4703           0 :     result = system(sys);
    4704           0 :     if (result == -1)
    4705           0 :         pg_log_error("could not start editor \"%s\"", editorName);
    4706           0 :     else if (result == 127)
    4707           0 :         pg_log_error("could not start /bin/sh");
    4708           0 :     free(sys);
    4709             : 
    4710           0 :     return result == 0;
    4711             : }
    4712             : 
    4713             : 
    4714             : /*
    4715             :  * do_edit -- handler for \e
    4716             :  *
    4717             :  * If you do not specify a filename, the current query buffer will be copied
    4718             :  * into a temporary file.
    4719             :  *
    4720             :  * After this function is done, the resulting file will be copied back into the
    4721             :  * query buffer.  As an exception to this, the query buffer will be emptied
    4722             :  * if the file was not modified (or the editor failed) and the caller passes
    4723             :  * "discard_on_quit" = true.
    4724             :  *
    4725             :  * If "edited" isn't NULL, *edited will be set to true if the query buffer
    4726             :  * is successfully replaced.
    4727             :  */
    4728             : static bool
    4729           0 : do_edit(const char *filename_arg, PQExpBuffer query_buf,
    4730             :         int lineno, bool discard_on_quit, bool *edited)
    4731             : {
    4732             :     char        fnametmp[MAXPGPATH];
    4733           0 :     FILE       *stream = NULL;
    4734             :     const char *fname;
    4735           0 :     bool        error = false;
    4736             :     int         fd;
    4737             :     struct stat before,
    4738             :                 after;
    4739             : 
    4740           0 :     if (filename_arg)
    4741           0 :         fname = filename_arg;
    4742             :     else
    4743             :     {
    4744             :         /* make a temp file to edit */
    4745             : #ifndef WIN32
    4746           0 :         const char *tmpdir = getenv("TMPDIR");
    4747             : 
    4748           0 :         if (!tmpdir)
    4749           0 :             tmpdir = "/tmp";
    4750             : #else
    4751             :         char        tmpdir[MAXPGPATH];
    4752             :         int         ret;
    4753             : 
    4754             :         ret = GetTempPath(MAXPGPATH, tmpdir);
    4755             :         if (ret == 0 || ret > MAXPGPATH)
    4756             :         {
    4757             :             pg_log_error("could not locate temporary directory: %s",
    4758             :                          !ret ? strerror(errno) : "");
    4759             :             return false;
    4760             :         }
    4761             : #endif
    4762             : 
    4763             :         /*
    4764             :          * No canonicalize_path() here. EDIT.EXE run from CMD.EXE prepends the
    4765             :          * current directory to the supplied path unless we use only
    4766             :          * backslashes, so we do that.
    4767             :          */
    4768             : #ifndef WIN32
    4769           0 :         snprintf(fnametmp, sizeof(fnametmp), "%s%spsql.edit.%d.sql", tmpdir,
    4770           0 :                  "/", (int) getpid());
    4771             : #else
    4772             :         snprintf(fnametmp, sizeof(fnametmp), "%s%spsql.edit.%d.sql", tmpdir,
    4773             :                  "" /* trailing separator already present */ , (int) getpid());
    4774             : #endif
    4775             : 
    4776           0 :         fname = (const char *) fnametmp;
    4777             : 
    4778           0 :         fd = open(fname, O_WRONLY | O_CREAT | O_EXCL, 0600);
    4779           0 :         if (fd != -1)
    4780           0 :             stream = fdopen(fd, "w");
    4781             : 
    4782           0 :         if (fd == -1 || !stream)
    4783             :         {
    4784           0 :             pg_log_error("could not open temporary file \"%s\": %m", fname);
    4785           0 :             error = true;
    4786             :         }
    4787             :         else
    4788             :         {
    4789           0 :             unsigned int ql = query_buf->len;
    4790             : 
    4791             :             /* force newline-termination of what we send to editor */
    4792           0 :             if (ql > 0 && query_buf->data[ql - 1] != '\n')
    4793             :             {
    4794           0 :                 appendPQExpBufferChar(query_buf, '\n');
    4795           0 :                 ql++;
    4796             :             }
    4797             : 
    4798           0 :             if (fwrite(query_buf->data, 1, ql, stream) != ql)
    4799             :             {
    4800           0 :                 pg_log_error("%s: %m", fname);
    4801             : 
    4802           0 :                 if (fclose(stream) != 0)
    4803           0 :                     pg_log_error("%s: %m", fname);
    4804             : 
    4805           0 :                 if (remove(fname) != 0)
    4806           0 :                     pg_log_error("%s: %m", fname);
    4807             : 
    4808           0 :                 error = true;
    4809             :             }
    4810           0 :             else if (fclose(stream) != 0)
    4811             :             {
    4812           0 :                 pg_log_error("%s: %m", fname);
    4813           0 :                 if (remove(fname) != 0)
    4814           0 :                     pg_log_error("%s: %m", fname);
    4815           0 :                 error = true;
    4816             :             }
    4817             :             else
    4818             :             {
    4819             :                 struct utimbuf ut;
    4820             : 
    4821             :                 /*
    4822             :                  * Try to set the file modification time of the temporary file
    4823             :                  * a few seconds in the past.  Otherwise, the low granularity
    4824             :                  * (one second, or even worse on some filesystems) that we can
    4825             :                  * portably measure with stat(2) could lead us to not
    4826             :                  * recognize a modification, if the user typed very quickly.
    4827             :                  *
    4828             :                  * This is a rather unlikely race condition, so don't error
    4829             :                  * out if the utime(2) call fails --- that would make the cure
    4830             :                  * worse than the disease.
    4831             :                  */
    4832           0 :                 ut.modtime = ut.actime = time(NULL) - 2;
    4833           0 :                 (void) utime(fname, &ut);
    4834             :             }
    4835             :         }
    4836             :     }
    4837             : 
    4838           0 :     if (!error && stat(fname, &before) != 0)
    4839             :     {
    4840           0 :         pg_log_error("%s: %m", fname);
    4841           0 :         error = true;
    4842             :     }
    4843             : 
    4844             :     /* call editor */
    4845           0 :     if (!error)
    4846           0 :         error = !editFile(fname, lineno);
    4847             : 
    4848           0 :     if (!error && stat(fname, &after) != 0)
    4849             :     {
    4850           0 :         pg_log_error("%s: %m", fname);
    4851           0 :         error = true;
    4852             :     }
    4853             : 
    4854             :     /* file was edited if the size or modification time has changed */
    4855           0 :     if (!error &&
    4856           0 :         (before.st_size != after.st_size ||
    4857           0 :          before.st_mtime != after.st_mtime))
    4858             :     {
    4859           0 :         stream = fopen(fname, PG_BINARY_R);
    4860           0 :         if (!stream)
    4861             :         {
    4862           0 :             pg_log_error("%s: %m", fname);
    4863           0 :             error = true;
    4864             :         }
    4865             :         else
    4866             :         {
    4867             :             /* read file back into query_buf */
    4868             :             char        line[1024];
    4869             : 
    4870           0 :             resetPQExpBuffer(query_buf);
    4871           0 :             while (fgets(line, sizeof(line), stream) != NULL)
    4872           0 :                 appendPQExpBufferStr(query_buf, line);
    4873             : 
    4874           0 :             if (ferror(stream))
    4875             :             {
    4876           0 :                 pg_log_error("%s: %m", fname);
    4877           0 :                 error = true;
    4878           0 :                 resetPQExpBuffer(query_buf);
    4879             :             }
    4880           0 :             else if (edited)
    4881             :             {
    4882           0 :                 *edited = true;
    4883             :             }
    4884             : 
    4885           0 :             fclose(stream);
    4886             :         }
    4887             :     }
    4888             :     else
    4889             :     {
    4890             :         /*
    4891             :          * If the file was not modified, and the caller requested it, discard
    4892             :          * the query buffer.
    4893             :          */
    4894           0 :         if (discard_on_quit)
    4895           0 :             resetPQExpBuffer(query_buf);
    4896             :     }
    4897             : 
    4898             :     /* remove temp file */
    4899           0 :     if (!filename_arg)
    4900             :     {
    4901           0 :         if (remove(fname) == -1)
    4902             :         {
    4903           0 :             pg_log_error("%s: %m", fname);
    4904           0 :             error = true;
    4905             :         }
    4906             :     }
    4907             : 
    4908           0 :     return !error;
    4909             : }
    4910             : 
    4911             : 
    4912             : 
    4913             : /*
    4914             :  * process_file
    4915             :  *
    4916             :  * Reads commands from filename and passes them to the main processing loop.
    4917             :  * Handler for \i and \ir, but can be used for other things as well.  Returns
    4918             :  * MainLoop() error code.
    4919             :  *
    4920             :  * If use_relative_path is true and filename is not an absolute path, then open
    4921             :  * the file from where the currently processed file (if any) is located.
    4922             :  */
    4923             : int
    4924       17902 : process_file(char *filename, bool use_relative_path)
    4925             : {
    4926             :     FILE       *fd;
    4927             :     int         result;
    4928             :     char       *oldfilename;
    4929             :     char        relpath[MAXPGPATH];
    4930             : 
    4931       17902 :     if (!filename)
    4932             :     {
    4933        5002 :         fd = stdin;
    4934        5002 :         filename = NULL;
    4935             :     }
    4936       12900 :     else if (strcmp(filename, "-") != 0)
    4937             :     {
    4938          40 :         canonicalize_path_enc(filename, pset.encoding);
    4939             : 
    4940             :         /*
    4941             :          * If we were asked to resolve the pathname relative to the location
    4942             :          * of the currently executing script, and there is one, and this is a
    4943             :          * relative pathname, then prepend all but the last pathname component
    4944             :          * of the current script to this pathname.
    4945             :          */
    4946          40 :         if (use_relative_path && pset.inputfile &&
    4947           0 :             !is_absolute_path(filename) && !has_drive_prefix(filename))
    4948             :         {
    4949           0 :             strlcpy(relpath, pset.inputfile, sizeof(relpath));
    4950           0 :             get_parent_directory(relpath);
    4951           0 :             join_path_components(relpath, relpath, filename);
    4952           0 :             canonicalize_path_enc(relpath, pset.encoding);
    4953             : 
    4954           0 :             filename = relpath;
    4955             :         }
    4956             : 
    4957          40 :         fd = fopen(filename, PG_BINARY_R);
    4958             : 
    4959          40 :         if (!fd)
    4960             :         {
    4961           0 :             pg_log_error("%s: %m", filename);
    4962           0 :             return EXIT_FAILURE;
    4963             :         }
    4964             :     }
    4965             :     else
    4966             :     {
    4967       12860 :         fd = stdin;
    4968       12860 :         filename = "<stdin>";   /* for future error messages */
    4969             :     }
    4970             : 
    4971       17902 :     oldfilename = pset.inputfile;
    4972       17902 :     pset.inputfile = filename;
    4973             : 
    4974       17902 :     pg_logging_config(pset.inputfile ? 0 : PG_LOG_FLAG_TERSE);
    4975             : 
    4976       17902 :     result = MainLoop(fd);
    4977             : 
    4978       17874 :     if (fd != stdin)
    4979          40 :         fclose(fd);
    4980             : 
    4981       17874 :     pset.inputfile = oldfilename;
    4982             : 
    4983       17874 :     pg_logging_config(pset.inputfile ? 0 : PG_LOG_FLAG_TERSE);
    4984             : 
    4985       17874 :     return result;
    4986             : }
    4987             : 
    4988             : 
    4989             : 
    4990             : static const char *
    4991           6 : _align2string(enum printFormat in)
    4992             : {
    4993           6 :     switch (in)
    4994             :     {
    4995           0 :         case PRINT_NOTHING:
    4996           0 :             return "nothing";
    4997             :             break;
    4998           6 :         case PRINT_ALIGNED:
    4999           6 :             return "aligned";
    5000             :             break;
    5001           0 :         case PRINT_ASCIIDOC:
    5002           0 :             return "asciidoc";
    5003             :             break;
    5004           0 :         case PRINT_CSV:
    5005           0 :             return "csv";
    5006             :             break;
    5007           0 :         case PRINT_HTML:
    5008           0 :             return "html";
    5009             :             break;
    5010           0 :         case PRINT_LATEX:
    5011           0 :             return "latex";
    5012             :             break;
    5013           0 :         case PRINT_LATEX_LONGTABLE:
    5014           0 :             return "latex-longtable";
    5015             :             break;
    5016           0 :         case PRINT_TROFF_MS:
    5017           0 :             return "troff-ms";
    5018             :             break;
    5019           0 :         case PRINT_UNALIGNED:
    5020           0 :             return "unaligned";
    5021             :             break;
    5022           0 :         case PRINT_WRAPPED:
    5023           0 :             return "wrapped";
    5024             :             break;
    5025             :     }
    5026           0 :     return "unknown";
    5027             : }
    5028             : 
    5029             : /*
    5030             :  * Parse entered Unicode linestyle.  If ok, update *linestyle and return
    5031             :  * true, else return false.
    5032             :  */
    5033             : static bool
    5034           0 : set_unicode_line_style(const char *value, size_t vallen,
    5035             :                        unicode_linestyle *linestyle)
    5036             : {
    5037           0 :     if (pg_strncasecmp("single", value, vallen) == 0)
    5038           0 :         *linestyle = UNICODE_LINESTYLE_SINGLE;
    5039           0 :     else if (pg_strncasecmp("double", value, vallen) == 0)
    5040           0 :         *linestyle = UNICODE_LINESTYLE_DOUBLE;
    5041             :     else
    5042           0 :         return false;
    5043           0 :     return true;
    5044             : }
    5045             : 
    5046             : static const char *
    5047          18 : _unicode_linestyle2string(int linestyle)
    5048             : {
    5049          18 :     switch (linestyle)
    5050             :     {
    5051          18 :         case UNICODE_LINESTYLE_SINGLE:
    5052          18 :             return "single";
    5053             :             break;
    5054           0 :         case UNICODE_LINESTYLE_DOUBLE:
    5055           0 :             return "double";
    5056             :             break;
    5057             :     }
    5058           0 :     return "unknown";
    5059             : }
    5060             : 
    5061             : /*
    5062             :  * do_pset
    5063             :  *
    5064             :  * Performs the assignment "param = value", where value could be NULL;
    5065             :  * for some params that has an effect such as inversion, for others
    5066             :  * it does nothing.
    5067             :  *
    5068             :  * Adjusts the state of the formatting options at *popt.  (In practice that
    5069             :  * is always pset.popt, but maybe someday it could be different.)
    5070             :  *
    5071             :  * If successful and quiet is false, then invokes printPsetInfo() to report
    5072             :  * the change.
    5073             :  *
    5074             :  * Returns true if successful, else false (eg for invalid param or value).
    5075             :  */
    5076             : bool
    5077        2008 : do_pset(const char *param, const char *value, printQueryOpt *popt, bool quiet)
    5078             : {
    5079        2008 :     size_t      vallen = 0;
    5080             : 
    5081             :     Assert(param != NULL);
    5082             : 
    5083        2008 :     if (value)
    5084        1858 :         vallen = strlen(value);
    5085             : 
    5086             :     /* set format */
    5087        2008 :     if (strcmp(param, "format") == 0)
    5088             :     {
    5089             :         static const struct fmt
    5090             :         {
    5091             :             const char *name;
    5092             :             enum printFormat number;
    5093             :         }           formats[] =
    5094             :         {
    5095             :             /* remember to update error message below when adding more */
    5096             :             {"aligned", PRINT_ALIGNED},
    5097             :             {"asciidoc", PRINT_ASCIIDOC},
    5098             :             {"csv", PRINT_CSV},
    5099             :             {"html", PRINT_HTML},
    5100             :             {"latex", PRINT_LATEX},
    5101             :             {"troff-ms", PRINT_TROFF_MS},
    5102             :             {"unaligned", PRINT_UNALIGNED},
    5103             :             {"wrapped", PRINT_WRAPPED}
    5104             :         };
    5105             : 
    5106         638 :         if (!value)
    5107             :             ;
    5108             :         else
    5109             :         {
    5110         638 :             int         match_pos = -1;
    5111             : 
    5112        5700 :             for (int i = 0; i < lengthof(formats); i++)
    5113             :             {
    5114        5068 :                 if (pg_strncasecmp(formats[i].name, value, vallen) == 0)
    5115             :                 {
    5116         638 :                     if (match_pos < 0)
    5117         632 :                         match_pos = i;
    5118             :                     else
    5119             :                     {
    5120           6 :                         pg_log_error("\\pset: ambiguous abbreviation \"%s\" matches both \"%s\" and \"%s\"",
    5121             :                                      value,
    5122             :                                      formats[match_pos].name, formats[i].name);
    5123           6 :                         return false;
    5124             :                     }
    5125             :                 }
    5126             :             }
    5127         632 :             if (match_pos >= 0)
    5128         626 :                 popt->topt.format = formats[match_pos].number;
    5129           6 :             else if (pg_strncasecmp("latex-longtable", value, vallen) == 0)
    5130             :             {
    5131             :                 /*
    5132             :                  * We must treat latex-longtable specially because latex is a
    5133             :                  * prefix of it; if both were in the table above, we'd think
    5134             :                  * "latex" is ambiguous.
    5135             :                  */
    5136           6 :                 popt->topt.format = PRINT_LATEX_LONGTABLE;
    5137             :             }
    5138             :             else
    5139             :             {
    5140           0 :                 pg_log_error("\\pset: allowed formats are aligned, asciidoc, csv, html, latex, latex-longtable, troff-ms, unaligned, wrapped");
    5141           0 :                 return false;
    5142             :             }
    5143             :         }
    5144             :     }
    5145             : 
    5146             :     /* set table line style */
    5147        1370 :     else if (strcmp(param, "linestyle") == 0)
    5148             :     {
    5149          30 :         if (!value)
    5150             :             ;
    5151          30 :         else if (pg_strncasecmp("ascii", value, vallen) == 0)
    5152          18 :             popt->topt.line_style = &pg_asciiformat;
    5153          12 :         else if (pg_strncasecmp("old-ascii", value, vallen) == 0)
    5154          12 :             popt->topt.line_style = &pg_asciiformat_old;
    5155           0 :         else if (pg_strncasecmp("unicode", value, vallen) == 0)
    5156           0 :             popt->topt.line_style = &pg_utf8format;
    5157             :         else
    5158             :         {
    5159           0 :             pg_log_error("\\pset: allowed line styles are ascii, old-ascii, unicode");
    5160           0 :             return false;
    5161             :         }
    5162             :     }
    5163             : 
    5164             :     /* set unicode border line style */
    5165        1340 :     else if (strcmp(param, "unicode_border_linestyle") == 0)
    5166             :     {
    5167           0 :         if (!value)
    5168             :             ;
    5169           0 :         else if (set_unicode_line_style(value, vallen,
    5170             :                                         &popt->topt.unicode_border_linestyle))
    5171           0 :             refresh_utf8format(&(popt->topt));
    5172             :         else
    5173             :         {
    5174           0 :             pg_log_error("\\pset: allowed Unicode border line styles are single, double");
    5175           0 :             return false;
    5176             :         }
    5177             :     }
    5178             : 
    5179             :     /* set unicode column line style */
    5180        1340 :     else if (strcmp(param, "unicode_column_linestyle") == 0)
    5181             :     {
    5182           0 :         if (!value)
    5183             :             ;
    5184           0 :         else if (set_unicode_line_style(value, vallen,
    5185             :                                         &popt->topt.unicode_column_linestyle))
    5186           0 :             refresh_utf8format(&(popt->topt));
    5187             :         else
    5188             :         {
    5189           0 :             pg_log_error("\\pset: allowed Unicode column line styles are single, double");
    5190           0 :             return false;
    5191             :         }
    5192             :     }
    5193             : 
    5194             :     /* set unicode header line style */
    5195        1340 :     else if (strcmp(param, "unicode_header_linestyle") == 0)
    5196             :     {
    5197           0 :         if (!value)
    5198             :             ;
    5199           0 :         else if (set_unicode_line_style(value, vallen,
    5200             :                                         &popt->topt.unicode_header_linestyle))
    5201           0 :             refresh_utf8format(&(popt->topt));
    5202             :         else
    5203             :         {
    5204           0 :             pg_log_error("\\pset: allowed Unicode header line styles are single, double");
    5205           0 :             return false;
    5206             :         }
    5207             :     }
    5208             : 
    5209             :     /* set border style/width */
    5210        1340 :     else if (strcmp(param, "border") == 0)
    5211             :     {
    5212         402 :         if (value)
    5213         402 :             popt->topt.border = atoi(value);
    5214             :     }
    5215             : 
    5216             :     /* set expanded/vertical mode */
    5217         938 :     else if (strcmp(param, "x") == 0 ||
    5218         938 :              strcmp(param, "expanded") == 0 ||
    5219         606 :              strcmp(param, "vertical") == 0)
    5220             :     {
    5221         332 :         if (value && pg_strcasecmp(value, "auto") == 0)
    5222           0 :             popt->topt.expanded = 2;
    5223         332 :         else if (value)
    5224             :         {
    5225             :             bool        on_off;
    5226             : 
    5227         260 :             if (ParseVariableBool(value, NULL, &on_off))
    5228         260 :                 popt->topt.expanded = on_off ? 1 : 0;
    5229             :             else
    5230             :             {
    5231           0 :                 PsqlVarEnumError(param, value, "on, off, auto");
    5232           0 :                 return false;
    5233             :             }
    5234             :         }
    5235             :         else
    5236          72 :             popt->topt.expanded = !popt->topt.expanded;
    5237             :     }
    5238             : 
    5239             :     /* header line width in expanded mode */
    5240         606 :     else if (strcmp(param, "xheader_width") == 0)
    5241             :     {
    5242           0 :         if (!value)
    5243             :             ;
    5244           0 :         else if (pg_strcasecmp(value, "full") == 0)
    5245           0 :             popt->topt.expanded_header_width_type = PRINT_XHEADER_FULL;
    5246           0 :         else if (pg_strcasecmp(value, "column") == 0)
    5247           0 :             popt->topt.expanded_header_width_type = PRINT_XHEADER_COLUMN;
    5248           0 :         else if (pg_strcasecmp(value, "page") == 0)
    5249           0 :             popt->topt.expanded_header_width_type = PRINT_XHEADER_PAGE;
    5250             :         else
    5251             :         {
    5252           0 :             int         intval = atoi(value);
    5253             : 
    5254           0 :             if (intval == 0)
    5255             :             {
    5256           0 :                 pg_log_error("\\pset: allowed xheader_width values are \"%s\" (default), \"%s\", \"%s\", or a number specifying the exact width", "full", "column", "page");
    5257           0 :                 return false;
    5258             :             }
    5259             : 
    5260           0 :             popt->topt.expanded_header_width_type = PRINT_XHEADER_EXACT_WIDTH;
    5261           0 :             popt->topt.expanded_header_exact_width = intval;
    5262             :         }
    5263             :     }
    5264             : 
    5265             :     /* field separator for CSV format */
    5266         606 :     else if (strcmp(param, "csv_fieldsep") == 0)
    5267             :     {
    5268          60 :         if (value)
    5269             :         {
    5270             :             /* CSV separator has to be a one-byte character */
    5271          60 :             if (strlen(value) != 1)
    5272             :             {
    5273          18 :                 pg_log_error("\\pset: csv_fieldsep must be a single one-byte character");
    5274          18 :                 return false;
    5275             :             }
    5276          42 :             if (value[0] == '"' || value[0] == '\n' || value[0] == '\r')
    5277             :             {
    5278          18 :                 pg_log_error("\\pset: csv_fieldsep cannot be a double quote, a newline, or a carriage return");
    5279          18 :                 return false;
    5280             :             }
    5281          24 :             popt->topt.csvFieldSep[0] = value[0];
    5282             :         }
    5283             :     }
    5284             : 
    5285             :     /* locale-aware numeric output */
    5286         546 :     else if (strcmp(param, "numericlocale") == 0)
    5287             :     {
    5288          12 :         if (value)
    5289          12 :             return ParseVariableBool(value, param, &popt->topt.numericLocale);
    5290             :         else
    5291           0 :             popt->topt.numericLocale = !popt->topt.numericLocale;
    5292             :     }
    5293             : 
    5294             :     /* null display */
    5295         534 :     else if (strcmp(param, "null") == 0)
    5296             :     {
    5297          96 :         if (value)
    5298             :         {
    5299          90 :             free(popt->nullPrint);
    5300          90 :             popt->nullPrint = pg_strdup(value);
    5301             :         }
    5302             :     }
    5303             : 
    5304             :     /* 'false' display */
    5305         438 :     else if (strcmp(param, "display_false") == 0)
    5306             :     {
    5307          18 :         if (value)
    5308             :         {
    5309          12 :             free(popt->falsePrint);
    5310          12 :             popt->falsePrint = pg_strdup(value);
    5311             :         }
    5312             :     }
    5313             : 
    5314             :     /* 'true' display */
    5315         420 :     else if (strcmp(param, "display_true") == 0)
    5316             :     {
    5317          18 :         if (value)
    5318             :         {
    5319          12 :             free(popt->truePrint);
    5320          12 :             popt->truePrint = pg_strdup(value);
    5321             :         }
    5322             :     }
    5323             : 
    5324             :     /* field separator for unaligned text */
    5325         402 :     else if (strcmp(param, "fieldsep") == 0)
    5326             :     {
    5327           6 :         if (value)
    5328             :         {
    5329           6 :             free(popt->topt.fieldSep.separator);
    5330           6 :             popt->topt.fieldSep.separator = pg_strdup(value);
    5331           6 :             popt->topt.fieldSep.separator_zero = false;
    5332             :         }
    5333             :     }
    5334             : 
    5335         396 :     else if (strcmp(param, "fieldsep_zero") == 0)
    5336             :     {
    5337           0 :         free(popt->topt.fieldSep.separator);
    5338           0 :         popt->topt.fieldSep.separator = NULL;
    5339           0 :         popt->topt.fieldSep.separator_zero = true;
    5340             :     }
    5341             : 
    5342             :     /* record separator for unaligned text */
    5343         396 :     else if (strcmp(param, "recordsep") == 0)
    5344             :     {
    5345           0 :         if (value)
    5346             :         {
    5347           0 :             free(popt->topt.recordSep.separator);
    5348           0 :             popt->topt.recordSep.separator = pg_strdup(value);
    5349           0 :             popt->topt.recordSep.separator_zero = false;
    5350             :         }
    5351             :     }
    5352             : 
    5353         396 :     else if (strcmp(param, "recordsep_zero") == 0)
    5354             :     {
    5355           0 :         free(popt->topt.recordSep.separator);
    5356           0 :         popt->topt.recordSep.separator = NULL;
    5357           0 :         popt->topt.recordSep.separator_zero = true;
    5358             :     }
    5359             : 
    5360             :     /* toggle between full and tuples-only format */
    5361         396 :     else if (strcmp(param, "t") == 0 || strcmp(param, "tuples_only") == 0)
    5362             :     {
    5363         294 :         if (value)
    5364         258 :             return ParseVariableBool(value, param, &popt->topt.tuples_only);
    5365             :         else
    5366          36 :             popt->topt.tuples_only = !popt->topt.tuples_only;
    5367             :     }
    5368             : 
    5369             :     /* set title override */
    5370         102 :     else if (strcmp(param, "C") == 0 || strcmp(param, "title") == 0)
    5371             :     {
    5372           6 :         free(popt->title);
    5373           6 :         if (!value)
    5374           0 :             popt->title = NULL;
    5375             :         else
    5376           6 :             popt->title = pg_strdup(value);
    5377             :     }
    5378             : 
    5379             :     /* set HTML table tag options */
    5380          96 :     else if (strcmp(param, "T") == 0 || strcmp(param, "tableattr") == 0)
    5381             :     {
    5382          48 :         free(popt->topt.tableAttr);
    5383          48 :         if (!value)
    5384          24 :             popt->topt.tableAttr = NULL;
    5385             :         else
    5386          24 :             popt->topt.tableAttr = pg_strdup(value);
    5387             :     }
    5388             : 
    5389             :     /* toggle use of pager */
    5390          48 :     else if (strcmp(param, "pager") == 0)
    5391             :     {
    5392           0 :         if (value && pg_strcasecmp(value, "always") == 0)
    5393           0 :             popt->topt.pager = 2;
    5394           0 :         else if (value)
    5395             :         {
    5396             :             bool        on_off;
    5397             : 
    5398           0 :             if (!ParseVariableBool(value, NULL, &on_off))
    5399             :             {
    5400           0 :                 PsqlVarEnumError(param, value, "on, off, always");
    5401           0 :                 return false;
    5402             :             }
    5403           0 :             popt->topt.pager = on_off ? 1 : 0;
    5404             :         }
    5405           0 :         else if (popt->topt.pager == 1)
    5406           0 :             popt->topt.pager = 0;
    5407             :         else
    5408           0 :             popt->topt.pager = 1;
    5409             :     }
    5410             : 
    5411             :     /* set minimum lines for pager use */
    5412          48 :     else if (strcmp(param, "pager_min_lines") == 0)
    5413             :     {
    5414           0 :         if (value &&
    5415           0 :             !ParseVariableNum(value, "pager_min_lines", &popt->topt.pager_min_lines))
    5416           0 :             return false;
    5417             :     }
    5418             : 
    5419             :     /* disable "(x rows)" footer */
    5420          48 :     else if (strcmp(param, "footer") == 0)
    5421             :     {
    5422           0 :         if (value)
    5423           0 :             return ParseVariableBool(value, param, &popt->topt.default_footer);
    5424             :         else
    5425           0 :             popt->topt.default_footer = !popt->topt.default_footer;
    5426             :     }
    5427             : 
    5428             :     /* set border style/width */
    5429          48 :     else if (strcmp(param, "columns") == 0)
    5430             :     {
    5431          48 :         if (value)
    5432          48 :             popt->topt.columns = atoi(value);
    5433             :     }
    5434             :     else
    5435             :     {
    5436           0 :         pg_log_error("\\pset: unknown option: %s", param);
    5437           0 :         return false;
    5438             :     }
    5439             : 
    5440        1696 :     if (!quiet)
    5441           2 :         printPsetInfo(param, &pset.popt);
    5442             : 
    5443        1696 :     return true;
    5444             : }
    5445             : 
    5446             : /*
    5447             :  * printPsetInfo: print the state of the "param" formatting parameter in popt.
    5448             :  */
    5449             : static bool
    5450           2 : printPsetInfo(const char *param, printQueryOpt *popt)
    5451             : {
    5452             :     Assert(param != NULL);
    5453             : 
    5454             :     /* show border style/width */
    5455           2 :     if (strcmp(param, "border") == 0)
    5456           0 :         printf(_("Border style is %d.\n"), popt->topt.border);
    5457             : 
    5458             :     /* show the target width for the wrapped format */
    5459           2 :     else if (strcmp(param, "columns") == 0)
    5460             :     {
    5461           0 :         if (!popt->topt.columns)
    5462           0 :             printf(_("Target width is unset.\n"));
    5463             :         else
    5464           0 :             printf(_("Target width is %d.\n"), popt->topt.columns);
    5465             :     }
    5466             : 
    5467             :     /* show expanded/vertical mode */
    5468           2 :     else if (strcmp(param, "x") == 0 || strcmp(param, "expanded") == 0 || strcmp(param, "vertical") == 0)
    5469             :     {
    5470           2 :         if (popt->topt.expanded == 1)
    5471           2 :             printf(_("Expanded display is on.\n"));
    5472           0 :         else if (popt->topt.expanded == 2)
    5473           0 :             printf(_("Expanded display is used automatically.\n"));
    5474             :         else
    5475           0 :             printf(_("Expanded display is off.\n"));
    5476             :     }
    5477             : 
    5478             :     /* show xheader width value */
    5479           0 :     else if (strcmp(param, "xheader_width") == 0)
    5480             :     {
    5481           0 :         if (popt->topt.expanded_header_width_type == PRINT_XHEADER_FULL)
    5482           0 :             printf(_("Expanded header width is \"%s\".\n"), "full");
    5483           0 :         else if (popt->topt.expanded_header_width_type == PRINT_XHEADER_COLUMN)
    5484           0 :             printf(_("Expanded header width is \"%s\".\n"), "column");
    5485           0 :         else if (popt->topt.expanded_header_width_type == PRINT_XHEADER_PAGE)
    5486           0 :             printf(_("Expanded header width is \"%s\".\n"), "page");
    5487           0 :         else if (popt->topt.expanded_header_width_type == PRINT_XHEADER_EXACT_WIDTH)
    5488           0 :             printf(_("Expanded header width is %d.\n"), popt->topt.expanded_header_exact_width);
    5489             :     }
    5490             : 
    5491             :     /* show field separator for CSV format */
    5492           0 :     else if (strcmp(param, "csv_fieldsep") == 0)
    5493             :     {
    5494           0 :         printf(_("Field separator for CSV is \"%s\".\n"),
    5495             :                popt->topt.csvFieldSep);
    5496             :     }
    5497             : 
    5498             :     /* show boolean 'false' display */
    5499           0 :     else if (strcmp(param, "display_false") == 0)
    5500             :     {
    5501           0 :         printf(_("Boolean false display is \"%s\".\n"),
    5502             :                popt->falsePrint ? popt->falsePrint : "f");
    5503             :     }
    5504             : 
    5505             :     /* show boolean 'true' display */
    5506           0 :     else if (strcmp(param, "display_true") == 0)
    5507             :     {
    5508           0 :         printf(_("Boolean true display is \"%s\".\n"),
    5509             :                popt->truePrint ? popt->truePrint : "t");
    5510             :     }
    5511             : 
    5512             :     /* show field separator for unaligned text */
    5513           0 :     else if (strcmp(param, "fieldsep") == 0)
    5514             :     {
    5515           0 :         if (popt->topt.fieldSep.separator_zero)
    5516           0 :             printf(_("Field separator is zero byte.\n"));
    5517             :         else
    5518           0 :             printf(_("Field separator is \"%s\".\n"),
    5519             :                    popt->topt.fieldSep.separator);
    5520             :     }
    5521             : 
    5522           0 :     else if (strcmp(param, "fieldsep_zero") == 0)
    5523             :     {
    5524           0 :         printf(_("Field separator is zero byte.\n"));
    5525             :     }
    5526             : 
    5527             :     /* show disable "(x rows)" footer */
    5528           0 :     else if (strcmp(param, "footer") == 0)
    5529             :     {
    5530           0 :         if (popt->topt.default_footer)
    5531           0 :             printf(_("Default footer is on.\n"));
    5532             :         else
    5533           0 :             printf(_("Default footer is off.\n"));
    5534             :     }
    5535             : 
    5536             :     /* show format */
    5537           0 :     else if (strcmp(param, "format") == 0)
    5538             :     {
    5539           0 :         printf(_("Output format is %s.\n"), _align2string(popt->topt.format));
    5540             :     }
    5541             : 
    5542             :     /* show table line style */
    5543           0 :     else if (strcmp(param, "linestyle") == 0)
    5544             :     {
    5545           0 :         printf(_("Line style is %s.\n"),
    5546             :                get_line_style(&popt->topt)->name);
    5547             :     }
    5548             : 
    5549             :     /* show null display */
    5550           0 :     else if (strcmp(param, "null") == 0)
    5551             :     {
    5552           0 :         printf(_("Null display is \"%s\".\n"),
    5553             :                popt->nullPrint ? popt->nullPrint : "");
    5554             :     }
    5555             : 
    5556             :     /* show locale-aware numeric output */
    5557           0 :     else if (strcmp(param, "numericlocale") == 0)
    5558             :     {
    5559           0 :         if (popt->topt.numericLocale)
    5560           0 :             printf(_("Locale-adjusted numeric output is on.\n"));
    5561             :         else
    5562           0 :             printf(_("Locale-adjusted numeric output is off.\n"));
    5563             :     }
    5564             : 
    5565             :     /* show toggle use of pager */
    5566           0 :     else if (strcmp(param, "pager") == 0)
    5567             :     {
    5568           0 :         if (popt->topt.pager == 1)
    5569           0 :             printf(_("Pager is used for long output.\n"));
    5570           0 :         else if (popt->topt.pager == 2)
    5571           0 :             printf(_("Pager is always used.\n"));
    5572             :         else
    5573           0 :             printf(_("Pager usage is off.\n"));
    5574             :     }
    5575             : 
    5576             :     /* show minimum lines for pager use */
    5577           0 :     else if (strcmp(param, "pager_min_lines") == 0)
    5578             :     {
    5579           0 :         printf(ngettext("Pager won't be used for less than %d line.\n",
    5580             :                         "Pager won't be used for less than %d lines.\n",
    5581             :                         popt->topt.pager_min_lines),
    5582             :                popt->topt.pager_min_lines);
    5583             :     }
    5584             : 
    5585             :     /* show record separator for unaligned text */
    5586           0 :     else if (strcmp(param, "recordsep") == 0)
    5587             :     {
    5588           0 :         if (popt->topt.recordSep.separator_zero)
    5589           0 :             printf(_("Record separator is zero byte.\n"));
    5590           0 :         else if (strcmp(popt->topt.recordSep.separator, "\n") == 0)
    5591           0 :             printf(_("Record separator is <newline>.\n"));
    5592             :         else
    5593           0 :             printf(_("Record separator is \"%s\".\n"),
    5594             :                    popt->topt.recordSep.separator);
    5595             :     }
    5596             : 
    5597           0 :     else if (strcmp(param, "recordsep_zero") == 0)
    5598             :     {
    5599           0 :         printf(_("Record separator is zero byte.\n"));
    5600             :     }
    5601             : 
    5602             :     /* show HTML table tag options */
    5603           0 :     else if (strcmp(param, "T") == 0 || strcmp(param, "tableattr") == 0)
    5604             :     {
    5605           0 :         if (popt->topt.tableAttr)
    5606           0 :             printf(_("Table attributes are \"%s\".\n"),
    5607             :                    popt->topt.tableAttr);
    5608             :         else
    5609           0 :             printf(_("Table attributes unset.\n"));
    5610             :     }
    5611             : 
    5612             :     /* show title override */
    5613           0 :     else if (strcmp(param, "C") == 0 || strcmp(param, "title") == 0)
    5614             :     {
    5615           0 :         if (popt->title)
    5616           0 :             printf(_("Title is \"%s\".\n"), popt->title);
    5617             :         else
    5618           0 :             printf(_("Title is unset.\n"));
    5619             :     }
    5620             : 
    5621             :     /* show toggle between full and tuples-only format */
    5622           0 :     else if (strcmp(param, "t") == 0 || strcmp(param, "tuples_only") == 0)
    5623             :     {
    5624           0 :         if (popt->topt.tuples_only)
    5625           0 :             printf(_("Tuples only is on.\n"));
    5626             :         else
    5627           0 :             printf(_("Tuples only is off.\n"));
    5628             :     }
    5629             : 
    5630             :     /* Unicode style formatting */
    5631           0 :     else if (strcmp(param, "unicode_border_linestyle") == 0)
    5632             :     {
    5633           0 :         printf(_("Unicode border line style is \"%s\".\n"),
    5634             :                _unicode_linestyle2string(popt->topt.unicode_border_linestyle));
    5635             :     }
    5636             : 
    5637           0 :     else if (strcmp(param, "unicode_column_linestyle") == 0)
    5638             :     {
    5639           0 :         printf(_("Unicode column line style is \"%s\".\n"),
    5640             :                _unicode_linestyle2string(popt->topt.unicode_column_linestyle));
    5641             :     }
    5642             : 
    5643           0 :     else if (strcmp(param, "unicode_header_linestyle") == 0)
    5644             :     {
    5645           0 :         printf(_("Unicode header line style is \"%s\".\n"),
    5646             :                _unicode_linestyle2string(popt->topt.unicode_header_linestyle));
    5647             :     }
    5648             : 
    5649             :     else
    5650             :     {
    5651           0 :         pg_log_error("\\pset: unknown option: %s", param);
    5652           0 :         return false;
    5653             :     }
    5654             : 
    5655           2 :     return true;
    5656             : }
    5657             : 
    5658             : /*
    5659             :  * savePsetInfo: make a malloc'd copy of the data in *popt.
    5660             :  *
    5661             :  * Possibly this should be somewhere else, but it's a bit specific to psql.
    5662             :  */
    5663             : printQueryOpt *
    5664          42 : savePsetInfo(const printQueryOpt *popt)
    5665             : {
    5666             :     printQueryOpt *save;
    5667             : 
    5668          42 :     save = (printQueryOpt *) pg_malloc(sizeof(printQueryOpt));
    5669             : 
    5670             :     /* Flat-copy all the scalar fields, then duplicate sub-structures. */
    5671          42 :     memcpy(save, popt, sizeof(printQueryOpt));
    5672             : 
    5673             :     /* topt.line_style points to const data that need not be duplicated */
    5674          42 :     if (popt->topt.fieldSep.separator)
    5675          42 :         save->topt.fieldSep.separator = pg_strdup(popt->topt.fieldSep.separator);
    5676          42 :     if (popt->topt.recordSep.separator)
    5677          42 :         save->topt.recordSep.separator = pg_strdup(popt->topt.recordSep.separator);
    5678          42 :     if (popt->topt.tableAttr)
    5679           0 :         save->topt.tableAttr = pg_strdup(popt->topt.tableAttr);
    5680          42 :     if (popt->nullPrint)
    5681           0 :         save->nullPrint = pg_strdup(popt->nullPrint);
    5682          42 :     if (popt->title)
    5683           0 :         save->title = pg_strdup(popt->title);
    5684             : 
    5685             :     /*
    5686             :      * footers and translate_columns are never set in psql's print settings,
    5687             :      * so we needn't write code to duplicate them.
    5688             :      */
    5689             :     Assert(popt->footers == NULL);
    5690             :     Assert(popt->translate_columns == NULL);
    5691             : 
    5692          42 :     return save;
    5693             : }
    5694             : 
    5695             : /*
    5696             :  * restorePsetInfo: restore *popt from the previously-saved copy *save,
    5697             :  * then free *save.
    5698             :  */
    5699             : void
    5700          42 : restorePsetInfo(printQueryOpt *popt, printQueryOpt *save)
    5701             : {
    5702             :     /* Free all the old data we're about to overwrite the pointers to. */
    5703             : 
    5704             :     /* topt.line_style points to const data that need not be duplicated */
    5705          42 :     free(popt->topt.fieldSep.separator);
    5706          42 :     free(popt->topt.recordSep.separator);
    5707          42 :     free(popt->topt.tableAttr);
    5708          42 :     free(popt->nullPrint);
    5709          42 :     free(popt->title);
    5710             : 
    5711             :     /*
    5712             :      * footers and translate_columns are never set in psql's print settings,
    5713             :      * so we needn't write code to duplicate them.
    5714             :      */
    5715             :     Assert(popt->footers == NULL);
    5716             :     Assert(popt->translate_columns == NULL);
    5717             : 
    5718             :     /* Now we may flat-copy all the fields, including pointers. */
    5719          42 :     memcpy(popt, save, sizeof(printQueryOpt));
    5720             : 
    5721             :     /* Lastly, free "save" ... but its sub-structures now belong to popt. */
    5722          42 :     free(save);
    5723          42 : }
    5724             : 
    5725             : static const char *
    5726          36 : pset_bool_string(bool val)
    5727             : {
    5728          36 :     return val ? "on" : "off";
    5729             : }
    5730             : 
    5731             : 
    5732             : static char *
    5733          36 : pset_quoted_string(const char *str)
    5734             : {
    5735          36 :     char       *ret = pg_malloc(strlen(str) * 2 + 3);
    5736          36 :     char       *r = ret;
    5737             : 
    5738          36 :     *r++ = '\'';
    5739             : 
    5740          66 :     for (; *str; str++)
    5741             :     {
    5742          30 :         if (*str == '\n')
    5743             :         {
    5744           6 :             *r++ = '\\';
    5745           6 :             *r++ = 'n';
    5746             :         }
    5747          24 :         else if (*str == '\'')
    5748             :         {
    5749           0 :             *r++ = '\\';
    5750           0 :             *r++ = '\'';
    5751             :         }
    5752             :         else
    5753          24 :             *r++ = *str;
    5754             :     }
    5755             : 
    5756          36 :     *r++ = '\'';
    5757          36 :     *r = '\0';
    5758             : 
    5759          36 :     return ret;
    5760             : }
    5761             : 
    5762             : 
    5763             : /*
    5764             :  * Return a malloc'ed string for the \pset value.
    5765             :  *
    5766             :  * Note that for some string parameters, print.c distinguishes between unset
    5767             :  * and empty string, but for others it doesn't.  This function should produce
    5768             :  * output that produces the correct setting when fed back into \pset.
    5769             :  */
    5770             : static char *
    5771         144 : pset_value_string(const char *param, printQueryOpt *popt)
    5772             : {
    5773             :     Assert(param != NULL);
    5774             : 
    5775         144 :     if (strcmp(param, "border") == 0)
    5776           6 :         return psprintf("%d", popt->topt.border);
    5777         138 :     else if (strcmp(param, "columns") == 0)
    5778           6 :         return psprintf("%d", popt->topt.columns);
    5779         132 :     else if (strcmp(param, "csv_fieldsep") == 0)
    5780           6 :         return pset_quoted_string(popt->topt.csvFieldSep);
    5781         126 :     else if (strcmp(param, "display_false") == 0)
    5782           6 :         return pset_quoted_string(popt->falsePrint ? popt->falsePrint : "f");
    5783         120 :     else if (strcmp(param, "display_true") == 0)
    5784           6 :         return pset_quoted_string(popt->truePrint ? popt->truePrint : "t");
    5785         114 :     else if (strcmp(param, "expanded") == 0)
    5786          12 :         return pstrdup(popt->topt.expanded == 2
    5787             :                        ? "auto"
    5788           6 :                        : pset_bool_string(popt->topt.expanded));
    5789         108 :     else if (strcmp(param, "fieldsep") == 0)
    5790           6 :         return pset_quoted_string(popt->topt.fieldSep.separator
    5791             :                                   ? popt->topt.fieldSep.separator
    5792             :                                   : "");
    5793         102 :     else if (strcmp(param, "fieldsep_zero") == 0)
    5794           6 :         return pstrdup(pset_bool_string(popt->topt.fieldSep.separator_zero));
    5795          96 :     else if (strcmp(param, "footer") == 0)
    5796           6 :         return pstrdup(pset_bool_string(popt->topt.default_footer));
    5797          90 :     else if (strcmp(param, "format") == 0)
    5798           6 :         return pstrdup(_align2string(popt->topt.format));
    5799          84 :     else if (strcmp(param, "linestyle") == 0)
    5800           6 :         return pstrdup(get_line_style(&popt->topt)->name);
    5801          78 :     else if (strcmp(param, "null") == 0)
    5802           6 :         return pset_quoted_string(popt->nullPrint
    5803             :                                   ? popt->nullPrint
    5804             :                                   : "");
    5805          72 :     else if (strcmp(param, "numericlocale") == 0)
    5806           6 :         return pstrdup(pset_bool_string(popt->topt.numericLocale));
    5807          66 :     else if (strcmp(param, "pager") == 0)
    5808           6 :         return psprintf("%d", popt->topt.pager);
    5809          60 :     else if (strcmp(param, "pager_min_lines") == 0)
    5810           6 :         return psprintf("%d", popt->topt.pager_min_lines);
    5811          54 :     else if (strcmp(param, "recordsep") == 0)
    5812           6 :         return pset_quoted_string(popt->topt.recordSep.separator
    5813             :                                   ? popt->topt.recordSep.separator
    5814             :                                   : "");
    5815          48 :     else if (strcmp(param, "recordsep_zero") == 0)
    5816           6 :         return pstrdup(pset_bool_string(popt->topt.recordSep.separator_zero));
    5817          42 :     else if (strcmp(param, "tableattr") == 0)
    5818           6 :         return popt->topt.tableAttr ? pset_quoted_string(popt->topt.tableAttr) : pstrdup("");
    5819          36 :     else if (strcmp(param, "title") == 0)
    5820           6 :         return popt->title ? pset_quoted_string(popt->title) : pstrdup("");
    5821          30 :     else if (strcmp(param, "tuples_only") == 0)
    5822           6 :         return pstrdup(pset_bool_string(popt->topt.tuples_only));
    5823          24 :     else if (strcmp(param, "unicode_border_linestyle") == 0)
    5824           6 :         return pstrdup(_unicode_linestyle2string(popt->topt.unicode_border_linestyle));
    5825          18 :     else if (strcmp(param, "unicode_column_linestyle") == 0)
    5826           6 :         return pstrdup(_unicode_linestyle2string(popt->topt.unicode_column_linestyle));
    5827          12 :     else if (strcmp(param, "unicode_header_linestyle") == 0)
    5828           6 :         return pstrdup(_unicode_linestyle2string(popt->topt.unicode_header_linestyle));
    5829           6 :     else if (strcmp(param, "xheader_width") == 0)
    5830             :     {
    5831           6 :         if (popt->topt.expanded_header_width_type == PRINT_XHEADER_FULL)
    5832           6 :             return pstrdup("full");
    5833           0 :         else if (popt->topt.expanded_header_width_type == PRINT_XHEADER_COLUMN)
    5834           0 :             return pstrdup("column");
    5835           0 :         else if (popt->topt.expanded_header_width_type == PRINT_XHEADER_PAGE)
    5836           0 :             return pstrdup("page");
    5837             :         else
    5838             :         {
    5839             :             /* must be PRINT_XHEADER_EXACT_WIDTH */
    5840             :             char        wbuff[32];
    5841             : 
    5842           0 :             snprintf(wbuff, sizeof(wbuff), "%d",
    5843             :                      popt->topt.expanded_header_exact_width);
    5844           0 :             return pstrdup(wbuff);
    5845             :         }
    5846             :     }
    5847             :     else
    5848           0 :         return pstrdup("ERROR");
    5849             : }
    5850             : 
    5851             : 
    5852             : 
    5853             : #ifndef WIN32
    5854             : #define DEFAULT_SHELL "/bin/sh"
    5855             : #else
    5856             : /*
    5857             :  *  CMD.EXE is in different places in different Win32 releases so we
    5858             :  *  have to rely on the path to find it.
    5859             :  */
    5860             : #define DEFAULT_SHELL "cmd.exe"
    5861             : #endif
    5862             : 
    5863             : static bool
    5864           0 : do_shell(const char *command)
    5865             : {
    5866             :     int         result;
    5867             : 
    5868           0 :     fflush(NULL);
    5869           0 :     if (!command)
    5870             :     {
    5871             :         char       *sys;
    5872             :         const char *shellName;
    5873             : 
    5874           0 :         shellName = getenv("SHELL");
    5875             : #ifdef WIN32
    5876             :         if (shellName == NULL)
    5877             :             shellName = getenv("COMSPEC");
    5878             : #endif
    5879           0 :         if (shellName == NULL)
    5880           0 :             shellName = DEFAULT_SHELL;
    5881             : 
    5882             :         /* See EDITOR handling comment for an explanation */
    5883             : #ifndef WIN32
    5884           0 :         sys = psprintf("exec %s", shellName);
    5885             : #else
    5886             :         sys = psprintf("\"%s\"", shellName);
    5887             : #endif
    5888           0 :         result = system(sys);
    5889           0 :         free(sys);
    5890             :     }
    5891             :     else
    5892           0 :         result = system(command);
    5893             : 
    5894           0 :     SetShellResultVariables(result);
    5895             : 
    5896           0 :     if (result == 127 || result == -1)
    5897             :     {
    5898           0 :         pg_log_error("\\!: failed");
    5899           0 :         return false;
    5900             :     }
    5901           0 :     return true;
    5902             : }
    5903             : 
    5904             : /*
    5905             :  * do_watch -- handler for \watch
    5906             :  *
    5907             :  * We break this out of exec_command to avoid having to plaster "volatile"
    5908             :  * onto a bunch of exec_command's variables to silence stupider compilers.
    5909             :  *
    5910             :  * "sleep" is the amount of time to sleep during each loop, measured in
    5911             :  * seconds.  The internals of this function should use "sleep_ms" for
    5912             :  * precise sleep time calculations.
    5913             :  */
    5914             : static bool
    5915          14 : do_watch(PQExpBuffer query_buf, double sleep, int iter, int min_rows)
    5916             : {
    5917          14 :     long        sleep_ms = (long) (sleep * 1000);
    5918          14 :     printQueryOpt myopt = pset.popt;
    5919             :     const char *strftime_fmt;
    5920             :     const char *user_title;
    5921             :     char       *title;
    5922          14 :     const char *pagerprog = NULL;
    5923          14 :     FILE       *pagerpipe = NULL;
    5924             :     int         title_len;
    5925          14 :     int         res = 0;
    5926          14 :     bool        done = false;
    5927             : #ifndef WIN32
    5928             :     sigset_t    sigalrm_sigchld_sigint;
    5929             :     sigset_t    sigalrm_sigchld;
    5930             :     sigset_t    sigint;
    5931             :     struct itimerval interval;
    5932             : #endif
    5933             : 
    5934          14 :     if (!query_buf || query_buf->len <= 0)
    5935             :     {
    5936           0 :         pg_log_error("\\watch cannot be used with an empty query");
    5937           0 :         return false;
    5938             :     }
    5939             : 
    5940             : #ifndef WIN32
    5941          14 :     sigemptyset(&sigalrm_sigchld_sigint);
    5942          14 :     sigaddset(&sigalrm_sigchld_sigint, SIGCHLD);
    5943          14 :     sigaddset(&sigalrm_sigchld_sigint, SIGALRM);
    5944          14 :     sigaddset(&sigalrm_sigchld_sigint, SIGINT);
    5945             : 
    5946          14 :     sigemptyset(&sigalrm_sigchld);
    5947          14 :     sigaddset(&sigalrm_sigchld, SIGCHLD);
    5948          14 :     sigaddset(&sigalrm_sigchld, SIGALRM);
    5949             : 
    5950          14 :     sigemptyset(&sigint);
    5951          14 :     sigaddset(&sigint, SIGINT);
    5952             : 
    5953             :     /*
    5954             :      * Block SIGALRM and SIGCHLD before we start the timer and the pager (if
    5955             :      * configured), to avoid races.  sigwait() will receive them.
    5956             :      */
    5957          14 :     sigprocmask(SIG_BLOCK, &sigalrm_sigchld, NULL);
    5958             : 
    5959             :     /*
    5960             :      * Set a timer to interrupt sigwait() so we can run the query at the
    5961             :      * requested intervals.
    5962             :      */
    5963          14 :     interval.it_value.tv_sec = sleep_ms / 1000;
    5964          14 :     interval.it_value.tv_usec = (sleep_ms % 1000) * 1000;
    5965          14 :     interval.it_interval = interval.it_value;
    5966          14 :     if (setitimer(ITIMER_REAL, &interval, NULL) < 0)
    5967             :     {
    5968           0 :         pg_log_error("could not set timer: %m");
    5969           0 :         done = true;
    5970             :     }
    5971             : #endif
    5972             : 
    5973             :     /*
    5974             :      * For \watch, we ignore the size of the result and always use the pager
    5975             :      * as long as we're talking to a terminal and "\pset pager" is enabled.
    5976             :      * However, we'll only use the pager identified by PSQL_WATCH_PAGER.  We
    5977             :      * ignore the regular PSQL_PAGER or PAGER environment variables, because
    5978             :      * traditional pagers probably won't be very useful for showing a stream
    5979             :      * of results.
    5980             :      */
    5981             : #ifndef WIN32
    5982          14 :     pagerprog = getenv("PSQL_WATCH_PAGER");
    5983             :     /* if variable is empty or all-white-space, don't use pager */
    5984          14 :     if (pagerprog && strspn(pagerprog, " \t\r\n") == strlen(pagerprog))
    5985           0 :         pagerprog = NULL;
    5986             : #endif
    5987          14 :     if (pagerprog && myopt.topt.pager &&
    5988           0 :         isatty(fileno(stdin)) && isatty(fileno(stdout)))
    5989             :     {
    5990           0 :         fflush(NULL);
    5991           0 :         disable_sigpipe_trap();
    5992           0 :         pagerpipe = popen(pagerprog, "w");
    5993             : 
    5994           0 :         if (!pagerpipe)
    5995             :             /* silently proceed without pager */
    5996           0 :             restore_sigpipe_trap();
    5997             :     }
    5998             : 
    5999             :     /*
    6000             :      * Choose format for timestamps.  We might eventually make this a \pset
    6001             :      * option.  In the meantime, using a variable for the format suppresses
    6002             :      * overly-anal-retentive gcc warnings about %c being Y2K sensitive.
    6003             :      */
    6004          14 :     strftime_fmt = "%c";
    6005             : 
    6006             :     /*
    6007             :      * Set up rendering options, in particular, disable the pager unless
    6008             :      * PSQL_WATCH_PAGER was successfully launched.
    6009             :      */
    6010          14 :     if (!pagerpipe)
    6011          14 :         myopt.topt.pager = 0;
    6012             : 
    6013             :     /*
    6014             :      * If there's a title in the user configuration, make sure we have room
    6015             :      * for it in the title buffer.  Allow 128 bytes for the timestamp plus 128
    6016             :      * bytes for the rest.
    6017             :      */
    6018          14 :     user_title = myopt.title;
    6019          14 :     title_len = (user_title ? strlen(user_title) : 0) + 256;
    6020          14 :     title = pg_malloc(title_len);
    6021             : 
    6022             :     /* Loop to run query and then sleep awhile */
    6023         766 :     while (!done)
    6024             :     {
    6025             :         time_t      timer;
    6026             :         char        timebuf[128];
    6027             : 
    6028             :         /*
    6029             :          * Prepare title for output.  Note that we intentionally include a
    6030             :          * newline at the end of the title; this is somewhat historical but it
    6031             :          * makes for reasonably nicely formatted output in simple cases.
    6032             :          */
    6033         766 :         timer = time(NULL);
    6034         766 :         strftime(timebuf, sizeof(timebuf), strftime_fmt, localtime(&timer));
    6035             : 
    6036         766 :         if (user_title)
    6037           0 :             snprintf(title, title_len, _("%s\t%s (every %gs)\n"),
    6038             :                      user_title, timebuf, sleep_ms / 1000.0);
    6039             :         else
    6040         766 :             snprintf(title, title_len, _("%s (every %gs)\n"),
    6041             :                      timebuf, sleep_ms / 1000.0);
    6042         766 :         myopt.title = title;
    6043             : 
    6044             :         /* Run the query and print out the result */
    6045         766 :         res = PSQLexecWatch(query_buf->data, &myopt, pagerpipe, min_rows);
    6046             : 
    6047             :         /*
    6048             :          * PSQLexecWatch handles the case where we can no longer repeat the
    6049             :          * query, and returns 0 or -1.
    6050             :          */
    6051         762 :         if (res <= 0)
    6052          10 :             break;
    6053             : 
    6054             :         /* If we have iteration count, check that it's not exceeded yet */
    6055         758 :         if (iter && (--iter <= 0))
    6056           6 :             break;
    6057             : 
    6058             :         /* Quit if error on pager pipe (probably pager has quit) */
    6059         752 :         if (pagerpipe && ferror(pagerpipe))
    6060           0 :             break;
    6061             : 
    6062             :         /* Tight loop, no wait needed */
    6063         752 :         if (sleep_ms == 0)
    6064           8 :             continue;
    6065             : 
    6066             : #ifdef WIN32
    6067             : 
    6068             :         /*
    6069             :          * Wait a while before running the query again.  Break the sleep into
    6070             :          * short intervals (at most 1s); that's probably unnecessary since
    6071             :          * pg_usleep is interruptible on Windows, but it's cheap insurance.
    6072             :          */
    6073             :         for (long i = sleep_ms; i > 0;)
    6074             :         {
    6075             :             long        s = Min(i, 1000L);
    6076             : 
    6077             :             pg_usleep(s * 1000L);
    6078             :             if (cancel_pressed)
    6079             :             {
    6080             :                 done = true;
    6081             :                 break;
    6082             :             }
    6083             :             i -= s;
    6084             :         }
    6085             : #else
    6086             :         /* sigwait() will handle SIGINT. */
    6087         744 :         sigprocmask(SIG_BLOCK, &sigint, NULL);
    6088         744 :         if (cancel_pressed)
    6089           0 :             done = true;
    6090             : 
    6091             :         /* Wait for SIGINT, SIGCHLD or SIGALRM. */
    6092         744 :         while (!done)
    6093             :         {
    6094             :             int         signal_received;
    6095             : 
    6096         744 :             errno = sigwait(&sigalrm_sigchld_sigint, &signal_received);
    6097         744 :             if (errno != 0)
    6098             :             {
    6099             :                 /* Some other signal arrived? */
    6100           0 :                 if (errno == EINTR)
    6101           0 :                     continue;
    6102             :                 else
    6103             :                 {
    6104           0 :                     pg_log_error("could not wait for signals: %m");
    6105           0 :                     done = true;
    6106         744 :                     break;
    6107             :                 }
    6108             :             }
    6109             :             /* On ^C or pager exit, it's time to stop running the query. */
    6110         744 :             if (signal_received == SIGINT || signal_received == SIGCHLD)
    6111           0 :                 done = true;
    6112             :             /* Otherwise, we must have SIGALRM.  Time to run the query again. */
    6113         744 :             break;
    6114             :         }
    6115             : 
    6116             :         /* Unblock SIGINT so that slow queries can be interrupted. */
    6117         744 :         sigprocmask(SIG_UNBLOCK, &sigint, NULL);
    6118             : #endif
    6119             :     }
    6120             : 
    6121          10 :     if (pagerpipe)
    6122             :     {
    6123           0 :         pclose(pagerpipe);
    6124           0 :         restore_sigpipe_trap();
    6125             :     }
    6126             :     else
    6127             :     {
    6128             :         /*
    6129             :          * If the terminal driver echoed "^C", libedit/libreadline might be
    6130             :          * confused about the cursor position.  Therefore, inject a newline
    6131             :          * before the next prompt is displayed.  We only do this when not
    6132             :          * using a pager, because pagers are expected to restore the screen to
    6133             :          * a sane state on exit.
    6134             :          */
    6135          10 :         fprintf(stdout, "\n");
    6136          10 :         fflush(stdout);
    6137             :     }
    6138             : 
    6139             : #ifndef WIN32
    6140             :     /* Disable the interval timer. */
    6141          10 :     memset(&interval, 0, sizeof(interval));
    6142          10 :     setitimer(ITIMER_REAL, &interval, NULL);
    6143             :     /* Unblock SIGINT, SIGCHLD and SIGALRM. */
    6144          10 :     sigprocmask(SIG_UNBLOCK, &sigalrm_sigchld_sigint, NULL);
    6145             : #endif
    6146             : 
    6147          10 :     pg_free(title);
    6148          10 :     return (res >= 0);
    6149             : }
    6150             : 
    6151             : /*
    6152             :  * a little code borrowed from PSQLexec() to manage ECHO_HIDDEN output.
    6153             :  * returns true unless we have ECHO_HIDDEN_NOEXEC.
    6154             :  */
    6155             : static bool
    6156         372 : echo_hidden_command(const char *query)
    6157             : {
    6158         372 :     if (pset.echo_hidden != PSQL_ECHO_HIDDEN_OFF)
    6159             :     {
    6160           0 :         printf(_("/******** QUERY *********/\n"
    6161             :                  "%s\n"
    6162             :                  "/************************/\n\n"), query);
    6163           0 :         fflush(stdout);
    6164           0 :         if (pset.logfile)
    6165             :         {
    6166           0 :             fprintf(pset.logfile,
    6167           0 :                     _("/******** QUERY *********/\n"
    6168             :                       "%s\n"
    6169             :                       "/************************/\n\n"), query);
    6170           0 :             fflush(pset.logfile);
    6171             :         }
    6172             : 
    6173           0 :         if (pset.echo_hidden == PSQL_ECHO_HIDDEN_NOEXEC)
    6174           0 :             return false;
    6175             :     }
    6176         372 :     return true;
    6177             : }
    6178             : 
    6179             : /*
    6180             :  * Look up the object identified by obj_type and desc.  If successful,
    6181             :  * store its OID in *obj_oid and return true, else return false.
    6182             :  *
    6183             :  * Note that we'll fail if the object doesn't exist OR if there are multiple
    6184             :  * matching candidates OR if there's something syntactically wrong with the
    6185             :  * object description; unfortunately it can be hard to tell the difference.
    6186             :  */
    6187             : static bool
    6188         186 : lookup_object_oid(EditableObjectType obj_type, const char *desc,
    6189             :                   Oid *obj_oid)
    6190             : {
    6191         186 :     bool        result = true;
    6192         186 :     PQExpBuffer query = createPQExpBuffer();
    6193             :     PGresult   *res;
    6194             : 
    6195         186 :     switch (obj_type)
    6196             :     {
    6197          60 :         case EditableFunction:
    6198             : 
    6199             :             /*
    6200             :              * We have a function description, e.g. "x" or "x(int)".  Issue a
    6201             :              * query to retrieve the function's OID using a cast to regproc or
    6202             :              * regprocedure (as appropriate).
    6203             :              */
    6204          60 :             appendPQExpBufferStr(query, "SELECT ");
    6205          60 :             appendStringLiteralConn(query, desc, pset.db);
    6206          60 :             appendPQExpBuffer(query, "::pg_catalog.%s::pg_catalog.oid",
    6207          60 :                               strchr(desc, '(') ? "regprocedure" : "regproc");
    6208          60 :             break;
    6209             : 
    6210         126 :         case EditableView:
    6211             : 
    6212             :             /*
    6213             :              * Convert view name (possibly schema-qualified) to OID.  Note:
    6214             :              * this code doesn't check if the relation is actually a view.
    6215             :              * We'll detect that in get_create_object_cmd().
    6216             :              */
    6217         126 :             appendPQExpBufferStr(query, "SELECT ");
    6218         126 :             appendStringLiteralConn(query, desc, pset.db);
    6219         126 :             appendPQExpBufferStr(query, "::pg_catalog.regclass::pg_catalog.oid");
    6220         126 :             break;
    6221             :     }
    6222             : 
    6223         186 :     if (!echo_hidden_command(query->data))
    6224             :     {
    6225           0 :         destroyPQExpBuffer(query);
    6226           0 :         return false;
    6227             :     }
    6228         186 :     res = PQexec(pset.db, query->data);
    6229         186 :     if (PQresultStatus(res) == PGRES_TUPLES_OK && PQntuples(res) == 1)
    6230         186 :         *obj_oid = atooid(PQgetvalue(res, 0, 0));
    6231             :     else
    6232             :     {
    6233           0 :         minimal_error_message(res);
    6234           0 :         result = false;
    6235             :     }
    6236             : 
    6237         186 :     PQclear(res);
    6238         186 :     destroyPQExpBuffer(query);
    6239             : 
    6240         186 :     return result;
    6241             : }
    6242             : 
    6243             : /*
    6244             :  * Construct a "CREATE OR REPLACE ..." command that describes the specified
    6245             :  * database object.  If successful, the result is stored in buf.
    6246             :  */
    6247             : static bool
    6248         186 : get_create_object_cmd(EditableObjectType obj_type, Oid oid,
    6249             :                       PQExpBuffer buf)
    6250             : {
    6251         186 :     bool        result = true;
    6252         186 :     PQExpBuffer query = createPQExpBuffer();
    6253             :     PGresult   *res;
    6254             : 
    6255         186 :     switch (obj_type)
    6256             :     {
    6257          60 :         case EditableFunction:
    6258          60 :             printfPQExpBuffer(query,
    6259             :                               "SELECT pg_catalog.pg_get_functiondef(%u)",
    6260             :                               oid);
    6261          60 :             break;
    6262             : 
    6263         126 :         case EditableView:
    6264             : 
    6265             :             /*
    6266             :              * pg_get_viewdef() just prints the query, so we must prepend
    6267             :              * CREATE for ourselves.  We must fully qualify the view name to
    6268             :              * ensure the right view gets replaced.  Also, check relation kind
    6269             :              * to be sure it's a view.
    6270             :              *
    6271             :              * Starting with PG 9.4, views may have WITH [LOCAL|CASCADED]
    6272             :              * CHECK OPTION.  These are not part of the view definition
    6273             :              * returned by pg_get_viewdef() and so need to be retrieved
    6274             :              * separately.  Materialized views (introduced in 9.3) may have
    6275             :              * arbitrary storage parameter reloptions.
    6276             :              */
    6277         126 :             if (pset.sversion >= 90400)
    6278             :             {
    6279         126 :                 printfPQExpBuffer(query,
    6280             :                                   "SELECT nspname, relname, relkind, "
    6281             :                                   "pg_catalog.pg_get_viewdef(c.oid, true), "
    6282             :                                   "pg_catalog.array_remove(pg_catalog.array_remove(c.reloptions,'check_option=local'),'check_option=cascaded') AS reloptions, "
    6283             :                                   "CASE WHEN 'check_option=local' = ANY (c.reloptions) THEN 'LOCAL'::text "
    6284             :                                   "WHEN 'check_option=cascaded' = ANY (c.reloptions) THEN 'CASCADED'::text ELSE NULL END AS checkoption "
    6285             :                                   "FROM pg_catalog.pg_class c "
    6286             :                                   "LEFT JOIN pg_catalog.pg_namespace n "
    6287             :                                   "ON c.relnamespace = n.oid WHERE c.oid = %u",
    6288             :                                   oid);
    6289             :             }
    6290             :             else
    6291             :             {
    6292           0 :                 printfPQExpBuffer(query,
    6293             :                                   "SELECT nspname, relname, relkind, "
    6294             :                                   "pg_catalog.pg_get_viewdef(c.oid, true), "
    6295             :                                   "c.reloptions AS reloptions, "
    6296             :                                   "NULL AS checkoption "
    6297             :                                   "FROM pg_catalog.pg_class c "
    6298             :                                   "LEFT JOIN pg_catalog.pg_namespace n "
    6299             :                                   "ON c.relnamespace = n.oid WHERE c.oid = %u",
    6300             :                                   oid);
    6301             :             }
    6302         126 :             break;
    6303             :     }
    6304             : 
    6305         186 :     if (!echo_hidden_command(query->data))
    6306             :     {
    6307           0 :         destroyPQExpBuffer(query);
    6308           0 :         return false;
    6309             :     }
    6310         186 :     res = PQexec(pset.db, query->data);
    6311         186 :     if (PQresultStatus(res) == PGRES_TUPLES_OK && PQntuples(res) == 1)
    6312             :     {
    6313         186 :         resetPQExpBuffer(buf);
    6314         186 :         switch (obj_type)
    6315             :         {
    6316          60 :             case EditableFunction:
    6317          60 :                 appendPQExpBufferStr(buf, PQgetvalue(res, 0, 0));
    6318          60 :                 break;
    6319             : 
    6320         126 :             case EditableView:
    6321             :                 {
    6322         126 :                     char       *nspname = PQgetvalue(res, 0, 0);
    6323         126 :                     char       *relname = PQgetvalue(res, 0, 1);
    6324         126 :                     char       *relkind = PQgetvalue(res, 0, 2);
    6325         126 :                     char       *viewdef = PQgetvalue(res, 0, 3);
    6326         126 :                     char       *reloptions = PQgetvalue(res, 0, 4);
    6327         126 :                     char       *checkoption = PQgetvalue(res, 0, 5);
    6328             : 
    6329             :                     /*
    6330             :                      * If the backend ever supports CREATE OR REPLACE
    6331             :                      * MATERIALIZED VIEW, allow that here; but as of today it
    6332             :                      * does not, so editing a matview definition in this way
    6333             :                      * is impossible.
    6334             :                      */
    6335         126 :                     switch (relkind[0])
    6336             :                     {
    6337             : #ifdef NOT_USED
    6338             :                         case RELKIND_MATVIEW:
    6339             :                             appendPQExpBufferStr(buf, "CREATE OR REPLACE MATERIALIZED VIEW ");
    6340             :                             break;
    6341             : #endif
    6342         126 :                         case RELKIND_VIEW:
    6343         126 :                             appendPQExpBufferStr(buf, "CREATE OR REPLACE VIEW ");
    6344         126 :                             break;
    6345           0 :                         default:
    6346           0 :                             pg_log_error("\"%s.%s\" is not a view",
    6347             :                                          nspname, relname);
    6348           0 :                             result = false;
    6349           0 :                             break;
    6350             :                     }
    6351         126 :                     appendPQExpBuffer(buf, "%s.", fmtId(nspname));
    6352         126 :                     appendPQExpBufferStr(buf, fmtId(relname));
    6353             : 
    6354             :                     /* reloptions, if not an empty array "{}" */
    6355         126 :                     if (reloptions != NULL && strlen(reloptions) > 2)
    6356             :                     {
    6357           0 :                         appendPQExpBufferStr(buf, "\n WITH (");
    6358           0 :                         if (!appendReloptionsArray(buf, reloptions, "",
    6359             :                                                    pset.encoding,
    6360           0 :                                                    standard_strings()))
    6361             :                         {
    6362           0 :                             pg_log_error("could not parse reloptions array");
    6363           0 :                             result = false;
    6364             :                         }
    6365           0 :                         appendPQExpBufferChar(buf, ')');
    6366             :                     }
    6367             : 
    6368             :                     /* View definition from pg_get_viewdef (a SELECT query) */
    6369         126 :                     appendPQExpBuffer(buf, " AS\n%s", viewdef);
    6370             : 
    6371             :                     /* Get rid of the semicolon that pg_get_viewdef appends */
    6372         126 :                     if (buf->len > 0 && buf->data[buf->len - 1] == ';')
    6373         126 :                         buf->data[--(buf->len)] = '\0';
    6374             : 
    6375             :                     /* WITH [LOCAL|CASCADED] CHECK OPTION */
    6376         126 :                     if (checkoption && checkoption[0] != '\0')
    6377           0 :                         appendPQExpBuffer(buf, "\n WITH %s CHECK OPTION",
    6378             :                                           checkoption);
    6379             :                 }
    6380         126 :                 break;
    6381             :         }
    6382             :         /* Make sure result ends with a newline */
    6383         186 :         if (buf->len > 0 && buf->data[buf->len - 1] != '\n')
    6384         126 :             appendPQExpBufferChar(buf, '\n');
    6385             :     }
    6386             :     else
    6387             :     {
    6388           0 :         minimal_error_message(res);
    6389           0 :         result = false;
    6390             :     }
    6391             : 
    6392         186 :     PQclear(res);
    6393         186 :     destroyPQExpBuffer(query);
    6394             : 
    6395         186 :     return result;
    6396             : }
    6397             : 
    6398             : /*
    6399             :  * If the given argument of \ef or \ev ends with a line number, delete the line
    6400             :  * number from the argument string and return it as an integer.  (We need
    6401             :  * this kluge because we're too lazy to parse \ef's function or \ev's view
    6402             :  * argument carefully --- we just slop it up in OT_WHOLE_LINE mode.)
    6403             :  *
    6404             :  * Returns -1 if no line number is present, 0 on error, or a positive value
    6405             :  * on success.
    6406             :  */
    6407             : static int
    6408           0 : strip_lineno_from_objdesc(char *obj)
    6409             : {
    6410             :     char       *c;
    6411             :     int         lineno;
    6412             : 
    6413           0 :     if (!obj || obj[0] == '\0')
    6414           0 :         return -1;
    6415             : 
    6416           0 :     c = obj + strlen(obj) - 1;
    6417             : 
    6418             :     /*
    6419             :      * This business of parsing backwards is dangerous as can be in a
    6420             :      * multibyte environment: there is no reason to believe that we are
    6421             :      * looking at the first byte of a character, nor are we necessarily
    6422             :      * working in a "safe" encoding.  Fortunately the bitpatterns we are
    6423             :      * looking for are unlikely to occur as non-first bytes, but beware of
    6424             :      * trying to expand the set of cases that can be recognized.  We must
    6425             :      * guard the <ctype.h> macros by using isascii() first, too.
    6426             :      */
    6427             : 
    6428             :     /* skip trailing whitespace */
    6429           0 :     while (c > obj && isascii((unsigned char) *c) && isspace((unsigned char) *c))
    6430           0 :         c--;
    6431             : 
    6432             :     /* must have a digit as last non-space char */
    6433           0 :     if (c == obj || !isascii((unsigned char) *c) || !isdigit((unsigned char) *c))
    6434           0 :         return -1;
    6435             : 
    6436             :     /* find start of digit string */
    6437           0 :     while (c > obj && isascii((unsigned char) *c) && isdigit((unsigned char) *c))
    6438           0 :         c--;
    6439             : 
    6440             :     /* digits must be separated from object name by space or closing paren */
    6441             :     /* notice also that we are not allowing an empty object name ... */
    6442           0 :     if (c == obj || !isascii((unsigned char) *c) ||
    6443           0 :         !(isspace((unsigned char) *c) || *c == ')'))
    6444           0 :         return -1;
    6445             : 
    6446             :     /* parse digit string */
    6447           0 :     c++;
    6448           0 :     lineno = atoi(c);
    6449           0 :     if (lineno < 1)
    6450             :     {
    6451           0 :         pg_log_error("invalid line number: %s", c);
    6452           0 :         return 0;
    6453             :     }
    6454             : 
    6455             :     /* strip digit string from object name */
    6456           0 :     *c = '\0';
    6457             : 
    6458           0 :     return lineno;
    6459             : }
    6460             : 
    6461             : /*
    6462             :  * Count number of lines in the buffer.
    6463             :  * This is used to test if pager is needed or not.
    6464             :  */
    6465             : static int
    6466         186 : count_lines_in_buf(PQExpBuffer buf)
    6467             : {
    6468         186 :     int         lineno = 0;
    6469         186 :     const char *lines = buf->data;
    6470             : 
    6471        2896 :     while (*lines != '\0')
    6472             :     {
    6473        2710 :         lineno++;
    6474             :         /* find start of next line */
    6475        2710 :         lines = strchr(lines, '\n');
    6476        2710 :         if (!lines)
    6477           0 :             break;
    6478        2710 :         lines++;
    6479             :     }
    6480             : 
    6481         186 :     return lineno;
    6482             : }
    6483             : 
    6484             : /*
    6485             :  * Write text at *lines to output with line numbers.
    6486             :  *
    6487             :  * For functions, lineno "1" should correspond to the first line of the
    6488             :  * function body; lines before that are unnumbered.  We expect that
    6489             :  * pg_get_functiondef() will emit that on a line beginning with "AS ",
    6490             :  * "BEGIN ", or "RETURN ", and that there can be no such line before
    6491             :  * the real start of the function body.
    6492             :  *
    6493             :  * Caution: this scribbles on *lines.
    6494             :  */
    6495             : static void
    6496          18 : print_with_linenumbers(FILE *output, char *lines, bool is_func)
    6497             : {
    6498          18 :     bool        in_header = is_func;
    6499          18 :     int         lineno = 0;
    6500             : 
    6501         192 :     while (*lines != '\0')
    6502             :     {
    6503             :         char       *eol;
    6504             : 
    6505         174 :         if (in_header &&
    6506          90 :             (strncmp(lines, "AS ", 3) == 0 ||
    6507          90 :              strncmp(lines, "BEGIN ", 6) == 0 ||
    6508          78 :              strncmp(lines, "RETURN ", 7) == 0))
    6509          18 :             in_header = false;
    6510             : 
    6511             :         /* increment lineno only for body's lines */
    6512         174 :         if (!in_header)
    6513         102 :             lineno++;
    6514             : 
    6515             :         /* find and mark end of current line */
    6516         174 :         eol = strchr(lines, '\n');
    6517         174 :         if (eol != NULL)
    6518         174 :             *eol = '\0';
    6519             : 
    6520             :         /* show current line as appropriate */
    6521         174 :         if (in_header)
    6522          72 :             fprintf(output, "        %s\n", lines);
    6523             :         else
    6524         102 :             fprintf(output, "%-7d %s\n", lineno, lines);
    6525             : 
    6526             :         /* advance to next line, if any */
    6527         174 :         if (eol == NULL)
    6528           0 :             break;
    6529         174 :         lines = ++eol;
    6530             :     }
    6531          18 : }
    6532             : 
    6533             : /*
    6534             :  * Report just the primary error; this is to avoid cluttering the output
    6535             :  * with, for instance, a redisplay of the internally generated query
    6536             :  */
    6537             : static void
    6538           0 : minimal_error_message(PGresult *res)
    6539             : {
    6540             :     PQExpBuffer msg;
    6541             :     const char *fld;
    6542             : 
    6543           0 :     msg = createPQExpBuffer();
    6544             : 
    6545           0 :     fld = PQresultErrorField(res, PG_DIAG_SEVERITY);
    6546           0 :     if (fld)
    6547           0 :         printfPQExpBuffer(msg, "%s:  ", fld);
    6548             :     else
    6549           0 :         printfPQExpBuffer(msg, "ERROR:  ");
    6550           0 :     fld = PQresultErrorField(res, PG_DIAG_MESSAGE_PRIMARY);
    6551           0 :     if (fld)
    6552           0 :         appendPQExpBufferStr(msg, fld);
    6553             :     else
    6554           0 :         appendPQExpBufferStr(msg, "(not available)");
    6555           0 :     appendPQExpBufferChar(msg, '\n');
    6556             : 
    6557           0 :     pg_log_error("%s", msg->data);
    6558             : 
    6559           0 :     destroyPQExpBuffer(msg);
    6560           0 : }

Generated by: LCOV version 1.16