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

55
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
fwv4=url-to-your-router-status-page
fwv4-skip="regular expression matching any string preceding your IP address, if necessary"
```
ddclient does something like this to provide builtin support for common
routers.
For example, the Linksys routers could have been added with: For example, the Linksys routers could have been added with:
fw=192.168.1.1/Status.htm ```
fw-skip=WAN.*?IP Address usev4=fwv4
fwv4=192.168.1.1/Status.htm
fwv4-skip=WAN.*?IP Address
```
OR OR [create a new issue](https://github.com/ddclient/ddclient/issues/new)
Send me the output from: containing the output from:
``$ ddclient --geturl {fw-ip-status-url} [--login login [--password password]]``
and I'll add it to the next release!
ie. for my fw/router I used: ``$ ddclient --geturl 192.168.1.254/status.htm`` ```
curl --include --location http://url.of.your.firewall/ip-status-page
```
5. Some broadband routers require the use of a password when ddclient so that we can add a new firewall definition to a future release of
accesses its status page to determine the router's WAN IP address. 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 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`