@crossbind/port-gdal-wasi 2.0.0-beta.50

package/dist/prebuilt/wasi-wasm32-st-release/share/man/man1/gdal-vector-export-schema.1

@@ -0,0 +1,194 @@
+.\" Man page generated from reStructuredText.
+.
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.TH "GDAL-VECTOR-EXPORT-SCHEMA" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal-vector-export-schema \- Export the OGR_SCHEMA from a vector dataset
+.sp
+Added in version 3.13.
+
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal vector export\-schema [OPTIONS] <INPUT>...
+
+Export the OGR_SCHEMA from a vector dataset.
+
+Positional arguments:
+  \-i, \-\-dataset, \-\-input <INPUT>            Input vector datasets [may be repeated] [required]
+
+Common Options:
+  \-h, \-\-help                                Display help message and exit
+  \-\-json\-usage                              Display usage as JSON document and exit
+  \-\-config <KEY>=<VALUE>                    Configuration option [may be repeated]
+
+Options:
+  \-l, \-\-layer, \-\-input\-layer <INPUT\-LAYER>  Input layer name [may be repeated]
+
+Advanced Options:
+  \-\-oo, \-\-open\-option <KEY>=<VALUE>         Open options [may be repeated]
+  \-\-if, \-\-input\-format <INPUT\-FORMAT>       Input formats [may be repeated]
+.EE
+.UNINDENT
+.UNINDENT
+.SH DESCRIPTION
+.sp
+\fBgdal vector export\-schema\fP exports the \fBOGR_SCHEMA\fP from a GDAL\-supported
+vector dataset, and returns it on the standard output stream when used from the
+command line, or in the \fBoutput\fP parameter when used from the API.
+.sp
+\fBOGR_SCHEMA\fP is a JSON object describing the structure of a vector dataset
+according to the schema definition at \X'tty: link https://github.com/OSGeo/gdal/blob/release/3.13/ogr/data/ogr_fields_override.schema.json'\fI\%ogr_fields_override.schema.json\fP\X'tty: link'
+.sp
+\fBgdal vector export\-schema\fP can be used as the last
+step of a pipeline.
+.sp
+The following options are available:
+.SH PROGRAM-SPECIFIC OPTIONS
+.INDENT 0.0
+.TP
+.B \-l, \-\-layer, \-\-input\-layer <INPUT\-LAYER>
+Name of one or more layers to inspect. If no layer names are passed,
+then all layers will be selected.
+.UNINDENT
+.SH STANDARD OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-oo, \-\-open\-option <NAME>=<VALUE>
+Dataset open option (format specific).
+.sp
+May be repeated.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-if, \-\-input\-format <format>
+Format/driver name to be attempted to open the input file(s). It is generally
+not necessary to specify it, but it can be used to skip automatic driver
+detection, when it fails to select the appropriate driver.
+This option can be repeated several times to specify several candidate drivers.
+Note that it does not force those drivers to open the dataset. In particular,
+some drivers have requirements on file extensions.
+.sp
+May be repeated.
+.UNINDENT
+.SH RETURN STATUS CODE
+.sp
+The program returns status code 0 in case of success, and non\-zero in case of
+error (non\-blocking errors emitted as warnings are considered as a successful
+execution).
+.SH EXAMPLES
+.SS Example 1: Extracting the OGR_SCHEMA from the file poly.gpkg
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal vector export\-schema poly.gpkg
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 2: Save the OGR_SCHEMA to a file
+.sp
+When using Windows PowerShell 5.1, redirecting output with \fB>\fP or \fBOut\-File \-Encoding utf8\fP
+produces UTF\-8 with a BOM (Byte Order Mark). When using the schema with \fI\%gdal vector create\fP
+it may fail with \fBERROR 1: JSON parsing error: unexpected character (at offset 0)\fP\&.
+.sp
+In PowerShell 5.1, use \fB\-Encoding ascii\fP for JSON output that contains no non\-ASCII characters.
+Bash
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal vector export\-schema natural_earth_vector.gpkg \-\-layer \(dqne_50m_admin_0_countries\(dq > countries.json
+.EE
+.UNINDENT
+.UNINDENT
+PowerShell
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+# PowerShell 5.1
+gdal vector export\-schema natural_earth_vector.gpkg \-\-layer \(dqne_50m_admin_0_countries\(dq | Out\-File countries.json \-Encoding ascii
+
+# PowerShell 7+
+gdal vector export\-schema natural_earth_vector.gpkg \-\-layer \(dqne_50m_admin_0_countries\(dq | Out\-File countries.json \-Encoding utf8
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 3: Validate an OGR_SCHEMA file using Python
+.sp
+Validate against the latest version of the schema definition at \X'tty: link https://github.com/OSGeo/gdal/blob/release/3.13/ogr/data/ogr_fields_override.schema.json'\fI\%ogr_fields_override.schema.json\fP\X'tty: link'
+using the Python package \X'tty: link https://pypi.org/project/check-jsonschema/'\fI\%check\-jsonschema\fP\X'tty: link' available on PyPI.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ pip install check\-jsonschema
+$ check\-jsonschema \-\-schemafile https://raw.githubusercontent.com/OSGeo/gdal/master/ogr/data/ogr_fields_override.schema.json countries.json \-\-verbose
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 4: Create an OGR_SCHEMA at the end of a pipeline
+.sp
+This example renames the field \fBpop_est\fP to \fBestimated_population\fP and changes its
+type from \fBReal\fP to \fBInteger\fP, before exporting the resulting OGR_SCHEMA.
+Bash
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal vector pipeline \e
+    ! read natural_earth_vector.gpkg \-\-layer ne_50m_admin_0_countries \e
+    ! sql \-\-sql \(dqSELECT geom,name,abbrev,pop_est AS estimated_population FROM ne_50m_admin_0_countries\(dq \-\-output\-layer \(dqcountries\(dq \e
+    ! set\-field\-type \-\-field\-name \(dqestimated_population\(dq \-\-field\-type Integer \e
+    ! export\-schema
+.EE
+.UNINDENT
+.UNINDENT
+PowerShell
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal vector pipeline \(ga
+    ! read natural_earth_vector.gpkg \-\-layer ne_50m_admin_0_countries \(ga
+    ! sql \-\-sql \(dqSELECT geom,name,abbrev,pop_est AS estimated_population FROM ne_50m_admin_0_countries\(dq \-\-output\-layer \(dqcountries\(dq \(ga
+    ! set\-field\-type \-\-field\-name \(dqestimated_population\(dq \-\-field\-type Integer \(ga
+    ! export\-schema
+.EE
+.UNINDENT
+.UNINDENT
+.SH AUTHOR
+Alessandro Pasotti <elpaso@itopen.it>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.

package/dist/prebuilt/wasi-wasm32-st-release/share/man/man1/gdal-vector-filter.1

@@ -0,0 +1,293 @@
+.\" Man page generated from reStructuredText.
+.
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.TH "GDAL-VECTOR-FILTER" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal-vector-filter \- Filter a vector dataset
+.sp
+Added in version 3.11.
+
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal vector filter [OPTIONS] <INPUT> <OUTPUT>
+
+Filter a vector dataset.
+
+Positional arguments:
+  \-i, \-\-input <INPUT>                                  Input vector datasets [required] [not available in pipelines]
+  \-o, \-\-output <OUTPUT>                                Output vector dataset [required] [not available in pipelines]
+
+Common Options:
+  \-h, \-\-help                                           Display help message and exit
+  \-\-json\-usage                                         Display usage as JSON document and exit
+  \-\-config <KEY>=<VALUE>                               Configuration option [may be repeated]
+  \-q, \-\-quiet                                          Quiet mode (no progress bar or warning message) [not available in pipelines]
+
+Options:
+  \-l, \-\-layer, \-\-input\-layer <INPUT\-LAYER>             Input layer name(s) [may be repeated] [not available in pipelines]
+  \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>  Output format (\(dqGDALG\(dq allowed) [not available in pipelines]
+  \-\-co, \-\-creation\-option <KEY>=<VALUE>                Creation option [may be repeated] [not available in pipelines]
+  \-\-lco, \-\-layer\-creation\-option <KEY>=<VALUE>         Layer creation option [may be repeated] [not available in pipelines]
+  \-\-overwrite                                          Whether overwriting existing output dataset is allowed [not available in pipelines]
+  \-\-update                                             Whether to open existing dataset in update mode [not available in pipelines]
+  \-\-overwrite\-layer                                    Whether overwriting existing output layer is allowed [not available in pipelines]
+  \-\-append                                             Whether appending to existing layer is allowed [not available in pipelines]
+                                                       Mutually exclusive with \-\-upsert
+  \-\-output\-layer <OUTPUT\-LAYER>                        Output layer name [not available in pipelines]
+  \-\-skip\-errors                                        Skip errors when writing features [not available in pipelines]
+  \-\-active\-layer <ACTIVE\-LAYER>                        Set active layer (if not specified, all)
+  \-\-bbox <BBOX>                                        Bounding box as xmin,ymin,xmax,ymax
+  \-\-where <WHERE>|@<filename>                          Attribute query in a restricted form of the queries used in the SQL WHERE statement
+  \-\-update\-extent                                      Update layer extent to take into account the filter
+
+Advanced Options:
+  \-\-if, \-\-input\-format <INPUT\-FORMAT>                  Input formats [may be repeated] [not available in pipelines]
+  \-\-oo, \-\-open\-option <KEY>=<VALUE>                    Open options [may be repeated] [not available in pipelines]
+  \-\-output\-oo, \-\-output\-open\-option <KEY>=<VALUE>      Output open options [may be repeated] [not available in pipelines]
+  \-\-upsert                                             Upsert features (implies \(aqappend\(aq) [not available in pipelines]
+                                                       Mutually exclusive with \-\-append
+.EE
+.UNINDENT
+.UNINDENT
+.SH DESCRIPTION
+.sp
+\fBgdal vector filter\fP can be used to filter a vector dataset from
+their spatial extent or a SQL WHERE clause.
+.sp
+\fBfilter\fP can also be used as a step of \fI\%gdal vector pipeline\fP\&.
+.SH GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET)
+.sp
+This program supports serializing the command line as a JSON file using the \fBGDALG\fP output format.
+The resulting file can then be opened as a vector dataset using the
+\fI\%GDALG: GDAL Streamed Algorithm\fP driver, and apply the specified pipeline in a on\-the\-fly /
+streamed way.
+.SH PROGRAM-SPECIFIC OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-bbox <xmin>,<ymin>,<xmax>,<ymax>
+Bounds to which to filter the dataset. They are assumed to be in the CRS of
+the input dataset.
+The X and Y axis are the \(dqGIS friendly ones\(dq, that is X is longitude or easting,
+and Y is latitude or northing.
+Note that filtering does not clip geometries to the bounding box.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-update\-extent
+Update layer extent to take into account the filter(s). Otherwise the layer
+extent will generally be the one of the source layer before applying the
+filter(s). Note that using this option requires doing a full scan of the
+filtered layers.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-where <WHERE>|@<filename>
+Attribute query (like SQL WHERE).
+.UNINDENT
+.SH STANDARD OPTIONS
+.INDENT 0.0
+.TP
+.B \-\-active\-layer <ACTIVE\-LAYER>
+Set the active layer. When it is specified, only the layer specified by
+its name will be subject to the processing. Other layers will be not
+modified.
+If this option is not specified, all layers will be subject to the
+processing.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-append
+Whether appending features to existing layer(s) is allowed.
+This also creates the output dataset if it does not exist yet.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-co, \-\-creation\-option <NAME>=<VALUE>
+Many formats have one or more optional dataset creation options that can be
+used to control particulars about the file created. For instance,
+the GeoPackage driver supports creation options to control the version.
+.sp
+May be repeated.
+.sp
+The dataset creation options available vary by format driver, and some
+simple formats have no creation options at all. A list of options
+supported for a format can be listed with the
+\fI\%\-\-formats\fP
+command line option but the documentation for the format is the
+definitive source of information on driver creation options.
+See \fI\%Vector drivers\fP format
+specific documentation for legal creation options for each format.
+.sp
+Note that dataset creation options are different from layer creation options.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-if, \-\-input\-format <format>
+Format/driver name to be attempted to open the input file(s). It is generally
+not necessary to specify it, but it can be used to skip automatic driver
+detection, when it fails to select the appropriate driver.
+This option can be repeated several times to specify several candidate drivers.
+Note that it does not force those drivers to open the dataset. In particular,
+some drivers have requirements on file extensions.
+.sp
+May be repeated.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-input\-layer <INPUT\-LAYER>
+Specifies the name of one or more layers to process. By default, all layers will be processed. To read and write all layers but only
+process a subset, use \fI\%\-\-active\-layer\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-lco, \-\-layer\-creation\-option <NAME>=<VALUE>
+Many formats have one or more optional layer creation options that can be
+used to control particulars about the layer created. For instance,
+the GeoPackage driver supports layer creation options to control the
+feature identifier or geometry column name, setting the identifier or
+description, etc.
+.sp
+May be repeated.
+.sp
+The layer creation options available vary by format driver, and some
+simple formats have no layer creation options at all. A list of options
+supported for a format can be listed with the
+\fI\%\-\-formats\fP
+command line option but the documentation for the format is the
+definitive source of information on driver creation options.
+See \fI\%Vector drivers\fP format
+specific documentation for legal creation options for each format.
+.sp
+Note that layer creation options are different from dataset creation options.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-oo, \-\-open\-option <NAME>=<VALUE>
+Dataset open option (format specific).
+.sp
+May be repeated.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-f, \-\-of, \-\-format, \-\-output\-format <OUTPUT\-FORMAT>
+Which output vector format to use. Allowed values may be given by
+\fBgdal \-\-formats | grep vector | grep rw | sort\fP
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-output\-layer <NAME>
+Specifies the name of the layer to which features will be written. If not
+specified, output layer names will be the same as input layer names.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-output\-open\-option, \-\-output\-oo <NAME>=<VALUE>
+Added in version 3.12.
+
+.sp
+Dataset open option for output dataset (format specific).
+.sp
+May be repeated.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-overwrite
+Allow program to overwrite existing target file or dataset.
+Otherwise, by default, \fBgdal\fP errors out if the target file or
+dataset already exists.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-overwrite\-layer
+Whether overwriting the existing output vector layer is allowed.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-skip\-errors
+Added in version 3.12.
+
+.sp
+Whether failures to write feature(s) should be ignored. Note that this option
+sets the size of the transaction unit to one feature at a time, which may
+cause severe slowdown when inserting into databases.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-update
+Whether to open an existing output dataset in update mode.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-upsert
+Added in version 3.12.
+
+.sp
+Variant of \fI\%\-\-append\fP where the \fI\%OGRLayer::UpsertFeature()\fP
+operation is used to insert or update features instead of appending with
+\fI\%OGRLayer::CreateFeature()\fP\&.
+.sp
+This is currently implemented only in a few drivers:
+\fI\%GPKG \-\- GeoPackage vector\fP, \fI\%Elasticsearch: Geographically Encoded Objects for Elasticsearch\fP and \fI\%MongoDBv3\fP
+(drivers that implement upsert expose the \fI\%GDAL_DCAP_UPSERT\fP
+capability).
+.sp
+The upsert operation uses the FID of the input feature, when it is set
+(and the FID column name is not the empty string),
+as the key to update existing features. It is crucial to make sure that
+the FID in the source and target layers are consistent.
+.sp
+For the GPKG driver, it is also possible to upsert features whose FID is unset
+or non\-significant (the \fB\-\-unset\-fid\fP option of \fI\%gdal vector edit\fP
+can be used to ignore the FID from the source feature), when there is a
+UNIQUE column that is not the integer primary key.
+.UNINDENT
+.SH RETURN STATUS CODE
+.sp
+The program returns status code 0 in case of success, and non\-zero in case of
+error (non\-blocking errors emitted as warnings are considered as a successful
+execution).
+.SH EXAMPLES
+.SS Example 1: Select features from a GeoPackage file that intersect the bounding box from longitude 2, latitude 49, to longitude 3, latitude 50 in WGS 84
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ gdal vector filter \-\-bbox=2,49,3,50 in.gpkg out.gpkg \-\-overwrite
+.EE
+.UNINDENT
+.UNINDENT
+.SH AUTHOR
+Even Rouault <even.rouault@spatialys.com>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.