JSAMP(1)

✨ jsamp(1) — User Commands ✨

okay bestie, sit down, because this one is a whole mood 💅 This is the manual page for jsamp, hanging out in the User Commands section, and I am obsessed with explaining it to you.

---

🌸 NAME 🌸

jsamp — the Java Simple Application Messaging Protocol command-line tool for the Virtual Observatory. that's the whole name, no notes ✨

---

🎀 SYNOPSIS 🎀

jsamp [-help] [-version] <command> [-help] <cmd-args> <command-class> [-help] <cmd-args>

yes she's a little long, she's worth it 🦋

---

💖 DESCRIPTION 💖

So jsamp is your low-level command-line interface to the functionality of the JSAMP (Simple Application Messaging Protocol) Java library. And what does that library do? It lets Virtual Observatory (VO) applications talk to each other and swap data around on your machine. bestie behavior, honestly 🫶

---

🔥 OPTIONS 🔥

• -help — shows you the contextual usage info for commands and sub-commands. like a little map, but make it fashion 🗺️
• -version — prints the matching SAMP protocol revision and the jsamp build version, if it's available. receipts, but for software 🧾
• -verbose — outputs extra info on stdout while it's executing. she's chatty and we love her for it 💬
• +verbose — does not output any info on stdout while executing. silent mode, mysterious mode 🤫

---

👑 COMMANDS 👑

Heads up bestie: all commands can be followed by the argument -help to display details of their arguments and sub-commands. every single one, no cap 💅

💫 Main Commands 💫

These are the main-character commands — the ones related to starting or setting up SAMP hub instances. hub girlies rise 🌈

• hub

hub [-mode no-gui|client-gui|msg-gui|facade] [-profiles std|web|<hubprofile-class>[,...]] [-extraprofiles std|web|<hubprofile-class>[,...]] [-std:secret <secret>] [-std:httplock] [-web:log none|http|xml|rpc] [-web:auth swing|true|false|extreme] [-web:[no]cors] [-web:[no]flash] [-web:[no]silverlight] [-web:[no]urlcontrol] [-web:[no]restrictmtypes]

starts a SAMP Hub so that your VO applications can share and exchange data through the Hub. it's giving hostess with the mostess 🎀

• bridge

bridge [-[no]exporturls] [-nostandard] [-sampdir <lockfile-dir>] [-sampfile <lockfile>] [-sampurl <lockurl>] [-keys <xmlrpc-url> <secret>] [-profile <clientprofile-class>]

sets up a proxy bridge between two or more SAMP hub instances. matchmaker energy, connecting the hubs 🦋

• help — displays the list of top-level jsamp commands. the index of the group chat 📋

🔍 Debugging Commands 🔍

• hubmonitor

hubmonitor [-auto <secs>] [-nomsg] [-nogui] [-mtype <pattern>]

monitors an existing SAMP hub and shows you the connected clients. lurking, but professionally 👀

• snooper

snooper [-clientname <appname>] [-clientmeta <metaname> <metavalue>] [-mtype <pattern>] [-subs <pattern> <subsinfo>]

monitors an existing SAMP hub and dumps the flow of messages straight to stdout. the way she just prints everything… 💀

🧪 Testing Commands 🧪

• calcstorm

calcstorm [-gui] [-nclient <n>] [-nquery <n>] [-mode sync|async|notify|random]

stress-tests a SAMP hub by opening multiple connections and exchanging lots of messages. going absolutely feral on purpose 🔥

• hubtester

hubtester [-gui]

runs a series of tests against a running SAMP hub. vibe check, but make it QA ✅

---

🌈 HOMEPAGE 🌈

http://www.star.bristol.ac.uk/~mbt/jsamp/commands.html

go read it, iykyk ⭐

---

💜 AUTHORS 💜

🖊️ Software author

Mark Taylor <M.B.Taylor@bristol.ac.uk>

🎀 Manpage author

Paul Sladen <debian@paul.sladen.org> — written as part of the Debian GNU/Linux packaging. shoutout to the packagers fr fr 🫶

---

📜 COPYRIGHT 📜

jsamp tool and manpage licence. putting on my serious glasses for this part 🕶️

License: BSD-2-clause — redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS
BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

---

and that's the whole page bestie, 💖 from the GNU crowd, dated 2016-06-17, sitting pretty as JSAMP(1) — iconic, no cap, slay, periodt 👑💅✨