File: README

package info (click to toggle)
licq 0.76-2.1
  • links: PTS
  • area: main
  • in suites: potato
  • size: 5,648 kB
  • ctags: 3,872
  • sloc: cpp: 28,405; sh: 9,804; ansic: 4,287; perl: 1,597; makefile: 316
file content (114 lines) | stat: -rw-r--r-- 3,922 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
LICQ v0.76

An ICQ clone written in C and C++ using a plugin system to allow for
many possible interfaces.  
See the webpage (http://www.licq.org) for more information.
Licq implements messages (online and offline), urls, chat, full file
transfer, gui configuration (with the qt-gui plugin), history as 
well as a number of other features.


LICENSE

This program is licensed under the terms of the GNU GPL, a copy
of which you should have received with this package.


INSTALLATION:

(If you have a binary distribution then see the FAQ for how to
 do a manual install.  Don't worry it's very easy, any monkey
 could do it.)

As root:
1. Type './configure' and it will determine all the right settings and 
   directories for your system. 
2. Type 'make' and in theory it will build. If you are using a non-GNU system,
   such as FreeBSD or Solaris, you will need the GNU version of make, often
   installed as `gmake'.  If you get errors about "void *" see the FAQ.
3. Type 'make install' and licq will be installed (defaults to 
   /usr/local).
4. Go to plugins/qt-gui and follow the directions there (doc/README) to install
   the Qt interface plugin (necessary).

As each user:
5. When you run licq for the first time it will install all the necessary
   files in ~/.licq.
6. You can import users from a number of other clients into Licq using
   one of the conversion scripts found on the download section of the web
   page or in the licq-data package.


SOCKS5 Proxy Support:
Licq supports SOCKS5 proxies.  To enable this support, run configure with
--enable-socks5, and optionally --with-socks5-inc=PATH and 
--with-socks5-lib=PATH.  Then just make sure all the right environment
variables are set and it should work.  Also read the SOCKS.HOWTO file.

Licq requires the following:
Some C++ compiler with proper standard c++ headers.

Licq has been compiled and run successfully on the following systems at one 
point (note current versions may no longer compile without a bit of tweaking):
Linux/x86
Linux/Alpha
Linux/PPC
FreeBSD/i386
AIX/RS6000
NetBSD/mk68000
Sun3/mk68000
Solaris/x86
Unixware
Solaris/sparc

CONFIGURATION:

Configuration is done through the ~/.licq/licq.conf file, which contains .ini 
style options.  Help on each option is include in the file.  The contact 
list is stored in conf/users.conf.  Each users info is stored as a simple 
text file called {user uin}.uin.  Again, the options are pretty obvious.  
You can add/remove/edit a user inside the gui, or by editing the conf files.  

The History file is the file where the user history is stored...you can 
specify a filename for each user, or you can put one of the following 
keywords:
none : no history file
default : makes the history file history/<uin>.history


USE:

Type licq -h for commandline help.

Using licq is fairly straight-forward.  Licq itself is merely a daemon
designed to run various plugin interfaces.  I have written an advanted
gui in qt (qt-gui) which should be used as the default plugin.  Once you
have compiled and installed Licq, unpack the plugins you wish to use into
the plugins/ directory, compile them, and then install them into 
/usr/local/share/licq/plugins (replace /usr/local with the prefix given
to configure if necessary).  Then start licq with the -p option:
$ licq -p qt-gui -- ...any options to the plugin...

Note the -- which tells the system to pass any options after that on to the
first plugin in the list.  Multiple plugins can be chained in this way:
$ licq -p qt-gui -p email-forward -- <qt-gui options> -- <email-forward options>


PROBLEMS:

See the BUGS file for reports on known bugs and problems.


TROUBLE-SHOOTING:

1. RUNNING
o  Segfault at startup.  If this occurs, run licq with the -d 15 switch and tell
   me how far it gets before segfaulting and I'll try and help.

Good luck.


CONTACTS:

Send any questions, comments, or other complaints to graham@licq.org,
uin 2127503