micq(7)
NAME
mICQ - interactive commands
DESCRIPTION
This manual page describes the commands that can be used
within micq. This page holds the same information as the
online help, but more precise and longer.
COMMANDS CONCERNING THE MICQ CLIENT
- verbose [verb]
- Set verbosity of mICQ to verb, or show the current
verbosity. The verbosity level is a set of flags: - 8 Show protocol errors.
- 16 Show creation and deletion of packets.
- 32 Show added and removed queue events.
- 64 Show created and deleted connections.
- 256 Show v6 packets and their data.
- 4096 Show v7/v8 packets.
- 8192 Show the hexdump of v7/v8 packets.
- 16284 Save those packets to disc.
- 65536 Show peer-to-peer packets.
- 131072 Show the hexdump of peer-to-peer packets.
- 262144 Save those packets to disc.
- 2097152
Show peer-to-peer handshake.
- 4194304
Show I/O connection setup.
- However, any non-zero verbose level will cause more
information to be printed, and any level greater
than 1 even more. - clear Clear the screen.
- sound [on|off|event]
- Toggle sound on or off, or call the event script for beeps. New syntax for 0.4.10.
- autoaway [timeout|on|off]
- Set the timeout to timeout, or switch auto away on
using the last used or default auto away time, or
switch auto away off saving the current used auto
away time. A timeout of 0 is equivalent to off. If
no argument is given, the current setting is dis
played. - auto [on|off]
- Turn auto reply messages on or off. If neither on
or off is given the auto reply messages are
displayed. - auto status message
- Change auto reply message for status status to mes_ sage.
- alias [alias expansion]
- Make a new alias named alias which is substituted
with expansion. If no arguments are given, all current aliases are listed. If the string %s is
present in expansion, it is replaced with the given arguments when the alias is invoked, otherwise they
will be appended. New for 0.4.10. - unalias alias
- Delete the alias named alias. New for 0.4.10.
- alter command new
- Make command initially or previously known as com_
mand from now on known as new. This command is obsoleted by the alias command as of mICQ 0.4.10. - trans [lang|nr] ...
- Switch to the language lang, given by iso code, or
output translation string number nr. To select the
default language given by the environment variables
LANG, LC_ALL and LC_MESSAGES, use !, auto or default. To select no translation at all, use ., none or unload. To get debugging information, pre fix it with debug. To get funny messages, postfix
it with @fun. - The files from ~/.micq/i18n/*.i18n take precedence
over the global ones, while the "funny" ones take
precedence over the standard ones. - Actually you may specify as many arguments as you
wish, e.g. to print string number 117 in German and
then switch back to default language, use "trans de
117 default". - uptime Show the time mICQ has been running, plus some
- statistics.
- set option value
- Set option option to either on or off, or an option specific set of values. option can be:
- hermit:
ignore all non-contacts,
- delbs: interpret delete characters as backspace,
- funny: use funny messages,
- log: do logging,
- logonoff:
also log status changes,
- auto: send auto-replies when you're e.g. away,
- uinprompt:
have the last nick in the prompt,
- autosave:
automatically save the micqrc,
- autofinger:
automatically finger new UINs,
- linebreak:
set the style for line-breaking messages to
simple, to simply print the message after the nick and wrap, break, to add a line
break before printing each incoming message,
indent, to indent all lines of a message to the level after the nick, or smart, to add a
line break only if the message wouldn't fit
on the line; - tabs: set the style for tab-handling to simple, to
tab through a list of last nick sent to and
received from, cycle, to cycle through all
online contacts, doing auto-completion, or
cycleall, to cycle through all (even offline) contacts, doing auto-completion; - silent:
suppress some output : off, on, to suppress
status changes, or complete, to suppress status changes, logins and logoffs. - New options for 0.4.10.
- save Saves current settings in the configuration file,
- which is ~/.micq/micqrc, unless specified other
wise. Beware, it will clobber any comments in this
file. - q[uit]
- exit Quit mICQ. Aliases quit and exit new for 0.4.10.
COMMANDS CONCERNING MESSAGE SENDING
A <contacts> argument denotes a comma separated list of
contacts, that is, of UINs and nick names. If it is the
last argument, the contacts may also be separated by
spaces.
- msg <contacts> [message]
- Send a message to all contacts. Without message
multi-line message mode is enabled. To send the
multi-line message, put a period (.) on a line of
its own. To cancel the message, put a hash sign
(#) on a line of its own.
Outgoing and incoming messages are marked differ
ently depending of the transport used. ««« and »»» mark messages sent via a direct connection; if an
outgoing message is not acknowledged by the peer
for some time, it is printed marked ===. «<< and >>» mark icq8 (also called type-2) messages; if an
outgoing message is not acknowledged by the peer
for some time, it is printed marked --=. Lastly,
<<< and >>> mark icq5 messages, which can be so called type-1, type-4 or offline message. These
kind of messages are not acknowledged.
A message is first tried to be sent via a preexisting direct connection; if none is established,
one is initiated in the background for further mes
sages. If no direct connection is open, or if the
message is not acknowledged after some time, the
connection will be failed and the next transport
tried: sending as type-2 message. This step will be
skipped if the peer does not set the required capa
bilities to signal its ability to receive them. If
this is skipped, times out or returns an error,
e.g. the peer has gone offline in the time between,
the message is sent as an ordinary type-4 message.
If the peer signals its ability to accept them and
support for them has not been disabled at compile
time, messages are sent UTF-8 encoded and appropri
ately tagged. Otherwise, the message is sent
encoded in the peer's configured encoding, or, if
unset, the default assumed remote encoding.
type-1, type-4 and offline messages can not be
tagged with their encoding, so successful transmis
sion of 8bit characters relies on correct configu
ration. - a [message]
- Send a message to the last person you sent a mes
sage to. See msg for more details. - r [message]
- Reply to last message received. See msg for more
details. - url <contacts> url message
- Send a message regarding an url to all contacts.
- sms [nick] [cell] message
- Send an SMS message message to cell phone number
cell, which looks like +<country code><number>, or
to the cell phone number of nick, which will be set
to cell if unset. You may not specify cell if nick already has a cell phone number given. Invalid cell
phone numbers will be removed from the nick's meta
data. - getauto [auto|away|na|dnd|occ|ffc] [contacts]
- Requests auto message from contacts for given sta
tus, where away is for away, na for not available,
dnd for do not disturb, occ for occupied and ffc
for free for chat. If auto or nothing is given, the
auto message for the contacts is fetched for their
respective status. Contacts not in any of those
status will be skipped. New for 0.4.10. - auth [req|grant|deny|add] <contacts>
- Grant or deny all contacts to add you to their list, request from all contacts to allow you to add them to your contact list, or tell contacts that you added them to your contact list.
- resend <contacts>
- Resend the last message to more contacts.
- last [<contacts>]
- Show the last message received from contact, or from everyone who already sent a message.
- tabs Shows of a list of users you can tab through. This
- list is only used in the simple tab style. See the tabs option of the set command.
COMMANDS CONCERNING FINDING AND SEEING OTHER USERS
- rand number
- Find a random user in interest group number.
- s [<contacts>]
- Show your current status, or of all given contacts in detail, including all aliases.
- e, w, ee, ww, eg, wg, eeg, wwg
- List parts of your contact list. The following
flags are displayed in the first column: - + This entry is actually no real contact, but
an alias of the preceding one. Only with ww.
- # This entry is not on your contact list, but
the UIN was used at some time. Only with w
and ww. - * This contact will see your status even if
you're invisible.
- - This contact won't see you at all.
- ^ This contact is ignored: no messages, no
status changes.
- The ww and ee display another column for direct
connection flags. If the first column would be
empty, it will be displayed in the first contact
for all of those commands unless it's ^. - & A direct connection to this contact is
established.
- | A direct connection to this contact has
failed.
- : A direct connection is currently tried to be
established.
- ^ No direct connection opened, but IP address
and port number are known.
- e List all people who are online in
- your contact list.
- w List all people in your contact list.
- ee List all people who are online in
- your contact list with more details.
- ww List all people in your contact list
- with more details. Also shows all
aliases. - eg List all people who are online in
- your contact list, sorted by contact
groups. New for 0.4.10. - wg List all people in your contact list,
- sorted by contact groups. New for
0.4.10. - eeg List all people who are online in
- your contact list with more details,
sorted by contact groups. New for
0.4.10. - wwg List all people in your contact list
- with more details. Also shows all
aliases, sorted by contact groups.
New for 0.4.10. - ewide List all people who are online in
- your contact list in a screen wide
format. - wide List all people who are in your con
- tact list in a screen wide format.
- status [nickname]
- Show the status of nickname. This
includes IP address, ICQ protocol
version and connection type, or list
shortly UIN, nick, status and last
online time for all contacts. - Note: This command is deprecated, use
s or ww instead. - f[inger] uin|nickname
- info uin|nickname
- Show all white page info for
uin|nickname. - i List all the people on your ignore
- list.
- search
- search em@il
- search nick
- search first last
- Search for a user with em@il as their
email address, with nick as their
nick (which mustn't contain an @), or
with first as their first and last as
their last name. If no argument is
given, ask for nick name, first name,
last name, email address and a whole
bunch of other data to search for. - add[group] group [contacts]
- Add all contacts in contacts to the
contact group group, which is created
if it doesn't exist and the command
is given as addgroup. New for
0.4.10.
Note: you need to save to make this
persistent. - add[alias] nickname alias
- add[alias] uin nickname
- Add uin to your contact list as nick_
name, or add alias alias for nick_ name. New (addalias) for 0.4.10.
Note: you need to save to make this
persistent. - rem[group] [all] group
- rem[group] group contacts
- Remove all contacts in contacts from
the contact group group, or remove
the contact group completely if all
is given. New for 0.4.10. Note: you
need to save to make this persistent. - rem[alias] [all] contacts
- Remove the aliases in contacts. If
any nick is the last alias for this
contact, or if all is given, remove
the contact completely.
New (remalias) for 0.4.10. Note: you
need to save to make this persistent. - togig contacts
- Toggles whether contact's messages
and status changes are ignored. - toginv contacts
- Toggles whether you will be hidden
for contacts. - togvis contacts
- Toggles whether contacts can see you
even if you are invisible.
COMMANDS CONCERNING YOUR ICQ ACCOUNT
- reg password
- Creates a new user account with pass
word password. - pass password
- Changes your icq password to pass_
word.
Note: your password may not start
with ó (the byte 0xf3).
Note: you need to save to make this
persistent in case you save your
password in your ~/.micq/micqrc file (see micqrc(7)), or you will get a
mismatched password on your next
login. - change [number [message]]
- Changes your status to number. With
out a number it lists some available
modes. Optionally set auto response
for this status to message. - online Change status to "online".
- away [message]
- Change status to "away". Optionally
set auto response for this status to
message. - na [message]
- Change status to "not available".
Optionally set auto response for this
status to message. - occ [message]
- Change status to "occupied". Option
ally set auto response for this sta
tus to message. - dnd [message]
- Change status to "do not disturb".
Optionally set auto response for this
status to message. - ffc [message]
- Change status to "free for chat".
Optionally set auto response for this
status to message. - inv Change status to "invisible".
- update Updates your basic user information
- (email, nickname, etc.).
- other Updates other user information like
- age and sex.
- about Updates your about user information.
- setr [number]
- Sets your random user group to num_
ber. Without argument, lists possi
ble interest groups.
COMMANDS CONCERNING ADVANCED FEATURES
- meta [show|load|save|set|get|rget] <con_
tacts>
- Handle meta data of contacts. The
following subcommands are known: - show Shows the meta data of all
contacts given.
- load Loads the meta data for all
contacts given from disc and
shows them. - save Saves the meta data for all
contacts given to disc.
- set Uploads your meta data to the
server.
- get Gets the meta data for all
contacts from the server and
shows them. - getr Gets the meta data for the
contact the last message was
received from from the server
and shows it. - New for 0.4.10.
- file [...]
- Alias for peer file. New for 0.4.10.
- peer command uin|nick
- Operate command command on user given
by UIN uin or nick name nick. - open Open a peer to peer connection
over TCP to the user.
- close Close and reset a peer to peer
connection to the user.
- off Switch off trying to establish
such a connection for sending
messages until it is explic
itly opened or reset. - file file description
Send file file with descrip
tion description. - files [file as]... description
Send files to the user. There
may be arbitrarily many pairs
of a physical file name file
and the name to be presented
to the peer, as. If as is
'/', the file name without the
path is sent, and if it is '.'
the same name is sent. - conn [command nr]
- List all connections, or operate com_
mand on connection nr. - open Open the given, or the first
server connection.
- login Open the given, or the first
server connection.
- close Close the given connection.
Temporary connections will get
removed by this. - remove Close and remove given (tempo
rary) connection.
- select Select the given server con
nection as the current one.
nr may be the connection num
ber or the UIN used for the
connection. - contact [command]
- Handle the server side contact list:
- show Download the server side con
tact list and just show it.
- diff Download the server side con
tact list and show only con
tacts (uin/nick pairs) that
are not in the local contact
list. - import Download the server side con
tact list and add all contacts
to the local one. - There is no contact list upload yet.
- peek nick
- Check whether nick is actually online
or not. Abuses a bug in the ICQ pro
tocol to figure this out; no addi
tional information except online or
offline can be found out this way.
SEE ALSO
AUTHOR
- This man page was created by James Morrison
<ja2morrison@student.math.uwaterloo.ca> for a reference to all interactive commands in
mICQ.