projects / postgresql.git / commitdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | patch | inline | side by side (parent: 24a4aff)
Polish help output. Allow --help to work with BSD getopts.
authorPeter Eisentraut
Sat, 6 Jan 2001 20:57:26 +0000 (20:57 +0000)
committerPeter Eisentraut
Sat, 6 Jan 2001 20:57:26 +0000 (20:57 +0000)
src/bin/pg_dump/pg_dump.c patch | blob | blame | history
src/bin/pg_dump/pg_restore.c patch | blob | blame | history

diff --git a/src/bin/pg_dump/pg_dump.c b/src/bin/pg_dump/pg_dump.c
index 43c91e3e4ed3f89472d04ec6b2b66a279f461f3a..69bd866eff736d46efbafaf3f97322c38d2bca15 100644 (file)
--- a/src/bin/pg_dump/pg_dump.c
+++ b/src/bin/pg_dump/pg_dump.c
@@ -22,7 +22,7 @@
  *
  *
  * IDENTIFICATION
- *   $Header: /cvsroot/pgsql/src/bin/pg_dump/pg_dump.c,v 1.184 2001/01/04 01:23:47 tgl Exp $
+ *   $Header: /cvsroot/pgsql/src/bin/pg_dump/pg_dump.c,v 1.185 2001/01/06 20:57:26 petere Exp $
  *
  * Modifications - 6/10/96 - [email protected] - version 1.13.dhb
  *
@@ -193,24 +193,27 @@ help(const char *progname)
 #ifdef HAVE_GETOPT_LONG
    puts(
        "  -a, --data-only          dump out only the data, not the schema\n"
-       "  -b, --blobs              dump out blob data\n"
+       "  -b, --blobs              dump out blob data\n"
        "  -c, --clean              clean (drop) schema prior to create\n"
        "  -C, --create             output commands to create database\n"
        "  -d, --inserts            dump data as INSERT, rather than COPY, commands\n"
        "  -D, --attribute-inserts  dump data as INSERT commands with attribute names\n"
-       "  -f, --file               specify output file name\n"
+       "  -f, --file=FILENAME      specify output file name\n"
        "  -F, --format {c|f|p}     output file format (custom, files, plain text)\n"
-       "  -h, --host     server host name\n"
+       "  -h, --host=HOSTNAME      server host name\n"
        "  -i, --ignore-version     proceed when database version != pg_dump version\n"
        "  -n, --no-quotes          suppress most quotes around identifiers\n"
        "  -N, --quotes             enable most quotes around identifiers\n"
        "  -o, --oids               dump object ids (oids)\n"
-       "  -O, --no-owner           don't output \\connect commands in plain text format\n"
-       "  -p, --port         server port number\n"
-       "  -R, --no-reconnect       disable ALL reconnections to the database in plain text format\n"
+       "  -O, --no-owner           do not output \\connect commands in plain text\n"
+       "                           format\n"
+       "  -p, --port=PORT          server port number\n"
+       "  -R, --no-reconnect       disable ALL reconnections to the database in\n"
+       "                           plain text format\n"
        "  -s, --schema-only        dump out only the schema, no data\n"
-       "  -S, --superuser    specify the superuser username to use in plain text format\n"
-       "  -t, --table       dump for this table only\n"
+       "  -S, --superuser=NAME     specify the superuser user name to use in plain\n"
+       "                           text format\n"
+       "  -t, --table=TABLE        dump for this table only\n"
        "  -u, --password           use password authentication\n"
        "  -v, --verbose            verbose\n"
        "  -x, --no-acl             do not dump ACL's (grant/revoke)\n"
@@ -224,19 +227,22 @@ help(const char *progname)
        "  -C                       output commands to create database\n"
        "  -d                       dump data as INSERT, rather than COPY, commands\n"
        "  -D                       dump data as INSERT commands with attribute names\n"
-       "  -f                       specify output file name\n"
+       "  -f FILENAME              specify output file name\n"
        "  -F {c|f|p}               output file format (custom, files, plain text)\n"
-       "  -h             server host name\n"
+       "  -h HOSTNAME              server host name\n"
        "  -i                       proceed when database version != pg_dump version\n"
        "  -n                       suppress most quotes around identifiers\n"
        "  -N                       enable most quotes around identifiers\n"
        "  -o                       dump object ids (oids)\n"
-       "  -O                       don't output \\connect commands in plain text format\n"
-       "  -p                 server port number\n"
-       "  -R                       disable ALL reconnections to the database in plain text format\n"
+       "  -O                       do not output \\connect commands in plain text\n"
+       "                           format\n"
+       "  -p PORT                  server port number\n"
+       "  -R                       disable ALL reconnections to the database in\n"
+       "                           plain text format\n"
        "  -s                       dump out only the schema, no data\n"
-       "  -S                 specify the superuser username to use in plain text format\n"
-       "  -t 
               dump for this table only\n"
+       "  -S NAME                  specify the superuser user name to use in plain\n"
+       "                           text format\n"
+       "  -t TABLE                 dump for this table only\n"
        "  -u                       use password authentication\n"
        "  -v                       verbose\n"
        "  -x                       do not dump ACL's (grant/revoke)\n"
@@ -253,7 +259,7 @@ version(void)
 {
    puts("pg_dump (PostgreSQL) " PG_VERSION);
    puts("Portions Copyright (c) 1996-2000, PostgreSQL, Inc");
-   puts("Portions Copyright (C) 1996 Regents of the University of California");
+   puts("Portions Copyright (c) 1996 Regents of the University of California");
    puts("Read the file COPYRIGHT to see the usage and distribution terms.");
 }
 
@@ -718,10 +724,24 @@ main(int argc, char **argv)
        outputBlobs = true;
    }
 
