2010-05-12 10:19:11 +08:00
|
|
|
/*
|
|
|
|
* opt.c
|
|
|
|
*
|
|
|
|
* options functions
|
2010-07-03 22:23:14 +08:00
|
|
|
*
|
2011-01-02 02:18:15 +08:00
|
|
|
* Copyright (c) 2010-2011, PostgreSQL Global Development Group
|
2010-09-21 04:08:53 +08:00
|
|
|
* contrib/pg_upgrade/option.c
|
2010-05-12 10:19:11 +08:00
|
|
|
*/
|
|
|
|
|
|
|
|
#include "pg_upgrade.h"
|
|
|
|
|
|
|
|
#include "getopt_long.h"
|
|
|
|
|
|
|
|
#ifdef WIN32
|
|
|
|
#include <io.h>
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
2010-10-20 05:38:16 +08:00
|
|
|
static void usage(void);
|
2011-06-23 05:50:40 +08:00
|
|
|
static void check_required_directory(char **dirpath,
|
2010-05-12 10:19:11 +08:00
|
|
|
char *envVarName, char *cmdLineOption, char *description);
|
2010-10-20 05:38:16 +08:00
|
|
|
|
|
|
|
|
2010-10-20 06:37:04 +08:00
|
|
|
UserOpts user_opts;
|
2010-05-12 10:19:11 +08:00
|
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
* parseCommandLine()
|
|
|
|
*
|
2010-12-15 20:11:31 +08:00
|
|
|
* Parses the command line (argc, argv[]) and loads structures
|
2010-05-12 10:19:11 +08:00
|
|
|
*/
|
|
|
|
void
|
2010-10-20 05:38:16 +08:00
|
|
|
parseCommandLine(int argc, char *argv[])
|
2010-05-12 10:19:11 +08:00
|
|
|
{
|
|
|
|
static struct option long_options[] = {
|
|
|
|
{"old-datadir", required_argument, NULL, 'd'},
|
|
|
|
{"new-datadir", required_argument, NULL, 'D'},
|
|
|
|
{"old-bindir", required_argument, NULL, 'b'},
|
|
|
|
{"new-bindir", required_argument, NULL, 'B'},
|
|
|
|
{"old-port", required_argument, NULL, 'p'},
|
|
|
|
{"new-port", required_argument, NULL, 'P'},
|
|
|
|
|
|
|
|
{"user", required_argument, NULL, 'u'},
|
|
|
|
{"check", no_argument, NULL, 'c'},
|
|
|
|
{"debug", no_argument, NULL, 'g'},
|
|
|
|
{"debugfile", required_argument, NULL, 'G'},
|
|
|
|
{"link", no_argument, NULL, 'k'},
|
|
|
|
{"logfile", required_argument, NULL, 'l'},
|
|
|
|
{"verbose", no_argument, NULL, 'v'},
|
|
|
|
{NULL, 0, NULL, 0}
|
|
|
|
};
|
2010-06-16 07:25:01 +08:00
|
|
|
int option; /* Command line option */
|
2010-05-12 10:19:11 +08:00
|
|
|
int optindex = 0; /* used by getopt_long */
|
2011-05-16 22:46:52 +08:00
|
|
|
int os_user_effective_id;
|
2010-07-07 03:19:02 +08:00
|
|
|
|
2011-05-16 22:46:52 +08:00
|
|
|
user_opts.transfer_mode = TRANSFER_MODE_COPY;
|
2010-05-12 10:19:11 +08:00
|
|
|
|
2010-10-20 05:38:16 +08:00
|
|
|
os_info.progname = get_progname(argv[0]);
|
2011-05-16 22:46:52 +08:00
|
|
|
|
|
|
|
/* Process libpq env. variables; load values here for usage() output */
|
2011-07-02 06:17:12 +08:00
|
|
|
old_cluster.port = getenv("PGPORTOLD") ? atoi(getenv("PGPORTOLD")) : DEF_PGUPORT;
|
|
|
|
new_cluster.port = getenv("PGPORTNEW") ? atoi(getenv("PGPORTNEW")) : DEF_PGUPORT;
|
2010-05-12 10:19:11 +08:00
|
|
|
|
2011-05-16 22:46:52 +08:00
|
|
|
os_user_effective_id = get_user_info(&os_info.user);
|
|
|
|
/* we override just the database user name; we got the OS id above */
|
|
|
|
if (getenv("PGUSER"))
|
|
|
|
{
|
|
|
|
pg_free(os_info.user);
|
|
|
|
/* must save value, getenv()'s pointer is not stable */
|
|
|
|
os_info.user = pg_strdup(getenv("PGUSER"));
|
|
|
|
}
|
2010-07-07 03:19:02 +08:00
|
|
|
|
2010-05-12 10:19:11 +08:00
|
|
|
if (argc > 1)
|
|
|
|
{
|
|
|
|
if (strcmp(argv[1], "--help") == 0 || strcmp(argv[1], "-h") == 0 ||
|
|
|
|
strcmp(argv[1], "-?") == 0)
|
|
|
|
{
|
2010-10-20 05:38:16 +08:00
|
|
|
usage();
|
2011-04-07 04:00:44 +08:00
|
|
|
exit(0);
|
2010-05-12 10:19:11 +08:00
|
|
|
}
|
|
|
|
if (strcmp(argv[1], "--version") == 0 || strcmp(argv[1], "-V") == 0)
|
|
|
|
{
|
2011-05-11 02:40:29 +08:00
|
|
|
puts("pg_upgrade (PostgreSQL) " PG_VERSION);
|
2011-04-07 04:00:44 +08:00
|
|
|
exit(0);
|
2010-05-12 10:19:11 +08:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2011-05-16 22:46:52 +08:00
|
|
|
/* Allow help and version to be run as root, so do the test here. */
|
|
|
|
if (os_user_effective_id == 0)
|
2010-10-20 05:38:16 +08:00
|
|
|
pg_log(PG_FATAL, "%s: cannot be run as root\n", os_info.progname);
|
2010-05-12 10:19:11 +08:00
|
|
|
|
2010-10-20 05:38:16 +08:00
|
|
|
getcwd(os_info.cwd, MAXPGPATH);
|
2010-05-12 10:19:11 +08:00
|
|
|
|
|
|
|
while ((option = getopt_long(argc, argv, "d:D:b:B:cgG:kl:p:P:u:v",
|
|
|
|
long_options, &optindex)) != -1)
|
|
|
|
{
|
|
|
|
switch (option)
|
|
|
|
{
|
|
|
|
case 'b':
|
2010-10-20 05:38:16 +08:00
|
|
|
old_cluster.bindir = pg_strdup(optarg);
|
2010-05-12 10:19:11 +08:00
|
|
|
break;
|
|
|
|
|
|
|
|
case 'B':
|
2010-10-20 05:38:16 +08:00
|
|
|
new_cluster.bindir = pg_strdup(optarg);
|
2010-05-12 10:19:11 +08:00
|
|
|
break;
|
|
|
|
|
|
|
|
case 'c':
|
2010-10-20 05:38:16 +08:00
|
|
|
user_opts.check = true;
|
2010-05-12 10:19:11 +08:00
|
|
|
break;
|
|
|
|
|
2011-05-16 22:46:52 +08:00
|
|
|
case 'd':
|
|
|
|
old_cluster.pgdata = pg_strdup(optarg);
|
|
|
|
break;
|
|
|
|
|
|
|
|
case 'D':
|
|
|
|
new_cluster.pgdata = pg_strdup(optarg);
|
|
|
|
break;
|
|
|
|
|
2010-05-12 10:19:11 +08:00
|
|
|
case 'g':
|
2010-10-20 05:38:16 +08:00
|
|
|
pg_log(PG_REPORT, "Running in debug mode\n");
|
2010-10-20 10:31:17 +08:00
|
|
|
log_opts.debug = true;
|
2010-05-12 10:19:11 +08:00
|
|
|
break;
|
|
|
|
|
|
|
|
case 'G':
|
2010-10-20 10:31:17 +08:00
|
|
|
if ((log_opts.debug_fd = fopen(optarg, "w")) == NULL)
|
2010-05-12 10:19:11 +08:00
|
|
|
{
|
2010-10-20 05:38:16 +08:00
|
|
|
pg_log(PG_FATAL, "cannot open debug file\n");
|
2011-04-07 04:00:44 +08:00
|
|
|
exit(1);
|
2010-05-12 10:19:11 +08:00
|
|
|
}
|
|
|
|
break;
|
|
|
|
|
|
|
|
case 'k':
|
2010-10-20 05:38:16 +08:00
|
|
|
user_opts.transfer_mode = TRANSFER_MODE_LINK;
|
2010-05-12 10:19:11 +08:00
|
|
|
break;
|
|
|
|
|
|
|
|
case 'l':
|
2010-10-20 10:31:17 +08:00
|
|
|
log_opts.filename = pg_strdup(optarg);
|
2010-05-12 10:19:11 +08:00
|
|
|
break;
|
|
|
|
|
|
|
|
case 'p':
|
2010-10-20 05:38:16 +08:00
|
|
|
if ((old_cluster.port = atoi(optarg)) <= 0)
|
2010-05-12 10:19:11 +08:00
|
|
|
{
|
2010-10-20 05:38:16 +08:00
|
|
|
pg_log(PG_FATAL, "invalid old port number\n");
|
2011-04-07 04:00:44 +08:00
|
|
|
exit(1);
|
2010-05-12 10:19:11 +08:00
|
|
|
}
|
|
|
|
break;
|
|
|
|
|
|
|
|
case 'P':
|
2010-10-20 05:38:16 +08:00
|
|
|
if ((new_cluster.port = atoi(optarg)) <= 0)
|
2010-05-12 10:19:11 +08:00
|
|
|
{
|
2010-10-20 05:38:16 +08:00
|
|
|
pg_log(PG_FATAL, "invalid new port number\n");
|
2011-04-07 04:00:44 +08:00
|
|
|
exit(1);
|
2010-05-12 10:19:11 +08:00
|
|
|
}
|
|
|
|
break;
|
|
|
|
|
|
|
|
case 'u':
|
2010-10-20 05:38:16 +08:00
|
|
|
pg_free(os_info.user);
|
|
|
|
os_info.user = pg_strdup(optarg);
|
2011-06-10 02:32:50 +08:00
|
|
|
|
2011-05-16 22:46:52 +08:00
|
|
|
/*
|
|
|
|
* Push the user name into the environment so pre-9.1
|
|
|
|
* pg_ctl/libpq uses it.
|
|
|
|
*/
|
|
|
|
pg_putenv("PGUSER", os_info.user);
|
2010-05-12 10:19:11 +08:00
|
|
|
break;
|
|
|
|
|
|
|
|
case 'v':
|
2010-10-20 05:38:16 +08:00
|
|
|
pg_log(PG_REPORT, "Running in verbose mode\n");
|
2010-10-20 10:31:17 +08:00
|
|
|
log_opts.verbose = true;
|
2010-05-12 10:19:11 +08:00
|
|
|
break;
|
|
|
|
|
|
|
|
default:
|
2010-10-20 05:38:16 +08:00
|
|
|
pg_log(PG_FATAL,
|
2010-05-12 10:19:11 +08:00
|
|
|
"Try \"%s --help\" for more information.\n",
|
2010-10-20 05:38:16 +08:00
|
|
|
os_info.progname);
|
2010-05-12 10:19:11 +08:00
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2010-10-20 10:31:17 +08:00
|
|
|
if (log_opts.filename != NULL)
|
2010-05-12 10:19:11 +08:00
|
|
|
{
|
|
|
|
/*
|
|
|
|
* We must use append mode so output generated by child processes via
|
|
|
|
* ">>" will not be overwritten, and we want the file truncated on
|
|
|
|
* start.
|
|
|
|
*/
|
|
|
|
/* truncate */
|
2010-10-20 10:31:17 +08:00
|
|
|
if ((log_opts.fd = fopen(log_opts.filename, "w")) == NULL)
|
2011-05-07 09:47:12 +08:00
|
|
|
pg_log(PG_FATAL, "cannot write to log file %s\n", log_opts.filename);
|
2010-10-20 10:31:17 +08:00
|
|
|
fclose(log_opts.fd);
|
|
|
|
if ((log_opts.fd = fopen(log_opts.filename, "a")) == NULL)
|
2011-05-07 09:47:12 +08:00
|
|
|
pg_log(PG_FATAL, "cannot write to log file %s\n", log_opts.filename);
|
2010-05-12 10:19:11 +08:00
|
|
|
}
|
|
|
|
else
|
2010-10-20 10:31:17 +08:00
|
|
|
log_opts.filename = strdup(DEVNULL);
|
2010-05-12 10:19:11 +08:00
|
|
|
|
|
|
|
/* if no debug file name, output to the terminal */
|
2010-10-20 10:31:17 +08:00
|
|
|
if (log_opts.debug && !log_opts.debug_fd)
|
2010-05-12 10:19:11 +08:00
|
|
|
{
|
2010-10-20 10:31:17 +08:00
|
|
|
log_opts.debug_fd = fopen(DEVTTY, "w");
|
|
|
|
if (!log_opts.debug_fd)
|
2011-05-07 09:47:12 +08:00
|
|
|
pg_log(PG_FATAL, "cannot write to terminal\n");
|
2010-05-12 10:19:11 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
/* Get values from env if not already set */
|
2011-07-02 06:17:12 +08:00
|
|
|
check_required_directory(&old_cluster.bindir, "PGBINOLD", "-b",
|
2010-05-12 10:19:11 +08:00
|
|
|
"old cluster binaries reside");
|
2011-07-02 06:17:12 +08:00
|
|
|
check_required_directory(&new_cluster.bindir, "PGBINNEW", "-B",
|
2010-05-12 10:19:11 +08:00
|
|
|
"new cluster binaries reside");
|
2011-07-02 06:17:12 +08:00
|
|
|
check_required_directory(&old_cluster.pgdata, "PGDATAOLD", "-d",
|
2011-05-16 22:46:52 +08:00
|
|
|
"old cluster data resides");
|
2011-07-02 06:17:12 +08:00
|
|
|
check_required_directory(&new_cluster.pgdata, "PGDATANEW", "-D",
|
2011-05-16 22:46:52 +08:00
|
|
|
"new cluster data resides");
|
2010-05-12 10:19:11 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
static void
|
2010-10-20 05:38:16 +08:00
|
|
|
usage(void)
|
2010-05-12 10:19:11 +08:00
|
|
|
{
|
2011-05-06 03:56:06 +08:00
|
|
|
printf(_("pg_upgrade upgrades a PostgreSQL cluster to a different major version.\n\
|
|
|
|
\nUsage:\n\
|
|
|
|
pg_upgrade [OPTIONS]...\n\
|
2010-05-12 10:19:11 +08:00
|
|
|
\n\
|
|
|
|
Options:\n\
|
2011-05-06 03:56:06 +08:00
|
|
|
-b, --old-bindir=OLDBINDIR old cluster executable directory\n\
|
|
|
|
-B, --new-bindir=NEWBINDIR new cluster executable directory\n\
|
|
|
|
-c, --check check clusters only, don't change any data\n\
|
|
|
|
-d, --old-datadir=OLDDATADIR old cluster data directory\n\
|
|
|
|
-D, --new-datadir=NEWDATADIR new cluster data directory\n\
|
|
|
|
-g, --debug enable debugging\n\
|
|
|
|
-G, --debugfile=FILENAME output debugging activity to file\n\
|
|
|
|
-k, --link link instead of copying files to new cluster\n\
|
|
|
|
-l, --logfile=FILENAME log session activity to file\n\
|
|
|
|
-p, --old-port=OLDPORT old cluster port number (default %d)\n\
|
|
|
|
-P, --new-port=NEWPORT new cluster port number (default %d)\n\
|
|
|
|
-u, --user=NAME clusters superuser (default \"%s\")\n\
|
|
|
|
-v, --verbose enable verbose output\n\
|
|
|
|
-V, --version display version information, then exit\n\
|
|
|
|
-h, --help show this help, then exit\n\
|
2010-05-12 10:19:11 +08:00
|
|
|
\n\
|
|
|
|
Before running pg_upgrade you must:\n\
|
|
|
|
create a new database cluster (using the new version of initdb)\n\
|
|
|
|
shutdown the postmaster servicing the old cluster\n\
|
|
|
|
shutdown the postmaster servicing the new cluster\n\
|
|
|
|
\n\
|
|
|
|
When you run pg_upgrade, you must provide the following information:\n\
|
|
|
|
the data directory for the old cluster (-d OLDDATADIR)\n\
|
|
|
|
the data directory for the new cluster (-D NEWDATADIR)\n\
|
2011-05-06 03:56:06 +08:00
|
|
|
the \"bin\" directory for the old version (-b OLDBINDIR)\n\
|
|
|
|
the \"bin\" directory for the new version (-B NEWBINDIR)\n\
|
2010-05-12 10:19:11 +08:00
|
|
|
\n\
|
|
|
|
For example:\n\
|
|
|
|
pg_upgrade -d oldCluster/data -D newCluster/data -b oldCluster/bin -B newCluster/bin\n\
|
2010-10-20 05:38:16 +08:00
|
|
|
or\n"), old_cluster.port, new_cluster.port, os_info.user);
|
2010-05-12 10:19:11 +08:00
|
|
|
#ifndef WIN32
|
|
|
|
printf(_("\
|
2011-07-02 06:17:12 +08:00
|
|
|
$ export PGDATAOLD=oldCluster/data\n\
|
|
|
|
$ export PGDATANEW=newCluster/data\n\
|
|
|
|
$ export PGBINOLD=oldCluster/bin\n\
|
|
|
|
$ export PGBINNEW=newCluster/bin\n\
|
2010-05-12 10:19:11 +08:00
|
|
|
$ pg_upgrade\n"));
|
|
|
|
#else
|
|
|
|
printf(_("\
|
2011-07-02 06:17:12 +08:00
|
|
|
C:\\> set PGDATAOLD=oldCluster/data\n\
|
|
|
|
C:\\> set PGDATANEW=newCluster/data\n\
|
|
|
|
C:\\> set PGBINOLD=oldCluster/bin\n\
|
|
|
|
C:\\> set PGBINNEW=newCluster/bin\n\
|
2010-05-12 10:19:11 +08:00
|
|
|
C:\\> pg_upgrade\n"));
|
|
|
|
#endif
|
2011-05-11 02:37:55 +08:00
|
|
|
printf(_("\nReport bugs to <pgsql-bugs@postgresql.org>.\n"));
|
2010-05-12 10:19:11 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/*
|
2011-06-23 05:50:40 +08:00
|
|
|
* check_required_directory()
|
2010-05-12 10:19:11 +08:00
|
|
|
*
|
2011-06-23 05:50:40 +08:00
|
|
|
* Checks a directory option.
|
2010-05-12 10:19:11 +08:00
|
|
|
* dirpath - the directory name supplied on the command line
|
|
|
|
* envVarName - the name of an environment variable to get if dirpath is NULL
|
|
|
|
* cmdLineOption - the command line option corresponds to this directory (-o, -O, -n, -N)
|
|
|
|
* description - a description of this directory option
|
|
|
|
*
|
|
|
|
* We use the last two arguments to construct a meaningful error message if the
|
|
|
|
* user hasn't provided the required directory name.
|
|
|
|
*/
|
|
|
|
static void
|
2011-06-23 05:50:40 +08:00
|
|
|
check_required_directory(char **dirpath, char *envVarName,
|
2011-06-16 05:23:02 +08:00
|
|
|
char *cmdLineOption, char *description)
|
2010-05-12 10:19:11 +08:00
|
|
|
{
|
2011-06-16 05:23:02 +08:00
|
|
|
if (*dirpath == NULL || strlen(*dirpath) == 0)
|
2010-05-12 10:19:11 +08:00
|
|
|
{
|
|
|
|
const char *envVar;
|
|
|
|
|
|
|
|
if ((envVar = getenv(envVarName)) && strlen(envVar))
|
2010-10-20 05:38:16 +08:00
|
|
|
*dirpath = pg_strdup(envVar);
|
2010-05-12 10:19:11 +08:00
|
|
|
else
|
2011-07-12 12:13:51 +08:00
|
|
|
pg_log(PG_FATAL, "You must identify the directory where the %s.\n"
|
|
|
|
"Please use the %s command-line option or the %s environment variable.\n",
|
2010-05-12 10:19:11 +08:00
|
|
|
description, cmdLineOption, envVarName);
|
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Trim off any trailing path separators
|
|
|
|
*/
|
2010-05-14 08:13:38 +08:00
|
|
|
#ifndef WIN32
|
|
|
|
if ((*dirpath)[strlen(*dirpath) - 1] == '/')
|
|
|
|
#else
|
|
|
|
if ((*dirpath)[strlen(*dirpath) - 1] == '/' ||
|
2010-07-07 03:19:02 +08:00
|
|
|
(*dirpath)[strlen(*dirpath) - 1] == '\\')
|
2010-05-14 08:13:38 +08:00
|
|
|
#endif
|
2010-05-12 10:19:11 +08:00
|
|
|
(*dirpath)[strlen(*dirpath) - 1] = 0;
|
|
|
|
}
|