This program reads a synchronization stream created with da.sync.write and applies the changes to the local archive. It is used with manual transfer of that stream to accomplish synchronization of two archives.
Usage
da.sync.read [switches…] [station] [file]
Switches
- --editor=STRING
-
This is the editor command that will be invoked when in read→modify→write editing mode. If not set then the editor will be selected by what is set in the $EDITOR environment variable. If that is not set then an editor will be selected based on the presence of a GUI environment.
Default: Automatically selected
- --file=FILE
-
This sets the file name to read or write to. By default standard input or output is used.
Default: Disabled, used standard input/output
- --flat[=BOOLEAN]
-
When set, this outputs on a single data indentifer and time bound to be output, instead of the full specification.
- --mode=TYPE
-
This sets the mode the flat file generator works in.
Default: Read data from the archive
The possible values are:
- --mode=datainput
-
Read data from the archive or standard input and generate the flat file as output.
- --mode=dataoutput
-
Read and parse data from the file and generate data on standard output.
- --mode=edit
-
Read data from the archive to a temporary file then open an editor on that file. Once the editor is closed write the changes back to the archive.
- --mode=modify
-
Same as --mode=edit
- --mode=read
-
Read data from the archive and generate a flat file as output.
- --mode=write
-
Write data to the archive from an input flag file.
- --mode=xml
-
Read data from the archive to a temporary file in XML then open an editor on that file. Once the editor is closed write the changes back to the archive.
- --output-bounds[=BOOLEAN]
-
When set, this causes the data bounds to always be output instead of only output when needed.
- --output-identifiers[=BOOLEAN]
-
When set, this causes the data identifiers (station, archive, variable, and flavors) to always be output instead of only output when needed.
- --read=TYPE
-
This sets the mode data are read with. This is used to control what data are displayed for editing.
Default: Accept default metadata
The possible values are:
- --read=all
-
Same as --read=everything
- --read=everything
-
Accept all input data.
- --read=metadata
-
Accept only metadata from the default archive. All read default data are ignored.
- --read=nodefault
-
Do not accept any default station data or metadata.
Arguments
- station
-
This argument is used to specify the station that synchronization is accepted for. The incoming data must match the station and profile to be accepted. The station is the three letter GAW station code of the location, such as
BND
. - file
-
This argument is used to specify the the file to read data from. If it is absent or set to
-
(a single dash) then the stream is read from standard input.