summaryrefslogtreecommitdiffstats
path: root/distdns.pod
blob: 920deb4a91d92f52324f2182adaaca7d2cdf0882 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
=head1 NAME

distdns - Distribute hostnames between clients

=head1 SYNOPSIS

 ./client.pl [options]

=head1 DESCRIPTION

The distdns scripts originated as an alternative to established dynamic DNS services.

It features basically two scripts: client-side F<client.pl> and server-side F<server.cgi>.
The client sends (once configured) personal network/computer/user name data to the server
which stores it as JSON if access is granted and data is complete.

When F<client.pl> is invoked (preferably by a scheduler, for example: cronjob), it also
receives hostnames with according IP addresses which are written to a matching network
marker within the hosts file.  This allows then to use these hostnames to connect to
machines.

=head1 OPTIONS

 -d, --debug    server debugging
 -h, --help     this help screen
 -i, --init     initialize session data

=over 4

=item * C<-d, --debug>

Enable "server debugging" in order to communicate fatal errors back to the client script.

=item * C<-h, --help>

Show usage screen.

=item * C<-i, --init>

Initialize session data prior to using client/server script regularly.

=back

=head1 AUTHORS

Michel Ketterle, Steven Schubiger

=cut