Home Download News FAQ / Knowledge Base Screenshots Documentation Support Site map
philosophical imaginary
Table of Contents


Note: you should perform these operations while logged in with root privileges. You may become root with the commands su - or sudo su -.


shows you how your ethernet interfaces are configured. Most often eth0 will be the primary device.

root@yourserver:/# ifconfig eth0
eth0      Link encap:Ethernet  HWaddr 00:0B:99:99:00:00 
          inet addr:  Bcast:  Mask:
          inet6 addr: fe80::290:4bff:9999:0000 /64 Scope:Link
          RX packets:1633075 errors:0 dropped:0 overruns:0 frame:0
          TX packets:2512154 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1000 
          RX bytes:690787053 (658.7 MiB)  TX bytes:221517909 (211.2 MiB)
          Interrupt:5 Memory:faff6000-faff8000 

If the line inet6 addr: fe80::290:4bff:9999:0000 /64 Scope:Link is missing, your system does not have ipv6 support. You may need to explicitely make webcit bind ipv4 then by specifying -i


shows the paths to other networks, most notably the default gateway (which for IPv4 is

root@yourserver/# route -n
Kernel IP routing table
Destination     Gateway         Genmask         Flags Metric Ref    Use Iface   U     0      0        0 eth0         UG    0      0        0 eth0


shows you which ports are open, and which processes listen on them (if you are root). It also shows the address of the other end of each open connection.

root@yourserver:/# netstat -lnp
Active Internet connections (only servers)
Proto Recv-Q Send-Q Local Address           Foreign Address         State       PID/Program name   
tcp        0      0   *               LISTEN     16825/citserver     
tcp        0      0   *               LISTEN     16825/citserver     
tcp        0      0  *               LISTEN     16825/citserver     
tcp        0      0   *               LISTEN     16825/citserver     
tcp        0      0   *               LISTEN     16825/citserver   
tcp        0      0   *               LISTEN     16825/citserver     
tcp        0      0   *               LISTEN     16825/citserver     
tcp        0      0   *               LISTEN     16825/citserver     
tcp        0      0    *               LISTEN     27329/webcit     
tcp        0      0    *               LISTEN     16825/citserver     
Active UNIX domain sockets (only servers)
Proto RefCnt Flags       Type       State         I-Node PID/Program name    Path
unix  2      [ ACC ]     STREAM     LISTENING     1569009  16825/citserver     /var/run/citadel/citadel.socket
unix  2      [ ACC ]     STREAM     LISTENING     1569016  16825/citserver     /var/run/citadel/lmtp.socket
unix  2      [ ACC ]     STREAM     LISTENING     1569019  16825/citserver     /var/run/citadel/lmtp-unfiltered.socket

If you prefer to see the names of the services than their port numbers you can omit the -n

If you have chosen to let your citserver bind a secific IP, the whole thing will look a little different. Lets say, your machine has the ips and, and you want citadel just to answer queries on since other services are already answering on the above listed ports on the lines will look like that:

tcp        0      0   *               LISTEN     16825/citserver     

so this not just removes the bind to, but also implicitely

tcp        0      0   *               LISTEN     16825/citserver     

won't be accessible; If you run Webcit with an IP connection (and not the unix domain socket “citadel.socket”), you need to point it to port 504; port 504 won't be accessible, and you will be pointed to the What's wrong when I get the message: Connection refused: can't connect to


Telnet is an unencrypted remote terminal tool. But we can also abuse it to check whether citadel is able to do its job:

We have illustrated the conversation with - > and < - to show what you type, and what the mail server (in this case a Citadel) sends back.

root@yourserver:/# telnet 25
Connected to
Escape character is '^]'.
->220 yourserver ESMTP Citadel server ready.
<-ehlo localhost
->250 Hello localhost (localhost [])
->250-SIZE 10485760
<-MAIL FROM: test@test.org
->250 2.0.0 Sender ok
->221 Goodbye...
Connection closed by foreign host.

You could make Citadel receive or send out an email this way. Furthermore, you have now confirmed that you are talking with the Citadel SMTP service, not with another email program left over from a previous or default installation.
The reply to the EHLO command also shows you which kind of authentication the host supports (another sample would be CRAMD-MD5). Citadel itself just supports “plain” auth, in receiving and sending direction. This is almost plaintext, so you should wrap a TLS session around it.
If you don't see

220 yourserver ESMTP Citadel server ready.

but something like Postfix, Exim, QMail you are not talking to your Citadel server.


Note: depending on your system netcat may either be named nc or netcat; we'll name it nc in the examples.
Netcat was designed for the purpose for which we misused telnet earlier. If you want for example to post a message using an automated script, telnet would add special control characters, which will spoil your effort. You need to use netcat in this case. But netcat can do even more: It can open server sockets (like citserver does) or speak UDP.

Netcat as Server

The problem we want to use netcat for in this example is the following: You want to know which headers your browser sends to webcit. For that we need netcat to open a server socket, our browser will talk to:

nc -l -p 8888

Now point your browser to (or the ip the box has your netcat is running) and see what netcat says:

GET / HTTP/1.1
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv: Gecko/20061205 Iceweasel/ (Debian-
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Accept-Language: de-de,en-us;q=0.5
Accept-Encoding: gzip,deflate
Accept-Charset: ISO-IR-111,utf-8;q=0.7,*;q=0.7
Keep-Alive: 300
Connection: keep-alive

now you can press control c to terminate your netcat, or type into it and say some nice things to your browser.

Netcat as Client

Here we want to use netcat to talk to your citserver in citadels native tongue; this is usualy done through TCP Port 504 (see your output of netcat above); (we'll add » and « for whats Citserver telling you, and what we tell him; You'll get similar output if you configure and compile webcit with CFLAGS += -D SERV_TRACE)

# nc 504
>> 200 poza Citadel server ready.
<< ECHO test
>> 200 test
>> 200 Goodbye.

Now if you want to do this from within a shellscript, you'll get the problem that NetCat will close the connection to the server when its input channel is closed; ence we need to make it waiting; we'll use '()' (which invokes a sub-shell) for that:

printf "ECHO test\nQUIT\n"
sleep 10
) | nc 504

Hostname lookup

To resolve IP addresses from names like google.com, your computer needs nameservers; the file /etc/hosts shows your programs where to find it. Verify that thie file exists, and that the IP address inside is reachable with ping.
Next you can use the nslookup or host utility to check if it's working:

->host google.com
<-google.com has address

(and some more…) Or to find out who is the mail exchanger there:

host -t mx google.com
google.com mail is handled by 10 smtp2.google.com.
google.com mail is handled by 10 smtp1.google.com.
google.com mail is handled by 10 smtp3.google.com.
google.com mail is handled by 10 smtp4.google.com.
Copyright © 1987-2014 Uncensored Communications Group. All rights reserved.     Login (site admin)