/usr/share/doc/stilts/sun256/secB.20.2.html is in stilts-doc 3.1.2-2.
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 | <html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" type="text/css" href="sun-style.css">
<title>Examples</title>
</head>
<body>
<hr>
<a href="tapquery.html">Next</a> <a href="taplint-usage.html">Previous</a> <a href="taplint.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="tapquery.html">tapquery: Queries a Table Access Protocol server</a><br>
<b>Up: </b><a href="taplint.html">taplint: Tests TAP services</a><br>
<b>Previous: </b><a href="taplint-usage.html">Usage</a><br>
<hr>
<h3><a name="secB.20.2">B.20.2 Examples</a></h3>
<p>Here are some examples of <code>taplint</code>:
<dl>
<dt><strong><pre>
stilts taplint http://dc.g-vo.org/tap
</pre></strong></dt>
<dd>Performs a default validation run against the TAP service based
at the given URL.
</dd>
<dt><strong><pre>
stilts taplint tapurl=http://gaia.esac.esa.int/tap-server/tap
examplesurl=file://localhost/tmp/examples.xml
stages='TME CAP EXA'
</pre></strong></dt>
<dd>Executes the <code>EXA</code>mples stage against
the GACS TAP service at ESAC.
Most of the service endpoints (tables, capabilities, availability etc)
are found at their default locations
relative to the given <code>tapurl</code>.
However, the Examples document is loaded instead
from the local file at the URL that has been specified by the
<code>examplesurl</code> parameter.
This makes is possible to test a non-deployed examples document against
a deployed TAP service. It may also be used if certain capabilities
have been deployed at non-default locations to satisfy multiple security
models or for other reasons.
You can play similar tricks with the other <code>*url</code> parameters
like <code>capabilitiesurl</code> and <code>tablesurl</code>,
as listed in the <a href="taplint-usage.html">documentation</a>.
<p>The <code>TME</code> (table metadata)
and <code>CAP</code> (service capabilities)
stages have been executed along with <code>EXA</code>,
since taplint needs to pick up the metadata and capabilities in order
to be able to do some of the checks on the examples it finds.
If those stage names are not included in the <code>stages</code>
parameter, the output will include some messages noting that fact,
and the tests will be less rigorous.
</p>
</dd>
<dt><strong><pre>
stilts taplint tapurl=http://example.com/tap
report=EW stages='TMS UWS' truncate=80 maxrepeat=4
</pre></strong></dt>
<dd>A validation run is done against the named TAP service.
Only Error and Warning type messages are output,
only two validation stages are performed,
lines are truncated to a maximum of 80 characters,
and each message is repeated a maximum of 4 times.
An invocation like this may be suitable if you find the default
operation too verbose.
<p>The output of this invocation might look like this:
<pre>
Section TMS: Check content of tables metadata from TAP_SCHEMA
E-TMS-CINT-1 Column principal in TAP_SCHEMA.columns has wrong type char not int
E-TMS-CINT-2 Column std in TAP_SCHEMA.columns has wrong type char not int
W-TMS-CLUN-1 Unused entry in TAP_SCHEMA.columns table: ivoa.obscore
Section UWS: Test asynchronous UWS/TAP behaviour
E-UWS-GMIM-1 Incorrect Content-Type text/xml != text/plain for http://exampl....
E-UWS-GMIM-2 Incorrect Content-Type text/xml != text/plain for http://exampl....
E-UWS-GMIM-3 Incorrect Content-Type text/xml != text/plain for http://exampl....
E-UWS-GMIM-4 Incorrect Content-Type text/xml != text/plain for http://exampl....
E-UWS-GMIM-x (3 more)
Totals: Errors: 9; Warnings: 1
</pre>
</p>
</dd>
</dl>
</p>
<hr><a href="tapquery.html">Next</a> <a href="taplint-usage.html">Previous</a> <a href="taplint.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="tapquery.html">tapquery: Queries a Table Access Protocol server</a><br>
<b>Up: </b><a href="taplint.html">taplint: Tests TAP services</a><br>
<b>Previous: </b><a href="taplint-usage.html">Usage</a><br>
<hr><i>STILTS - Starlink Tables Infrastructure Library Tool Set<br>Starlink User Note256<br>STILTS web page:
<a href="http://www.starlink.ac.uk/stilts/">http://www.starlink.ac.uk/stilts/</a><br>Author email:
<a href="mailto:m.b.taylor@bristol.ac.uk">m.b.taylor@bristol.ac.uk</a><br>Mailing list:
<a href="mailto:topcat-user@jiscmail.ac.uk">topcat-user@jiscmail.ac.uk</a><br></i></body>
</html>
|