---
name: "ipcheck"
section: "8"
platform: "linux"
package: "ipcheck"
version: "0.233-2"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/ipcheck"
---

# ipcheck(8)

Dyndns.org client to register your dynamic IP address

## NAME

**ipcheck** - Dyndns.org client to register your dynamic IP address

## SYNOPSIS

```
ipcheck [options] Username Password Hostnames
ipcheck [options] --acctfile acct_info_file
```

## DESCRIPTION

**ipcheck is a simple Python script to register your dynamic IP address using the NIC V2.0 protocol.** **It aim to be fully compliant with the dyndns client specification.**

**The script is very easy to use and supports multiple methods for determining the external IP (parsing** **interfaces on the local machine, web based IP detection, direct support for devices from Linksys,** **Netgear, Draytek, Netopia, HawkingTech, Watchgard, Cayman, Nexland, ZyXEL, SMC, Compex, UgatePlus,** **DLink and Cisco).**

**Run the script with no command line arguments for quick start instructions.**

## OPTIONS

- **-a address**

  **Manually specify the address.**

- **-r URL**

  **NAT router, use web IP detection.**

- **-A text**

  **Scan syslog for an IP after text (Unix only).**

- **-F filename**

  **Guess the WAN IP from a firewall log.**

- **-b**

  **Backup mx option ON (default OFF).**

- **-c**

  **Custom dns option (default dynamic).**

- **-d dir**

  **Directory for data files (default current).**

- **-e script**

  **Execute script after a successful update.**

- **-f**

  **Force update regardless of current state.**

- **-g**

  **NAT router, let dyndns guess your IP.** **(do not use this in a cronjob, try -r).**

- **-h**

  **Print this help text.**

- **--help**

  **Print all available help text.**

- **-i interface**

  **Interface for local address (default ppp0).**

- **-j**

  **Disable https.**

- **-l**

  **Log debugging text to ipcheck.log file.**

- **--syslog**

  **Log debugging text to syslog (Unix only).**

- **-m mxhost**

  **MX host (default NOCHG).**

- **-o**

  **Set dyndns offline mode.**

- **-p**

  **Proxy bypass on port 8245.**

- **-q**

  **Quiet mode (unless there is an error).**

- **-s**

  **Static dns option (default dynamic).**

- **-t**

  **Test run, do not send the update.**

- **-v**

  **Verbose mode.**

- **-w**

  **Wildcard mode ON (default OFF).**

- **--makedat**

  **Create the ipcheck.dat file by dns lookup.**

- **--devices**

  **Print router** *options* **(Linksys, Netgear, etc).**

- **-n ip**

  **The router IP address on the internal lan.**

## OTHER OPTIONS

- •

  **For help with different** *options***: ipcheck -h**

- •

  **For supported devices listing: ipcheck --devices**

- •

  **For long detailed help text: ipcheck --help**

## EXAMPLES

**Example 1: the external IP is on eth0 of the current machine:**

```
    # ipcheck -l -i eth0 username password hostnames
```

**Example 2: you are using the Linksys routing device:**

```
    # ipcheck -l -L linksyspassword username password hostnames
```

**Example 3: you want to use web based ip detection:**

```
    # ipcheck -l -r checkip.dyndns.org:8245 ...
```

**where ... is your dyndns username password and hostnames.** *Hostnames* **should be comma delimited if there are more than one.**

## AUTHOR

**ipcheck was written by Kal \<kal@users.sourceforge.net\>.**

**This manual page was written by Joao Eriberto Mota Filho \<eriberto@debian.org\>** **for Debian project (but may be used by others).**