+   if (argc > 1)
+   {
+       if (strcmp(argv[1], "--help")==0 || strcmp(argv[1], "-?")==0)
+       {
+           help(progname);
+           exit(0);
+       }
+       if (strcmp(argv[1], "--version")==0 || strcmp(argv[1], "-V")==0)
+       {
+           version();
+           exit(0);
+       }
+   }
+
 #ifdef HAVE_GETOPT_LONG
-   while ((c = getopt_long(argc, argv, "abcCdDf:F:h:inNoOp:sS:t:uvxzZ:V?", long_options, &optindex)) != -1)
+   while ((c = getopt_long(argc, argv, "abcCdDf:F:h:inNoOp:RsS:t:uvxzZ:V?", long_options, &optindex)) != -1)
 #else
-   while ((c = getopt(argc, argv, "abcCdDf:F:h:inNoOp:sS:t:uvxzZ:V?-")) != -1)
+   while ((c = getopt(argc, argv, "abcCdDf:F:h:inNoOp:RsS:t:uvxzZ:V?-")) != -1)
 #endif
 
    {
@@ -852,32 +872,15 @@ main(int argc, char **argv)
                exit(0);
                break;
 
-           case '?':
-
-               /*
-                * getopt returns '?' on unknown argument. That's not
-                * quite what we want
-                */
-               if (strcmp(argv[optind - 1], "-?") == 0 || strcmp(argv[optind - 1], "--help") == 0)
-               {
-                   help(progname);
-                   exit(1);
-               }
-               else
-               {
-                   fputs("Try -? for help.\n", stderr);
-                   exit(1);
-               }
-               break;
 #ifndef HAVE_GETOPT_LONG
            case '-':
                fprintf(stderr, "%s was compiled without support for long options.\n"
-                  "Use -? for help on invocation options.\n", progname);
+                  "Use --help for help on invocation options.\n", progname);
                exit(1);
                break;
 #endif
            default:
-               fprintf(stderr, "%s: unknown option -%c\nTry -? for help.\n", progname, c);
+               fprintf(stderr, "Try '%s --help' for more information.\n", progname);
                exit(1);
        }
    }
@@ -885,7 +888,7 @@ main(int argc, char **argv)
    if (optind < (argc - 1)) {
        fprintf(stderr,
                "%s: extra parameters found on command line after '%s' (first is '%s').\n"
-               "Please respecify command.\nUse -? for help on invocation options.\n",
+               "Please respecify command.\nUse --help for help on invocation options.\n",
                progname, argv[optind], argv[optind+1]);
        exit(1);
    }
