usage()

static void usage ( )

static

Definition at line 339 of file raster2pgsql.c.

        {
        printf(_("RELEASE: %s GDAL_VERSION=%d (%s)\n"), POSTGIS_LIB_VERSION, POSTGIS_GDAL_VERSION, xstr(POSTGIS_REVISION));
        printf(_(
                "USAGE: raster2pgsql [<options>] <raster>[ <raster>[ ...]] [[<schema>.]<table>]\n"
                "  Multiple rasters can also be specified using wildcards (*,?).\n"
                "\n"
                "OPTIONS:\n"
        ));
        /*
        printf(_(
                "  -s [<from>:]<srid> Set the SRID field. Defaults to %d.\n"
                "     Optionally reprojects from given SRID (cannot be used with -Y).\n"
                "     Raster's metadata will be checked to determine an appropriate SRID.\n"
                "     If a srid of %d is provided (either as from or as target).\n"
        ), SRID_UNKNOWN, SRID_UNKNOWN);
        */
        printf(_(
                "  -s <srid> Set the SRID field. Defaults to %d. If SRID not\n"
                "     provided or is %d, raster's metadata will be checked to\n"
                "     determine an appropriate SRID.\n"
        ), SRID_UNKNOWN, SRID_UNKNOWN);
        printf(_(
                "  -b <band> Index (1-based) of band to extract from raster. For more\n"
                "      than one band index, separate with comma (,). Ranges can be\n"
                "      defined by separating with dash (-). If unspecified, all bands\n"
                "      of raster will be extracted.\n"
        ));
        printf(_(
                "  -t <tile size> Cut raster into tiles to be inserted one per\n"
                "      table row. <tile size> is expressed as WIDTHxHEIGHT.\n"
                "      <tile size> can also be \"auto\" to allow the loader to compute\n"
                "      an appropriate tile size using the first raster and applied to\n"
                "      all rasters.\n"
        ));
        printf(_(
                "  -P Pad right-most and bottom-most tiles to guarantee that all tiles\n"
                "     have the same width and height.\n"
        ));
        printf(_(
                "  -R  Register the raster as an out-of-db (filesystem) raster. Provided\n"
                "      raster should have absolute path to the file\n"
        ));
        printf(_(
                " (-d|a|c|p) These are mutually exclusive options:\n"
                "     -d  Drops the table, then recreates it and populates\n"
                "         it with current raster data.\n"
                "     -a  Appends raster into current table, must be\n"
                "         exactly the same table schema.\n"
                "     -c  Creates a new table and populates it, this is the\n"
                "         default if you do not specify any options.\n"
                "     -p  Prepare mode, only creates the table.\n"
        ));
        printf(_(
                "  -f <column> Specify the name of the raster column\n"
        ));
        printf(_(
                "  -F  Add a column with the filename of the raster.\n"
        ));
        printf(_(
                "  -n <column> Specify the name of the filename column. Implies -F.\n"
        ));
        printf(_(
                "  -l <overview factor> Create overview of the raster. For more than\n"
                "      one factor, separate with comma(,). Overview table name follows\n"
                "      the pattern o_<overview factor>_<table>. Created overview is\n"
                "      stored in the database and is not affected by -R.\n"
        ));
        printf(_(
                "  -q  Wrap PostgreSQL identifiers in quotes.\n"
        ));
        printf(_(
                "  -I  Create a GIST spatial index on the raster column. The ANALYZE\n"
                "      command will automatically be issued for the created index.\n"
        ));
        printf(_(
                "  -M  Run VACUUM ANALYZE on the table of the raster column. Most\n"
                "      useful when appending raster to existing table with -a.\n"
        ));
        printf(_(
                "  -C  Set the standard set of constraints on the raster\n"
                "      column after the rasters are loaded. Some constraints may fail\n"
                "      if one or more rasters violate the constraint.\n"
                "  -x  Disable setting the max extent constraint. Only applied if\n"
                "      -C flag is also used.\n"
                "  -r  Set the constraints (spatially unique and coverage tile) for\n"
                "      regular blocking. Only applied if -C flag is also used.\n"
        ));
        printf(_(
                "  -T <tablespace> Specify the tablespace for the new table.\n"
                "      Note that indices (including the primary key) will still use\n"
                "      the default tablespace unless the -X flag is also used.\n"
        ));
        printf(_(
                "  -X <tablespace> Specify the tablespace for the table's new index.\n"
                "      This applies to the primary key and the spatial index if\n"
                "      the -I flag is used.\n"
        ));
        printf(_(
                "  -N <nodata> NODATA value to use on bands without a NODATA value.\n"
        ));
        printf(_(
                "  -k  Keep empty tiles by skipping NODATA value checks for each raster band. \n"
        ));
        printf(_(
                "  -E <endian> Control endianness of generated binary output of\n"
                "      raster. Use 0 for XDR and 1 for NDR (default). Only NDR\n"
                "      is supported at this time.\n"
        ));
        printf(_(
                "  -V <version> Specify version of output WKB format. Default\n"
                "      is 0. Only 0 is supported at this time.\n"
        ));
        printf(_(
                "  -e  Execute each statement individually, do not use a transaction.\n"
        ));
        printf(_(
                "  -Y <max_rows_per_copy> Use COPY statements instead of INSERT statements. \n"
                "    Optionally specify <max_rows_per_copy>; default 50 when not specified. \n"
        ));
 
        printf(_(
                "  -G  Print the supported GDAL raster formats.\n"
        ));
        printf(_(
                "  -?  Display this help screen.\n"
        ));
}

References _, POSTGIS_GDAL_VERSION, POSTGIS_LIB_VERSION, SRID_UNKNOWN, and xstr.

Referenced by main().

Here is the caller graph for this function: