NAME
eftd - ISDN EUROFILE file transfer server
SYNOPSIS
As this is alpha test software, options might change with each release!
eftd [-a [ACCESS_FILE]] [-IlsV?] [-d LEVEL] [-D MASK] [-b LOGFILE] [-l
LEVEL] [-L MASK] [-U FALLBACK_USER_ID] [-x ADDR]
DESCRIPTION
eftd eftd allows clients to connect to your machine via the ISDN and to
transfer files by means of the EUROFILE transfer protocol. That
protocol is specified by ETSI norms ETS 300-075 and ETS 300-383.
Unless the -s option is given, the server loops forever waiting for
incoming connections and forks a child process for each connection
received.
OPTIONS
-a Expects a string argument interpreted as a file name. If eftd
is compiled with the CONFIG_EFTD_WUAUTH option, eftd reads
ACCESS_FILE and uses the contents for user authentication
similarly to wu-ftpd’s ftpaccess file. See eftaccess(5) for
further details.
-b Expects a string argument interpreted as a file name.
Communication events selected by the -l or -L option are logged
(appended) to the file specified by the option’s argument. (This
is the ’LogBook’ file in terms of ETS 300 383, thus the ’b’). If
this option is omitted, a system dependent default (i.e.
/var/log/eftd.log) is used. Opening of the LogBook file can be
supressed simply by not suppling any -l or -L option.
-d Expects an integer argument which is interpreted as a log level.
Protocol or internal events up to the level are logged to
stderr.
For levels 0 - 3, see the -l option.
Higher values include more events in the log, such as low level
protocol and call traces and temporarily inserted debugging
output statements.
Use of -d as well as level > 3 is primarily intended for
debugging purpose. This also implies that the output caused by
log levels > 3 is not documented and likely to change between
releases.
-D The bitmask argument allows for low level grained control of
stderr output. It overrides previous -I and augments -d options.
For maximum amount of debugging output use "-D -1". As this is
really intended to be used for low level debugging, examine the
eftp4linux sources (start by reading the source file
src/lib/tdu_user.h) if you really want to use this option on
your own.
-I Logs the contents of /dev/isdnctrl to stderr. For this to work,
other processes reading /dev/isdnctrl (i.e. isdnlog) should be
stopped before). This option is intended for debugging purpose
only.
-l The integer argument specifies the log level for selecting the
events written to the LogBook file (as specified by the -b
option). Levels are
0 No events at all.
1 Important events related to session start and end (login and
logout)
2 Important events during each session. Also adds some events
related session start/stop of minor priority.
3 Other minor priority events.
>3 Low level events. As these are primarily useful for debugging
purpose, it’s probably better (but not strictly necessary) to
log them by means of the -d option. See the latter for more
info.
CAUTION:
this log feature is currently new, extremly unfinished,
incomplete and subject to improvements (volunteers welcome) and
not my highest priority item. Thus, don’t expect the current
format of the messages to be fixed forever.
-L Conceptually similar to -D (see the latter). Allows fine grained
control for selecting the events logged to the LogBook (-b)
file.
-x The string type argument should consist of up to 15 digits which
specify the X.25 [X.121/X.301] address the servers listens on
for incoming connections. As EUROFILE is usually used with
ISO-8208 X.25 DTE-DTE mode, you should use the empty string as
argument here, which is the default. Thus, it is extremely
unlikely that you want to use this option at all.
This option can be given two times, allowing the server to
listen on two different x25 addresses simultaneously.
-s Single process mode. If this option is given, the server just
serves the first incoming connection and exits when the session
is finished. It does not fork a child process for serving that
connection.
This is mainly useful for running eftd under the control of a
debugger (such as gdb). If you want to debug eftd like this,
also make sure that the ’-m’ option is not set. (As the -m
option forks an additional supervisor process, -s alone will not
result in a debuggable single process eftd). Further, as the
single process will not run under root permissions any longer
after an EUROFile connection has been accepted, eftd can not
clear isdn connections on its own, you may need to do so
yourself.
-m Multiple connection mode. If this option is given, the server
immidiately continues to accept new connections without waiting
for the just accepted session to finish. The number of
simultaneous served connections is not internally limited by the
server. However, upper limits might be imposed by the mumber of
physically available isdn B-channels, the number of running
incoming isdn network interfaces configured with "encap
x25iface", or by the authentification procedure (i.e. group
limits configured in /etc/isdn/eftaccess).
When multi mode is activated, the server forks an extra
privileged supervisor process for each accepted connections
which takes care of clearing the isdn connection after the
session is finished. Thus, if N EURFILE sessions are active,
there will be 2N+1 eftd processes.
-UUSER When this option is specified, a login attempt with a user name
not in the passwd database will be using USER as the login name
(with empty password).
You might use ’-U ftp’ if you have configured anonymous access
and want that unknown user ids should be handled as an anonymous
eft access. Unknown user ids frequently occur as many clients
insert some dummy user name in the t_associate request if no
user name was configured.
-V Prints version.
-? prints usage message.
FEATURES
The server supports most of the EUROFILE primitives, including
navigation and extended directory format. However, T-RENAME, T-DELETE,
and LIST are not supported yet.
If eftd is compiled with the CONFIG_EFTD_WUAUTH option, user access is
granted using an authentication procedure derived from wu-ftpd, the
Washington University ftp server. Refer to the eft_wuauth man page for
further details.
Transfers can be logged to /var/log/eft_xferlog. The format of this
file is compatible with the wu-ftpd xferlog format. Refer to the
eft_xferlog man page for details. Also see event logging below.
eftd can also be invoked (and then stopped) by means of the
/etc/init.d/isdneurofile shell script:
/etc/init.d/isdneurofile start|stop
This script reads configuration parameters (usually from
/etc/isdn/eft.conf). You might want to edit this file before starting
it.
Besides starting eftd, the script also takes care of setting up the
necessary isdn network interfaces. The script can be used by sysvinit
to automatically start eft service as part of the system boot
precedure. (But make sure it is called after isdn and x25 modules are
loaded).
TRANSFER NAMES
The EUROFILE protocol identifies files to be transferred by means of a
so called ‘transfer name’. According to ETS 300-383/ETS 300-075, a
transfer name may constist up to 8 keywords separated by the ’/’
character. Each keyword may constist of up to 12 printable (between
0x21 and 0x7e) ascii characters except ’(’, ’)’, ’*’, bytes.
The transfer names generated by eftd (and which will be displayed in
response to a T-Directory request) will always conform to this.
eftd will also accept transfer names within incoming request (T-Load
and T-Save request) that do not conform to the standards. If a
transfer name in an incoming request is valid, it is processed by a
mapping procedure which resolves to a file name. Transfer names not
conforming to the standard are not subject to mapping. They are treated
literally as POSIX filenames.
TRANSFER NAME MAPPING
eftd maps transfer names to file names by means of two different
methods. If the current working directory is writable by the user, a
database is used that maps between transfer names and file names.
The database is currently implemented by means of symlinks which are
created in the working directory. Symlinks matching
.++eft_fn.TRANSFER_NAME contain the file name corresponding to
TRANSFER_NAME. Symlinks matching .++eft_tn.FILE_NAME contain the
transfer name name corresponding to FILE_NAME. You can clean tha
database by just removing all those symlinks (rm .++eft_[ft]n.*).
If the directory is not writable by the user, an algorithm based ob the
file/transfer name and the file’s inode number is used to map between
transfer names and file names.
EVENT LOGGING
eftd provides for two event logging channels. The first is always
stderr, the other is the so called LogBook file (an ETS 300 383 term)
(which might be altered by means of the -b option)
The amount of events logged can be controlled by a log level, which may
be supplied by means of the -d (for stderr channel) or the -l (for
LogBook file channel). An even finer grained (but even less portable)
control is possible by means of bitmask arguments supplied with the -D
or -L option.
For debugging purpose, it is somtimes helpful to write the standard
error messages syncronized with the logged events into the same stream.
Thus, for generating debugging logs, it is preferable to use the stderr
channel. For debugging certain very low (i.e. Linux kernel) level
protocol problems, it is even desirable to write the isdn events (as
read from /dev/isdnctrl) to the same stream. eftd provides for a -I
option to achieve this goal as close as possible (however, synchronity
cannot be granted here).
Wenn large log levels are used, huge amounts of stderr output will be
generated. Thus you might consider to redirect stderr to a disk file in
such a case.
Writing to a log file might block the eftd process, which might result
in timing problems if the process is blocked for a very long (several
seconds) time. Thus, it is not advisable to log events to files (i.e.
located on unreliable NFS servers) which are likly to cause such
blocking.
INTERWORKING PROBLEMS
The majority of DOS/Windows based clients implicitly assume that file
transfer names fulfil DOS file name conventions and don’t distinguish
between upper and lower case names. This is in violation to the ETSI
norms and might cause inter-working problems. The server provides for
a compatibility mode to inter-operate with such clients. In order to
activate that compatibility mode, prepend a ’+’ character to the login
name when connecting to the server. See the doc/INTERWOKING file for
details.
If you intend to offer files for public download via eft, it is
recommended to use file names that match DOS conventions only.
RESTRICTIONS (also called BUGS :-)
Renaming and deleting (T-RENAME, T-DELETE) of files is not supported
yet. The S-LIST primitive (recursivly listing all directories) is not
supported.
Compression is not supported. This is not a serious limitation nowadays
because on-disk compression formats like [g]zip are widley available,
compress better, and also save disk storage. When eftp has established
the connection, it issues the "eftp>" prompt and waits for commands
that will be read from standard input. Interactive input can be edited
by means of the GNU readline library.
AUTHOR
manpage written from usage text file by Paul Slootman
<paul@debian.org>.
eftd(8)