X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=man%2Fman5%2Fafp.conf.5.tmpl;h=d2bbf43a3a74b6cc12e88cd04c53b124dceb485a;hb=31bda62b05fe69efe7d54188c74dcee936064f4d;hp=e12561a2eb963fc05136e7a5b47f361e94322fb1;hpb=f5bd1a2be184f7c58d6117c5c2738f52c333378e;p=netatalk.git diff --git a/man/man5/afp.conf.5.tmpl b/man/man5/afp.conf.5.tmpl index e12561a2..d2bbf43a 100644 --- a/man/man5/afp.conf.5.tmpl +++ b/man/man5/afp.conf.5.tmpl @@ -2,12 +2,12 @@ .\" Title: afp.conf .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.75.2 -.\" Date: 22 Nov 2012 +.\" Date: 06 Dez 2012 .\" Manual: Netatalk 3.0 .\" Source: Netatalk 3.0 .\" Language: English .\" -.TH "AFP\&.CONF" "5" "22 Nov 2012" "Netatalk 3.0" "Netatalk 3.0" +.TH "AFP\&.CONF" "5" "06 Dez 2012" "Netatalk 3.0" "Netatalk 3.0" .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- @@ -37,8 +37,8 @@ The file consists of sections and parameters\&. A section begins with the name o .RS 4 .\} .nf -\fIname\fR = \fIvalue \fR - + \fIname\fR = \fIvalue \fR + .fi .if n \{\ .RE @@ -53,7 +53,7 @@ Only the first equals sign in a parameter is significant\&. Whitespace before or Any line beginning with a semicolon (\(lq;\(rq) or a hash (\(lq#\(rq) character is ignored, as are lines containing only whitespace\&. .PP Any line ending in a -\(lq\e\(rq +\(lq \e \(rq is continued on the next line in the customary UNIX fashion\&. .PP The values following the equals sign in parameters are all either a string (no quotes needed) or a boolean, which may be given as yes/no, 1/0 or true/false\&. Case is not significant in boolean values, but is preserved in string values\&. Some items such as create masks are numeric\&. @@ -93,9 +93,8 @@ baz: .RS 4 .\} .nf -[baz] -path = /foo/bar - + [baz] + path = /foo/bar .fi .if n \{\ .RE @@ -124,9 +123,7 @@ The following example illustrates this\&. Given all user home directories are st .RS 4 .\} .nf -[Homes] -path = afp\-data -basedir regex = /home + [Homes] path = afp\-data basedir regex = /home .fi .if n \{\ @@ -232,6 +229,11 @@ prints dollar sign ($) .SH "EXPLANATION OF GLOBAL PARAMETERS" .SS "Authentication Options" .PP +ad domain = \fIDOMAIN\fR \fB(G)\fR +.RS 4 +Append @DOMAIN to username when authenticating\&. Useful in Active Directory environments that otherwise would require the user to enter the full user@domain string\&. +.RE +.PP admin auth user = \fIuser\fR \fB(G)\fR .RS 4 Specifying eg "\fBadmin auth user = root\fR" whenever a normal user login fails, afpd will try to authenticate as the specified @@ -506,30 +508,6 @@ extmap file = \fIpath\fR \fB(G)\fR Sets the path to the file which defines file extension type/creator mappings\&. (default is :ETCDIR:/AppleVolumes\&.system)\&. .RE .PP -fce listener = \fIhost[:port]\fR \fB(G)\fR -.RS 4 -Enables sending FCE events to the specified -\fIhost\fR, default -\fIport\fR -is 12250 if not specified\&. Specifying mutliple listeners is done by having this option once for each of them\&. -.RE -.PP -fce events = \fIfmod,fdel,ddel,fcre,dcre,tmsz\fR \fB(G)\fR -.RS 4 -Speficies which FCE events are active, default is -\fIfmod,fdel,ddel,fcre,dcre\fR\&. -.RE -.PP -fce coalesce = \fIall|delete|create\fR \fB(G)\fR -.RS 4 -Coalesce FCE events\&. -.RE -.PP -fce holdfmod = \fIseconds\fR \fB(G)\fR -.RS 4 -This determines the time delay in seconds which is always waited if another file modification for the same file is done by a client before sending an FCE file modification event (fmod)\&. For example saving a file in Photoshop would generate multiple events by itself because the application is opening, modifying and closing a file mutliple times for every "save"\&. Defautl: 60 seconds\&. -.RE -.PP guest account = \fIname\fR \fB(G)\fR .RS 4 Specifies the user that guests should use (default is "nobody")\&. The name should be quoted\&. @@ -591,9 +569,9 @@ Max length of UTF8\-MAC volume name for Mac OS X\&. Note that Hangul is especial .RS 4 .\} .nf -73: limit of Mac OS X 10\&.1 -80: limit of Mac OS X 10\&.4/10\&.5 (default) -255: limit of recent Mac OS X + 73: limit of Mac OS X 10\&.1 80: limit of Mac + OS X 10\&.4/10\&.5 (default) 255: limit of recent Mac OS + X .fi .if n \{\ .RE @@ -644,6 +622,33 @@ Both logtype and loglevels are case insensitive\&. .sp .5v .RE .RE +.SS "Filesystem Change Events (FCE)" +.PP +Netatalk includes a nifty filesystem change event mechanism where afpd processes notfiy interested listeners about certain filesytem event by UDP network datagrams\&. +.PP +fce listener = \fIhost[:port]\fR \fB(G)\fR +.RS 4 +Enables sending FCE events to the specified +\fIhost\fR, default +\fIport\fR +is 12250 if not specified\&. Specifying mutliple listeners is done by having this option once for each of them\&. +.RE +.PP +fce events = \fIfmod,fdel,ddel,fcre,dcre,tmsz\fR \fB(G)\fR +.RS 4 +Speficies which FCE events are active, default is +\fIfmod,fdel,ddel,fcre,dcre\fR\&. +.RE +.PP +fce coalesce = \fIall|delete|create\fR \fB(G)\fR +.RS 4 +Coalesce FCE events\&. +.RE +.PP +fce holdfmod = \fIseconds\fR \fB(G)\fR +.RS 4 +This determines the time delay in seconds which is always waited if another file modification for the same file is done by a client before sending an FCE file modification event (fmod)\&. For example saving a file in Photoshop would generate multiple events by itself because the application is opening, modifying and closing a file mutliple times for every "save"\&. Defautl: 60 seconds\&. +.RE .SS "Debug Parameters" .PP These options are useful for debugging only\&. @@ -804,9 +809,19 @@ Useful for Time Machine: limits the reported volume size, thus preventing Time M This is an approimated calculation taking into accout the contents of Time Machine sparsebundle images\&. Therefor you MUST NOT use this volume to store other content when using this option, because it would NOT be accounted\&. The calculation works by reading the band size from the Info\&.plist XML file of the sparsebundle, reading the bands/ directory counting the number of band files, and then multiplying one with the other\&. .RE .PP -valid users = \fIusers/groups\fR \fB(V)\fR +valid users = \fIuser @group\fR \fB(V)\fR .RS 4 -The allow option allows the users and groups that access a share to be specified\&. Users and groups are specified, delimited by spaces or commas\&. Groups are designated by a @ prefix\&. Example: "valid users = user1 user2 @group" +The allow option allows the users and groups that access a share to be specified\&. Users and groups are specified, delimited by spaces or commas\&. Groups are designated by a @ prefix\&. Names may be quoted in order to allow for spaces in names\&. Example: +.sp +.if n \{\ +.RS 4 +.\} +.nf +valid users = user "user 2" @group \(lq@group 2" +.fi +.if n \{\ +.RE +.\} .RE .PP invalid users = \fIusers/groups\fR \fB(V)\fR @@ -912,8 +927,8 @@ is for directories only\&. Don\'t use with "\fBunix priv = no\fR"\&. .RS 4 .\} .nf -file perm = 0660 -directory perm = 0770 +file perm = 0660 directory perm = + 0770 .fi .if n \{\ .RE