summaryrefslogtreecommitdiffstats
path: root/contrib/lukemftpd/README
blob: 60d645fbd7fdb98794ff8b0b8e017d9b50e7d08e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
WHAT IS LUKEMFTPD?
------------------

`lukemftpd' is what many users affectionately call the enhanced ftp
server in NetBSD (http://www.netbsd.org).  The `lukem' comes from
the account name of the NetBSD developer who wrote most of the
enhancements: Luke Mewburn <lukem@netbsd.org>.

This package is a `port' of the NetBSD ftp server to other systems.

The enhancements over the standard ftp server in 4.4BSD (and derivatives)
include:
	* command line options:
		+ allow override of directory used by anonymous ftp (-a)
		+ optional change of directory for configuration files (-c)
		+ check whether a user would be granted access (-C)
		+ specify email address for display messages (-e)
		+ change hostname advertised as (-h, -H)
		+ specify data port to listen on (-P)
		+ keep track of the number of users logged in (-q, -Q)
		+ permanently drop privileges (-r)
		+ specify version advertised (-V)
		+ log wu-ftpd style `xferlog' entries to syslog (-X)

	* % escape sequences in files displayed to users (/etc/motd,
	  /etc/ftpwelcome, ...)

	* IPv6 support (from the KAME project).

	* ftpusers(5) control of who may log in, and optional
	  specification of a "class" to be associated with the
	  specified user or group.

	* ftpd.conf(5) to control various configuration options on
	  a per-class basis.  The following options are supported:
		+ address to advertise in PASV and LPSV responses
		+ check the PORT command for validity
		+ specify the directory to chroot(2) to
		+ automatic in-line conversions (e.g, `.tar.gz'
		  retrieval of directories)
		+ display a file the first time a directory is entered
		+ specify the home directory of the session (for "cd ~")
		+ limit the maximum number of concurrent sessions
		+ limit the maximum size of an uploaded file
		+ set the default timeout and restrict the maximum
		  timeout that a user may request
		+ deny user from running the CHMOD, DELE, MKD, RMD, RNFR
		  and UMASK commands
		+ specify the motd(5) file to display upon login
		+ specify a glob(3) pattern of files to notify a user
		  of the existance of once a directory is entered
		+ enable/disable the use of PASV and EPSV connections
		+ limit the ports that PORT and LPRT may bind to
		+ limit the transfer rate of transfers
		+ limit the characters that may be used in an uploaded
		  filename
		+ set the umask
		+ deny user from running APPE, STOR and STOU as well
		  as CHMOD, ...

	* In-built copy of ls(1) to implement LIST (unless disabled
	  out with --disable-builtinls), so that /bin/ls does not need
	  to exist inside the ftp tree.

	* Virtual servers can be supported with a combination of
	  ftpd(8) flags and support in the invoking inetd(8) program
	  (such as that in NetBSD).

	* Optional S/Key authentication (if configued with --with-skey).


Features present in NetBSD's ftpd but not yet available in lukemftpd:
	* logging active sessions to utmp(5) (-u, -U)
	* logging completed sessions to wtmp(5) (-w, -W)


INSTALLATION
------------

Refer to `INSTALL' for more information on how to compile and install
lukemftpd.


FEEDBACK / BUG REPORTS
----------------------

Please email feedback back to the maintainer: <lukem@netbsd.org>.


COPYRIGHT
---------

lukemftpd is covered by a BSD-style copyright notice. Please refer to
the file `COPYING' for more information.


AVAILABILITY
------------

The primary ftp site for lukemftpd is:
	ftp://ftp.netbsd.org/pub/NetBSD/misc/lukemftp/
(the same location as lukemftp)
OpenPOWER on IntegriCloud