FAQ

   1 /*
   2 *
   3 * The CenterIM FAQ (frequently asked questions)
   4 * originally by Konstantin Klyagin
   5 * currently maintained by the CenterIM community.
   6 *
   7 *
   8 */
   9
  10 /* *** */
  11
  12 Q: What about implementing such a neat <blah-blah> feature in centerim?
  13
  14 A: Hey, centerim is GPL and opensource, so feel free to contribute.
  15    Don't wait for the maintainers to implement it, just do it
  16    yourself and send a patch.
  17
  18 /* *** */
  19
  20 Q: Can't build it under FreeBSD..
  21
  22 A: Use gmake instead of make
  23
  24 /* *** */
  25
  26 Q: (by Paonia Ezrine, paonia@home.welcomehome.org)
  27    When I run centerim in a xterm or from the console it is fine but
  28    when I run it in a gnome terminal windows the screen does not update
  29    correctly. Specificly the right side of the screen does not get
  30    cleared after I send a message or other similar events.
  31
  32 A: (by Jakub Travnik, j.travnik@sh.cvut.cz)
  33
  34    It happens only with the gnome-terminal. centerim works fine on
  35    linux-console and eterm (enlightenment) so it is problem with
  36    gnome-terminal. It does not support all xterm sequences.
  37    /usr/share/terminfo/g/gnome file could correct that (gnome users
  38    should have it), so that ncurses will not use such a extended
  39    sequences for gnome-terminal.
  40
  41    Workaround: For me it worked setting TERM variable to gnome and then
  42    running centerim without problems.
  43
  44    (gnome-terminal)
  45    $ export TERM=gnome
  46    $ centerim
  47
  48    and it is ok
  49
  50 /* *** */
  51
  52 Q: How do I authorize someone's request with centerim?
  53
  54 A: You'll see as soon as someone requests it.
  55
  56 /* *** */
  57
  58 Q: I can't use Ctrl-O to view history and Ctrl-Y to delete a line under
  59    FreeBSD
  60
  61 A: Execute the following before starting centerim:
  62     stty dsusp undef
  63     stty discard undef
  64
  65 /* *** */
  66
  67 Q: I can't get out from a dialog or a menu. When I press ESC, nothing
  68    happens.
  69
  70 A: Have you ever used mc (Midnight commander)? It requires users to
  71    press ESC twice to close a dialog, menu, etc. It's not a problem, but
  72    just a terminal specific issue.
  73
  74 /* *** */
  75
  76 Q: How do I enable logging the protocol info, etc?
  77
  78 A: Run centerim with --debug flag.
  79
  80 /* *** */
  81
  82 Q: CenterIM compiles way too slow on my box. What's wrong?
  83
  84 A: C++ compiler optimization being a rather slow thing is on by default.
  85    To turn it off, do the following.
  86    [konst@morgue]$ CXXFLAGS=-O0 ./configure && make
  87
  88 /* *** */
  89
  90 Q: From: jeff covey <jeff.covey@pobox.com>
  91
  92   if i understand the faq correctly, centerim makes esc into escesc
  93   because some terminals don't map esc properly. could the use of esc or
  94   escesc be made a configuration choice? for me, hitting escape twice is
  95   reallyreally annoyingannoying, especially if i'm two menus in, and to
  96   get out, i have to hit escape four times in a rowrowrowrow.
  97
  98 A: From: lanzz@lanzz.org
  99
 100   it's a limitation of the console. keys like f1..f12, the arrows, etc,
 101   generate sequences of characters starting with esc. if the application
 102   was to handle esc as cancel unconditionally, you'll have arrows
 103   cancelling your dialogs. so the app must do one of these things to
 104   avoid that:
 105
 106   1. require esc-esc instead of single esc, as that disambiguates it
 107      from the function keys
 108
 109   2. have a certain timeout and accepting the esc as a cancel only if
 110      there wasn't a function sequence after the esc during the timeout
 111
 112   3. switch keyboard to raw or medium-raw mode and do keycode mapping
 113      internally
 114
 115   as 2. is annoying and sluggish (at least to me) and 3. is too much
 116   work for too little gain, i think the current situation with double
 117   esc is the best choice. centerim was using timeout esc in the past (i
 118   think it's the default way ncurses handles esc) and at least i'm happy
 119   with the change :)
 120
 121   perhaps there could be a configurable choice between double-esc and
 122   timeout, if that doesn't complicate the input routines too much.
 123
 124 /* *** */
 125
 126 Q: From: staale@lorentzen.org
 127
 128    > + [icq] connecting to the server
 129    > + [icq] disconnected, turboing
 130
 131    > Msn works fine.
 132
 133    > I've tried different icq-servers, with no luck. Anyone with a
 134    > clue to what this can be?
 135
 136 A: It means exactly "turboing". You're loggin in and out too fast, so
 137    that the server turns on DoS attack protection. All you can do is
 138    to try again in half an hour.
 139
 140 /* *** */
 141
 142 Q: WTF?! My centerim binary is more than 20Mb. SOS! HELP! Virus? Aliens?
 143
 144 A: There are three steps you need to take.
 145
 146     1. Look at other applications written in C++ compiled in your system.
 147     2. Read the install(1) and strip(1) man-pages.
 148     3. Type "strip -s centerim; ls -l centerim"
 149
 150 /* *** */
 151
 152 Q: I need a program for sending messages on IM networks from the command
 153    line. Is it possible to write a program that would use the centerim
 154    libraries, or maybe there is a special batch mode in the program?
 155
 156 A: Batch mode like you described is not possible to be implemented, because
 157    due to frequent logons followed by disconnections the servers will turn
 158    on their DoS attacks protection. So there is the only decent way which
 159    consists in sending messages in batch mode through an already running
 160    centerim instance. If you want to run it like a "daemon", use
 161    screen(1). More details on the batch mode usage can be found in the
 162    README, chapter 9.2.
 163
 164 /* *** */
 165
 166 Q: ICQ new UINs registration doesn't work! It just sends a request and
 167    then after 30 seconds reports a timeout.
 168
 169 A: It does work. Though, the ICQ server doesn't report the "password is
 170    too simple" situaion. Try to enter another one, more complicated. Also,
 171    as far as I know, "xxx123" is complicated enough to be accepted by
 172    the server software.
 173
 174 /* *** */
 175
 176 Q: What about storing passwords in some kind of an encrypted mode in the
 177    config file?
 178
 179 A: It doesn't make much sense, because in many cases they're transferred
 180    unencrypted. And also the program must first decrypt them before sending,
 181    so the one who really wants to find out them anyway will make it quite
 182    easily. But if you still think that such a crypting will help, please
 183    consult homepage of the program which was made especially for ones
 184    like you: http://thekonst.net/en/kripp/
 185
 186 /* *** */
 187
 188 Q: When $HOME/.centerim/config gets created, you should set it mode 0600
 189    so only the user can read it. It contains passwords in clear text
 190    which other users on a system could read.
 191
 192 A: Your filesystem permissions knowledge is very sound, but please just try
 193    to access the config file before making any affirmations. You'll see
 194    that the .centerim directiory permissions do not allow others to read
 195    your configuration data.