/usr/share/doc/stilts/sun256/mode-samp.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 | <html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" type="text/css" href="sun-style.css">
<title>samp</title>
</head>
<body>
<hr>
<a href="mode-stats.html">Next</a> <a href="mode-out.html">Previous</a> <a href="outModes.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="mode-stats.html">stats</a><br>
<b>Up: </b><a href="outModes.html">Output Modes</a><br>
<b>Previous: </b><a href="mode-out.html">out</a><br>
<hr>
<h4><a name="mode-samp">6.4.7 <code>samp</code></a></h4>
<p><strong>Usage:</strong>
<pre> omode=samp format=<value> client=<name-or-id>
</pre></p>
<p>Sends the table to registered SAMP-aware applications
subscribed to a suitable table load MType.
SAMP, the Simple Application Messaging Protocol,
is a tool interoperability protocol.
A <em>SAMP Hub</em> must be running for this to work.
</p>
<p>Additional parameters for this output mode are:
<dl>
<dt><strong><code>format = <value></code> <em>(String[])</em></strong></dt>
<dd>Gives one or more table format types for attempting the
table transmission over SAMP.
If multiple values are supplied, they should be separated
by spaces.
Each value supplied for this parameter corresponds to a different
MType which may be used for the transmission.
If a single value is used, a SAMP broadcast will be used.
If multiple values are used, each registered client will be
interrogated to see whether it subscribes to the corresponding
MTypes in order; the first one to which it is subscribed will be
used to send the table.
The standard options are
<ul>
<li><code>votable</code>:
use MType <code>table.load.votable</code></li>
<li><code>fits</code>:
use MType <code>table.load.fits</code></li>
</ul>
If any other string is used which corresponds to one of
STILTS's known table output formats,
an attempt will be made to use an ad-hoc MType of the form
<code>table.load.format</code>.
<p>[Default: <code>votable fits</code>]
</p>
</dd>
<dt><strong><code>client = <name-or-id></code> <em>(String)</em></strong></dt>
<dd>Identifies a registered SAMP client which is to
receive the table.
Either the client ID or the (case-insensitive) application name
may be used.
If a non-null value is given, then the table will be sent to
only the first client with the given name or ID.
If no value is supplied the table will be sent to
all suitably subscribed clients.
</dd>
</dl>
</p>
<hr><a href="mode-stats.html">Next</a> <a href="mode-out.html">Previous</a> <a href="outModes.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="mode-stats.html">stats</a><br>
<b>Up: </b><a href="outModes.html">Output Modes</a><br>
<b>Previous: </b><a href="mode-out.html">out</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>
|