PostGIS  2.5.0beta2dev-r@@SVN_REVISION@@

◆ usage()

static void usage ( )
static

Definition at line 327 of file raster2pgsql.c.

References _, POSTGIS_LIB_VERSION, and SRID_UNKNOWN.

Referenced by main().

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