Tellurian Pty Ltd
272 Prospect Road
Prospect SA 5082
Australia

ACN 069 073 267

ph. +61 8 8408 9600
fax. +61 8 8408 9614

Tellurian TftpdNT

A TFTP service for
Windows NT and Windows 95

Copyright © Tellurian Pty Ltd, 1998
Copyright (c) 1983 Regents of the University of California.
All rights reserved.

trinkets@tellurian.com.au
10 August, 1998

Tellurian TftpdNT is a member of our `iNTernet trinketTM range of products, which enable your Microsoft Windows^* NT or Windows 95 computer to provide the kinds of network service which has traditionally only been available on `big' computers, such as those running the Unix operating system.

Tellurian TftpdNT is a service for Windows NT Workstation or Server, and works stand alone in a Windows 95. It complies to the Internet RFC 783 for Trivial File Transfer Protocol or TFTP and permits your Windows NT or Windows 95 computer to be the TFTP server for your organisation's network. In conjunction with Tellurian bootpdNT, your Windows 95/NT computer can provide boot services for diskless workstations.

This document describes the installation, care and feeding of your TFTP service to ensure a long and satisfying relationship between you, your service and the network you are running.

^* Windows, Windows NT and Windows 95 are trademarks of Microsoft. iNTernet trinket is a trademark of Tellurian.

Installation for Windows NT

Place the TFTPDNT.EXE file in the directory you wish it to permanently reside, change to this directory then run:

tftpdnt --install

This will place an entry in the registry for a service called TftpdNT which will execute TFTPDNT.EXE from this directory. If you move TftpdNT to a different directory you will have to update the registry; the easiest way is to re-install it.

By default Tellurian TftpdNT will be registered as a manually started service.

Installation for Windows 95

There are no special installation instructions for Windows 95. Simply place the TFTPDNT.EXE file in the directory you wish it to reside.

De-Installation for Windows NT

Tellurian TftpdNT can be de-installed in two steps:

Stop the service (if it is running).
From the DOS command line, run:

tftpdnt --remove

This will remove all Registry entries created. The TFTPDNT.EXE file can then be deleted with safety.

De-Installation for Windows 95

Tellurian TftpdNT can be de-installed in three steps:

Stop the program (if it is running).
Run the following DOS command:

tftpdnt --win95 -r

Stop it again.

This will remove all Registry entries created. The TFTPDNT.EXE file can then be deleted with safety.

Running under Windows NT

To start Tellurian TftpdNT under Windows NT, open the Services control panel, hilight the TftpdNT entry and click the Start button. You can specify startup parameters to set the location of the log file, the debug level and such.

Consult the Windows NT Workstation Help files on starting and stopping services for information on general operating procedures. Issues specific to Tellurian TftpdNT follow...

In DOS command mode, Tellurian TftpdNT supports the following command arguments:

`--install`	Install TftpdNT as Windows NT service
`--remove`	Remove all Registry entries related to Tellurian TftpdNT
`--help`	Explain all possible command parameters

Running under Windows 95

In DOS command mode, Tellurian TftpdNT supports the following command arguments:

`--help`	Explain all possible command parameters
`--win95 [param ...]`	Start the program in a DOS box.

You must use the --win95 argument to start the program under Windows 95.

Startup Parameters

When started as a Windows NT service, Tellurian TftpdNT accepts parameters affecting it's operation and indicating the location of files. Those parameters are entered at the bottom of the Services control panel.

When started as a Windows 95 program, the same parameters can be used, but they are typed on the command line, after the --win95 argument.

-l logfile

logfile represents the full pathname of the file to log TFTP events (default `C:\tftpdnt.log')

-d loglevel

<loglevel is a number between 0 and 9 indicating the amount of detail desired in the log file.

0	No logging is performed and a logfile is not created.
1	Basic initialization messages are generated.
6	Level 1 PLUS Control Service events.
9	Level 6 PLUS Packet received/transmitted events.

-o rootdir

Directory that the TftpdNT will use for transfers (default `C:\tftpboot'). If you want TftpdNT to be able to use any directory on any drive, use `-' for rootdir; e.g. `-o -'. Note that allowing TFTP transfers into, or from, any directory is considered a security weakness.

-t timeout

Re-transmission timeout in seconds (default 5 sec.)

-s

Save the current command parameters to the Registry.

-r

Reset the information in the Registry to the defaults mentioned under Installation.

Long filenames are supported in the rootdir and logfile parameters, but in Windows NT Service control panel it is important that you precede all backslashes (`\') and spaces (` ') with a backslash (`\'). eg. `c:\logs\tftp log.txt' must be typed as `c:\\logs\\tftp\ log.txt'.

If you need to change the default parameters or start the service automatically at boot time, start the service once manually specifying your preferred values in the Command Parameters box and include the -s option. This will save these parameters in the Registry, and next time the service is started it will use the values in the Registry.

Any parameters specified in the Command Parameters or command line will override entries in the Registry.

Security Issues

The use of TftpdNT does not require an account or password on the remote system. Due to the lack of authentication information, TftpdNT will allow only readable files to be accessed. Files may be written only if they already exist and are writable. Access to files is restricted by invoking TftpdNT with name of root directory as a parameter. In this case access is restricted to files which are in this directory or one of its subdirectories.

Copyright, Licence and Warranty

Tellurian TftpdNT is provided under one of the following licences. Please refer to the version appropriate for you.