diff --git a/src/bin/pg_dump/pg_restore.c b/src/bin/pg_dump/pg_restore.c
index d8049df81b2cf7703de782a97eb0e16063dbc888..7d701c90fa1c401bbf740c4fb4c14be204cc4c2f 100644 (file)
--- a/src/bin/pg_dump/pg_restore.c
+++ b/src/bin/pg_dump/pg_restore.c
@@ -129,7 +129,21 @@ int main(int argc, char **argv)
 
    opts = NewRestoreOptions();
 
-   progname = *argv;
+   progname = argv[0];
+
+   if (argc > 1)
+   {
+       if (strcmp(argv[1], "--help")==0 || strcmp(argv[1], "-?")==0)
+       {
+           usage(progname);
+           exit(0);
+       }
+       if (strcmp(argv[1], "--version")==0 || strcmp(argv[1], "-V")==0)
+       {
+           puts("pg_restore (PostgreSQL) " PG_VERSION);
+           exit(0);
+       }
+   }
 
 #ifdef HAVE_GETOPT_LONG
    while ((c = getopt_long(argc, argv, "acCd:f:F:h:i:lNoOp:P:rRsS:t:T:uU:vx", cmdopts, NULL)) != EOF)
@@ -235,8 +249,8 @@ int main(int argc, char **argv)
                opts->aclsSkip = 1;
                break;
            default:
-               usage(progname);
-               break;
+               fprintf(stderr, "Try '%s --help' for more information.\n", progname);
+               exit(1);
        }
    }
 
