1CLIMM(7)               Miscellaneous Information Manual               CLIMM(7)
2
3
4

NAME

6       climm - interactive commands
7

DESCRIPTION

9       This  manual page describes the commands that can be used within climm.
10       This page holds the same information as the online help, but more  pre‐
11       cise and longer.  Notations: square brackets ([]) denote optional argu‐
12       ments, while angle brackets (<>) denote arguments (in opposite to  key‐
13       words).  Specifically, <uin> denotes an arbitrary UIN, while <contacts>
14       denotes a comma separated list of contacts, that is, of UINs  and  nick
15       names.  If  it is the last argument, the contacts may also be separated
16       by spaces.
17

COMMANDS CONCERNING MESSAGE SENDING

19       msg <contacts> [<message>]
20              Send a message to all contacts.  Without message, or  with  mes‐
21              sage  ending  in  a  backslash  (\),  multi-line message mode is
22              enabled.  To send the multi-line message, put a period (.)  on a
23              line  of its own.  To cancel the message, put a hash sign (#) on
24              a line of its own.
25              Outgoing and incoming messages are marked differently  depending
26              of  the  transport  used.   ««« and »»» mark messages sent via a
27              direct connection.  «%« and »%» mark messages sent via a  direct
28              connection  that  were  encrypted  (requires  GnuTLS  or OpenSSL
29              enabled at compile time).  «<< and >>» mark  icq8  (also  called
30              type-2) messages.  Lastly, <<< and >>> mark icq5 messages, which
31              can be so called type-1, type-4 or offline message.  These  kind
32              of messages are not acknowledged.
33              A  message  is  first tried to be sent via a pre-existing direct
34              connection; if none is established,  one  is  initiated  in  the
35              background  for  further  messages.  If  no direct connection is
36              open, or if the message is not acknowledged after some time, the
37              connection  will be failed and the next transport tried: sending
38              as type-2 message. This step will be skipped if  the  peer  does
39              not  set  the  required  capabilities  to  signal its ability to
40              receive them. If this is skipped, times out or returns an error,
41              e.g.  the peer has gone offline in the time between, the message
42              is sent as an ordinary type-4 message.
43              If the peer signals its ability to  accept  them,  messages  are
44              sent UTF-8 encoded and appropriately tagged. Otherwise, the mes‐
45              sage is sent encoded in the peer´s configured encoding,  or,  if
46              unset,  the default assumed remote encoding.  type-1, type-4 and
47              offline messages can not be tagged with their encoding, so  suc‐
48              cessful transmission of non-USASCII-characters relies on correct
49              configuration and heuristics.
50
51       a [<message>]
52              Send a message to the last person you sent a message to.   Auto-
53              expanding alias for msg %a.
54
55       r [<message>]
56              Reply  to  last  message  received.   Auto-expanding  alias  for
57              msg %r.
58
59       url <contacts> <url> <message>
60              Send a message regarding an url to all contacts.
61
62       sms [<nick>] [<cell>] <message>
63              Send an SMS message message to cell  phone  number  cell,  which
64              looks  like +<country code><number>, or to the cell phone number
65              of nick, which will be set to cell if unset. You may not specify
66              cell if nick already has a cell phone number given. Invalid cell
67              phone numbers will be removed from the nick´s meta data.
68
69       chat <contacts> [<message>]
70              Sends a message message to contacts contacts  just  as  the  msg
71              command.  After  the  message is sent (or cancelled), multi-line
72              mode is entered and messages sent until an empty message is can‐
73              celled.   Cancelling  a  non-empty  message will only cancel the
74              message itself, and more messages  in  multi-line  mode  can  be
75              sent.
76
77       getauto [auto|away|na|dnd|occ|ffc] [<contacts>]
78              Requests auto message from contacts for given status, where away
79              is for away, na for not available, dnd for do not  disturb,  occ
80              for  occupied  and  ffc for free for chat. If auto or nothing is
81              given, the auto message for the contacts is  fetched  for  their
82              respective  status.  Contacts not in any of those status will be
83              skipped.  New for 0.4.10.
84
85       auth [req|grant|deny|add] <contacts>
86              Grant or deny all contacts to add you  to  their  list,  request
87              from all contacts to allow you to add them to your contact list,
88              or tell contacts that you added them to your contact list.
89
90       resend <contacts>
91              Resend the last message to more contacts.
92
93       last [<contacts>]
94              Show the last message received from contact,  or  from  everyone
95              who already sent a message.
96
97       h <contact> [<last> [<count>]]
98
99       history <contact> [<last> [<count>]]
100              Show  messages  from  <contact> from the log files. Start at the
101              last latest message, or the -last message if last  is  negative,
102              defaulting  to  the  20ieth last message, and display count mes‐
103              sages, defaulting to 20 if not given.
104
105       historyd <contact|*> <date> [<count>]
106              Show messages from <contact> or all contacts (for  *)  from  the
107              log  files.  Start at date date, which must be given in ISO 8601
108              format, either YYYY-MM-DD or  YYYY-MM-DDTHH:MM:SS,  and  display
109              count messages, defaulting to 20 if not given.
110
111       find <contact> <pattern>
112              Search  the pattern pattern case-insensitive in the log file for
113              contact.
114
115       finds <contact> <pattern>
116              Search the pattern pattern case-sensitive in the  log  file  for
117              contact.
118
119       tabs   Shows of a list of users you can tab through.
120

COMMANDS CONCERNING YOUR STATUS

122       login  A built-in shortcut for conn login.  Opens the first server con‐
123              nection.
124
125       online [for <contacts> [<message>]]
126              Change status to online, or change status to online only for the
127              listed  contacts  and  optionally specify the status message for
128              them.
129
130       away [for <contacts>] [<message>]
131              Change status to away and optionally set  auto  response  tempo‐
132              rarely  for  this  status  to message, or change status only for
133              given contacts and optionally specify  the  status  message  for
134              them.
135
136       na [for <contacts>] [<message>]
137              Change  status  to  na(not available)  and  optionally  set auto
138              response temporarely for this status to message, or change  sta‐
139              tus  only  for  given contacts and optionally specify the status
140              message for them.
141
142       occ [for <contacts>] [<message>]
143              Change status to occ(occupied) and optionally set auto  response
144              temporarely  for  this  status to message, or change status only
145              for given contacts and optionally specify the status message for
146              them.
147
148       dnd [for <contacts>] [<message>]
149              Change  status  to  dnd(do not disturb)  and optionally set auto
150              response temporarely for this status to message, or change  sta‐
151              tus  only  for  given contacts and optionally specify the status
152              message for them.
153
154       ffc [for <contacts>] [<message>]
155              Change status to  ffc(free for chat)  and  optionally  set  auto
156              response  temporarely for this status to message, or change sta‐
157              tus only for given contacts and optionally  specify  the  status
158              message for them.
159
160       inv [for <contacts>] [<message>]
161              Change status to inv(invisible) and optionally set auto response
162              temporarely for this status to message, or  change  status  only
163              for given contacts and optionally specify the status message for
164              them.
165
166       change [<number> [for <contacts>] [<message>]]
167              Without a number it  lists  some  available  modes.   Otherwise,
168              change  status to number and optionally set auto response tempo‐
169              rarely for this status to message, or  change  status  only  for
170              given  contacts  and  optionally  specify the status message for
171              them.
172

COMMANDS CONCERNING FINDING AND SEEING OTHER USERS

174       f <contacts>
175
176       finger <contacts>
177              Show all white page information for contacts <contacts>.
178
179       ss <contacts>
180              Show all saved white page information for contacts <contacts>.
181
182       i      List all the people on your ignore list.
183
184       s [<contacts>]
185              Show your current status, or of all given  contacts  in  detail,
186              including all aliases.
187
188       e, ee, eg, eeg, ev, eev, egv, eegv, w, ww, wg, wwg, wv, wwv, wgv, wwgv
189              List  parts  of  your contact list. The following flags are dis‐
190              played in the first column:
191
192              +      This entry is actually no real contact, but an  alias  of
193                     the preceding one. Only with ww.
194
195              #      This  entry  is not on your contact list, but the UIN was
196                     used at some time. Only with w and ww.
197
198              *      This contact will see your status even if you´re  invisi‐
199                     ble.
200
201              -      This contact won´t see you at all.
202
203              ^      This contact is ignored: no messages, no status changes.
204
205              The  ww*  and  ee*  group of commands display another column for
206              direct connection flags. If the first column would be empty,  it
207              will be displayed in the first contact for all of those commands
208              unless it´s ^.
209
210              &      A direct connection to this contact is established.
211
212              |      A direct connection to this contact has failed.
213
214              :      A direct connection is currently tried to be established.
215
216              ^      No direct connection opened, but IP address and port num‐
217                     ber are known.
218
219              Another column is added for the ww* and ee* group of commands to
220              show the status with regards to the server side contact list, as
221              far as it is known:
222
223              S      The  contact  is  in  the  server  side contact list, and
224                     should be there.
225
226              s      The contact is in  the  server  side  contact  list,  but
227                     should not be there.
228
229              .      The  contact  is not in the server side contact list, but
230                     should  be  there.  This  usually  means   "authorization
231                     required".
232
233              ´ ´    The  contact  is not in the server side contact list, and
234                     is not wanted there.
235
236       e [<group>]
237              List all people which are online  in  your  contact  list.  Also
238              print your own status.
239
240       ee [<group>]
241              List  all people which are online in your contact list with more
242              details.
243
244       eg, eeg
245              As above, but sort by groups. New for 0.4.10.
246
247       w, ww, wg, wwg
248              As above, but also include offline contacts.
249
250       ev, eev, egv, eegv, wv, wwv, wgv, wwgv
251              As above, but also include  hidden  contacts  (with  the  shadow
252              option effectively set). New for 0.5.
253
254       ewide  List  all  people  which  are  online  in your contact list in a
255              screen wide format.
256
257       wide   List all people in your contact list in a screen wide format.
258
259       search
260
261       search <em@il>
262
263       search <contact>
264
265       search <first> <last>
266              Search for a user with em@il as their email address,  with  nick
267              as  their  nick  (which  mustn´t contain an @), or with first as
268              their first and last as their  last  name.  If  no  argument  is
269              given,  ask  for nick name, first name, last name, email address
270              and a whole bunch of other data to search for.
271
272       rand [<number>]
273              Find a random user in interest group number.  If number  is  not
274              given, list all interest groups.
275

COMMANDS CONCERNING YOUR CONTACT LIST

277       add <uin> <nickname>
278              Add uin to your contact list as nickname.
279              Note: you need to save to make this persistent.
280
281       add <contact> <alias>
282
283       addalias <contact> <alias>
284              Add alias alias for nickname.  New (addalias) for 0.4.10.
285              Note: you need to save to make this persistent.
286
287       add [<group> [<contacts>]
288
289       addgroup <group> [<contacts>]
290              Add  all  contacts in contacts to the contact group group, which
291              is created if it doesn´t exist  and  the  command  is  given  as
292              addgroup.  New for 0.4.10.
293              Note: you need to save to make this persistent.
294
295       rem [all] <contacts>
296
297       remalias [all] <contacts>
298              Remove  the  aliases in contacts.  If any nick is the last alias
299              for this contact, or if all is given, remove  the  contact  com‐
300              pletely.
301              New  (remalias) for 0.4.10.  Note: you need to save to make this
302              persistent.
303
304       rem all <group>
305
306       rem <group> <contacts>
307
308       remgroup all <group>
309
310       remgroup <group> <contacts>
311              Remove all contacts in contacts from the contact group group, or
312              remove  the  contact  group completely if all is given.  New for
313              0.4.10.  Note: you need to save to make this persistent.
314
315       togig <contacts>
316              Toggles  whether  contact´s  messages  and  status  changes  are
317              ignored.
318
319       toginv <contacts>
320              Toggles whether you will be hidden for contacts.
321
322       togvis <contacts>
323              Toggles whether contacts can see you even if you are invisible.
324

COMMANDS CONCERNING YOUR ICQ ACCOUNT

326       pass <password>
327              Changes your icq password to password.
328              Note: your password may not start with ó (the byte 0xf3).
329              Note:  you need to save to make this persistent in case you save
330              your password in your ~/.climm/climmrc file (see climmrc(5)), or
331              you will get a mismatched password on your next login.
332
333       update Updates your basic user information (email, nickname, etc.).
334
335       other  Updates other user information like age and sex.
336
337       about  Updates your about user information.
338
339       setr [<number>]
340              Sets  your random user group to number.  Without argument, lists
341              possible interest groups.
342
343       reg <password>
344              Creates a new user account with password password.
345

COMMANDS FOR CONFIGURING THE CLIMM CLIENT

347       verbose [<level>]
348              Set verbosity of climm to level, or show the current  verbosity.
349              The verbosity level is a set of flags:
350
351              8      Show protocol errors.
352
353              16     Show creation and deletion of packets.
354
355              32     Show added and removed queue events.
356
357              64     Show created and deleted connections.
358
359              256    Show v6 packets and their data.
360
361              4096   Show v7/v8 packets.
362
363              8192   Show the hexdump of v7/v8 packets.
364
365              16284  Save those packets to disc.
366
367              65536  Show peer-to-peer packets.
368
369              131072 Show the hexdump of peer-to-peer packets.
370
371              262144 Save those packets to disc.
372
373              2097152
374                     Show peer-to-peer handshake.
375
376              4194304
377                     Show I/O connection setup.
378
379              However,  any non-zero verbose level will cause more information
380              to be printed, and any level greater than 1 even more.
381
382       clear  Clear the screen.
383
384       sound [on|off|event]
385              Toggle sound on or off, or call the event script for beeps.  New
386              syntax for 0.4.10.
387
388       prompt <user_prompt>
389              Set user prompt in user_prompt.  The following variables will be
390              parsed and may be used in prompt string:
391
392              %U     by your current user name
393
394              %n     by your current nick
395
396              %S     by description of your status
397
398              %s     by short description of your status
399
400              %P     by server name
401
402              %p     by type of server (icq8, jabber, msn...)
403
404              %a     by last send uin/nick
405
406              %r     by last recived uin/nick
407
408              %t     by time in format HH:MM:SS
409
410              %T     by time in format given in option prompt_strftime .
411
412              %%     %
413
414              %[0-9]c
415                     by foreground color
416
417              %[0-9]C
418                     by background color
419
420              %[0-1]b
421                     bold. on = 1 (default), off = 0
422
423              %[0-1]u
424                     underline. on = 1 (default), off = 0
425
426              %[0-1]i
427                     inverse; on = 1 (default), off = 0.  Reverses  foreground
428                     and background colors.
429
430              %d     set default all colors and styles
431
432              \b     backspace
433
434              \r     carriage return
435
436              \n     new line
437
438              \t     horizontal tab
439
440              \e     ESC
441
442              \\     backslash
443
444              Example:
445               prompt                        %4c%b%p%d://%1c%b%n%3c/%2c%b%s%8c
446              %t%7c%b>%6c%r%7c%b<%6c%b%a%7c%b>
447
448       autoaway [<timeout>|on|off]
449              Set the timeout to timeout, or switch auto  away  on  using  the
450              last  used  or  default  auto away time, or switch auto away off
451              saving the current used auto away time. A timeout of 0 is equiv‐
452              alent  to  off.  If no argument is given, the current setting is
453              displayed.
454
455       alias [auto[expand]] [<alias> [<expansion>]]
456              Make a new alias named alias which is  substituted  with  expan‐
457              sion.   If  no  alias is given, list all current aliases.  If no
458              expansion is given, list the current alias.  Otherwise, create a
459              new  alias.  If the auto or autoexpand keyword is given, the new
460              alias is auto-expanding, that is,  it  is  immediately  expanded
461              when  the space or return key is pressed directly after entering
462              the alias.
463              If the string %s is present  in  expansion,  each  occurence  is
464              replaced  with  the  given  arguments when the alias is invoked,
465              otherwise they will be appended.  If the string %r is present in
466              expansion,  each  occurence  is replaced by the nick name or, if
467              the nick is not available, the UIN, of the contact that sent the
468              last  message  to you, or the empty string if there is none.  If
469              the string  %a  is  present  in  expansion,  each  occurence  is
470              replaced  by the nick name or, if the nick is not available, the
471              UIN, of the contact that you sent the last message  to,  or  the
472              empty string if there is none.
473              New for 0.4.10. Auto-expanding aliases new for 0.5.0.4.
474
475       unalias <alias>
476              Delete the alias named alias.  New for 0.4.10.
477
478       lang [<lang>|<nr>] ...
479              Switch  to the language and encoding lang, given by iso code, or
480              output translation string number nr.  To select the default lan‐
481              guage  given  by  the  environment  variables  LANG,  LC_ALL and
482              LC_MESSAGES, use !, auto or default.  To select  no  translation
483              at  all,  use  ., none or unload.  To get debugging information,
484              prefix it with debug.
485
486              The files from ~/.climm/i18n/*.i18n  take  precedence  over  the
487              global  ones,  the  files  from BASE/i18n/*.i18b take precedence
488              over those from ~/.climm/i18n/*.i18n, while  the  "funny"  texts
489              take precedence over the standard ones.
490
491              You  may  specify  as  many arguments as you wish, e.g. to print
492              string number 117 in German and then switch back to default lan‐
493              guage, use "trans de 117 default".
494
495       uptime Show the time climm has been running, plus some statistics.
496
497       set <option> <value>
498              Set option option to either on or off, or an option specific set
499              of values.  option can be:
500
501              color: use colors,
502
503              delbs: interpret delete characters as backspace,
504
505              funny: use funny messages,
506
507              auto:  send auto-replies when you´re e.g. away,
508
509              prompt:
510                     Type of the prompt:
511
512                     user   use user prompt.  See  command  prompt  in  climm‐
513                            cmds(7), and options prompt and prompt_strftime in
514                            climmrc(5),
515
516                     uin    have the last nick in the prompt,
517
518                     simple simpe prompt, by default is "climm>".
519
520              autosave:
521                     automatically save the climmrc,
522
523              autofinger:
524                     automatically finger new UINs,
525
526              linebreak:
527                     set the style for line-breaking messages  to  simple,  to
528                     simply  print the message after the nick and wrap, break,
529                     to add a line break before printing  each  incoming  mes‐
530                     sage,  indent,  to  indent  all lines of a message to the
531                     level after the nick, or smart, to add a line break  only
532                     if the message wouldn´t fit on the line;
533
534              New  options  for 0.4.10. Options hermit, log, logonoff, silent,
535              tabs removed for 0.5; use the opt command for them.
536
537       opt [<contact>|<contact group>|connection|global [<option> [<value>]]]
538              Set option  option  for  contact  contact,  contact  group  con‐
539              tact group,  for the current connection or globally to the value
540              value, or display the current value, or display all options  and
541              their settings.
542              When  resolving options for contacts, the option for the contact
543              itself will be used, if set; otherwise, if the  contact  belongs
544              to a group, the option for that group, if set; otherwise, if the
545              contact  belongs  to  a  server  connection  (i.e.  is  not  yet
546              removed),  the  option  for the server connection; otherwise the
547              global option, if set. Otherwise, 0 for integer  options,  FALSE
548              for boolean options, the color string for "no color" unless this
549              color string is  requested,  or  the  empty  string  for  string
550              options.
551              When  resolving  options  for  contact  groups, the same is done
552              except for the first step; options  for  connections  are  taken
553              from  the  connection,  then  globally;  and  global options, of
554              course, only globally.
555              The following options currently exist, with type and applicabil‐
556              ity:
557
558              colorscheme integer global
559                     The  number  of the color scheme to use. Set to 0 to dis‐
560                     able and use the colors defined below.
561
562              colornone color global
563                     The color string to use for  normal  text.  The  keywords
564                     black,  red,  green,  yellow, blue, magenta, cyan, white,
565                     none, and bold are understood and replaced by their  ANSI
566                     control  sequences.  Note that any color already includes
567                     none, so specify bold always after the color.  Any  other
568                     text  is interpreted as control characters to output ver‐
569                     batim.
570
571              colorserver color global
572                     The color string to use for server stuff.
573
574              colorclient color global
575                     The color string to use for client stuff.
576
577              colorinvchar color global
578                     The color string to use  when  displaying  byte-sequences
579                     invalid for the given encoding.
580
581              colorerror color global
582                     The color string to use for errors.
583
584              colordebug color global
585                     The color string to use for debug output.
586
587              colorquote color global
588                     The color string to use for quoted text.
589
590              webaware boolean connection
591                     Whether the current status should be visible on the web.
592
593              hideip boolean connection
594                     Whether to hide the (local) IP address.
595
596              dcauth boolean connection
597                     Whether  authorized  contacts  can  see  the  (remote) IP
598                     address.
599
600              dccont boolean connection
601                     Whether contacts can see the (remote) IP address.
602
603              countaway boolean connection
604                     If set, incoming messages will be counted and their orig‐
605                     inators  shown  if the status is manually changed to any‐
606                     thing other than online or ffc (with or  without  invisi‐
607                     ble).   Otherwise,  this  is  only done if the status was
608                     automatically changed to away  or  na  (with  or  without
609                     invisible).
610
611              obeysbl boolean connection
612                     Whether to load the server-based contact list upon login.
613                     This will enforce required authorizations, which will  be
614                     ignored for local contact lists.
615
616              ignore boolean contact
617                     Whether to ignore all messages from this contact.
618
619              hidefrom boolean contact
620                     Whether to be invisible for this contact.
621
622              intimate boolean contact
623                     Whether to be allways visible for this contact.
624
625              logonoff boolean contact
626                     Whether to log when this contacts goes online or offline.
627
628              logchange boolean contact
629                     Whether to log status changes for this contact.
630
631              logmess boolean contact
632                     Whether to log messages for this contact.
633
634              showonoff boolean contact
635                     Whether to show when this contact goes online or offline.
636
637              showchange boolean contact
638                     Whether to show status changes for this contact.
639
640              autoauto boolean contact
641                     Whether  to  automatically  request automatic messages on
642                     status changes for this contact.
643
644              hideack boolean contact
645                     Whether to hide acknowledges for messages  to  this  con‐
646                     tact.
647                     Note:  using  this  is  a really bad idea, as you'll miss
648                     when messages are resent without acknowledge.
649
650              wantsbl boolean contact
651                     Whether you want this contact to be on  the  server  side
652                     contact list.
653
654              peekme boolean contact
655                     Whether you want this contact to be peeked when using the
656                     peek all or peekall command.
657
658              shadow boolean contact
659                     Whether you want to hide this  contact  in  contact  list
660                     displays as long as none of the *v commands is used.
661
662              local boolean contact
663                     Whether  this  contact  is not a real contact, but just a
664                     nick for a number.
665
666              encoding string contact
667                     The encoding to assume for  messages  whose  encoding  is
668                     undefined, in particular meta data on the server.
669
670              tabspool integer contact
671                     Whether to add a contact to the tabs list upon startup.
672
673              autoaway string contact
674                     The  autoaway  string  for  status away to return to this
675                     contact.
676
677              autona string contact
678                     The autoaway string for status na to return to this  con‐
679                     tact.
680
681              autoocc string contact
682                     The autoaway string for status occ to return to this con‐
683                     tact.
684
685              autodnd string contact
686                     The autoaway string for status dnd to return to this con‐
687                     tact.
688
689              autoffc string contact
690                     The autoaway string for status ffc to return to this con‐
691                     tact.
692
693              colormessage string contact
694                     The color string to use for messages of this contact.
695
696              colorsent string contact
697                     The color string to use for the nick  when  messages  are
698                     sent.
699
700              colorack string contact
701                     The  color  string  to use for the nick when messages are
702                     acknowledged.
703
704              colorincoming string contact
705                     The color string to use for the nick  when  messages  are
706                     received.
707
708              colorcontact string contact
709                     The color string to use for the nick otherwise.
710
711              New for 0.5.
712
713       optcontact <contact> [<option> [<value>]]
714              Set  or display option option or all options of contact contact.
715              New for 0.5.
716
717       optgroup <group> [<option> [<value>]]
718              Set or display option option or all  options  of  contact  group
719              group.  New for 0.5.
720
721       optconnection [<option> [<value>]]
722              Set or display connection option option.  New for 0.5.
723
724       optglobal [<option> [<value>]]
725              Set or display global option option.  New for 0.5.
726
727       save   Saves  current  settings  in  the  configuration  file, which is
728              ~/.climm/climmrc, unless specified otherwise.  Beware,  it  will
729              clobber any comments in this file.
730
731       q [<msg>]
732
733       quit [<msg>]
734
735       exit [<msg>]
736              Quit  climm. If given, send the message msg to all contacts pre‐
737              viously messaged that are still online and on the contact list.
738              Note: climm will not wait for any acknowledges - if the  message
739              is  not received by the contact for whatever reason, it will not
740              be resent.
741              Aliases quit and exit new for 0.4.10.
742
743       x [<msg>]
744              Quit climm without saving. If given, send the message msg to all
745              contacts  previously  messaged  that are still online and on the
746              contact list.
747              Note: climm will not wait for any acknowledges - if the  message
748              is  not received by the contact for whatever reason, it will not
749              be resent.
750              Aliases quit and exit new for 0.4.10.  New for 0.5.
751

COMMANDS CONCERNING ADVANCED FEATURES

753       meta [show|load|save|set|get|rget] <contacts>
754              Handle meta data of  contacts.  The  following  subcommands  are
755              known:
756
757              show   Shows the meta data of all contacts given.
758
759              load   Loads  the meta data for all contacts given from disc and
760                     shows them.
761
762              save   Saves the meta data for all contacts given to disc.
763
764              set    Uploads your meta data to the server.
765
766              get    Gets the meta data for all contacts from the  server  and
767                     shows them.
768
769              getr   Gets  the  meta data for the contact the last message was
770                     received from from the server and shows it.
771
772              New for 0.4.10.
773
774       file [...]
775              Alias for peer file.  New for 0.4.10.
776
777       accept [...]
778              Alias for peer accept.  New for 0.4.10.4.
779
780       peer <command> <uin|nick>
781              Operate command command on user given by UIN uin  or  nick  name
782              nick.
783
784              open   Open a peer to peer connection over TCP to the user.
785
786              close  Close and reset a peer to peer connection to the user.
787
788              off    Switch  off  trying  to  establish  such a connection for
789                     sending messages until it is explicitly opened or reset.
790
791              file <file> <description>
792                     Send file file with description description.
793
794              files [<file> <as>]... <description>
795                     Send files to the user. There  may  be  arbitrarily  many
796                     pairs  of  a  physical  file name file and the name to be
797                     presented to the peer, as.  If as is ´/´, the  file  name
798                     without  the path is sent, and if it is ´.´ the same name
799                     is sent.
800
801              accept [<contact>] [<id>]
802                     Accept an incoming file request  from  contact  with  the
803                     given  ID id.  If there is only one pending incoming file
804                     request, the contact and id  arguments  may  be  omitted,
805                     otherwise  it is undefined which file request is answered
806                     when several match.
807
808              deny [<contact>] [<id>] [<reason>]
809                     Deny an incoming file request from contact with the given
810                     ID id with the reason reason.
811
812       login [...]
813              Alias for conn login.  New for 0.4.10.4.
814
815       conn [<command> <nr>]
816              List all connections, or operate command on connection nr.
817
818              open   Open  the  given,  or  the  first  server  connection. An
819                     optional password may be given, which overrides any  pre‐
820                     viously known one.
821
822              login  Open  the  given,  or  the  first  server  connection. An
823                     optional password may be given, which overrides any  pre‐
824                     viously known one.
825
826              close  Close  the  given  connection. Temporary connections will
827                     get removed by this.
828
829              remove Close and remove given (temporary) connection.
830
831              select Select the given server connection as  the  current  one.
832                     nr  may  be the connection number or the UIN used for the
833                     connection.
834
835       contact [<command>]
836              Handle the server side contact list:
837
838              show   Download the server side contact list and just show it.
839
840              diff   Download the server side contact list and show only  con‐
841                     tacts  (uin/nick pairs) that are not in the local contact
842                     list.
843
844              add    Download the server side contact list and  add  all  con‐
845                     tacts to the local one.
846
847              upload Try  to  upload local contacts to the server side contact
848                     list.
849
850              download
851                     Download contacts from the server side contact list,  but
852                     avoid modifying already existing contacts.
853
854              import Download contacts from the server side contact list, mod‐
855                     ifying existing contacts.
856                     Note: This will always try to upload only those  contacts
857                     with  the  wantsbl contact option. Do a optglobal wantsbl
858                     on if you want to upload all of your contacts.
859
860       peek [<contacts>] [all] [<contacts>]
861              Check for each contact whether it is actually online or not. The
862              special keyword all will check upon all contacts with the peekme
863              option effectively set.
864              Note: This abuses a bug in the ICQ protocol to figure  this  out
865              and  thus  can stop working at any time.  No additional informa‐
866              tion except online or offline can be found out this way.
867
868       peek2 <contacts>
869              Builtin alias for getauto away contacts.  Can be used to  detect
870              presence  of  users  of  some  clients,  but  this itself can be
871              detected by the other user's client.  climm since 0.5  will  not
872              be detected by this, but will detect tries from other clients.
873
874       peekall [<contacts>]
875              Builtin alias for peek <contacts> all.
876
877       as <nr|uin> <cmd>
878              Execute  climm command cmd as if the connection number nr or for
879              the UIN uin would be the current one.
880

COMMANDS FOR SCRIPTING

882       tclscript <file>
883              Execute the tcl script file, which may be given relative to  the
884              climm base directory.
885
886       tcl <string>
887              Execute  the  tcl  command string.  Type tcl climm help to get a
888              list of climm-specific tcl commands.
889

SEE ALSO

891       climm(1), climmrc(5)
892

AUTHOR

894       This man page was  originally  created  by  James  Morrison  <ja2morri‐
895       son@student.math.uwaterloo.ca>  for a reference to all interactive com‐
896       mands in climm.  It has  been  adapted  to  current  usage  by  Rüdiger
897       Kuhlmann.
898
899
900
901                                     climm                            CLIMM(7)
Impressum