penumbrad

Status

Penumbrad now works for actual file transfer using the protocol.

The https server is working and accepts uploads, encrypts and signs them, and stores them in /var/lib/penumbra. A thread periodically issues advert packets for any uploads. Another thread accepts the adverts and the https server (listening on localhost:8111) shows any advertised or uploaded uploads. If you select a file to be downloaded, it is streamed to your local browser, either directly from the encrypted upload files or by streaming it first over the penumbra protocol from a box that has the actual data.

Passing on requests is not implemented yet, but the rest of the file transfer actions are, so that two penumbra stations within range can pass files around using the protocol from requests by a browser.

Building it

You will need the following packages installed to build

libgcrypt

libgcrypt-devel

openssl

openssl-devel

libfec

libfec-devel

libgpg-error

libgpg-error-devel

A patched copy of libfec can be found on the downloads page.

Installing it

After the build, as root

make install setperms

or

make DESTDIR=<fake root> install setperms

to install into <fake root>/ as /

The RPM takes care of this as part of the RPM install action.

Running it

The Usermode Daemon needs to be run as root, but it changes its permissions to UID and GID 1200 immediately after opening the raw socket it needs to transmit.

Just run it with no args and it should start issuing Penumbra packets. For initial confirmation it is working and debug, you can use the -s switch to have it send 10 plain ASCII packets a second: if your driver and 80211 stack is patched then these should be being sent in plaintext from your wireless adapter. You can confirm with tcpdump using another box with a wireless device running Monitor mode on the same channel that the packets are coming out in clear. If you have a second Penumbra capable device, the embedded webserver shows the status of any pinging stations active in the last two seconds under the interface stats on the left.

The packets look like this



See Packet Traces for an idea of what the packets look like at each stage.

penumbrad has the following commandline options:

-D/daemonize	Fork into a background process that is not reliant on the existence of the terminal used to start it; run as a daemon
-d/debug	Print additional activity information on stdout, not useful with daemonize
-s/sendpings	Send cleartext station ID packets at 100ms intervals. Used for surveying and debugging - destroys station anonymity
-p <n>/--port=<n>	Set the https server listen port

---