README

GENERAL
=======

Telepathy-Ring is a Telepathy connection manager for GSM and similar mobile
telephony.

Telepathy-Ring is named after Douglas H. Ring, one of the inventors of
cellular mobile phone system.

Currently, Telephathy-Ring implements Connection Manager and Connection
functionality, StreamedMedia channels for voice calls and Text channels for
SMS messaging.


ENVIRONMENT VARIABLES AND DEBUGGING
===================================

The following environment variables are used:

- RING_PERSIST - if set, keep running even if no connection is active
- RING_REALTIME - if set, try to use realtime priority
- RING_MEMLOCK - if set, use mmlockall()
- RING_LOGFILE - redirect debugging output (stdout/stderr) to named file
- RING_DEBUG - if set, determine what kind of debugging output to print
  - all - everything
  - connection - connection-related
  - media - call and media-related
  - text - SMS-related
- MODEM_DEBUG - determine what kind of debugging output to print from modem libraries
  - all - print everything
  - call - print call-related messages
  - sms  - print sms-related messages
  - sim  - print sim-related messages
  - dbus - print dbus-related messages
- SMS_DEBUG - determine what kind of debugging output to print from sms-glib
  - all - print everything
  - submit - encoding SMS-SUBMIT
  - deliver - decoding SMS-DELIVER
  - status-report - decoding and handling SMS-STATUS-REPORT


REQUIRED LIBRARIES
==================

Telepathy-Ring is based on telepathy-glib (0.11.11 or newer)


RUNNING WITH ELEVATED PRIORITY
==============================

Telepathy-Ring can be launched with RING_REALTIME and RING_MEMLOCK
environment variables set. If they are not set, the priorities are read from
/var/lib/telepathy-ring/realtime and /var/lib/telepathy-ring/memlock
instead.