xfft(1)

Name

xfft - X.25 Fast File Transfer utility

Syntax

xfft -d devname [-p [0 | 1]] [-l logfile] [-b basedir]

Description

xfft is TSG's Fast File Transfer utility. It is used in conjunction with xpad to transmit to or receive files from a remote site. xpad makes an outgoing X.25 call to the machine on which xfft is available as an x25daemon -invoked utility. xfft then sends prompts down the X.25 circuit to the xpad user, who in turn enters commands for xfft. xfft is only run on the machine accepting incoming calls via x25daemon. Do NOT invoke this command from the command line.

Options

These command line options are recognized:

Option Argument Description

-d devname Specify Device Name to use

-p [0 | 1] Allow (1), or disallow the put operation of xfft

-l logfile Enables logging to logfile

-b basedir Name of base directory where user can receive from and optionally send files to. By default this directory is /usr/spool/xfft.

When xfft transmits or receives a file it sends a special qualified data packet that only xpad recognizes. The same applies when xfft has finished the transfer. xfft uses no protocol other than this. It relies on the X.25 virtual circuit to be an error free transmission medium. Public data network virtual circuits usually exhibit these characteristics, however, if they do experience network difficulties, they always issue a Circuit Reset. If a Reset occurs during a file transfer, it is abandoned, as the file is certain to be garbled.

At xfft's prompt, the user enters a command. The files specified by the put or get commands must exist within xfft's base directory tree: /usr/spool/xfft on the sending machine or the selected base directory. For get operations, xpad will create the file using as its base directory the current one when xpad is invoked. This directory may be changed using the xpad lcd command.

The put operation is only allowed if the remote machine exhibits the -p1 option on the xfft entry in the /etc/x25incalls file.

xfft attempts to prevent unauthorized file access by asserting that the requested filename does not begin with either a / or a .. This is probably not 100% secure.

xfft recognizes the following commands:

Command Description

dir, ls list files

get [name] receive file

put [name] send file (only if put operation is allowed)

cd [dir] change to given directory within /usr/spool/xfft or user specified base directory

pwd display current xfft directory

mkdir, md [dir] create a new directory within current directory

help, man [topic] provide help

exit, quit leave the xfft server

The following /etc/x25incalls entry would be appropriate for invoking xfft:

CUD=\1\0\0\0FILE:ACCEPT:X29:YES:/usr/lib/x25/utils/xfft -d $dev -p 1

The above command would route all incoming calls in which "FILE" was specified as xpad's Call User Data to the xfft utility. The disposition field must be ACCEPT and the mode field must be X29. The use of CUD "FILE" is a TSG convention, as x25incalls is shipped with this line.

Revision 6.1.0 (February 2003)

Option	Argument	Description
`-d`	`devname`	Specify Device Name to use
`-p`	`[0 \| 1]`	Allow (1), or disallow the put operation of xfft
`-l`	`logfile`	Enables logging to logfile
`-b`	`basedir`	Name of base directory where user can receive from and optionally send files to. By default this directory is /usr/spool/xfft.

Command	Description
dir, ls	list files
get [name]	receive file
put [name]	send file (only if put operation is allowed)
cd [dir]	change to given directory within /usr/spool/xfft or user specified base directory
pwd	display current xfft directory
mkdir, md [dir]	create a new directory within current directory
help, man [topic]	provide help
exit, quit	leave the xfft server