=================
The Dnsfile suite
=================

This is a set of tools that implement the Dnsfile protocol, a protocol for
distributing files over the Domain Name System (DNS).

This suite contains the following items:

Client applications
-------------------

 o dnsfile_connect

   Prints out the environment variables used if you want to use the other
   tools without having to specify the prefix and DNS server on the command
   line. If you use bash, you can simply do

   eval `dnsfile_connect <arguments>`

   If you use another shell, you can execute the program and just enter the
   environment variables yourself. Patches for other shells are appreciated.

   You can do dnsfile_connect <server> <dnszone> to connect to a known Dnsfile
   server where the files are stored in the given Dnsfile zone. You can also
   use dnsfile_connect <dnszone> to look up the Dnsfile servers for the given
   Dnsfile zone using the system resolver. This only works if the Dnsfile
   server is delegated to by its parent domain.

 o dnsfile_ls dir

   Prints out dnsfile file listings. If you don't use dnsfile_connect, you can
   specify a server to connect to and a prefix yourself, run with "-h" for more
   details

 o dnsfile_get [-c] file

   Retrieves a file through DNSfile. Use -c to resume a stopped download.

Server applications
-------------------

 o dnsfile_server @interface [path]

   A basic Dnsfile server application. By default, it exports the current working
   directory. Use dnsfile_server -h for more information.

 o dnsfile.la

   This is a Posadis module implementing Dnsfile. Configuration settings are:

    - allow - range of clients to allow queries from
    - refuse - range of clients to refuse queries from
    - server - list of dnsfile servers for the zone (required!)
    - root - path to export

Building and installing Dnsfile
===============================

To build Dnsfile (you'll need to have the Poslib headers installed), do a:
  make

To instsll, just copy the binary files to your preferred location :)

To build the Posadis module (you'll need the Posadis headers installed), do:
  make POSADIS_LIB=yes

To install the Posadis module, copy dnsfile.la and dnsfile.so.0 to the Posadis
library directory/