\n" . "This page describes the configuration for ddclient. If you need\n". "anymore info about supported routers or supported protocols, check the\n" . "other pages. Other options are described here.\n" . "\n" . "
Normally you don't need many arguments when starting ddclient. " . "You can run ddclient as "/usr/sbin/ddclient -daemon 300 -syslog" \n" . "which should be enough for most configuration. You can put all the needed\n" . "parameters in the configuration file.\n" . "
\n" . "" . "\n" . "\n" . "\n" . "\n" . "
\n" ; $main[] = $text; $text['id'] = "usage"; $text['title'] = "Usage"; $text['menu'] = "usage"; $text['body'] = "usage:ddclient [options]
-daemon delay | run as a daemon (default: 0). | |
-proxy host | use 'host' as the HTTP proxy. | |
-server host | update DNS information on 'host' (default: members.dyndns.org). | |
-protocol type | update protocol used (default: dyndns2). | |
-file path | load configuration information from 'path' (default: /etc/ddclient/ddclient.conf). | |
-cache path | record address used in 'path' (default: /etc/ddclient/ddclient.cache). | |
-pid path | record process id in 'path'. | |
-use which | how the should IP address be obtained. (default: ip). \n" . " More information about the possible use-arguments can be found on \n" . " the supported routers page | |
-ip address | set the IP address to 'address'. | |
-postscript script | run 'script' after updating. | |
-if interface | obtain IP address from 'interface' (default: ppp0). | |
-if-skip pattern | skip any IP addresses before 'pattern' in the output of ifconfig {if}. | |
-web provider|url | obtain IP address from provider's IP checking page (default: dyndns). | |
-web-skip pattern | skip any IP addresses before 'pattern' on the web provider|url. | |
-fw address|url | obtain IP address from firewall at 'address'. | |
-fw-skip pattern | skip any IP addresses before 'pattern' on the firewall address|url. | |
-fw-login login | use 'login' when getting IP from fw. | |
-fw-password secret | use password 'secret' when getting IP from fw. | |
-cmd program | obtain IP address from by calling {program}. | |
-cmd-skip pattern | skip any IP addresses before 'pattern' in the output of {cmd}. | |
-login user | login as 'user'. | |
-password secret | use password 'secret'. | |
-host host | update DNS information for 'host'. | |
-{no}retry | retry failed updates. (default: noretry). | |
-{no}force | force an update even if the update may be unnecessary (default: noforce). | |
-timeout max | wait at most 'max' seconds for the host to respond (default: 0). | |
-{no}syslog | log messages to syslog (default: nosyslog). | |
-facility {type} | log messages to syslog to facility {type} (default: daemon). | |
-priority {pri} | log messages to syslog with priority {pri} (default: notice). | |
-mail address | e-mail messages to {address}. | |
-mail-failure address | e-mail messages for failed updates to {address}. | |
-{no}exec | do {not} execute; just show what would be done (default: exec). | |
-{no}debug | print {no} debugging information (default: nodebug). | |
-{no}verbose | print {no} verbose information (default: noverbose). | |
-{no}quiet | print {no} messages for unnecessary updates (default: noquiet). | |
-help | this message (default: 0). | |
-{no}query | print {no} ip addresses and exit. |
\n" . "The configuration file, ddclient.conf, can be used to define the \n" . "default behaviour and operation of ddclient. The file consists of \n" . "sequences of global variable definitions and host definitions. \n" . "Since version 3.6.5, ddclient.conf is located by default in \n" . "/etc/ddclient/ddclient.conf. Another location can be forced \n" . "by using the -file option" . "
\n" . "\n" . "Global definitions look like: \n" . "name=value [,name=value]* \n" . "
\n" . "\n" . "Next example \n" . "specifies that ddclient should operate as a daemon, checking the \n" . "eth0 interface for an IP address change every 5 minutes and use the \n" . "'dyndns2' protocol by default. \n" . "
\n" . "daemon=600 \n" . "use=if, if=eth0 \n" . "proxy=proxy.myisp.com \n" . "protocol=dyndns2 \n" . "\n" . "
Host definitions look like: \n" . "[name=value [,name=value]*]* a.host.domain [,b.host.domain] [login] [password] \n" . "
\n" . "Next example specifies two host definitions. \n" . "The first definition will use the hammernode1 protocol, \n" . "my-hn-login and my-hn-password to update the ip-address of \n" . "myhost.hn.org and my2ndhost.hn.org. \n" . "
\n" . "The second host definition will use the current default protocol \n" . "('dyndns2'), my-login and my-password to update the ip-address of \n" . "myhost.dyndns.org and my2ndhost.dyndns.org. \n" . "
\n" . "The order of this sequence is significant because the values of any \n" . "global variable definitions are bound to a host definition when the \n" . "host definition is encountered. \n" . "
\n" . "
\n" . "protocol=hammernode1, \ \n" . "login=my-hn-login, password=my-hn-password myhost.hn.org \n" . "login=my-login, password=my-password myhost.dyndns.org,my2nd.dyndns.org \n" . "\n" . "
See the sample-ddclient.conf file for further examples.
\n" ; $main[] = $text; ?>