@@ -311,72 +325,76 @@ int main(int argc, char **argv)
 
 static void usage(const char *progname)
 {
+   printf("%s restores a PostgreSQL database from an archive created by pg_dump.\n\n"
+          "Usage:\n  %s [options] [backup file]\n\n"
+          "Options:\n",
+          progname, progname);
 #ifdef HAVE_GETOPT_LONG
-   fprintf(stderr,
-   "usage:  %s [options] [backup file]\n"
-       "  -a, --data-only             \t dump out only the data, no schema\n"
-       "  -d, --dbname          \t specify database name\n"
-       "  -c, --clean                 \t clean(drop) schema prior to create\n"
-       "  -C, --create                \t output commands to create the database\n"
-       "  -f filename                 \t script output filename\n"
-       "  -F, --format {c|f}          \t specify backup file format\n"
-       "  -h, --host        \t server host name\n"
-       "  -i, --index[=name]          \t dump indexes or named index\n"
-       "  -l, --list                  \t dump summarized TOC for this file\n"
-       "  -N, --orig-order            \t dump in original dump order\n"
-       "  -o, --oid-order             \t dump in oid order\n"
-       "  -O, --no-owner              \t don't output reconnect to database to match object owner\n"
-       "  -p, --port            \t server port number\n"
-       "  -P, --function[=name]       \t dump functions or named function\n"
-       "  -r, --rearrange             \t rearrange output to put indexes etc at end\n"
-       "  -R, --no-reconnect          \t disallow ALL reconnections to the database\n"
-       "  -s, --schema-only           \t dump out only the schema, no data\n"
-       "  -S, --superuser       \t specify the superuser username to use in disabling triggers\n"
-       "  -t [table], --table[=table] \t dump for this table only\n"
-       "  -T, --trigger[=name]        \t dump triggers or named trigger\n"
-       "  -u, --password              \t use password authentication\n"
-       "  -U, --use-list filename     \t use specified TOC for ordering output from this file\n"
-       "  -v, --verbose               \t verbose\n"
-       "  -x, --no-acl                \t skip dumping of ACLs (grant/revoke)\n"
-       , progname);
-
-#else
-   fprintf(stderr,
-   "usage:  %s [options] [backup file]\n"
-       "  -a                          \t dump out only the data, no schema\n"
-       "  -d                    \t specify database name\n"
-       "  -c                          \t clean(drop) schema prior to create\n"
-       "  -C                          \t output commands to create the database\n"
-       "  -f filename                 \t script output filename\n"
-       "  -F {c|f}                    \t specify backup file format\n"
-       "  -h                \t server host name\n"
-       "  -i name                     \t dump indexes or named index\n"
-       "  -l                          \t dump summarized TOC for this file\n"
-       "  -N                          \t dump in original dump order\n"
-       "  -o                          \t dump in oid order\n"
-       "  -O                          \t don't output reconnect to database to match object owner\n"
-       "  -p                    \t server port number\n"
-       "  -P name                     \t dump functions or named function\n"
-       "  -r                          \t rearrange output to put indexes etc at end\n"
-       "  -R                          \t disallow ALL reconnections to the database\n"
-       "  -s                          \t dump out only the schema, no data\n"
-       "  -S                    \t specify the superuser username to use in disabling triggers\n"
-       "  -t name                     \t dump for this table only\n"
-       "  -T name                     \t dump triggers or named trigger\n"
-       "  -u                          \t use password authentication\n"
-       "  -U filename                 \t use specified TOC for ordering output from this file\n"
-       "  -v                          \t verbose\n"
-       "  -x                          \t skip dumping of ACLs (grant/revoke)\n"
-       , progname);
+   puts(
+       "  -a, --data-only          dump out only the data, no schema\n"
+       "  -c, --clean              clean (drop) schema prior to create\n"
+       "  -C, --create             output commands to create the database\n"
+       "  -d, --dbname=NAME        specify database name\n"
+       "  -f, --file=FILENAME      script output file name\n"
+       "  -F, --format {c|f}       specify backup file format\n"
+       "  -h, --host HOSTNAME      server host name\n"
+       "  -i, --index[=NAME]       dump indexes or named index\n"
+       "  -l, --list               dump summarized TOC for this file\n"
+       "  -N, --orig-order         dump in original dump order\n"
+       "  -o, --oid-order          dump in oid order\n"
+       "  -O, --no-owner           do not output reconnect to database to match\n"
+       "                           object owner\n"
+       "  -p, --port PORT          server port number\n"
+       "  -P, --function[=NAME]    dump functions or named function\n"
+       "  -r, --rearrange          rearrange output to put indexes etc. at end\n"
+       "  -R, --no-reconnect       disallow ALL reconnections to the database\n"
+       "  -s, --schema-only        dump out only the schema, no data\n"
+       "  -S, --superuser=NAME     specify the superuser user name to use for\n"
+       "                           disabling triggers\n"
+       "  -t [TABLE], --table[=TABLE]  dump for this table only\n"
+       "  -T, --trigger[=NAME]     dump triggers or named trigger\n"
+       "  -u, --password           use password authentication\n"
+       "  -U, --use-list=FILENAME  use specified table of contents for ordering\n"
+       "                           output from this file\n"
+       "  -v, --verbose            verbose\n"
+       "  -x, --no-acl             skip dumping of ACLs (grant/revoke)\n");
+
+#else /* not HAVE_GETOPT_LONG */
+
+   puts(
+       "  -a                       dump out only the data, no schema\n"
+       "  -c                       clean (drop) schema prior to create\n"
+       "  -C                       output commands to create the database\n"
+       "  -d NAME                  specify database name\n"
+       "  -f FILENAME              script output file name\n"
+       "  -F {c|f}                 specify backup file format\n"
+       "  -h HOSTNAME              server host name\n"
+       "  -i NAME                  dump indexes or named index\n"
+       "  -l                       dump summarized TOC for this file\n"
+       "  -N                       dump in original dump order\n"
+       "  -o                       dump in oid order\n"
+       "  -O                       do not output reconnect to database to match\n"
+       "                           object owner\n"
+       "  -p PORT                  server port number\n"
+       "  -P NAME                  dump functions or named function\n"
+       "  -r                       rearrange output to put indexes etc at end\n"
+       "  -R                       disallow ALL reconnections to the database\n"
+       "  -s                       dump out only the schema, no data\n"
+       "  -S NAME                  specify the superuser user name to use for\n"
+       "                           disabling triggers\n"
+       "  -t NAME                  dump for this table only\n"
+       "  -T NAME                  dump triggers or named trigger\n"
+       "  -u                       use password authentication\n"
+       "  -U FILENAME              use specified table of contents for ordering\n"
+       "                           output from this file\n"
+       "  -v                       verbose\n"
+       "  -x                       skip dumping of ACLs (grant/revoke)\n");
 #endif
-   fprintf(stderr,
-           "\nIf [backup file] is not supplied, then standard input "
-           "is used.\n");
-   fprintf(stderr, "\n");
-
-   exit(1);
+   puts("If [backup file] is not supplied, then standard input is used.\n");
+   puts("Report bugs to .");
 }
 
+
 static char* _cleanupName(char* name)
 {
     int        i;
This is the main PostgreSQL git repository.