connwrap - initialize gnutls session in cw_connect
[centerim.git] / FAQ
blob1bc761a8c3292c592e77c7d364e2c3acab2a9a1a
1 /*
3 * The CenterIM FAQ (frequently asked questions)
4 * originally by Konstantin Klyagin
5 * currently maintained by the CenterIM community.
6 * read the up-to-date version at http://www.centerim.org/index.php/FAQ
8 */
10 /* *** */
12 Q: What about implementing such a neat <blah-blah> feature in centerim?
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.
18 /* *** */
20 Q: Can't build it under FreeBSD..
22 A: Use gmake instead of make
24 /* *** */
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.
32 A: (by Jakub Travnik, j.travnik@sh.cvut.cz)
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.
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
50 /* *** */
52 Q: How do I authorize someone's request with centerim?
54 A: You'll see as soon as someone requests it.
56 /* *** */
58 Q: I can't use Ctrl-O to view history and Ctrl-Y to delete a line under
59    FreeBSD
61 A: Execute the following before starting centerim:
62     stty dsusp undef
63     stty discard undef
65 /* *** */
67 Q: I can't get out from a dialog or a menu. When I press ESC, nothing
68    happens.
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.
74 /* *** */
76 Q: How do I enable logging the protocol info, etc?
78 A: Run centerim with --debug flag.
80 /* *** */
82 Q: CenterIM compiles way too slow on my box. What's wrong?
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
88 /* *** */
90 Q: From: jeff covey <jeff.covey@pobox.com>
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.
98 A: From: lanzz@lanzz.org
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:
106   1. require esc-esc instead of single esc, as that disambiguates it
107      from the function keys
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
112   3. switch keyboard to raw or medium-raw mode and do keycode mapping
113      internally
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 :)
121   perhaps there could be a configurable choice between double-esc and
122   timeout, if that doesn't complicate the input routines too much.
124 /* *** */
126 Q: From: staale@lorentzen.org
128    > + [icq] connecting to the server
129    > + [icq] disconnected, turboing
131    > Msn works fine.
133    > I've tried different icq-servers, with no luck. Anyone with a
134    > clue to what this can be?
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.
140 /* *** */
142 Q: WTF?! My centerim binary is more than 20Mb. SOS! HELP! Virus? Aliens?
144 A: There are three steps you need to take.
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"
150 /* *** */
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?
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.
164 /* *** */
166 Q: ICQ new UINs registration doesn't work! It just sends a request and
167    then after 30 seconds reports a timeout.
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.
174 /* *** */
176 Q: What about storing passwords in some kind of an encrypted mode in the
177    config file?
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/
186 /* *** */
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.
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.