SILC 0.9.x RPM package Release Notes
Author: Johnny Mnemonic <johnny@themnemonic.org>
These release notes describe the
content and the basic usage of the RPM packages of the SILC project.
These notes are updated as I receive feedback, so please check back for new
information. These notes were last updated 27th March, 2002.
For more information about specific
SILC issues, read the SILC FAQ or
the package-specific release notes:
|
Contents
- What's New
- Client Package
- Server Package
What's New
| [19th Dec 2001] |
This document :-) |
| [21st Jan 2002] |
Updated with new server v0.7.5
logging system information. Fixed also some typos. |
| [27th Feb 2002] |
Updated with client v0.8 upgrade
information and perl support information. |
| [27th Mar 2002] |
Added perl support usage information. |
| [8th Sep 2002] |
Various updates around the server package |
Client Package
The client package contains the basic files for
the SILC client, these are the binary file, the help files, and the documentation files.
Installation
To install the client package type the following command as root:
# rpm -Uvh silc-client-0.8-1.i386.rpm
Note that you need the ncurses libraries to run the client, as its functionality is
based on these shared libraries.
After client installation, you can directly connect to a silc network by typing the
command:
$ silc
The first time you run the client it will require some moments to generate a key pair
that will be placed in your home under the ".silc" directory.
Important #1: Please keep your secret key secure or someone could read your SILC
connections, breaking all the ideals on which the SILC project has been developed.
Important #2: Don't run the client as root! Chat clients will never be secure enough
to do this, so please use it with as an unprivileged user.
Perl scripting support
If you have the perl interpreter installed you can use the perl scripting support for getting your
client to perform automated operations.
Since the perl support is not portable due to a bad path management, it has been included as shared
module. The building host is Red Hat 7.3 with perl 5.6.1 installed, so you will be only able to load
this module if that matches your perl5 installation path.
To load the module you can use the command "/load perl".
For an introduction to perl scripting check the
irssi.org web site. You can
find some examples in the /usr/share/silc/scripts directory.
File list for the client package |
- /etc/silc
C /etc/silc/silc.conf
- /usr/bin/silc
- /usr/lib/silc
- /usr/lib/silc/modules/libfe_perl.so
- /usr/lib/silc/modules/libperl_core.so
- /usr/lib/silc/perl5
- /usr/lib/silc/perl5/Irssi
- /usr/lib/silc/perl5/Irssi.pm
- /usr/lib/silc/perl5/Irssi/TextUI.pm
- /usr/lib/silc/perl5/Irssi/UI.pm
- /usr/lib/silc/perl5/auto
- /usr/lib/silc/perl5/auto/Irssi
- /usr/lib/silc/perl5/auto/Irssi/Irssi.bs
- /usr/lib/silc/perl5/auto/Irssi/Irssi.so
- /usr/lib/silc/perl5/auto/Irssi/TextUI
- /usr/lib/silc/perl5/auto/Irssi/TextUI/TextUI.bs
- /usr/lib/silc/perl5/auto/Irssi/TextUI/TextUI.so
- /usr/lib/silc/perl5/auto/Irssi/UI
- /usr/lib/silc/perl5/auto/Irssi/UI/UI.bs
- /usr/lib/silc/perl5/auto/Irssi/UI/UI.so
D /usr/share/doc/silc-client-0.8.3
D /usr/share/doc/silc-client-0.8.3/CHANGES
D /usr/share/doc/silc-client-0.8.3/COPYING
D /usr/share/doc/silc-client-0.8.3/CREDITS
D /usr/share/doc/silc-client-0.8.3/FAQ
D /usr/share/doc/silc-client-0.8.3/README
D /usr/share/doc/silc-client-0.8.3/TODO
D /usr/share/doc/silc-client-0.8.3/formats.txt
D /usr/share/doc/silc-client-0.8.3/manual.txt
D /usr/share/doc/silc-client-0.8.3/signals.txt
D /usr/share/doc/silc-client-0.8.3/startup-HOWTO.html
- /usr/share/silc
- /usr/share/silc/help
- /usr/share/silc/help/action
- /usr/share/silc/help/admin
- /usr/share/silc/help/alias
- /usr/share/silc/help/away
- /usr/share/silc/help/ban
- /usr/share/silc/help/beep
- /usr/share/silc/help/bind
- /usr/share/silc/help/cat
- /usr/share/silc/help/cd
- /usr/share/silc/help/channel
- /usr/share/silc/help/clear
- /usr/share/silc/help/close
- /usr/share/silc/help/cmode
- /usr/share/silc/help/connect
- /usr/share/silc/help/cumode
- /usr/share/silc/help/cycle
- /usr/share/silc/help/date
- /usr/share/silc/help/dehilight
- /usr/share/silc/help/disconnect
- /usr/share/silc/help/echo
- /usr/share/silc/help/eval
- /usr/share/silc/help/exec
- /usr/share/silc/help/file
- /usr/share/silc/help/format
- /usr/share/silc/help/getkey
- /usr/share/silc/help/help
- /usr/share/silc/help/hilight
- /usr/share/silc/help/ignore
- /usr/share/silc/help/info
- /usr/share/silc/help/invite
- /usr/share/silc/help/invitelist
- /usr/share/silc/help/join
- /usr/share/silc/help/key
- /usr/share/silc/help/kick
- /usr/share/silc/help/kickban
- /usr/share/silc/help/kill
- /usr/share/silc/help/knockout
- /usr/share/silc/help/lastlog
- /usr/share/silc/help/layout
- /usr/share/silc/help/levels
- /usr/share/silc/help/list
- /usr/share/silc/help/load
- /usr/share/silc/help/log
- /usr/share/silc/help/me
- /usr/share/silc/help/motd
- /usr/share/silc/help/msg
- /usr/share/silc/help/names
- /usr/share/silc/help/nick
- /usr/share/silc/help/note
- /usr/share/silc/help/notice
- /usr/share/silc/help/oper
- /usr/share/silc/help/part
- /usr/share/silc/help/perlflush
- /usr/share/silc/help/ping
- /usr/share/silc/help/query
- /usr/share/silc/help/quit
- /usr/share/silc/help/reconnect
- /usr/share/silc/help/reload
- /usr/share/silc/help/rmreconns
- /usr/share/silc/help/rmrejoins
- /usr/share/silc/help/save
- /usr/share/silc/help/sconnect
- /usr/share/silc/help/script
- /usr/share/silc/help/scrollback
- /usr/share/silc/help/server
- /usr/share/silc/help/set
- /usr/share/silc/help/shutdown
- /usr/share/silc/help/silcoper
- /usr/share/silc/help/statusbar
- /usr/share/silc/help/toggle
- /usr/share/silc/help/topic
- /usr/share/silc/help/umode
- /usr/share/silc/help/unalias
- /usr/share/silc/help/unignore
- /usr/share/silc/help/unload
- /usr/share/silc/help/unquery
- /usr/share/silc/help/upgrade
- /usr/share/silc/help/users
- /usr/share/silc/help/version
- /usr/share/silc/help/whois
- /usr/share/silc/help/whowas
- /usr/share/silc/help/window
- /usr/share/silc/scripts
- /usr/share/silc/scripts/autoop.pl
- /usr/share/silc/scripts/beep.pl
- /usr/share/silc/scripts/clones.pl
- /usr/share/silc/scripts/dns.pl
- /usr/share/silc/scripts/hello.pl
- /usr/share/silc/scripts/mail-maildir.pl
- /usr/share/silc/scripts/mail.pl
- /usr/share/silc/themes
C /usr/share/silc/themes/default.theme
* The version 0.8.3 is only chosen as an example
|
|
Server Package
The server package contains the SILC server
binary, the configuration file, and the RedHat init script to start the server at boot
time.
Installation
To install the server package type the following command as root:
# rpm -Uvh silc-server-0.7.5-1.i386.rpm
Starting the server
After installation, you can immediately start your server with the command:
# service silcd start
Starting silcd: [ OK ]
..or..
# /etc/rc.d/init.d/silcd start
Starting silcd: [ OK ]
If you get a failure message or an error message please mail
me with the needed information so I can update this document with the most common troubles.
Anyways, you should configure your new SILC server first. You can do this by simply editing
the file /etc/silc/silcd.conf with your favorite text editor. Please refer to the SILC
documentation if you have troubles changing the default values.
One note about the log files
With the server package 0.7.5 a new logging system was introduced. All the logging files are now
collocated in the /var/log/silc dedicated subdirectory. The logs are automatically rotated daily
on the base of the logrotate configuration file /etc/logrotate.d/silcd.
Feel free to change default logging settings, but remember that if you choose a non-writable
directory, silcd won't be able to rotate files over maximum size.
Also note that the /var/log directory must have +x permission for logging to work properly.
Configuring boot-time server
The package self-configures during the installation in the boot-time init scripts, but it is
disabled by default. To enable it you just need to type:
# chkconfig silcd on
You must type this command as root, and it gives no output.
If you want to check the boot-time status you can use the command:
# chkconfig --list silcd
silcd 0:off 1:off 2:off 3:off 4:off 5:off 6:off
These flags show if, for each of the six known runlevels, the silcd either started or not. Note
that the only interesting runlevels are 3 4 and 5, and are those which are turned on by
default when you use the command above, so leave the others unchanged.
File list for the server package |
C /etc/logrotate.d/silcd
C /etc/rc.d/init.d/silcd
C /etc/silc/silcalgs.conf
C /etc/silc/silcd.conf
- /usr/sbin/silcd
D /usr/share/doc/silc-server-0.9.4
D /usr/share/doc/silc-server-0.9.4/CHANGES
D /usr/share/doc/silc-server-0.9.4/COPYING
D /usr/share/doc/silc-server-0.9.4/CREDITS
D /usr/share/doc/silc-server-0.9.4/FAQ
D /usr/share/doc/silc-server-0.9.4/README
D /usr/share/doc/silc-server-0.9.4/TODO
D /usr/share/doc/silc-server-0.9.4/draft-riikonen-presence-attrs-00.txt
D /usr/share/doc/silc-server-0.9.4/draft-riikonen-silc-commands-03.txt
D /usr/share/doc/silc-server-0.9.4/draft-riikonen-silc-flags-payloads-00.txt
D /usr/share/doc/silc-server-0.9.4/draft-riikonen-silc-ke-auth-05.txt
D /usr/share/doc/silc-server-0.9.4/draft-riikonen-silc-pp-05.txt
D /usr/share/doc/silc-server-0.9.4/draft-riikonen-silc-spec-05.txt
D /usr/share/doc/silc-server-0.9.4/example_silcd.conf
D /usr/share/doc/silc-server-0.9.4/examples
D /usr/share/doc/silc-server-0.9.4/examples/README
D /usr/share/doc/silc-server-0.9.4/examples/cell1_backup.conf
D /usr/share/doc/silc-server-0.9.4/examples/cell1_router.conf
D /usr/share/doc/silc-server-0.9.4/examples/cell1_server1.conf
D /usr/share/doc/silc-server-0.9.4/examples/cell1_server2.conf
D /usr/share/doc/silc-server-0.9.4/examples/cell2_router.conf
D /usr/share/doc/silc-server-0.9.4/examples/cell2_server1.conf
D /usr/share/doc/silc-server-0.9.4/examples/cell2_server2.conf
D /usr/share/doc/silc-server-0.9.4/examples/cell3_router.conf
D /usr/share/doc/silc-server-0.9.4/examples/cell3_server1.conf
D /usr/share/doc/silc-server-0.9.4/examples/cell3_server2.conf
D /usr/share/doc/silc-server-0.9.4/examples/cell_router.conf
D /usr/share/doc/silc-server-0.9.4/examples/silcd.prv
D /usr/share/doc/silc-server-0.9.4/examples/silcd.pub
- /var/log/silc
* The version 0.9.4 was only chosen as an example
|
|