Fabio/ddclient
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

README.md: Revise troubleshooting section

Browse source 
* Use a bulleted list instead of a numbered list
  * Fix indentation
  * Fix formatting
  * Replace `fw` with `fwv4`
  * Suggest `curl` instead of `ddclient --geturl`
  * etc.
This commit is contained in:
Richard Hansen 2024-07-19 17:38:27 -04:00
parent dfef6b2e99
commit dab67eae69
1 changed files with 38 additions and 23 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

61
README.md
View file

@ -168,41 +168,56 @@ This issue arises when using the `use` parameter in the config and using one of
## TROUBLESHOOTING ## TROUBLESHOOTING
1. enable debugging and verbose messages: ``$ ddclient --daemon=0 --debug --verbose --noquiet`` * Enable debugging and verbose messages: `ddclient --daemon=0 --debug --verbose`
2. Do you need to specify a proxy? * Do you need to specify a proxy?
If so, just add a ``proxy=your.isp.proxy`` to the ddclient.conf file. If so, just add a `proxy=your.isp.proxy` to the `ddclient.conf` file.
3. Define the IP address of your router with ``fw=xxx.xxx.xxx.xxx`` in * Define the IP address of your router with `fwv4=xxx.xxx.xxx.xxx` in
``/etc/ddclient/ddclient.conf`` and then try ``$ ddclient --daemon=0 --query`` to see if the router status web page can be understood. `/etc/ddclient/ddclient.conf` and then try `$ ddclient --daemon=0 --query`
to see if the router status web page can be understood.
4. Need support for another router/firewall? * Need support for another router/firewall?
Define the router status page yourself with: ``fw=url-to-your-router``'s-status-page ``fw-skip=any-string-preceding-your-IP-address`` Define the router yourself with:
ddclient does something like this to provide builtin support for ```
common routers. usev4=fwv4
For example, the Linksys routers could have been added with: fwv4=url-to-your-router-status-page
fwv4-skip="regular expression matching any string preceding your IP address, if necessary"
```
fw=192.168.1.1/Status.htm ddclient does something like this to provide builtin support for common
fw-skip=WAN.*?IP Address routers.
For example, the Linksys routers could have been added with:
OR ```
Send me the output from: usev4=fwv4
``$ ddclient --geturl {fw-ip-status-url} [--login login [--password password]]`` fwv4=192.168.1.1/Status.htm
and I'll add it to the next release! fwv4-skip=WAN.*?IP Address
```
ie. for my fw/router I used: ``$ ddclient --geturl 192.168.1.254/status.htm`` OR [create a new issue](https://github.com/ddclient/ddclient/issues/new)
containing the output from:
5. Some broadband routers require the use of a password when ddclient ```
accesses its status page to determine the router's WAN IP address. curl --include --location http://url.of.your.firewall/ip-status-page
If this is the case for your router, add ```
so that we can add a new firewall definition to a future release of
ddclient.
* Some broadband routers require the use of a password when ddclient accesses
its status page to determine the router's WAN IP address.
If this is the case for your router, add
```
fw-login=your-router-login fw-login=your-router-login
fw-password=your-router-password fw-password=your-router-password
```
to the beginning of your ddclient.conf file. to the beginning of your ddclient.conf file.
Note that some routers use either 'root' or 'admin' as their login Note that some routers use either 'root' or 'admin' as their login while
while some others accept anything. some others accept anything.
## USING DDCLIENT WITH `ppp` ## USING DDCLIENT WITH `ppp`