The Serval Project's core daemon that implements Distributed Numbering Architecture (DNA), MDP, VoMP, Rhizome, MeshMS, etc.
Go to file
gardners 424046ccd1 fix bundle secret extraction when loading ssender protected meshms bundles.
fix meshms ack test to not depend on deprecated debug output of meshms
command line operations.
2013-05-15 10:46:25 +09:30
asterisk_include Added support for batmand.peers file for reliable peer querying. 2011-03-21 13:08:35 +10:30
Debian/etc Improve Debian init.d script and default file 2013-01-24 13:24:11 +10:30
doc Improve config documentation 2013-04-16 12:44:47 +09:30
java/org/servalproject/servald Fix JNI argv parsing: throw exception on NULL 2013-02-15 19:33:12 +10:30
m4 Artefacts created by libtoolize -c -i 2012-09-12 15:21:50 +09:30
nacl cleaned up NaCl build to just compile using make. 2012-10-18 17:26:52 +10:30
openwrt/packages/serval-dna Updated build files for openwrt (now all live in openwrt/). 2012-10-29 07:38:16 +10:30
sqlite-amalgamation-3070900 Reduce use of stderr in many places 2012-08-01 17:54:02 +09:30
tests fix bundle secret extraction when loading ssender protected meshms bundles. 2013-05-15 10:46:25 +09:30
utilities Fix Markdown formatting 2013-02-22 00:05:34 -08:00
win32 Allow clients to request variables for all records by passing empty did. 2011-04-27 12:17:26 +09:30
.dir-locals.el Add file to set emacs variables to match the prevailing style. 2012-07-29 13:52:46 +09:30
.gitignore Improve test framework: create_file() 2012-10-31 18:13:33 +10:30
aclocal.m4 Merge branch 'master' of github.com:servalproject/serval-dna 2012-04-23 20:41:52 +09:30
Android.mk Fix broken Android build 2013-03-18 15:35:37 +10:30
androidonlysources.mk refactored Makefile.in and Anrdoid.mk so that source file lists are 2012-10-25 04:30:14 +10:30
asterisk_app.c Expunge old DNA protocol code (cleans up warnings) 2012-06-25 15:37:11 +09:30
audio_alsa.c work on bypass-audio. 2012-05-11 08:14:00 +09:30
audio_msm_g1.c Fix rhizome transfers 2012-06-27 16:54:42 +09:30
audio_reflector.c work on bypass-audio. 2012-05-11 08:14:00 +09:30
audiodevices.c Try detecting ALSA better. 2012-09-06 12:43:06 +09:30
check-in-out-return.c fix false positive bug. 2013-05-14 15:34:43 +09:30
cli.c Add "keyring dump" command 2013-04-30 17:29:06 +09:30
cli.h Add "keyring dump" command 2013-04-30 17:29:06 +09:30
commandline.c add "meshms list conversations" command. 2013-05-10 20:30:25 +09:30
conf_om.c Improve "config dump" command 2013-02-28 15:18:48 +10:30
conf_parse.c Silence clang warnings 2013-04-11 13:46:09 +09:30
conf_schema.c all meshms tests now pass, including new encrpytion mode auto selection 2013-05-10 15:42:32 +09:30
conf_schema.h Report packet acks, make routing decisions based on dropped packets 2013-05-08 11:37:02 +09:30
conf.c Improve configuration dump to log 2013-03-29 00:22:08 +10:30
conf.h Improve config schema macros and log options 2013-04-05 15:00:54 +10:30
config_test.c Improve new config code, SORTED and NO_DUPLICATE flags 2012-11-30 12:32:30 +10:30
config.guess Artefacts created by libtoolize -c -i 2012-09-12 15:21:50 +09:30
config.sub Artefacts created by libtoolize -c -i 2012-09-12 15:21:50 +09:30
configure.in Fix bcopy()/bzero() #define hack 2013-02-25 15:23:03 +10:30
constants.h Add link state monitor commands 2013-05-02 16:19:59 +09:30
crc32.c Use correct variable size for crc's 2013-02-20 15:36:26 +10:30
crypto.c refactor out code that calculates public key from a crypto sign public 2013-05-14 11:55:32 +09:30
crypto.h Extract crypto signing primitives from mdp processing 2012-10-19 14:54:41 +10:30
dataformats.c Replace "add did" command with improved "keyring add did" 2013-02-14 16:06:01 +10:30
directory_client.c Use any packet as a self-announce 2012-12-16 10:09:29 +10:30
directory_service.c Add 'sid:' field to output of "reverse lookup" 2013-02-15 19:34:24 +10:30
dna_helper.c Log to file, Android and stderr simultaneously 2013-03-27 16:17:38 +10:30
encode.c Put back a pile of files needed for building on osx, and also required 2012-03-15 10:57:38 +10:30
fakeradio.c Fix fake radio 2013-02-20 15:36:26 +10:30
fdqueue.c detect when USB serial adapters have been pulled on OSX 2013-04-26 16:51:31 +09:30
fifo.c Add PA setup and FIFO code (still not plumbed into the main program) 2012-04-23 16:32:47 +09:30
fifo.h Add PA setup and FIFO code (still not plumbed into the main program) 2012-04-23 16:32:47 +09:30
headerfiles.mk Add new rotbuf primitives 2013-04-29 14:30:44 +09:30
install-sh Artefacts created by libtoolize -c -i 2012-09-12 15:21:50 +09:30
INSTALL.md Fix quoting typos 2013-03-05 17:19:23 -08:00
instance.c Improve form_serval_instance_path() error message 2013-04-04 17:46:09 +10:30
jni.c Imported ref10/ implementation of crypto_sign from supercop-20120525 2012-10-18 17:26:48 +10:30
keyring.c Add "keyring dump" command 2013-04-30 17:29:06 +09:30
log.c Fix bugs in log file rotation 2013-04-11 17:54:18 +09:30
log.h Improve logging: add HINT level, NOWHENCE() macro 2013-04-09 17:23:19 +09:30
lsif.c Fix warnings from gcc 4.6.3 2013-03-18 16:48:15 +10:30
ltmain.sh Artefacts created by libtoolize -c -i 2012-09-12 15:21:50 +09:30
macconfig Fixed broadcast address discovery to work on Mac. 2011-08-08 16:11:05 +09:30
main.c Integrate new config into servald 2012-12-04 14:12:28 +10:30
Makefile.dbg Move debug options to Makefile.dbg so we don't have to re-run configure. 2012-07-29 14:55:10 +09:30
Makefile.in Add new rotbuf primitives 2013-04-29 14:30:44 +09:30
mdp_client.c Replace old routing engine with new link state engine 2013-05-02 14:29:28 +09:30
mdp_client.h Add interface name to route print output 2013-02-20 16:18:58 +10:30
mem.c Add erealloc() function to mem.h, mem.c 2013-04-30 17:26:27 +09:30
mem.h Add erealloc() function to mem.h, mem.c 2013-04-30 17:26:27 +09:30
meshms.c fix bundle secret extraction when loading ssender protected meshms bundles. 2013-05-15 10:46:25 +09:30
meshpotato_build Assorted unknown changes. Updated Makefile.in etc to properly build serval.c for building asterisk module. 2011-06-15 13:52:30 +09:30
monitor-cli.c Fix warnings from gcc 4.6.3 2013-03-18 16:48:15 +10:30
monitor-client.c Integrate new config into servald 2012-12-04 14:12:28 +10:30
monitor-client.h Reuse command line parsing framework with monitor interface 2012-09-25 13:31:34 +09:30
monitor.c Announce all links on connection to monitor interface 2013-05-08 13:42:11 +09:30
mpbuild Added mesh potato build script. 2011-08-10 15:39:40 +02:00
net.c New hton_in_addr() function 2013-02-05 16:56:37 +10:30
net.h New hton_in_addr() function 2013-02-05 16:56:37 +10:30
nonce.c fix building on android. 2013-05-07 15:09:22 +09:30
os.c take sleep() out of urandomdev(), since it just causes problems, and 2013-05-07 14:42:47 +09:30
os.h Add emkdirs() and emkdirsn() 2013-04-04 17:37:49 +10:30
overlay_address.c Add basic link state routing 2013-04-26 16:54:01 +09:30
overlay_address.h Replace old routing engine with new link state engine 2013-05-02 14:29:28 +09:30
overlay_buffer.c Add length of link record for forward compatibility 2013-04-29 10:06:22 +09:30
overlay_buffer.h Add length of link record for forward compatibility 2013-04-29 10:06:22 +09:30
overlay_interface.c Report packet acks, make routing decisions based on dropped packets 2013-05-08 11:37:02 +09:30
overlay_link.c Allow for out of order packets, reduce link state spam 2013-05-08 11:37:31 +09:30
overlay_mdp_services.c Add basic link state routing 2013-04-26 16:54:01 +09:30
overlay_mdp.c use generate_nonce() to generate a nonce, instead of reading from 2013-05-07 14:43:35 +09:30
overlay_olsr.c Use any packet as a self-announce 2012-12-16 10:09:29 +10:30
overlay_packet.h Add interface and sequence flags to packet format 2012-12-14 17:07:27 +10:30
overlay_packetformats.c Send sequence number on all broadcast frames 2013-05-03 16:23:23 +09:30
overlay_packetradio.c removed extraneous argument to tcgetattr() 2013-05-08 13:32:24 +09:30
overlay_payload.c Send sequence number on all broadcast frames 2013-05-03 16:23:23 +09:30
overlay_queue.c Allow for out of order packets, reduce link state spam 2013-05-08 11:37:31 +09:30
overlay.c Replace old routing engine with new link state engine 2013-05-02 14:29:28 +09:30
pa_phone.c Refactor: rename some cli.h structs 2013-02-13 17:43:24 +10:30
packetformats.c Overhaul debug flags 2012-12-11 15:59:46 +10:30
performance_timing.c Don't ask for manifests if we don't have room in transfer queues 2013-04-11 15:24:41 +09:30
randombytes.c Added missing GPL license declaration to file. 2012-02-17 00:42:37 +10:30
README.md Fix README.md -- Markdown typo 2012-10-28 23:18:12 -07:00
rhizome_bundle.c fix bundle secret extraction when loading ssender protected meshms bundles. 2013-05-15 10:46:25 +09:30
rhizome_crypto.c fix various bugs preventing obfuscated sender / conversation list 2013-05-14 22:56:19 +09:30
rhizome_database.c fix various bugs preventing obfuscated sender / conversation list 2013-05-14 22:56:19 +09:30
rhizome_direct_http.c Merge in recent work on meshms in servald by Alexandra and myself. 2013-05-10 12:22:16 +09:30
rhizome_direct.c Remove useless debug message 2013-02-20 16:18:59 +10:30
rhizome_fetch.c Don't ask for manifests if we don't have room in transfer queues 2013-04-11 15:24:41 +09:30
rhizome_http.c add time stamp to rssi.csv 2013-05-07 13:40:38 +09:30
rhizome_packetformats.c Add config option to disable fetching via rhizome 2013-03-05 10:56:20 +10:30
rhizome_store.c fixed failing tests/rhizomeops test 38 2013-05-10 12:30:49 +09:30
rhizome.c leave date field in conversation list bundles for now. 2013-05-14 21:47:36 +09:30
rhizome.h further work on conversation list bundle. 2013-05-14 21:41:26 +09:30
rotbuf.c Add new rotbuf primitives 2013-04-29 14:30:44 +09:30
rotbuf.h Fix rotbuf_advance(), add rotbuf_remain() 2013-04-30 17:28:32 +09:30
route_link.c Announce all links on connection to monitor interface 2013-05-08 13:42:11 +09:30
serialization_meshms.c fixed bug where ack blocks were written as message blocks 2013-05-09 22:36:04 +09:30
serval_packetvisualise.c Changed rhizome manifest signature block type code semantics to 2012-10-29 16:07:42 +10:30
serval.h refactor out code that calculates public key from a crypto sign public 2013-05-14 11:55:32 +09:30
servalwrap.c Extra tests for failures 2013-05-03 16:21:30 +09:30
server.c Improve configuration dump to log 2013-03-29 00:22:08 +10:30
sha2.c Initial stab at porting to Solaris. 2012-09-05 20:42:50 +09:30
sha2.h Substantial preparatory work towards Rhizome/MeshMS store-and-forward 2011-12-13 19:34:12 +10:30
sighandlers.c more work on dna helper interface. 2012-06-21 16:35:28 +09:30
slip.c fix unforgivable typo that broke compilation. 2013-05-08 11:03:30 +09:30
socket.c Refactor out socket name setting code into one place. 2012-07-29 22:20:54 +09:30
socket.h Refactor out socket name setting code into one place. 2012-07-29 22:20:54 +09:30
sourcefiles.mk Merge in recent work on meshms in servald by Alexandra and myself. 2013-05-10 12:22:16 +09:30
srandomdev.c Fix warnings from gcc 4.6.3 2013-03-18 16:48:15 +10:30
str.c Improve timeout control in routing tests 2013-04-22 16:01:38 +09:30
str.h Add alloca_str_toprint_quoted() macro to str.h 2013-04-30 17:27:10 +09:30
strbuf_helpers.c Add strbuf_append_strftime() 2013-04-04 17:40:58 +10:30
strbuf_helpers.h Add strbuf_append_strftime() 2013-04-04 17:40:58 +10:30
strbuf.c Fix bug in strbuf_puts(), not always appending nul 2013-02-20 14:28:06 +10:30
strbuf.h Add strbuf_remaining() 2013-04-04 17:41:18 +10:30
strlcpy.c Fix issues arising from new strlcpy.c 2012-08-14 11:23:27 +09:30
strlcpy.h Fix build when strlcpy is present 2013-01-11 14:43:37 +10:30
testconfig.sh.in Trival test of dna JNI command line entry point 2012-04-23 18:25:26 +09:30
testdefs_rhizome.sh Add 'rhizome delete' and 'rhizome clean' commands 2013-02-20 15:37:09 +10:30
testdefs.sh Refactor interface handling to separate encapsulation from stream type 2013-02-20 15:36:23 +10:30
testframework.sh Improve test framework: set TFWSOURCE env var 2013-04-29 15:10:16 +09:30
testnacl.c Added test code for NaCl. 2011-10-25 13:39:14 +10:30
tfw_createfile.c Improve str.h and str.c 2012-11-22 18:15:40 +10:30
version_servald.c Servald version string from git describe 2013-03-12 14:03:33 +10:30
version_string.sh fixed version_string.sh to work (or at least not fail) with git 2013-04-26 15:27:53 +09:30
vomp_console.c Improve command-line parsing (issue ) 2013-04-09 17:23:20 +09:30
vomp.c created tool for automatically finding IN()s without matching 2013-02-20 16:18:56 +10:30
xprintf.c Add XPRINT strbuf adapter 2013-03-25 12:02:48 +10:30
xprintf.h Add XPRINT strbuf adapter 2013-03-25 12:02:48 +10:30

