X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?p=netatalk.git;a=blobdiff_plain;f=man%2Fman5%2Fafp.conf.5.in;h=2cac69d423e9eb0ecc96d254e5ad015c5f26f4fa;hp=90ac57ac921273f22f2725e4e455ab16083de163;hb=15adf47aa5b6272ff29b6cbfdd98c083ba877c1c;hpb=21058d44aabd9f97e2edfd245770584412c30f2d diff --git a/man/man5/afp.conf.5.in b/man/man5/afp.conf.5.in index 90ac57ac..2cac69d4 100644 --- a/man/man5/afp.conf.5.in +++ b/man/man5/afp.conf.5.in @@ -2,12 +2,12 @@ .\" Title: afp.conf .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.78.0 -.\" Date: 30 Apr 2013 +.\" Date: 13 Sep 2013 .\" Manual: @NETATALK_VERSION@ .\" Source: @NETATALK_VERSION@ .\" Language: English .\" -.TH "AFP\&.CONF" "5" "30 Apr 2013" "@NETATALK_VERSION@" "@NETATALK_VERSION@" +.TH "AFP\&.CONF" "5" "13 Sep 2013" "@NETATALK_VERSION@" "@NETATALK_VERSION@" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -424,6 +424,8 @@ afp listen = \fIip address[:port] [ip address[:port] \&.\&.\&.]\fR \fB(G)\fR Specifies the IP address that the server should advertise \fBand\fR listens to\&. The default is advertise the first IP address of the system, but to listen for any incoming request\&. The network address may be specified either in dotted\-decimal format for IPv4 or in hexadecimal format for IPv6\&. +.sp +IPv6 address + port combination must use URL the format using square brackets [IPv6]:port .RE .PP afp port = \fIport number\fR \fB(G)\fR @@ -470,7 +472,7 @@ Sets the maximum number of clients that can simultaneously connect to the server .PP server quantum = \fInumber\fR \fB(G)\fR .RS 4 -This specifies the DSI server quantum\&. The default value is 1 MB\&. The maximum value is 0xFFFFFFFFF, the minimum is 32000\&. If you specify a value that is out of range, the default value will be set\&. Do not change this value unless you\*(Aqre absolutely sure, what you\*(Aqre doing +This specifies the DSI server quantum\&. The default value is 0x100000 (1 MiB)\&. The maximum value is 0xFFFFFFFFF, the minimum is 32000\&. If you specify a value that is out of range, the default value will be set\&. Do not change this value unless you\*(Aqre absolutely sure, what you\*(Aqre doing .RE .PP sleep time = \fInumber\fR \fB(G)\fR @@ -566,6 +568,16 @@ Sets a message to be displayed when clients logon to the server\&. The message s and should be quoted\&. Extended characters are allowed\&. .RE .PP +ignored attributes = \fIall | nowrite | nodelete | norename\fR \fB(G)/(V)\fR +.RS 4 +Speficy a set of file and directory attributes that shall be ignored by the server, +\fBall\fR +includes all the other options\&. +.sp +In OS X when the Finder sets a lock on a file/directory or you set the BSD uchg flag in the Terminal, all three attributes are used\&. Thus in order to ignore the Finder lock/BSD uchg flag, add set +\fIignored attributes = all\fR\&. +.RE +.PP mimic model = \fImodel\fR \fB(G)\fR .RS 4 Specifies the icon model that appears on clients\&. Defaults to off\&. Note that afpd must support Zeroconf\&. Examples: RackMac (same as Xserve), PowerBook, PowerMac, Macmini, iMac, MacBook, MacBookPro, MacBookAir, MacPro, AppleTV1,1, AirPort\&. @@ -583,6 +595,16 @@ solaris share reservations = \fIBOOLEAN\fR (default: \fIyes\fR) \fB(G)\fR Use share reservations on Solaris\&. Solaris CIFS server uses this too, so this makes a lock coherent multi protocol server\&. .RE .PP +spotlight = \fIBOOLEAN\fR (default: \fIno\fR) \fB(G)/(V)\fR +.RS 4 +Whether to enable Spotlight searches\&. Note: once the global option is enabled, any volume that is not enabled won\*(Aqt be searchable at all\&. +.RE +.PP +veto message = \fIBOOLEAN\fR (default: \fIno\fR) \fB(G)\fR +.RS 4 +Send optional AFP messages for vetoed files\&. Then whenever a client tries to access any file or directory with a vetoed name, it will be sent an AFP message indicating the name and the directory\&. +.RE +.PP vol dbpath = \fIpath\fR \fB(G)\fR .RS 4 Sets the database information to be stored in path\&. You have to specify a writable location, even if the volume is read only\&. The default is @@ -802,6 +824,11 @@ ldap name attr = \fIdn\fR \fB(G)\fR Name of the LDAP attribute with the users short name\&. .RE .PP +ldap group attr = \fIdn\fR \fB(G)\fR +.RS 4 +Name of the LDAP attribute with the groups short name\&. +.RE +.PP ldap uuid string = \fISTRING\fR \fB(G)\fR .RS 4 Format of the uuid string in the directory\&. A series of x and \-, where every x denotes a value 0\-9a\-f and every \- is a separator\&. @@ -812,6 +839,11 @@ Default: xxxxxxxx\-xxxx\-xxxx\-xxxx\-xxxxxxxxxxxx ldap uuid encoding = \fIstring | ms\-guid (default: string)\fR \fB(G)\fR .RS 4 Format of the UUID of the LDAP attribute, allows usage of the binary objectGUID fields from Active Directory\&. If left unspecified, string is the default, which passes through the ASCII UUID returned by most other LDAP stores\&. If set to ms\-guid, the internal UUID representation is converted to and from the binary format used in the objectGUID attribute found on objects in Active Directory when interacting with the server\&. +.sp +See also the options +\fBldap user filter\fR +and +\fBldap group filter\fR\&. .PP string .RS 4 @@ -824,9 +856,20 @@ Binary objectGUID from Active Directory .RE .RE .PP -ldap group attr = \fIdn\fR \fB(G)\fR +ldap user filter = \fISTRING (default: unused)\fR \fB(G)\fR .RS 4 -Name of the LDAP attribute with the groups short name\&. +Optional LDAP filter that matches user objects\&. This is necessary for Active Directory environments where users and groups are stored in the same directory subtree\&. +.sp +Recommended setting for Active Directory: +\fIobjectClass=user\fR\&. +.RE +.PP +ldap group filter = \fISTRING (default: unused)\fR \fB(G)\fR +.RS 4 +Optional LDAP filter that matches group objects\&. This is necessary for Active Directory environments where users and groups are stored in the same directory subtree\&. +.sp +Recommended setting for Active Directory: +\fIobjectClass=group\fR\&. .RE .SH "EXPLANATION OF VOLUME PARAMETERS" .SS "Parameters" @@ -1044,6 +1087,13 @@ is performed when accessing filesystems from clients\&. This is generally useful on volumes and do the conversion with that\&. Then this option can be set to no\&. .RE .PP +delete veto files = \fIBOOLEAN\fR (default: \fIno\fR) \fB(V)\fR +.RS 4 +This option is used when Netatalk is attempting to delete a directory that contains one or more vetoed files or directories (see the veto files option)\&. If this option is set to no (the default) then if a directory contains any non\-vetoed files or directories then the directory delete will fail\&. This is usually what you want\&. +.sp +If this option is set to yes, then Netatalk will attempt to recursively delete any files and directories within the vetoed directory\&. +.RE +.PP follow symlinks = \fIBOOLEAN\fR (default: \fIno\fR) \fB(V)\fR .RS 4 The default setting is false thus symlinks are not followed on the server\&. This is the same behaviour as OS X\*(Aqs AFP server\&. Setting the option to true causes afpd to follow symlinks on the server\&. symlinks may point outside of the AFP volume, currently afpd doesn\*(Aqt do any checks for "wide symlinks"\&.