Skip to content

Latest commit

 

History

History
129 lines (94 loc) · 3.07 KB

README.md

File metadata and controls

129 lines (94 loc) · 3.07 KB
Raw

sj

Simple jabber client based on ideas from "Irc It".

Official website: https://klemkow.net/sj.html

Paper of the slcon2: https://klemkow.net/sj.pdf

Goals

The XMPP protocol is a monster and totally overengineered. But you have to deal with it because of its widespread use and good features. To beat this monster, this project tries to divide it into smaller parts and to create one program to handle one aspect of XMPP.

The program "sj" just does a few things:

  • opens a connection to an XMPP server
  • do authentication (+binding +session registration)
  • perfoms keep-alive pings to the server
  • segmenting tags and routing them to other daemons:
    • presenced
    • messaged
    • iqd

requires

usage

# set base directory
export SJ_DIR=/home/user/.xmpp

# start daemon
tcpclient server.org 5222 sj -u user -s server.org -r sj &
password:

# set presence to 'online'
presence

# add a contact to your roster
roster -a [email protected] -n joe

# subscribe his online status
presence -t [email protected] subscribe

# let him see your online status
presence -t [email protected] subscribed

# view buddies on your roster
roster
[email protected]                both    joe

TODO

  • replace socket-handling with UCSPI

  • add SSL support

  • designing interface for backend programs

  • replace linked list with one of queue.h

  • write front end tools

    • web front end for mobile chatting

  • write manpages for all tools

  • messaged

    • (de)escape messaged xml save
    • detect filesystem changes

  • create of accounts in-band

  • change passwords

  • integrations into a service management solution like svc of djb

  • XEP-0077: In-Band Registration

  • XEP-0030: Service Discovery

  • XEP-0012: Last Activity

  • XEP-0202: Entity Time

tested with

  • OpenBSD
    • gcc 4.2.1
    • gcc 4.8.2
    • clang 3.5
  • MacOSX
  • GNU/Linux
    • gcc (Debian 4.7.2-5)
    • clang (Debian 3.0-6.2)

build

git clone https://github.com/younix/sj.git
cd sj
git submodule init
git submodule update
make

plugins

You should be able to write plugins for this client in any language of your choice. The interface are just plain text files.

front ends

See sj tools for some front ends.

known issues

POSIXLY_CORRECT for GNU getopt()

The following command will produce error "tlsc: invalid option" on systems with GNU getopt()

tcpclient server.org 5222 sj -u user -s server.org -r sj

unless you set the environment variable POSIXLY_CORRECT. See the issue for tlsc for more details. You can also get around this problem by using sj environment variables (e.g. SJ_USER) instead of command line options.

TLSC_NO_VERIFICATION

Currently, you need to set the environment variable export TLSC_NO_VERIFICATION=1 in order to avoid "tlsc: tls_error: ssl verify setup failure".