i n f r a d i g


FTP directive
 
Meaning
(can occur in 'ifftp.txt' file)
  
NOTFTP [0|1]Trivial FTP server
NOFTP [0|1]FTP server
NOFTPS [0|1]FTP+SSL server
TFTP_PORT 69Specifiy port number to use (also note BIND keyword)
FTP_PORT 21Specifiy port number to use (also note BIND keyword)
FTPS_PORT 998Specifiy port number to use (also note BIND keyword)
NOANONYMOUS [0|1] 
LOGF ../data/ftp.logFTP-server log files
LOGFILEFORMAT [clf|eclf|iis|eiis]Specify log file format
TFTPROOT pathRoot document directory for the tftp-server
FTPROOT pathRoot document directory for the ftp-server
USERROOT pathRoot user directory for a virtual host or default
<VHOST hostname>Start mapping virtual host
</VHOST>End mapping virtual host
<VUSER userid>Start mapping virtual user
</VUSER>End mapping virtual user
<VDIR virtual>Start mapping virtual directory for a virtual host or default
</VDIR>End mapping virtual directory
ALIAS accountAlias the virtual user to a real account
DIRECTORY pathSet the physical directory for a virtual host or default
AUTH [userid]Require a userid to log in and read
NOAUTHDon't require a userid to log in and read
MAUTH [userid|*]Require a userid to log in and modify
NOMAUTHDon't require a userid to log in and modify
PERMIT [ip-address|hostname]Grant 'ip-address' or 'hostname' access
EXCLUDE [ip-address|hostname]Deny 'ip-address' or 'hostname' access

NOTFTP [0|1]

If specified then no Trivial FTP service is provided. The server must be stopped for a change in this keyword to take effect.

NOFTP [0|1]

If specified then no FTP service is provided. The server must be stopped for a change in this keyword to take effect.

NOFTPS [0|1]

If specified then no special FTP+SSL service is provided. The server must be stopped for a change in this keyword to take effect.

NOANONYMOUS [0|1]

If specified (or value 1) then no anonymous FTP service is provided.

FTPROOT path

Path to a directory that specifies the top-level for anonymous FTP file access (if the ftp-server is installed).

Note: this path can be a relative path. Forward slashes ('/') are allowed under Windows.

TFTPROOT path

Path to a directory that specifies the top-level for anonymous Trivial FTP file access (if the tftp-server is installed).

Note: this path can be a relative path. Forward slashes ('/') are allowed under Windows.

LOGFILEFORMAT [clf|eclf|iis|eiis]

Specifiy log file format. Default is 'eclf' (extended common log format).

PERMIT [ip-address|hostname|domain]

Specify the IP address, IP mask, hostname or domain of a machine that is allowed access, anyone else must be in a 'hosted' domain. This command can be specified multiple times. A wild-card can be used, for example...
	PERMIT 10.*
	PERMIT domain.com
	PERMIT *.research.mydomain.com

Use the "ORDER PERMIT EXCLUDE" (the default) or "ORDER EXCLUDE PERMIT" to specify processing options.

EXCLUDE [ip-address|ip-mask|hostname|domain]

Specify the IP address, IP mask, hostname or domain of a machine that is NOT allowed relay access. This command can be specified multiple times. A wild-card can be used, for example...
	EXCLUDE 10.0.*.0                 # Training room
	EXCLUDE bdlg3.mydomain.com
will deny a certain subnet relay access.

Use the "ORDER PERMIT EXCLUDE" (the default) or "ORDER EXCLUDE PERMIT" to specify processing options.

<VHOST hostname>

A virtual host can be used to present different web-sites based upon the name that was used to access the machine. For instance a machine may have one IP-address but multiple names (or personalities). Depending upon which one was used then the appropriate response is given. For example...
	<VDIR /demo>
	DIRECTORY ../inetpub/demo
	AUTH *
	</VDIR>

	<VHOST test.mydomain.com>
	<VDIR /demo>
	DIRECTORY ../inetpub/demo-test
	AUTH progs
	AUTH sales
	</VDIR>
	</VHOST>

	<VHOST dev.mydomain.com>
	<VDIR /demo>
	DIRECTORY ../inetpub/demo-dev
	MAUTH progs
	</VDIR>
	</VHOST>

</VHOST>

Ends a virtual host mapping.

USERROOT path

Path to a directory that specifies the top-level for WWW user access (if the web-server is installed). That is, where 'userid' directory is created. If this keyword is not present then user directories are not allowed. The URL 'http://domain/~userid' gets mapped to the directory 'USEROOT/userid/public_html'. The reason for using 'public_html' as the public access point is that this allows the user a private area above it that isn't exposed to the Web and which may be updated by FTP or other means. If the file 'USERROOT/user/.forward' exists then it is used during mail delivery such that a copy of the message is sent to each address listed (one per line) instead of being delivered to the user account. The URL 'ftp://domain/~userid' or FTP remote directory '/~userid' gets mapped to the directory 'USERROOT/userid/public_ftp' by anonymous users (with read-only access) and to 'USERROOT/userid' by the owner (with modify access).

Note: this path can be a relative path. Forward slashes ('/') are allowed under Windows.

<VUSER username>

A virtual user can be used to present a user's directories differently. For example...
	<VUSER test>
	ALIAS u101
	<VDIR /demo>
	AUTH *
	</VDIR>
	<VDIR /dev>
	AUTH progs
	</VDIR>
	</VUSER>

</VUSER>

Ends a virtual user mapping.

ALIAS account

Defines a mapping between a virtual user and a real account. For example...
	<VHOST domain1>
	<VUSER test>
	<ALIAS u101
	</VUSER>
	</VHOST>

	<VHOST domain2>
	<VUSER test>
	<ALIAS u102
	</VUSER>
	</VHOST>

<VDIR virtual>

A virtual directory is the left-most part of the local part of a URL and can be mapped to a separate physical location. It is analogous to a mount point with a network file-system. For example...
	<VDIR /incoming>
	MAUTH *
	</VDIR>
If a <VDIR> definition occurs outside of a <VHOST> definition it applies to the default host. If it occurs inside then it applies to that host only.

</VDIR>

Ends a virtual directory mapping.

DIRECTORY physical

Defines the default mapping between a virtual entity and a physical directory. This keyword is optional.

Note: this path can be a relative path. Forward slashes ('/') are allowed under Windows.

AUTH [userid|userid@|*]

Specify a user that is allowed read access. Can be an alias to allow for groups. Default is everyone has read access. if '*' then any valid userid can access. If blank anonymous access is allowed. If 'userid@' then 'userid@domain' can log in to 'domain'.

MAUTH [userid|userid@|*]

Specify a user that is allowed modify access. Can be an alias to allow for groups. Default is everyone has read access. If '*' then any valid userid can modify. If blank then anonymous access is allowed. If 'userid@' then 'userid@domain' can log in to 'domain'.