Serval DNA

This repository contains the source code for the “core” Serval components implemented in GNU C:

  • The Distributed Numbering Architecture (DNA) is the key innovation that makes mesh telephony viable in the absence of any infrastructure, eg, in the aftermath of a natural disaster or in remote locations. It is a protocol carried over MDP (see below) that allows any device to ask its neighboring devices for a phone number (DID). Such a request will propagate through the mesh, and any device may respond with the identity (SID) of a subscriber who has “claimed” that DID.

  • The Serval Keyring is a flat file containing all the user identities on a single device. Each identity is a set of elliptic curve secret cryptographic keys that belong to a single “mesh subscriber”, indexed by the subscriber's 256-bit public key, called a SID. Each identity in the keyring is locked by its own user-chosen password (called a PIN in the code and documentation), using elliptic curve cryptography to protect locked entries from theft or tampering, and steganography to allow the user to plausibly deny the existence of any locked identity.

  • The Mesh Datagram Protocol (MDP) is Serval's own layer 3 protocol designed for secure mesh networking. It is completely independent of Internet protocols such as IP and UDP, but for the time being is implemented as an “overlay” network based on UDP/IP because that is the interface that Linux and other operating systems provide for sending data over WiFi. However, MDP could easily be implemented directly over a layer 2 data link such as WiFi or Ethernet MAC. MDP uses subscribers' public keys (SID) as source and destination addresses, and has a 32-bit port number analogous to the 16-bit port number used in TCP/IP.

  • The Rhizome content distribution service is a storage engine implemented using SQLite and a content-exchange protocol based on MDP and HTTP for the pervasive dissemination of content like images, videos, documents, software upgrades, etc. Each piece of content in Rhizome is called a “bundle”, which has two parts: a manifest that describes the content, and the payload, which is the content itself. Each bundle has its own unique cryptographic identifier that allows any recipient to verify that it has not been tampered with.

  • The MeshMS messaging service is implemented using Rhizome as its transport, with each thread represented as a pair of bundles, one for each direction. At present, the MeshMS logic is implemented in Java within the Serval Mesh Android app, but is planned to be re-implemented in C as part of Serval DNA (see issue #28).

  • Serval Infrastructure services may optionally be deployed on any devices in the mesh to expose external services to mesh subscribers and vice versa (eg, VoIP gateways, SMS satellite links, packetised web), and to overcome scalability limitations of a perfectly decentralised mesh (eg, central telephone directory).

Most of these services are performed by a daemon process called servald. Serval Infrastructure is implemented by a separate daemon called directory_service.

Serval DNA is free software produced by the Serval Project and many contributors. It is licensed to the public under the GNU General Public License version 2. All source code is freely available from the Serval Project's serval-dna Git repository on GitHub.

The copyright in most of the source code in Serval DNA is held by Serval Project Inc., an organisation incorporated in the state of South Australia in the Commonwealth of Australia for the purpose of developing the Serval mesh software.

The Serval Project will accept contributions from individual developers who have agreed to the Serval Project Developer Agreement - Individual, and from organisations that have agreed to the Serval Project Developer Agreement - Entity.

servald

The servald executable is a multi-purpose program designed to be invoked directly from the command line and also via JNI from within a Java program. The following command will print a summary of all the operations that servald offers:

servald help

Some operations are self-contained, some start and stop the servald daemon process, some communicate with the servald daemon as an MDP client, and others via a two-way pipe called the monitor interface.

For more detail on the purpose and usage of the servald command-line, see the doc directory.

Build and test

Instructions for building and testing Serval DNA are in INSTALL.md. (If that link is does not work, try INSTALL.md.)