<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<link rel="stylesheet" href="style.css"/>
<title>IMCom Commands</title>
</head>
<body>
<table width="100%" cellpadding="15">
<tr>
<td>
<div class="intro">
<h1>
IMCom Commands
</h1>
</div>
<div>
<p>
This page documents the commands that are available in IMCom. It is organized by catagory.
<a href="#messagecommands">Message Commands</a>,
<a href="#presencecommands">Presence Commands</a>,
<a href="#rostermanagement">Roster Management Commands</a>,
<a href="#agentcommands">Agent Registration Commands</a>,
<a href="#vcards">vCard Commands</a>,
<a href="#conferencecommands">Conference Commands</a>,
<a href="#filexfer">File Transfer Commands</a>,
<a href="#imcomutilities">IMCom Utility Commands</a>,
<a href="#jabberadmin">Jabber Administrator Commands</a>.
</p>
</div>
<div>
<p>
Some basic rules for IMCom:
</p>
<ul>
<li>
Whereever a JID is required you can substitute the
nickname you have associated with that JID
</li>
<li>
Nicknames can have spaces in them, but if they do
have spaces they need to be quoted where it will be
ambiguous. Exmaple usage: /msg "Airog Pants" hi
there!
</li>
<li>
You can direct a command to a particular resource by
appending a / followed by the resource your are
directing to. This works with both nicknames and
JIDs. In the case where a resource is required, but not
specified IMCom will do its best to guess which resource
you mean. Example usage: /msg airog/home hi there!
</li>
</ul>
</div>
</td>
<td class="navigation" rowspan="12">
<div class="navigation">
<p class="intro"><strong class="heading">Navigation</strong>:<br/><br/>
<a href="../index.html">Home</a><br/>
<a href="news.html">IMCom News</a><br/>
<a href="whatis.html">What is IMCom</a><br/>
<a href="download.html">Download</a><br/>
<a href="commands.html">Commands</a><br/>
<a href="advanced.html">Advanced</a><br/>
<a href="CHANGELOG">ChangeLog</a><br/>
<a href="imcomrc.html">Example Config</a><br/>
<br/>
<a href="http://www.jabber.org/"><img src="jabberbutton.png" alt="Jabber Open IM"/></a>
</p>
</div>
</td>
</tr>
</table>
<div class="section">
<a name="messagecommands"/>
<div class="centerintro">Message Commands</div>
<div>
<a name="msg"/>
<div class="command">/msg</div>
<p>This command sends a message to a single user.</p>
<p class="fixed">
Usage 1: /msg [JID] [message]<br/>
Usage 2: /msg [JID]<br/>
[type-multiple]<br/>
[lines-of]<br/>
[text]<br/>
[period or hash (. or #)]<br/>
<br/>
Example 1: /msg airog hi there!<br/>
Example 2: /msg airog<br/>
[msg]: this<br/>
[msg]: is<br/>
[msg]: a<br/>
[msg]: multiline<br/>
[msg]: message<br/>
[msg]: .<br/>
<br/>
</p>
<p>
There are two modes for this command: single-line mode and multi-line mode.<br/>
<b>Single Line</b> mode is the first usage and example.<br/>
<b>Multi Line</b> mode is the second usage and example. In
multi-line mode hit enter after typing the JID and IMCom
will display a different prompt: [msg]: Type a period on a
line by itself to send the message, or type a hash ( # ) on
a line by itself to cancel the message.<br/>
</p>
</div>
<div>
<a name="again"/>
<div class="command">//</div>
<p>This command sends a message to the last person you sent a message to.</p>
<p class="fixed">
Usage 1: // [message]<br/>
Usage 2: //<br/>
[type-multiple]<br/>
[lines-of]<br/>
[text]<br/>
[period or hash (. or #)]<br/>
<br/>
Example 1: // hi there!<br/>
Example 2: //<br/>
[msg]: this<br/>
[msg]: is<br/>
[msg]: a<br/>
[msg]: multiline<br/>
[msg]: message<br/>
[msg]: .<br/>
<br/>
</p>
<p>
Like the /msg command this command has two modes<br/>
<b>Single Line</b> mode is the first usage and example.<br/>
<b>Multi Line</b> mode is the second usage and example. In
multi-line mode hit enter after typing // and IMCom
will display a different prompt: [msg]: Type a period on a
line by itself to send the message, or type a hash ( # ) on
a line by itself to cancel the message.<br/>
</p>
</div>
<div>
<a name="reply"/>
<div class="command">/r</div>
<p>This command sends a message to the person who last sent you a message.</p>
<p class="fixed">
Usage 1: /r [message]<br/>
Usage 2: /r<br/>
[type-multiple]<br/>
[lines-of]<br/>
[text]<br/>
[period or hash (. or #)]<br/>
<br/>
Example 1: /r hi there!<br/>
Example 2: /r<br/>
[msg]: this<br/>
[msg]: is<br/>
[msg]: a<br/>
[msg]: multiline<br/>
[msg]: message<br/>
[msg]: .<br/>
<br/>
</p>
<p>
Like the /msg command this command has two modes<br/>
<b>Single Line</b> mode is the first usage and example.<br/>
<b>Multi Line</b> mode is the second usage and example. In
multi-line mode hit enter after typing /r and IMCom
will display a different prompt: [msg]: Type a period on a
line by itself to send the message, or type a hash ( # ) on
a line by itself to cancel the message.<br/>
</p>
</div>
<div>
<a name="msgr"/>
<div class="command">/msgr</div>
<p>This command sends a message to a specific resource a person is logged into. It is now obsolete as this can be done by using quotes with the /msg command.</p>
<p class="fixed">
Usage: /msgr [JID] [resource]<br/>
[type-multiple]<br/>
[lines-of]<br/>
[text]<br/>
[period or hash (. or #)]<br/>
<br/>
Example: /msgr airog at home<br/>
[msg]: this<br/>
[msg]: is<br/>
[msg]: a<br/>
[msg]: multiline<br/>
[msg]: message<br/>
[msg]: .<br/>
<br/>
</p>
<p>
Multi-line mode is the only way to use this command.
</p>
</div>
<div>
<a name="msgbang"/>
<div class="command">/msg!</div>
<p>This command sends the results of a command.</p>
<p class="fixed">
Usage: /msg! [JID] [COMMAND]<br/>
<br/>
Example: /msg! airog /sbin/ifconfig eth0<br/>
</p>
<p>
This command is only available on UNIX systems since it uses os.popen4()
</p>
</div>
<div>
<a name="msggroup"/>
<div class="command">/msggroup</div>
<p>This command sends a message to a defined jabber roster group.</p>
<p class="fixed">
Usage: /msggroup [GROUP]<br/>
[type-multiple]<br/>
[lines-of]<br/>
[text]<br/>
[period or hash (. or #)]<br/>
<br/>
Example: /msggroup friends<br/>
[msg]: this<br/>
[msg]: is<br/>
[msg]: a<br/>
[msg]: multiline<br/>
[msg]: message<br/>
[msg]: .<br/>
<br/>
</p>
<p>
Multi-line mode is the only way to use this command.
</p>
</div>
</div>
<div class="section">
<a name="presencecommands"/>
<div class="centerintro">Presence Commands</div>
<div>
<a name="online"/>
<div class="command">/online</div>
<p>This command sets your status to online</p>
<p class="fixed">
Usage 1: /online<br/>
Usage 2: /online [reason]<br/>
<br/>
Example 1: /online<br/>
Example 2: /online I'm home now<br/>
</p>
</div>
<div>
<a name="chat"/>
<div class="command">/chat</div>
<p>This command sets your status to chat</p>
<p class="fixed">
Usage: /chat<br/>
<br/>
Example 1: /chat<br/>
</p>
</div>
<div>
<a name="away"/>
<div class="command">/away</div>
<p>This command sets your status to away</p>
<p class="fixed">
Usage 1: /away<br/>
Usage 2: /away [reason]<br/>
<br/>
Example 1: /away<br/>
Example 2: /away I'm getting a soda<br/>
</p>
<p>
The default reason is "I'm too lazy to enter why I'm away"
</p>
</div>
<div>
<a name="xa"/>
<div class="command">/xa</div>
<p>This command sets your status to eXtended Away</p>
<p class="fixed">
Usage 1: /xa<br/>
Usage 2: /xa [reason]<br/>
<br/>
Example 1: /xa<br/>
Example 2: /xa I've gone to a meeting<br/>
</p>
<p>
The default reason is "I'm too lazy to enter why I'm xa"
</p>
</div>
<div>
<a name="dnd"/>
<div class="command">/dnd</div>
<p>This command sets your status to Do Not Disturb</p>
<p class="fixed">
Usage 1: /dnd<br/>
Usage 2: /dnd [reason]<br/>
<br/>
Example 1: /dnd<br/>
Example 2: /dnd I'm working hard on documentation<br/>
</p>
<p>
The default reason is "I'm too lazy to enter why I'm dnd"
</p>
</div>
<div>
<a name="setpriority"/>
<div class="command">/setpriority</div>
<p>This command sets this resource's priority.</p>
<p class="fixed">
Usage: /setpriority [PRIORITY-LEVEL]<br/>
<br/>
Example: /setpriority 6<br/>
</p>
<p>
Sets the base priority for the current connection. This
number should be 6 or larger. This is the priority used when
you are status online, or status chat. [PRIORITY-LEVEL] - 2
is used for status away, [PRIORITY-LEVEL] - 4 is used for
status xa, [PRIORITY-LEVEL] - 6 is used for stataus dnd.
</p>
</div>
</div>
<div class="section">
<a name="rostermanagement"/>
<div class="centerintro">Roster Management Commands</div>
<div>
<a name="e"/>
<div class="command">e</div>
<p>This command shows all users who are currently online</p>
<p class="fixed">
Usage: e<br/>
<br/>
Example: e<br/>
</p>
<p>
This will print out a list of all the users in your roster
which are online, chat, away, xa, or dnd, and are not in
group 'lurker'. The lurker group is a special group people
can belong where you will never see their presence updates,
unless you /show lurker.
</p>
</div>
<div>
<a name="w"/>
<div class="command">w</div>
<p>This command shows the presence of all users on your roster.</p>
<p class="fixed">
Usage: w<br/>
<br/>
Example: w<br/>
</p>
<p>
This will print out a list of all your roster items and
their status except for roster items belonging to the
'lurker' group. The lurker group is a special group people
can belong where you will never see their presence updates,
unless you /show lurker.
</p>
</div>
<div>
<a name="add"/>
<div class="command">/add</div>
<p>Add a user to your roster.</p>
<p class="fixed">
Usage: /add [JID] [nickname]<br/>
<br/>
Example: /add airog@floobin.cx "IMCom Author"<br/>
</p>
<p>
This will create an entry in your roster, set the nickname of that entry and request to subscribe to that user's presence.
</p>
</div>
<div>
<a name="remove"/>
<div class="command">/remove</div>
<p>Unsubscribe from a user's presence.</p>
<p class="fixed">
Usage: /remove [JID]<br/>
<br/>
Example: /remove "IMCom Author"<br/>
</p>
<p>
This only unsubscribes from a users presence, it DOES NOT
remove the item from your roster. To remove an item from
your roster use the /delete command. When you use this
command the person will still have a NickName associated
with them as well as whatever groups they happen to be
in. The only difference will be that you will nolonger
receive presence updates.
</p>
</div>
<div>
<a name="delete"/>
<div class="command">/delete</div>
<p>Removes a user from your roster.</p>
<p class="fixed">
Usage: /delete [JID]<br/>
<br/>
Example: /delete "IMCom Author"<br/>
</p>
<p>
This will delete an entry from your roster, unsubscribing from the person's presence if need be.
</p>
</div>
<div>
<a name="auth"/>
<div class="command">/auth</div>
<p>Authorize someone to subscribe to your presence.</p>
<p class="fixed">
Usage: /auth [JID]<br/>
<br/>
Example: /auth airog@floobin.cx<br/>
</p>
</div>
<div>
<a name="deny"/>
<div class="command">/deny</div>
<p>Deny someone from subscribing to your presence.</p>
<p class="fixed">
Usage: /deny [JID]<br/>
<br/>
Example: /deny airog@floobin.cx<br/>
</p>
</div>
<div>
<a name="rename"/>
<div class="command">/rename</div>
<p>Give someone a new nickname</p>
<p class="fixed">
Usage: /rename [JID] [NEW-NICK]<br/>
<br/>
Example: /rename "IMCom Author" "airog"<br/>
</p>
</div>
<div>
<a name="addgroup"/>
<div class="command">/addgroup</div>
<p>Place someone into an additional group.</p>
<p class="fixed">
Usage: /addgroup [JID] [GROUP]<br/>
<br/>
Example: /addgroup airog lurker<br/>
</p>
<p>
This command will place someone into another group,
retaining whatever groups they happen to be in already. In
Jabber a user can belong to many groups.
</p>
<p>
In IMCom there are two special groups, lurker and ignore.<br/>
<b>lurker</b> : This group is for people you want on your
roster, and from time to time want to see whether they are
online, but in general you don't care to see them in your
list, and don't want to see presence updates from them. I
use this group for people I talk to every few
months.<br/><br/>
<b>ignore</b> : This group is for people you never want to
see anything from.
</p>
</div>
<div>
<a name="delgroup"/>
<div class="command">/delgroup</div>
<p>Remove someone from a group.</p>
<p class="fixed">
Usage: /delgroup [JID] [GROUP]<br/>
<br/>
Example: /delgroup airog lurker<br/>
</p>
<p>
This command will remove someone from a group, retaining
whatever other groups they happen to be in as well. In
Jabber a user can belong to many groups.
</p>
</div>
<div>
<a name="setgroup"/>
<div class="command">/setgroup</div>
<p>Set the group to which someone belongs</p>
<p class="fixed">
Usage: /setgroup [JID] [GROUP]<br/>
<br/>
Example: /setgroup airog lurker<br/>
</p>
<p>
This command will make the user belong to precisely to the group specified and no other groups.
</p>
</div>
<div>
<a name="membership"/>
<div class="command">/membership</div>
<p>Show the groups that a user is in.</p>
<p class="fixed">
Usage: /membership [JID]<br/>
<br/>
Example: /membership airog<br/>
</p>
</div>
<div>
<a name="show"/>
<div class="command">/show</div>
<p>Show the presence information of people who are in a group.</p>
<p class="fixed">
Usage 1: /show<br/>
Usage 2: /show lurker<br/>
<br/>
Example 1: /show<br/>
Example 2: /show lurker<br/>
</p>
<p>
There are two uses for this command. The first is to show
what groups exist. The second is to produce an output like w
for a subset of people defined by a group.
</p>
</div>
</div>
<div class="section">
<a name="agentcommands"/>
<div class="centerintro">Agent Registration Commands</div>
<div>
<a name="agents"/>
<div class="command">/agents</div>
<p>Display a list of available transports on the server..</p>
<p class="fixed">
Usage: /agents<br/>
<br/>
Example: /agents<br/>
</p>
</div>
<div>
<a name="agenthelp"/>
<div class="command">/agenthelp</div>
<p>Begin the registration process with a particular agent.</p>
<p class="fixed">
Usage: /agenthelp [JID]<br/>
<br/>
Example: /agenthelp icq.floobin.cx<br/>
</p>
<p>
Follow the directions on screen to complete the registration.
</p>
</div>
<div>
<a name="unregister"/>
<div class="command">/unregister</div>
<p>Unregister with a transport.</p>
<p class="fixed">
Usage: /unregister [JID]<br/>
<br/>
Example: /unregister icq.floobin.cx<br/>
</p>
</div>
</div>
<div class="section">
<a name="vcards"/>
<div class="centerintro">vCard Commands</div>
<div>
<a name="info"/>
<div class="command">/info</div>
<p>Retrieve someone's vCard.</p>
<p class="fixed">
Usage: /info [JID]<br/>
<br/>
Example: /info airog<br/>
</p>
</div>
<div>
<a name="submitvcard"/>
<div class="command">/submitvcard</div>
<p>Submit a vCard to the server.</p>
<p class="fixed">
Usage: /submitvcard [DisplayName] [FamilyName] [GivenName] [NickName] [Email]<br/>
<br/>
Example: /submitvcard Casey Crabb Kennth airog crabbkw@nafai.dyndns.org<br/>
</p>
</div>
</div>
<div class="section">
<a name="filexfer"/>
<div class="centerintro">File Transfer Commands</div>
<div>
<a name="sendfile"/>
<div class="command">/sendfile</div>
<p>Offer a file to someone.</p>
<p class="fixed">
Usage: /sendfile [JID] [FILE]<br/>
<br/>
Example: /sendfile airog /home/user/myDocument.html<br/>
</p>
<p>
Please note that the file should be an absolute path (it
will tab complete). It does not understand the ~
notation. Sorry.
</p>
</div>
<div>
<a name="getfile"/>
<div class="command">/getfile</div>
<p>Retrieve an offered file.</p>
<p class="fixed">
Usage: /getfile [JID]<br/>
<br/>
Example: /getfile airog<br/>
</p>
<p>
This will download the file to ~/.imcom/files/
</p>
</div>
</div>
<div class="section">
<a name="conferencecommands"/>
<div class="centerintro">Conference Commands</div>
<div>
<a name="joinconf"/>
<div class="command">/joinconf</div>
<p>Joins or creates a chatroom.</p>
<p class="fixed">
Usage: /joinconf [CONFERENCE-JID]
[NICKNAME-TO-ASSIGN-CONFERENCE]
[NICKNAME-YOU-WANT-TO-BE-KNOWN-AS-IN-CONFERENCE]
[OPTIONNALLY-PASSWORD]<br/>
<br/>
Example: /conf jdev@conference.jabber.org jdev casey<br/>
</p>
<p>
Conferecing in IMCom works by creating a 'nickname' for a
conference jid upon joining. After you've joined a
conference you will recieve messages from the conference
like normal messages. You can send a message to the
conference using regular messaging commands, including
//. You can send a private conference message by using a
message command and directing to the conference-nickname
followed by a slash followed by the nickname of the person
you want to send a private message to. <br/>
Example:<br/>
/joinconf jdev@conference.jabber.org jdev casey<br/>
/msg jdev Hi all!<br/>
/msg jdev/someuser Hi someuser!<br/>
<br/><br/>
In the jabber world there are two types of conferencing. The
soon to be deprecated group-chat, and the relatively new
Multi-User-Chat. IMCom supports both of these methods
transparently, with the exception that the advanced commands
(kick, ban, voice, member, owner, admin) only work with
Multi-User-Chat.<br/><br/>
Also, when joining a room that doesn't exist on
Multi-User-Chat capable component you will have to fill out
a form for room creation. The process is fairly
straight-forward, simply follow the instructions that come
up.<br/>
</p>
</div>
<div>
<a name="confusers"/>
<div class="command">/confusers</div>
<p>Displays a list of people in a chatroom.</p>
<p class="fixed">
Usage: /confusers [CONFERENCE-JID]<br/>
<br/>
Example: /confusers jdev<br/>
</p>
</div>
<div>
<a name="leaveconf"/>
<div class="command">/leaveconf</div>
<p>Leaves a chatroom.</p>
<p class="fixed">
Usage: /leaveconf [CONFERENCE-JID]<br/>
<br/>
Example: /leaveconf jdev<br/>
</p>
</div>
<div>
<a name="confnickchange"/>
<div class="command">/confnickchange</div>
<p>Change your nickname in a conference</p>
<p class="fixed">
Usage: /confnickchange [CONFERENCE-JID] [NEW-NICK]<br/>
<br/>
Example: /confnickchange jdev airog<br/>
</p>
</div>
<div>
<a name="confinvite"/>
<div class="command">/confinvite</div>
<p>Invite someone into a chatroom, sending the required password if there is one.</p>
<p class="fixed">
Usage: /confinvite [CONFERENCE-JID] [JID]<br/>
<br/>
Example: /confinvite jdev myFriend<br/>
</p>
<p>
This command will only work with MUC-capable rooms.
</p>
</div>
<div>
<a name="confsubject"/>
<div class="command">/confsubject</div>
<p>Change the subject in a chat room</p>
<p class="fixed">
Usage: /confsubject [CONFERENCE-JID] [NEW-SUBJECT]<br/>
<br/>
Example: /confsubject jdev JEP0045 -- MUC is now draft!<br/>
</p>
<p>
This command will only work with MUC-capable rooms.
</p>
</div>
<div>
<a name="confkick"/>
<div class="command">/confkick</div>
<p>Kick someone out of a chatroom.</p>
<p class="fixed">
Usage: /confkick [CONFERENCE-JID] [NICK-TO-KICK] [REASON]<br/>
<br/>
Example: /confkick jdev casey you're being bad!<br/>
</p>
<p>
This command will only work with MUC-capable rooms.
</p>
</div>
<div>
<a name="confvoice"/>
<div class="command">/confvoice</div>
<p>Grant someone voice priviledges in a chatroom.</p>
<p class="fixed">
Usage: /confvoice [CONFERENCE-JID] [NICK]<br/>
<br/>
Example: /confvoice jdev casey<br/>
</p>
<p>
This command will only work with MUC-capable rooms.
</p>
</div>
<div>
<a name="confdevoice"/>
<div class="command">/confdevoice</div>
<p>Revoke someone's voice priviledges in a chatroom.</p>
<p class="fixed">
Usage: /confdevoice [CONFERENCE-JID] [NICK]<br/>
<br/>
Example: /confdevoice jdev casey<br/>
</p>
<p>
This command will only work with MUC-capable rooms.
</p>
</div>
<div>
<a name="confban"/>
<div class="command">/confban</div>
<p>Ban someone from the chatroom.</p>
<p class="fixed">
Usage: /confban [CONFERENCE-JID] [nick] [reason]<br/>
<br/>
Example: /conf jdev casey you've been bad!<br/>
</p>
<p>
This command will only work with MUC-capable rooms.<br/>
There is no way to unban someone in IMCom currently.
</p>
</div>
<div>
<a name="confmod"/>
<div class="command">/confmod</div>
<p>Grant someone moderator priviledges in a chatroom.</p>
<p class="fixed">
Usage: /confmod [CONFERENCE-JID] [nick]<br/>
<br/>
Example: /confmod jdev casey<br/>
</p>
<p>
This command will only work with MUC-capable rooms.
</p>
</div>
<div>
<a name="confdemod"/>
<div class="command">/confdemod</div>
<p>Revoke moderator priviledges from somone in a chatroom.</p>
<p class="fixed">
Usage /confdemod [CONFERENCE-JID] [nick]<br/>
<br/>
Example: /confdemod jdev casey<br/>
</p>
<p>
This command will only work with MUC-capable rooms.
</p>
</div>
<div>
<a name="confmember"/>
<div class="command">/confmember</div>
<p>Grant member affiliation to someone in a chatroom.</p>
<p class="fixed">
Usage /confmember [CONFERENCE-JID] [nick]<br/>
<br/>
Example: /confmember jdev casey<br/>
</p>
<p>
This command will only work with MUC-capable rooms.
</p>
</div>
<div>
<a name="confdemember"/>
<div class="command">/confdemember</div>
<p>Revoke member affiliation from someone in a chatroom.</p>
<p class="fixed">
Usage /confdemember [CONFERENCE-JID] [nick]<br/>
<br/>
Example: /confdemember jdev casey<br/>
</p>
<p>
This command will only work with MUC-capable rooms.
</p>
</div>
<div>
<a name="confadmin"/>
<div class="command">/confadmin</div>
<p>Grant administrator affiliation to someone in a chatroom.</p>
<p class="fixed">
Usage /confadmin [CONFERENCE-JID] [nick]<br/>
<br/>
Example: /confadmin jdev casey<br/>
</p>
<p>
This command will only work with MUC-capable rooms.
</p>
</div>
<div>
<a name="confdeadmin"/>
<div class="command">/confdeadmin</div>
<p>Revoke administrator affiliation from someone ni a chatroom.</p>
<p class="fixed">
Usage /confdeadmin [CONFERENCE-JID] [nick]<br/>
<br/>
Example: /confdeadmin jdev casey<br/>
</p>
<p>
This command will only work with MUC-capable rooms.
</p>
</div>
<div>
<a name="confowner"/>
<div class="command">/confowner</div>
<p>Grant owner affiliation to someone in a chatroom.</p>
<p class="fixed">
Usage /confowner [CONFERENCE-JID] [nick]<br/>
<br/>
Example: /confowner jdev casey<br/>
</p>
<p>
This command will only work with MUC-capable rooms.
</p>
</div>
<div>
<a name="confdeowner"/>
<div class="command">/confdeowner</div>
<p>Revoke owner affiliation from someone in a chatroom.</p>
<p class="fixed">
Usage /confdeowner [CONFERENCE-JID] [nick]<br/>
<br/>
Example: /confdeowner jdev casey<br/>
</p>
<p>
This command will only work with MUC-capable rooms.
</p>
</div>
<div>
<a name="confdestroy"/>
<div class="command">/confdestroy</div>
<p>Destroy a chatroom.</p>
<p class="fixed">
Usage /confdestroy [CONFERENCE-JID] [reason]<br/>
<br/>
Example: /confowner jdev its all going down.<br/>
</p>
<p>
This command will only work with MUC-capable rooms.
</p>
</div>
<div>
<a name="confconfig"/>
<div class="command">/confconfig</div>
<p>Re-configure a chatroom.</p>
<p class="fixed">
Usage /confconfig [CONFERENCE-JID]<br/>
<br/>
Example: /confconfig jdev<br/>
</p>
<p>
This command will only work with MUC-capable rooms.<br/>
This will display a form much like the one used for creation of a MUC-room.
</p>
</div>
</div>
<div class="section">
<a name="imcomutilities"/>
<div class="centerintro">IMCom Utility Commands</div>
<div>
<a name="set"/>
<div class="command">/set</div>
<p>Set boolean variable options in IMCom</p>
<p class="fixed">
Usage: /set [OPTION] [VALUE]<br/>
<br/>
Example: /set statusshow off<br/>
</p>
<p>
The boolean values accepted as true are "true", "yes", "on". Everything else is interpreted as
false. Currently the following variables are supported<br/>
</p>
<ul>
<li><b>statusshow</b>: Whether or not to show status updates</li>
<li><b>colors</b>: Whether or not to use colors</li>
<li><b>debug</b>: Whether or not to output debugging information</li>
<li><b>ringbell</b>: Whether or not to ring the terminal bell on incoming messages</li>
<li><b>allowInterrupt</b>: Whether to allow interruptions in the middle of multi-line messages.</li>
<li><b>nickPrompt</b>: Whether or not to user nicknames as the multi-line message prompt.</li>
<li><b>autoStatus</b>: Whether or not to use the AutoStatus functionality</li>
<li><b>statusnag</b>: Whether or not to warn the user if their status is not online when sending messages</li>
<li><b>confsuppress</b>:Whether or not to suppress the 'From' line on conference messages</li>
<li><b>igndupstatus</b>:Whether or not to ignore duplicate status messages</li>
</ul>
</div>
<div>
<a name="bang"/>
<div class="command">!</div>
<p>Execute a shell command</p>
<p class="fixed">
Usage: ! [COMMAND]<br/>
<br/>
Example: ! ls ~<br/>
</p>
<p>
This command will print the results of [COMMAND] for you to see
</p>
</div>
<div>
<a name="alias"/>
<div class="command">/alias</div>
<p>Create a textual substition alias</p>
<p class="fixed">
Usage: /alias [NAME] [COMMAND]<br/>
<br/>
Example: /alias printtime ! date<br/>
</p>
<p>
The example above creates the aliased command printtime, which
runs the date program using the ! command. /alias by itself
will list the aliases which currently exist.
</p>
</div>
<div>
<a name="unalias"/>
<div class="command">/unalias</div>
<p>Remove a textual substition alias</p>
<p class="fixed">
Usage: /unalias [ALIAS]<br/>
<br/>
Example: /unalias printtime<br/>
</p>
<p>
The example above removes the aliased command
print. /unalias by itself will list the aliases which
currently exist.
</p>
</div>
<div>
<a name="listprofiles"/>
<div class="command">/listprofiles</div>
<p>List all the profiles in your IMCom configuration.</p>
<p class="fixed">
Usage: /listprofiles<br/>
<br/>
Example: /listprofiles<br/>
</p>
</div>
<div>
<a name="listprofiles"/>
<div class="command">/listprofiles</div>
<p>List all the profiles in your IMCom configuration.</p>
<p class="fixed">
Usage: /listprofiles<br/>
<br/>
Example: /listprofiles<br/>
</p>
</div>
<div>
<a name="switchprofile"/>
<div class="command">/switchprofile</div>
<p>Switch to another profile from your config.</p>
<p class="fixed">
Usage: /switchprofile [PROFILE-NAME]<br/>
<br/>
Example: /switchprofile debug<br/>
</p>
</div>
<div>
<a name="quit"/>
<div class="command">/quit</div>
<p>Logoff and quit IMCom.</p>
<p class="fixed">
Usage: /quit<br/>
<br/>
Example: /quit<br/>
</p>
</div>
<div>
<a name="saveprefs"/>
<div class="command">/saveprefs</div>
<p>Save this profile's preferences to disk.</p>
<p class="fixed">
Usage: /saveprefs<br/>
<br/>
Example: /saveprefs<br/>
</p>
<p>
Your profile's preferences are NOT saved automatically, if
you change a boolean variable or create an alias it will be
LOST when you next start IMCom UNLESS you /saveprefs.
</p>
</div>
<div>
<a name="logs"/>
<div class="command">/logs</div>
<p>An advanced command that lets you search through logs files</p>
<p class="fixed">
Usage: /logs<br/>
<br/>
Example: /logs<br/>
</p>
<p>
I really need to figure out exactly how this works and
document it well. If you see this, send an email to
crabbkw@nafai.dyndns.org to kick him into doing it.
</p>
</div>
<div>
<a name="last"/>
<div class="command">/last</div>
<p>Show the history of exchange with someone</p>
<p class="fixed">
Usage 1: /last [JID]<br/>
Usage 2: /last [JID] [NUMBER-OF-EXCHANGES]<br/>
<br/>
Example 1: /last airog<br/>
Example 2: /last airog 4<br/>
</p>
</div>
<div>
<a name="help"/>
<div class="command">/help</div>
<p>Prints out a quick reference of IMCom's commands.</p>
<p class="fixed">
Usage: /help<br/>
<br/>
Example: /help<br/>
</p>
</div>
<div>
<a name="version"/>
<div class="command">/version</div>
<p>Prints out IMCom's version or requests what version someone else is using</p>
<p class="fixed">
Usage 1: /version<br/>
Usage 2: /version [JID]<br/>
<br/>
Example 1: /version<br/>
Example 2: /version airog<br/>
</p>
</div>
<div>
<a name="changepassword"/>
<div class="command">/changepassword</div>
<p>Changes your jabber account password.</p>
<p class="fixed">
Usage: /changepassword [NEW-PASSWORD]<br/>
<br/>
Example: /changepassword im-in-the-clear<br/>
</p>
</div>
<div>
<a name="modload"/>
<div class="command">/loadmod</div>
<p>Attempts to load a module.</p>
<p class="fixed">
Usage: /loadmod [MODULE-NAME]<br/>
<br/>
Example: /loadmod conferencecolorsmodule<br/>
</p>
</div>
<div>
<a name="modunload"/>
<div class="command">/unloadmod</div>
<p>Attempts to unload a module.</p>
<p class="fixed">
Usage: /unloadmod [MODULE-NAME]<br/>
<br/>
Example: /unloadmod conferencecolorsmodule<br/>
</p>
</div>
<div>
<a name="modconfig"/>
<div class="command">/configmod</div>
<p>Tells the module to run its configuration routine.</p>
<p class="fixed">
Usage: /configmod [MODULE-NAME]<br/>
<br/>
Example: /configmod conferencecolorsmodule<br/>
</p>
</div>
</div>
<div class="section">
<a name="jabberadmin"/>
<div class="centerintro">Jabber Administrator Commands</div>
<div>
<a name="admin"/>
<div class="command">/admin</div>
<p>Sends a message to all users online or set a MOTD.</p>
<p class="fixed">
Usage 1: /admin [SERVER] announce/online<br/>
[type-multiple]<br/>
[lines-of]<br/>
[text]<br/>
[period or hash (. or #)]<br/>
Usage 2: /admin [SERVER] announce/motd<br/>
[type-multiple]<br/>
[lines-of]<br/>
[text]<br/>
[period or hash (. or #)]<br/>
<br/>
Example 1: /admin floobin.cx announce/online<br/>
[msg]: this<br/>
[msg]: is<br/>
[msg]: a<br/>
[msg]: multiline<br/>
[msg]: message broadcast to all<br/>
[msg]: users online right now.<br/>
[msg]: .<br/>
Example 1: /admin floobin.cx announce/motd<br/>
[msg]: this<br/>
[msg]: is<br/>
[msg]: a<br/>
[msg]: multiline<br/>
[msg]: message of the day<br/>
[msg]: .<br/>
</p>
<p>
You must be an admin on the jabber server to do this.<br/>
This command behaves like a multi-line message.<br/>
</p>
</div>
<div>
<a name="adminwho"/>
<div class="command">/adminwho</div>
<p>Prints a list of all users currently on the server.</p>
<p class="fixed">
Usage: /adminwho [SERVER]<br/>
<br/>
Example: /adminwho floobin.cx<br/>
</p>
<p>
You must be an admin on the jabber server to do this.<br/>
</p>
</div>
</div>
</body>
</html>
