table of contents
other languages
ftpaccess(5) | File Formats Manual | ftpaccess(5) |
NAME¶
ftpaccess - ftpd的配置档描述 DESCRIPTION¶
这个ftpaccess档案是用来配置下述功能的运作- autogroup<群组名称><类别>[<类别>...]
- 如果一个匿名的(ANONYMOUS)使用者是任何<类别>的成员,那麽ftp伺服器将会实行一次setegid()到该<群组名称>。这允许特殊类别的匿名使用者存取group-and-owner-read-only的档案以及目录。<群组名称>是/etc/group里的一个有效群组(或是你的getgrent()呼叫所查阅的地方)。
- class<类别><类型列表><全球位址>[<全球位址>...]
- 定义使用者的<类别>,使用<全球位址>格式的来源位址。可以定义<类别>多个成员。可以有多个"class"指令列出该类别额外的成员。如果多个"calss"指令可以应用到该次的连线期间,会使用在access档案中第一个列出的。尝试为一台主机定义一个有效的类别失败的话将会引起存取被拒绝。<类型列表>是一个以任何"anonymous","guest"及"real"关键字所组成使用逗点隔开的列表。如果包含"real"关键字,该类别可以符合使用FTP存取真实的帐号的使用者,而如果包含"anonymous"关键字该类别可以符合使用匿名FTP的使用者。而"guest"关键字符合访客存取帐号(参阅"guestgroup"以取得更多资讯)
<全球位址>可以是一个全球的领域名称或是一个全球的数字 位址。
- deny<全球位址><讯息档案>
- 永远拒绝符合<全球位址>主机的存取。显示<讯息档案>。<全球位址>可以是"!nameserved"用来拒绝没有名称伺服器服务中的节点的存取。
- guestgroup<群组名称>[<群组名称>...]
- 如果一个真实的(REAL)使用者是任何<群组名称>的成员,该次连线期间的设立完全如同匿名的FTP一般。换句话说,会执行一次chroot(),而且该使用者不再被允许发出USER及PASS指令。<群组名称>是/etc/group里的一个有效群组(或是你的getgrent()呼叫所查阅的地方)。
guest1::100:92:Guest Account:/ftp/./incoming:/etc/ftponly
-
limit<类别><时间><讯息档案> - 在某<时间>将某<类别>限制为个使用者,若使用者的存取被拒绝则显示<讯息档案>内容。限制的检查只在签入时期实行。如果多个"limit"指令可以应用到该次连线期间的话,会使用第一个适合的。尝试定义一个有效的限制失败,或是值为-1的限制,等於不设限。<时间>使用UUCPL.sys档案相同的格式。
- loginfails<数字>
- 在<数字>签入失败後,记录一个重复签入失败(repeated
loginfailures)讯息并且终止该FTP连线。预设值是5。
- private
- 使用者签入之後,SITEGROUP及SITEGPASS指令可以用来指定一增强存取的群组以及与之有关的密码。如果该群组名称以及密码是有效的,该使用者变成(经由setegid())一个在群组存取档案/etc/ftpgroups中所指定群组的成员。
- banner<路径>
- 作用与message指令类似,除了此banner是在使用者键入使用者名称/密码之前显示以外。该<路径>系相对於真实的系统根目录,不是匿名FTP所使用的根目录。
- email<名称>
- 定义ftp档案处(archive)维护者的电子邮递位址。这个字串将会在每一次使用%E代换变数(magiccookie)的时候印出。
- message<路径>{<时机>{<类别>...}}
- 定义一个配合<路径>的档案名称在使用者签入时或是在使用切换工作目录指令的时候ftpd将会显示该档案的内容。该项<时机>参数可以是"LOGIN"或"CWD=<目录>"。如果<时机>是"CWD=<目录>"的话,<目录>指定将会引发该通知的新预设目录。
- %T
- 本地时间(form ThuNov1517:12:42 1990)
- %F
- CWD所在分割区的剩馀空间(kbytes)[并非所有系统都有支援]
- %C
- 目前的工作目录
- %E
- 定义在ftpaccess中维护者的电子邮递位址
- %R
- 远端主机名称
- %L
- 本地主机名称
- %U
- 签入时所给的使用者名称
- %M
- 这个类别所允许的最大使用者数目
- %N
- 这个类别目前的使用者数目
- readme<路径>{<时机>{<类别>}}
- 定义一个配合<路径>的档案名称在使用者签入时或是在使用切换工作目录指令的时候ftpd将会告知使用者该档案存在及修改的日期。<时机>参数可以是"LOGIN"或"CWD=<目录>"。若<时机>是"CWD=<目录>"的话,<目录>指定将会引发该通知的新预设目录。此项讯息将只显示一次以避免打扰使用者。要记得当README讯息被一匿名的FTP使用者引发时,该<路径>必须是相对於匿名FTP目录树的根目录。
- logcommands<类型列表>
- 以使用者启动个别的记录指令。<类型列表>是一个以任何的"anonymous","guest"及"real"关键字所组成使用逗点隔开的列表。如果包含"real"关键字,将会为使用FTP存取真实帐号的使用者做记录,而如果包含"anonymous"关键字则将会为使用匿名FTP的使用者做记录。"guest"关键字符合访客存取帐号(参阅"guestgroup"以取得更多资讯)
- logtransfers<类型列表><目录>
- 启动对真实的或匿名的FTP使用者的档案传输记录。对传输到伺服器(进来)的记录可以跟从伺服器传输(出去)分开来启动。<类型列表>是一个以任何的"anonymous","guest"及"real"关键字所组成使用逗点隔开的列表。如果其中包含有"real"关键字,将会为使用FTP存取真实帐号的使用者做记录,而如果包含"anonymous"关键字则将会为使用匿名FTP的使用者做记录。而"guest"关键字符合访客存取帐号(参阅"guestgroup"以取得更多资讯)。<目录>是一个以任何的"inbound"以及"outbound"两个关键字所组成以逗点隔开的列表,而且将会分别引发对送往该伺服器以及从该伺服器送出的传输记录。
- alias<字串><目录>
- 为一个目录定义一个别名,<字串>。可以用来加入逻辑目录的其它概念。
- cdpath<目录>
- 定义cdpath里的一个项目。这定义一个在改变目录时使用的搜寻路径。
cdpath/pub/packages cdpath/.aliases
cdfoo
-
compress[...]
- tar[...]
为任何符合任何的类别启动压缩(compress)或包裹(tar)功能。实际的转换(conversions)定义在外部的档案FTPLIB/ftpconversions之中。
- shutdown<路径>
- 如果<路径>所指的档案存在,伺服器将会规律地检查该档案以便得知该伺服器是否将要被停机。如果计画一次停机,则会通告使用者,新的连线在停机之前的一段指定的时间之後会被拒绝且目前的连线在停机之前的一段指定的时间之後会被停止。<路径>指到一个结构如下的档案:
<年><月><日><时><分><拒绝_期间><抛弃_期间><本文>
- <年>
- 任何>1970的年份
- <月>
- 0-11<----注意!
- <时>
- 0-23
- <分>
- 0-59
- %s
- 系统将要停机的时间
- %r
- 新的连线将会被拒绝的时间
- %d
- 目前的连线将会被抛弃的时间
-
chmod<类型列表>
- delete<类型列表>
overwrite<类型列表>
umask<类型列表>
允许或不允许执行指定功能的能力。依照预设值,允许所有的使用者执行。
- passwd-check()
- 定义该伺服器对匿名ftp密码检查的层级与执行。
- none
- 不执行密码检查。
- trivial
- 密码中必须包含一个'@'字元。
- rfc822
- 密码必须是一个rfc822相容的位址。
- warn
- 警告该使用者,但是允许他们签入。
- enforce
- 警告该使用者,并且接著将之踢出。
- path-filter<类型列表><讯息><允许的字元集>{<不允许的正规表示式>...}
- 对於属於<类型列表>的使用者,path-filter定义控制何种档案名称允许或不允许的正规表示式(regularexpressions)。可以有多个不允许的正规表示式。如果一个档案名称因为不符合正规表示式的标准而无效的话,将会显示<讯息>给该使用者。例如:
path-filteranonymous/etc/pathmsg^[-A-Za-z0-9._]*$^.^-
- upload<拥有者><群组>["dirs"|"nodirs"]
- 配合定义一个认可或拒绝上传的目录。
upload*no upload/incomingyesftpdaemon0666 upload/incoming/gifsyesjlcguest0600 nodirs