Index of /linux/c
Installation Notes:
-----------------------
There are two `configure' options needed to properly compile this package
for installation.
--prefix
--sysconfdir
The `--prefix' option sets environment varible for the installation of the
packages executables, images, and man page.
On most systems this option should be `--prefix=/usr'.
The `--sysconfdir' options set the environment variable for the installation
of the init start-up script "tzod" in the "init.d" directory for the TZO
service to start at boot.
Make sure the full path to the "init.d" directory id specified, this will be
in the /etc directory.
RedHat Systems
/etc/rc.d/init.d
Debian Systems
/etc/init.d
Examples:
-------------
Red Hat Systems
./configure --prefix=/usr --sysconfdir=/etc/rc.d/init.d
make
make install
-------------
Debian Systems
./configure --prefix=/usr --sysconfdir=/etc/init.d
make
make install
_______________________________________________________________________
Manual Page for TZO 1.6.4
Copyright (c) 2001, Tzolkin Corp.
This is free documentation; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version of
the License, or (at your option) any later version.
The GNU General Public License's references to "object code"
and "executables" are to be interpreted as the output of any
document formatting or typesetting system, including
intermediate and printed output.
This manual is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or TNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public
License along with this manual; if not, write to the Free
Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
USA.
tzo 1.6.4
Dynamic DNS Client For TZO DDNS Services.
tzo [ -uhdkmioba ] [ -u user ] [ -h homedir ] [ -d domain ] [ -k key ]
[ -m email ] [ -i signon ] [ -o signoff ] [ -b background ] [ -a device ]
DESCRIPTION
tzo, version 1.6.4.
tzo is a Dynamic DNS client for the Linux Platform. With tzo,
you can run your own Web, Email, FTP, Chat or any other type of internet
server from your cable/DSL, T1 or dialup connection.
The following sections describe how to use tzo.
Connection Type
Denition of how your computer is connected to the Internet.
IP Address
Selection of what type of IP Address you use and how often you want it checked.
Sign On / Off Service
What actions you want the tzo client to perform when you start and stop
the client.
TZO Control Panel
The TZO Control Panel is a domain management tool to update various
properties of any domain that is hosted with TZO DNS.
Run as a Service
Congure the tzo client to run as a background service.
Enter New TZO Key
How to enter a new TZO Key if you change accounts or switch from trial
to full service.
Change Email
Dialog box to change your Email Address on the tzo DDNS Servers.
Change Domain Name
Dialog box to change your domain name on the tzo DDNS Servers.
Tell a Friend about tzo
Dialog box to enter a friends email address and tell them about the
cool tzo DDNS Service.
Exit
Exit the tzo Client.
OPTIONS
tzo options are traditional POSIX one letter options, GNU style
long options are not available. POSIX style options start with
a single ``-''.
Options Have Priority over default $(USER).ini settings.
Command Line Options for tzo
-u user,
User name with tzo account.
-h user's home directory,
User's home directory containing $(HOME)/.tzo/$(USER).ini file.
-d domain,
Domain Name you have with tzo.
-k key,
Your TZO Key.
-m email,
Your Registered Email Address
-i,
Signon your domain.
-o,
Signoff your domain.
-b,
Run tzo in the background
-a device,
Specify the Device you want to use. e.g. - ppp0, eth0, le0, etc.
EXAMPLES:
If you are starting tzo as a system init service use this method, but,
only after you have run the client in GUI mode as that user!
tzo -u username -h /home/userdir
If you are logged in, precongured, these methods will work ne.
Use this to lanch GUI mode.
tzo
Use this to lanch in background mode.
tzo -i -b
This mode bypasses the settings in the "$(HOME)/.tzo/$(USER).ini" file.
tzo -d yourdomain.net -k XXXXXXXXXXXXXXX -m you@yourdomain.net -i -b -a eth0
ACCOUNTS
For New or Existing accounts please read on ...
The rst time tzo is executed, you will be asked to answer some questions
regarding a new or existing account with tzo. If you have an existing
account with tzo, simply enter the Key you received from tzo, if
you are begining a new trial account, select the sub-domain you would like
to use, enter your email address and a tzo Key will be sent to you via email.
Make sure you enter a valid email address or you will not receive a Key.
CONNECTION TYPE
The Connection Type Dialog box congures the tzo Client
to use a specied modem device or ethernet device.
Default Modem Device: ppp0
Default Ethernet Device: eth0
Resolve from Device: Gets the IP Address from the selected device.
When this radio button is selected, the tzo client will detect the device
IP Address. This can be either a private address (10.x.x.x - 192.168.x.x -
172.16.x.x) or a public Internet IP Address. The reason for allowing private
addresses to be used, is so users that connect via VPN's over private networks
can do so easily, and also, if the Dynamic DNS is solely being used for an
internal private network, private addresses are preferred.
Resolve from Server: Ignores the selected device and resolves the gateway
IP Address to the users Domain Name. When this radio button is selected,
the tzo Client ignores what ever the device IP Address is and will
detect the refering IP Address that sent the update to the tzo Servers.
This should be used if you are using tzo behind a rewall or NAT router.
Ports used by tzo:
21330
21331
21332
If you are going through a proxy gateway server then you need to open
the above three ports for Bi-Directional Communication.
IP ADDRESS
Select what type of IP Address you use and how often you would like to
check for a change of your IP Address if it is dynamic...
If you are not sure what type of IP Addess you use then Select the first
radio button: I am not sure what type of IP Address I use.
Select the second radio button if you have a dynamic IP Address,
then select how often you would like to check your IP Address for a change
If you have a static IP Address select the third radio button and
enter your Static IP Address.
SIGN ON / OFF SERVICE
This dialog box enables you to set different actions when you
Sign On / Off of TZO DDNS.
There are two options for Signing ON to tzo...
first: Set your Domain Name to your Current IP Address.
Second: Set your Domain Name to a specifed IP Address - Enter the IP
Address in the Text fifield.
There are four options for Signing OFF of tzo...
first: Set your Domain Name to 0.0.0.0 so others cannot lookup your Domain's
IP Address, or keep others from accessing your computer - The best option for
high security.
Second: Do Not change the IP Address of your Domain Name.
Third: Set your Domain Name to a Specied IP Address - Use this if your have a
backup server that your website is mirrored on or any other type of backup
server you may have.
Fourth: Set your Domain Name to point to a web page that says that you are
temporarily off line - good if you are going to be off line for a short time.
TZO CONTROL PANEL
The TZO Control Panel is a new feature from tzo that allows users to control
ALL aspects of their domain properties on the TZO DDNS Servers.
Options Controllable via the TZO Control Panel Include:
Domain:
Update the IP Address.
Change you Domain Name.
Manage DNS Forwarding.
Add Domain to List.
Remove Domain from List.
Web:
Manage Web Forwarding.
Email:
Change Your Email Address.
Manage MX Records.
Manage Email Forwarding.
Manage Email Store and Forward.
Manage Email Hosting.
Keys:
Send TZO Keys to your Email Address.
AutoFailover:
Manage Single Site Monitoring.
Manage Multi-Site Monitoring.
Tools:
Send a test Email message.
Create a Bookmark.
Control Panel Help.
RUNNING TZO AS A SERVICE"
What happens when I check the "Running TZO as a Service" radio button?
Running tzo as a service will allow tzo to start running before you log
on to your computer. This is very useful for unattended operation. In
order to have tzo run as a service, an account first needs to be setup
with tzo and the tzo account on the local system also needs to be setup.
The tzo executable will look for "$(HOME)/.tzo/$(USER).ini" in order to
startup unattended. So, in order for tzo to start as a system service,
their account must first be setup. tzo will look for this .ini upon starting
from the init runlevel.
Depending on the Linux Distribution you are running tzo on, it will
do one of three things to add tzo as a runlevel service. - ONLY IF RUNNING AS root !!!
On Red Hat Systems: tzo uses "chkcong" to add and delete tzo from the init runlevels
On Debian Systems: tzo uses "update-rc.d" to add and delete tzo from the init runlevels.
On all other Linux systems: tzo manually adds and deletes the symlinks for
starting and stopping tzo from the init runlevels.
An alternate way tzo can autostart is with a users login. If you are running
tzo as a normal user (not root), tzo will add a line to the ".bash_profile" file
in that current user's directory. This will autostart tzo in the background when
ever that user logs in.
ENTER NEW TZO KEY
If you change from a trial service to a Full Service with tzo you will need to
enter a new Key. Also, when you renew your Service with tzo, you may need to
enter a new key. Just enter the new Key that you receive from tzo and hit "OK",
this will update your tzo account with your new Key.
CHANGE EMAIL
The Change Email Dialog box enables the email address to be changed for an
account on the tzo DDNS Servers. This change of the email address also effects
the "Email Forwarding Service". If an account has email forwarding, the email
will instantly be forwarded to the new email address.
CHANGE DOMAIN NAME
The "Change Domain Name" Dialog box allows the account domain name to be changed
for Standard and Premier accounts. Standard tzo accounts, which are sub-domains,
(name.tzo.com - or - name.domain.com) can only be changed to the same type of
sub-domain name. Premier tzo accounts can be updated with Top Level Domains or
sub-level domains (domain.com - or - name.domain.com).
TELL A FREIND ABOUT TZO
If you wish to tell a friend or co-worker about tzo you can do it here. This
allows you to put in an email address of someone you want to send information
regarding tzo DNS Services, this will contact our email servers and have a
message sent to whom you choose. This will only send ONE email message and
will NOT keep that address on record.
EXIT
No Brainer ... To exit, please select file - Exit.
Thank you... :^)
FILES
The following files are installed at # make install ...
$(PATH)/tzo - tzo executable.
/usr/share/pixmaps/tzologo.xpm - Dialog Box image
/usr/share/pixmaps/tzo.xpm - tzo icon image.
The following files are created after the tzo client has run at least once.
$(HOME)/.tzo/$(USER).ini - information about your account
$(HOME)/.tzo/tzo.log - active account logging for signon/signoffs
BUGS
tzo is in early stages of linux development, so it may not
be completely stable and some features may not be supported. The client has
been successfully tested on RedHat 7.x systems and Progeny Debian.
BUG REPORTS
If you nd a bug in tzo, please send email
to support@tzo.com. Please include your OS type
and the OS version, the version of tzo, and the C compiler you
used to compile it.
Before sending a bug report, please verify that you have the latest
version of tzo. Many bugs (major and minor) are fixed
at each release, and if yours is out of date, the problem may already
have been solved.
SEE ALSO
http://linux.tzo.com/
LICENSE
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or TNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple PLace, Suite 330, Boston, MA 02111-1307 USA
AUTHORS
The authors of tzo are:
Gary Cook <gary@tzo.com>
Eric McIntyre <eric@tzo.com>
Mike Foley <mdf@tzo.com>
Jeff Cronstrom <jeff@tzo.com>
The manpage was written by Jeff Cronstrom <jeff@tzo.com>.
-------------- END --------------
![[ICO]](/icons/blank.gif){kind=icon}
![[DIR]](/icons/back.gif){kind=icon}
![[ ]](/icons/compressed.gif){kind=icon}
![[ ]](/icons/tar.gif){kind=icon}