dynipadmin(1)

NAME
dynipadmin - DynIP Client(tm) Internet Name Administration Program

SYNOPSIS
dynipadmin [-d|-p] | [-r <firstname> <lastname> <email address> <hostname> [<domain id>] [<ip address>]] | [-s <registration key>]

DESCRIPTION
DynIP(sm) is a Dynamic IP Management System which allows Internet hosts with dynamic IP addresses -such as dial-up users- to have a permanent and static Internet Name. dynipadmin allows you to manipulate your Internet Name registration information. Initially, you will use the dynipadmin program to register your desired Internet Name for your computer. Later, you can use this program to delete or update your registration information. The dynipadmin program operates in conjunction with the DynIP server and allows you to register a Internet Name that always refers to your current dynamic IP address. Once you have registered your personal Internet Name, your machine is known to the Internet by a static domain name of the form <your chosen hostname>.dynip.com.

OPTIONS

-p  Reload your Internet Name registration information. This option allows you to synchronize your registration information in the dynip.cfg configuration file with the information stored on the DynIP server. This is necessary in case you have made modifications to your registration information using our website (http://www.dynip.com)

-d  Delete your Internet Name registration information. This is necessary if you wish to register a new Internet Name or you no longer wish to make use of the services offered by DynIP.

-r <firstname> <lastname> <email> <hostname> [domain id] [ip address]
    Register a new Internet Name. You must supply a valid email address. The DynIP server will e-mail you important registration information once your Internet Name has been successfully registered. You can only have one active Internet Name registration at a time. If you wish to change your Internet Name, you can just submit a new Internet name registration (using the -r option) and your existing Internet Name registration will be overwritten. The ``domain id'' parameter is an optional parameter that allows you to associate the specified hostname with another second-level domain. Generally, hostnames are associated with the second-level domain dynip.com, but if you have made arrangements to have DynIP host your own private second-level domain, DynIP will issue you a 10-digit password (the ``domain id'') that allows you to associate your hostname with your own second-level domain. For more information about using your own private domain, please contact support@dynip.com. There are a number of affinity second-level domain names that you can also associate your hostname with. These are listed in the dynip.dom domain ID database file. You can either specify the second-level domain name as the ``domain id'' parameter, or the numerical number assigned to the second-level domain. See the examples section below for details. The ``ip address'' parameter is an optional parameter that allows you to specify the static IP address that is to be associated with the registered Internet Name. This is useful if you have a (semi)static IP address (long lease DHCP cable-modem users, for example) but have a cryptic hostname. The ``ip address'' parameter does not have to refer to the IP address of the host that you are registering the domain on, so you could essentially ``rename'' any existing host on the Internet.

-s <new registration key>
    This option allows you to set the registration key that the dynipadmin and dynipclient program will use to identify itself to the DynIP server. This option is only useful when you already have an active Internet Name registration and are installing an updated version of the DynIP client distribution, or are re-installing the DynIP client on another computer or operating system. This option merely updates the values in the dynip.cfg configuration file. The registration key must be two numbers separated by a dash (``-'').

EXAMPLES

dynipadmin -r Joe Bar joebar@myisp.com foobar

This requests a new Internet Name registration with a hostname of 'foobar'. When the registration is completed successfully, your computer is known to the Internet by foobar.dynip.com. To activate your Internet Name, you will need to run the dynipclient program every time that you connect to the Internet and for the duration of your connection.

dynipadmin -r Joe Bar joebar@myisp.ca barfoo 123.113.64.9

This requests a new Internet Name registration with a hostname of 'barfoo'. When the registration is completed successfully, the machine with IP address 123.113.64.9 is known to the Internet by an alternate name, barfoo.dynip.com. You do not need to run the dynipclient program, because the new Internet Name is pointing to a static IP address.

dynipadmin -r Joe Bar joebar@myisp.com mysite dynip.com

This requests a new Internet Name registration for mysite.dynip.com. The ``domain ID'' specifies dynip.com, which could have been omitted because it is the default domain.

dynipadmin -r Joe Bar joebar@myisp.com mysite ipname.com

This requests a new Internet Name registration for mysite.ipname.com. The ``domain ID'' specifies an affinity domain which appears in the domain ID database file, dynip.dom.Hostnamescanbeassociatedwithanyofthelistedaffinity domains in the domain ID database file.

NOTES
Some hostnames are reserved and the dynipadmin program will inform you when you have selected a reserved hostname, or when you have selected a hostname that is already in use by another user. There are no reserved names for hostname registrations under your own second-level domain (i.e., when specifying the ``domain id'' parameter).

The DynIP server issues a unique registration key the first time that you register an Internet Name. This registration key is your ``password'' and can be used with the DynIP client across platforms to enable your Internet Name. For example, if you have both a Windows NT machine and a FreeBSD or Linux machine, both can have the same registration key so that your Internet Name can be used to access either machine (but not simultaneously).

FILES
 dynip.cfg    The DynIP configuration file
 dynip.dom    The Domain ID database file

SEE ALSO
dynipclient(1)
DynIP, a division of CanWeb Internet Services Ltd.