FAQ

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