PostGIS  2.5.0dev-r@@SVN_REVISION@@

◆ usage()

static void usage ( )
static

Definition at line 324 of file raster2pgsql.c.

References _, POSTGIS_LIB_VERSION, and SRID_UNKNOWN.

Referenced by main().

324  {
325  printf(_("RELEASE: %s GDAL_VERSION=%d (r%d)\n"), POSTGIS_LIB_VERSION, POSTGIS_GDAL_VERSION, POSTGIS_SVN_REVISION);
326  printf(_(
327  "USAGE: raster2pgsql [<options>] <raster>[ <raster>[ ...]] [[<schema>.]<table>]\n"
328  " Multiple rasters can also be specified using wildcards (*,?).\n"
329  "\n"
330  "OPTIONS:\n"
331  ));
332  /*
333  printf(_(
334  " -s [<from>:]<srid> Set the SRID field. Defaults to %d.\n"
335  " Optionally reprojects from given SRID (cannot be used with -Y).\n"
336  " Raster's metadata will be checked to determine an appropriate SRID.\n"
337  " If a srid of %d is provided (either as from or as target).\n"
338  ), SRID_UNKNOWN, SRID_UNKNOWN);
339  */
340  printf(_(
341  " -s <srid> Set the SRID field. Defaults to %d. If SRID not\n"
342  " provided or is %d, raster's metadata will be checked to\n"
343  " determine an appropriate SRID.\n"
345  printf(_(
346  " -b <band> Index (1-based) of band to extract from raster. For more\n"
347  " than one band index, separate with comma (,). Ranges can be\n"
348  " defined by separating with dash (-). If unspecified, all bands\n"
349  " of raster will be extracted.\n"
350  ));
351  printf(_(
352  " -t <tile size> Cut raster into tiles to be inserted one per\n"
353  " table row. <tile size> is expressed as WIDTHxHEIGHT.\n"
354  " <tile size> can also be \"auto\" to allow the loader to compute\n"
355  " an appropriate tile size using the first raster and applied to\n"
356  " all rasters.\n"
357  ));
358  printf(_(
359  " -P Pad right-most and bottom-most tiles to guarantee that all tiles\n"
360  " have the same width and height.\n"
361  ));
362  printf(_(
363  " -R Register the raster as an out-of-db (filesystem) raster. Provided\n"
364  " raster should have absolute path to the file\n"
365  ));
366  printf(_(
367  " (-d|a|c|p) These are mutually exclusive options:\n"
368  " -d Drops the table, then recreates it and populates\n"
369  " it with current raster data.\n"
370  " -a Appends raster into current table, must be\n"
371  " exactly the same table schema.\n"
372  " -c Creates a new table and populates it, this is the\n"
373  " default if you do not specify any options.\n"
374  " -p Prepare mode, only creates the table.\n"
375  ));
376  printf(_(
377  " -f <column> Specify the name of the raster column\n"
378  ));
379  printf(_(
380  " -F Add a column with the filename of the raster.\n"
381  ));
382  printf(_(
383  " -n <column> Specify the name of the filename column. Implies -F.\n"
384  ));
385  printf(_(
386  " -l <overview factor> Create overview of the raster. For more than\n"
387  " one factor, separate with comma(,). Overview table name follows\n"
388  " the pattern o_<overview factor>_<table>. Created overview is\n"
389  " stored in the database and is not affected by -R.\n"
390  ));
391  printf(_(
392  " -q Wrap PostgreSQL identifiers in quotes.\n"
393  ));
394  printf(_(
395  " -I Create a GIST spatial index on the raster column. The ANALYZE\n"
396  " command will automatically be issued for the created index.\n"
397  ));
398  printf(_(
399  " -M Run VACUUM ANALYZE on the table of the raster column. Most\n"
400  " useful when appending raster to existing table with -a.\n"
401  ));
402  printf(_(
403  " -C Set the standard set of constraints on the raster\n"
404  " column after the rasters are loaded. Some constraints may fail\n"
405  " if one or more rasters violate the constraint.\n"
406  " -x Disable setting the max extent constraint. Only applied if\n"
407  " -C flag is also used.\n"
408  " -r Set the constraints (spatially unique and coverage tile) for\n"
409  " regular blocking. Only applied if -C flag is also used.\n"
410  ));
411  printf(_(
412  " -T <tablespace> Specify the tablespace for the new table.\n"
413  " Note that indices (including the primary key) will still use\n"
414  " the default tablespace unless the -X flag is also used.\n"
415  ));
416  printf(_(
417  " -X <tablespace> Specify the tablespace for the table's new index.\n"
418  " This applies to the primary key and the spatial index if\n"
419  " the -I flag is used.\n"
420  ));
421  printf(_(
422  " -N <nodata> NODATA value to use on bands without a NODATA value.\n"
423  ));
424  printf(_(
425  " -k Skip NODATA value checks for each raster band.\n"
426  ));
427  printf(_(
428  " -E <endian> Control endianness of generated binary output of\n"
429  " raster. Use 0 for XDR and 1 for NDR (default). Only NDR\n"
430  " is supported at this time.\n"
431  ));
432  printf(_(
433  " -V <version> Specify version of output WKB format. Default\n"
434  " is 0. Only 0 is supported at this time.\n"
435  ));
436  printf(_(
437  " -e Execute each statement individually, do not use a transaction.\n"
438  ));
439  printf(_(
440  " -Y Use COPY statements instead of INSERT statements.\n"
441  ));
442  printf(_(
443  " -G Print the supported GDAL raster formats.\n"
444  ));
445  printf(_(
446  " -? Display this help screen.\n"
447  ));
448 }
#define _(String)
Definition: shpcommon.h:24
#define POSTGIS_LIB_VERSION
Definition: sqldefines.h:12
#define SRID_UNKNOWN
Unknown SRID value.
Definition: liblwgeom.h:187
Here is the caller graph for this function: