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

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

@@ -0,0 +1,387 @@
+.\" 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-CONCAT" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal-vector-concat \- Concatenate vector datasets
+.sp
+Added in version 3.11.
+
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal vector concat [OPTIONS] <INPUTS>... <OUTPUT>
+
+Concatenate vector datasets.
+
+Positional arguments:
+  \-i, \-\-input <INPUTS>                                       Input vector datasets [1.. values] [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
+  \-\-skip\-errors                                              Skip errors when writing features [not available in pipelines]
+  \-\-mode <MODE>                                              Determine the strategy to create output layers from source layers . MODE=merge\-per\-layer\-name|stack|single (default: merge\-per\-layer\-name)
+  \-\-output\-layer <OUTPUT\-LAYER>                              Name of the output vector layer (single mode), or template to name the output vector layers (stack mode)
+  \-\-source\-layer\-field\-name <SOURCE\-LAYER\-FIELD\-NAME>        Name of the new field to add to contain identification of the source layer, with value determined from \(aqsource\-layer\-field\-content\(aq
+  \-\-source\-layer\-field\-content <SOURCE\-LAYER\-FIELD\-CONTENT>  A string, possibly using {AUTO_NAME}, {DS_NAME}, {DS_BASENAME}, {DS_INDEX}, {LAYER_NAME}, {LAYER_INDEX}
+  \-\-field\-strategy <FIELD\-STRATEGY>                          How to determine target fields from source fields. FIELD\-STRATEGY=union|intersection (default: union)
+  \-s, \-\-input\-crs <INPUT\-CRS>                                Input CRS
+  \-d, \-\-output\-crs <OUTPUT\-CRS>                              Output CRS
+
+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 concat\fP concatenates several source datasets.
+.sp
+It has 3 main modes:
+.INDENT 0.0
+.IP \(bu 2
+\fI\%\-\-mode\fP = \fBmerge\-per\-layer\-name\fP (the default). The output
+dataset generated by the command will contain as many layers as there are
+different layer names in the source datasets.
+For example if there are 2 datasets, one with layers \fIa\fP and \fIb\fP, and the
+other one with layers \fIb\fP and \fIc\fP, 3 output layers will be created: \fIa\fP,
+\fIb\fP (merging the 2 source layers) and \fIc\fP\&.
+.IP \(bu 2
+\fI\%\-\-mode\fP = \fBstack\fP\&. The output dataset generated by the command will
+contain as many layers as there are layers in the source datasets.
+For example if there are 2 datasets \fBds1\fP (with layers \fIa\fP and \fIb\fP) and
+\fBds2\fP (with layers \fIb\fP and \fIc\fP), 4 output layers will be created: \fBds1_a\fP,
+\fBds1_b\fP, \fBds2_b\fP and \fBds2_c\fP\&.
+.IP \(bu 2
+\fI\%\-\-mode\fP = \fBsingle\fP\&. The output dataset generated by the command will
+contain one single layer, merging all layers in the source datasets.
+.UNINDENT
+.sp
+When an output layer merges several source layer, by default the resulting
+schema will contain the union of all source fields. It is possible to select
+only the intersection with the \fI\%\-\-field\-strategy\fP set to \fBintersection\fP\&.
+Regarding the resulting CRS, by default the CRS of the source layer will be
+used as the target CRS, and features of other source layers that do no match
+this CRS will be reprojected to it. \fI\%\-\-output\-crs\fP can be used to select
+a given destination CRS.
+.sp
+This command can also be used as the first 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 \-\-field\-strategy union|intersection
+Determines how the schema of the target layer is built from the schemas of
+the input layers:
+.INDENT 7.0
+.IP \(bu 2
+\fBunion\fP (default) to use a super\-set of all the fields from all source layers.
+.IP \(bu 2
+\fBintersection\fP to use a sub\-set of all the common fields from all
+source layers.
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-input\-crs, \-s <INPUT\-CRS>
+Set (override) input spatial reference. If not specified the SRS found in the input
+dataset will be used.
+.sp
+The coordinate reference systems that can be passed are anything supported by the
+OGRSpatialReference.SetFromUserInput() call, which includes EPSG Projected,
+Geographic or Compound CRS (i.e. EPSG:4296), a well known text (WKT) CRS definition,
+PROJ.4 declarations, or the name of a .prj file containing a WKT CRS definition.
+.sp
+If the SRS has an explicit vertical datum that points to a geoid grid, and the input dataset is a
+single band dataset, a vertical correction will be applied to the values of the
+dataset.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-mode merge\-per\-layer\-name|stack|single
+Determine the strategy to create output layers from source layers. See
+introductory paragraph for more details.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-output\-crs, \-d <OUTPUT\-CRS>
+Set output spatial reference. Inputs will be reprojected to this CRS if necessary.
+.sp
+The coordinate reference systems that can be passed are anything supported by the
+OGRSpatialReference.SetFromUserInput() call, which includes EPSG Projected,
+Geographic or Compound CRS (i.e. EPSG:4296), a well known text (WKT) CRS definition,
+PROJ.4 declarations, or the name of a .prj file containing a WKT CRS definition.
+.sp
+If the SRS has an explicit vertical datum that points to a geoid grid, and the input dataset is a
+single band dataset, a vertical correction will be applied to the values of the
+dataset.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-output\-layer <OUTPUT\-LAYER>
+Name of the output vector layer (in \fBsingle\fP mode, and the default is
+\(dqmerged\(dq), or template to name the output vector layers in \fBstack\fP
+mode (the default value is \fB{AUTO_NAME}\fP).
+Not allowed in \fBmerge\-per\-layer\-name\fP mode.
+.sp
+The template in \fBstack\fP mode can be a string with the following variables
+that will be substituted with a value computed from the input layer being processed:
+.INDENT 7.0
+.IP \(bu 2
+\fB{AUTO_NAME}\fP: equivalent to \fB{DS_BASENAME}_{LAYER_NAME}\fP if both
+values are different, or \fB{LAYER_NAME}\fP when they are identical
+(case of shapefile).
+.IP \(bu 2
+\fB{DS_NAME}\fP: name of the source dataset
+.IP \(bu 2
+\fB{DS_BASENAME}\fP: base name of the source dataset
+.IP \(bu 2
+\fB{DS_INDEX}\fP: index of the source dataset
+.IP \(bu 2
+\fB{LAYER_NAME}\fP: name of the source layer
+.IP \(bu 2
+\fB{LAYER_INDEX}\fP: index of the source layer
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-source\-layer\-field\-content <SOURCE\-LAYER\-FIELD\-CONTENT>
+If specified, the schema of the target layer will be extended with a new field
+(whose name is given by \fI\%\-\-source\-layer\-field\-name\fP,
+or \fBsource_ds_lyr\fP otherwise), whose content is determined by the specified
+template (see \fI\%\-\-output\-layer\fP for variables that can be used).
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-source\-layer\-field\-name <SOURCE\-LAYER\-FIELD\-NAME>
+If specified, the schema of the target layer will be extended with a field
+whose name is the value of this option and whose content is
+determined \fI\%\-\-source\-layer\-field\-content\fP\&.
+.UNINDENT
+.SH STANDARD OPTIONS
+.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.
+.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\-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: Creating a GeoPackage stacking all input shapefiles in separate layers.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal vector concat \-\-mode=stack *.shp out.gpkg
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 2: Adding a field to indicate the source layer, and reprojecting to a single CRS
+.sp
+Concatenate the content of \fBfrance.shp\fP and \fBgermany.shp\fP in \fBmerged.shp\fP,
+reprojecting them to ETRS89, and add a \(aqcountry\(aq field to each feature whose value is \(aqfrance\(aq or
+\(aqgermany\(aq depending where it comes from:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+gdal vector concat \-\-mode=single \-\-source\-layer\-field\-name=country \-\-output\-crs=EPSG:4258 france.shp germany.shp merged.shp
+.EE
+.UNINDENT
+.UNINDENT
+.SH AUTHOR
+Even Rouault <even.rouault@spatialys.com>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.

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

@@ -0,0 +1,280 @@
+.\" 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-CONVERT" "1" "Aug 18, 2026" "" "GDAL"
+.SH NAME
+gdal-vector-convert \- Convert a vector dataset
+.sp
+Added in version 3.11.
+
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+Usage: gdal vector convert [OPTIONS] <INPUT> <OUTPUT>
+
+Convert 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]
+  \-\-no\-create\-empty\-layers                             Avoid creating layers to which no features will be written [not available in pipelines]
+
+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 convert\fP can be used to convert data data between
+different formats.
+.SH STANDARD OPTIONS
+.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.
+.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 \-\-no\-create\-empty\-layers
+Added in version 3.13.
+
+.sp
+Avoid creating layers to which no features will be written.
+.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
+.INDENT 0.0
+.TP
+.B \-q, \-\-quiet
+Suppress progress bar and some warning messages.
+.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: Converting file poly.shp to a GeoPackage
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ gdal vector convert poly.shp output.gpkg
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 2: Add new layer from file line.shp to an existing GeoPackage, and rename it \(dqlines\(dq
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ gdal vector convert \-\-update \-\-output\-layer=lines line.shp output.gpkg
+.EE
+.UNINDENT
+.UNINDENT
+.SS Example 3: Append features from from file poly2.shp to an existing layer poly of a GeoPackage, without a progress bar
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.EX
+$ gdal vector convert \-\-quiet \-\-append \-\-output\-layer=poly poly2.shp output.gpkg
+.EE
+.UNINDENT
+.UNINDENT
+.SH AUTHOR
+Even Rouault <even.rouault@spatialys.com>
+.SH COPYRIGHT
+1998-2026
+.\" Generated by docutils manpage writer.
+.