distdns.pod

   1 =head1 NAME
   2
   3 distdns - Distribute hostnames between clients
   4
   5 =head1 SYNOPSIS
   6
   7  ./client.pl [options]
   8
   9 =head1 DESCRIPTION
  10
  11 The distdns scripts originated as an alternative to established dynamic DNS services.
  12
  13 It features basically two scripts: client-side F<client.pl> and server-side F<server.cgi>.
  14 The client sends (once configured) personal network/computer/user name data to the server
  15 which stores it as JSON if access is granted and data is complete.
  16
  17 When F<client.pl> is invoked (preferably by a scheduler, for example: cronjob), it also
  18 receives hostnames with according IP addresses which are written to a matching network
  19 marker within the hosts file.  This allows then to use these hostnames to connect to
  20 machines.
  21
  22 =head1 OPTIONS
  23
  24  -d, --debug    server debugging
  25  -h, --help     this help screen
  26  -i, --init     initialize session data
  27  -l, --list     list remote entries
  28
  29 =over 4
  30
  31 =item * C<-d, --debug>
  32
  33 Enable "server debugging" in order to communicate fatal errors back to the client script.
  34
  35 =item * C<-h, --help>
  36
  37 Show usage screen.
  38
  39 =item * C<-i, --init>
  40
  41 Initialize session data prior to using client/server script regularly.
  42
  43 =item * C<-l, --list>
  44
  45 List remote JSON entries.
  46
  47 =back
  48
  49 =head1 AUTHORS
  50
  51 Michel Ketterle, Steven Schubiger
  52
  53 =cut