/usr/share/doc/gmt/html/man/x2sys_put.html is in gmt-doc 4.5.11-1build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 | <!-- Creator : groff version 1.19.2 -->
<!-- CreationDate: Tue Nov 5 09:45:53 2013 -->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="generator" content="groff -Thtml, see www.gnu.org">
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="Content-Style" content="text/css">
<style type="text/css">
p { margin-top: 0; margin-bottom: 0; }
pre { margin-top: 0; margin-bottom: 0; }
table { margin-top: 0; margin-bottom: 0; }
</style>
<title>X2SYS_PUT</title>
</head>
<body bgcolor="#ffffff">
<h1 align=center>X2SYS_PUT</h1>
<a href="#NAME">NAME</a><br>
<a href="#SYNOPSIS">SYNOPSIS</a><br>
<a href="#DESCRIPTION">DESCRIPTION</a><br>
<a href="#OPTIONS">OPTIONS</a><br>
<a href="#EXAMPLES">EXAMPLES</a><br>
<a href="#X2SYS DATABASES">X2SYS DATABASES</a><br>
<a href="#SEE ALSO">SEE ALSO</a><br>
<hr>
<a name="NAME"></a>
<h2>NAME</h2>
<p style="margin-left:11%; margin-top: 1em">x2sys_put
− Update x2sys track data bases</p>
<a name="SYNOPSIS"></a>
<h2>SYNOPSIS</h2>
<p style="margin-left:11%; margin-top: 1em"><b>x2sys_put</b>
[ <i>info.tbf</i> ] <b>−T</b><i>TAG</i> [
<b>−D</b> ] [ <b>−F</b> ] [ <b>−V</b>
]</p>
<a name="DESCRIPTION"></a>
<h2>DESCRIPTION</h2>
<p style="margin-left:11%; margin-top: 1em"><b>x2sys_put</b>
accepts a track bin-index file created by
<b><A HREF="x2sys_binlist.html">x2sys_binlist</A></b> and adds this information about the
data tracks to the relevant data base. You may chose to
overwrite existing data with new information for older
tracks (<b>−F</b>) and even completely remove
information for certain tracks (<b>−D</b>). The x2sys
<i>TAG</i> must match the tag encoded in the <i>info.tbf</i>
file. To inquire about tracks in the data base, use
<b><A HREF="x2sys_get.html">x2sys_get</A></b>.</p>
<table width="100%" border=0 rules="none" frame="void"
cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p style="margin-top: 1em" valign="top"><b>−T</b></p> </td>
<td width="8%"></td>
<td width="78%">
<p style="margin-top: 1em" valign="top">Specify the x2sys
<i>TAG</i> which tracks the attributes of this data
type.</p> </td>
</table>
<a name="OPTIONS"></a>
<h2>OPTIONS</h2>
<p style="margin-left:11%; margin-top: 1em">No space
between the option flag and the associated arguments.
<i><br>
info.tbf</i></p>
<p style="margin-left:22%;">Name of a single track bin
file. If not given, stdin will be read.</p>
<table width="100%" border=0 rules="none" frame="void"
cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p style="margin-top: 1em" valign="top"><b>−D</b></p> </td>
<td width="8%"></td>
<td width="78%">
<p style="margin-top: 1em" valign="top">Delete all tracks
found in the track bin file [Default will try to add them as
new track entries].</p></td>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p style="margin-top: 1em" valign="top"><b>−F</b></p> </td>
<td width="8%"></td>
<td width="78%">
<p style="margin-top: 1em" valign="top">Replace any
existing database information for these tracks with the new
information in the track bin file [Default refuses to
process tracks already in the database].</p></td>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p style="margin-top: 1em" valign="top"><b>−V</b></p> </td>
<td width="8%"></td>
<td width="78%">
<p style="margin-top: 1em" valign="top">Selects verbose
mode, which will send progress reports to stderr [Default
runs "silently"].</p></td>
</table>
<a name="EXAMPLES"></a>
<h2>EXAMPLES</h2>
<p style="margin-left:11%; margin-top: 1em">To add the
information stored in the track bin-index file latest.tbf to
the track data bases associated with the tag MGD77, and
replace any exiting information for these tracks, try</p>
<p style="margin-left:11%; margin-top: 1em"><b>x2sys_put</b>
latest.tbf <b>−F −V −T</b> MGD77</p>
<a name="X2SYS DATABASES"></a>
<h2>X2SYS DATABASES</h2>
<p style="margin-left:11%; margin-top: 1em">The
<b>x2sys_put</b> utility adds new information to the x2sys
data bases. These consists of two files: The first file
contains a listing of all the tracks that have been added to
the system; it is named <i>TAG</i>_tracks.d and is in ASCII
format. The second file is named <i>TAG</i>_index.b and is
in native binary format. It contains information on which
tracks cross each of the bins, and what data sets were
observed while crossing the bin. The bins are defined by the
<b>−R</b> and <b>−I</b> options passed to
<b><A HREF="x2sys_init.html">x2sys_init</A></b> when the <i>TAG</i> was first initiated.
Both data base files are stored in the
<b>$X2SYS_HOME</b>/<i>TAG</i> directory. Do not attempt to
edit these files by hand.</p>
<a name="SEE ALSO"></a>
<h2>SEE ALSO</h2>
<p style="margin-left:11%; margin-top: 1em"><i><A HREF="x2sys_binlist.html">x2sys_binlist</A></i>(1),
<i><A HREF="x2sys_get.html">x2sys_get</A></i>(1)</p>
<hr>
</body>
</html>
|