X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?p=netatalk.git;a=blobdiff_plain;f=doc%2Fmanpages%2Fman5%2Fafp.conf.5.xml;h=44e083c282f1f20a757ffaae0eb89ae60d290938;hp=27e8b14e81d3aff738e6a25aeeeea572392e252c;hb=3a84db87064922ad10ac10cc1d6833380e575995;hpb=85f0a9871848c178e301a804c9d9081f3fbaee33 diff --git a/doc/manpages/man5/afp.conf.5.xml b/doc/manpages/man5/afp.conf.5.xml index 27e8b14e..44e083c2 100644 --- a/doc/manpages/man5/afp.conf.5.xml +++ b/doc/manpages/man5/afp.conf.5.xml @@ -5,7 +5,7 @@ 5 - 30 Apr 2013 + 05 Jun 2014 @NETATALK_VERSION@ @@ -157,7 +157,7 @@ VARIABLE SUBSTITUTIONS You can use variables in volume names. The use of variables in paths - is not supported for now. + is limited to $u. @@ -673,10 +673,10 @@ 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're absolutely sure, - what you're doing + 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're + absolutely sure, what you're doing @@ -713,6 +713,24 @@ + + recvfile = BOOLEAN (default: + no) (G) + + + Whether to use splice() on Linux for receiving data. + + + + + splice size = number (default: + 64k) (G) + + + Maximum number of bytes spliced. + + + use sendfile = BOOLEAN (default: yes) (G) @@ -724,6 +742,7 @@ + zeroconf = BOOLEAN (default: yes) (G) @@ -788,6 +807,29 @@ + + chmod request = preserve (default) | ignore | simple + (G/V) + + + Advanced permission control that deals with ACLs. + + + + - UNIX chmod() requests are completely ignored + + + - preserve ZFS ACEs for + named users and groups or POSIX ACL group mask + + + - just to a chmod() as + requested without any extra steps + + + + + close vol = BOOLEAN (default: no) (G) @@ -799,6 +841,44 @@ + + cnid mysql host = MySQL server address + (G) + + + name or address of a MySQL server for use with the mysql CNID + backend. + + + + + cnid mysql user = MySQL user + (G) + + + MySQL user for authentication with the server. + + + + + cnid mysql pw = password + (G) + + + Password for MySQL server. + + + + + cnid mysql db = database name + (G) + + + Name of an existing database for which the specified user + has full privileges. + + + cnid server = ipaddress[:port] (G)/(V) @@ -811,6 +891,16 @@ + + dbus daemon = path + (G) + + + Sets the path to dbus-daemon binary used by Spotlight feature. + The default is /bin/dbus-daemon. + + + dircachesize = number (G) @@ -838,6 +928,22 @@ + + force xattr with sticky bit = + BOOLEAN (default: + no) (G/V) + + + Writing metadata xattr on directories with the + sticky bit set may fail even though we may have write + access to a directory, because if the sticky bit is set + only the owner is allowed to write xattrs. + + By enabling this option Netatalk will write the + metadata xattr as root. + + + guest account = name (G) @@ -858,24 +964,13 @@ - - login message = message - (G)/(V) - - - Sets a message to be displayed when clients logon to the - server. The message should be in and - should be quoted. Extended characters are allowed. - - - ignored attributes = all | nowrite | nodelete | norename (G)/(V) Speficy a set of file and directory attributes that shall - be ignored by the server, all includes all + be ignored by the server, includes all the other options. 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 @@ -884,6 +979,17 @@ + + login message = message + (G)/(V) + + + Sets a message to be displayed when clients logon to the + server. The message should be in and + should be quoted. Extended characters are allowed. + + + mimic model = model (G) @@ -923,26 +1029,109 @@ + + sparql results limit = + NUMBER (default: + UNLIMITED) (G) + + + Impose a limit on the number of results queried from Tracker + via SPARQL queries. + + + + + spotlight = + BOOLEAN (default: + no) (G)/(V) + + + Whether to enable Spotlight searches. Note: once the global + option is enabled, any volume that is not enabled won't be + searchable at all. See also dbus daemon + option. + + + + + spotlight attributes = + COMMA SEPERATED STRING (default: + EMPTY) (G) + + + A list of attributes that are allowed to be used in + Spotlight searches. By default all attributes can be + searched, passing a string limits attributes to elements + of the string. Example: spotlight + attributes = *,kMDItemTextContent + + + + + + spotlight expr = + BOOLEAN (default: + yes) (G) + + + Whether to allow the use of logic expression in + searches. + + + + + start dbus = + BOOLEAN (default: + yes) (G) + + + Whether to start a dbus instance for use with Tracker. + + + + + start tracker = + BOOLEAN (default: + yes) (G) + + + Whether to start Tracker with + tracker-control -s. + + + veto message = BOOLEAN (default: no) (G) - Use section as option preset for all - volumes (when set in the [Global] section) or for one volume (when - set in that volume's section). + 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. vol dbpath = path - (G) + (G)/(V) 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 - @localstatedir@/netatalk/CNID/. + @localstatedir@/netatalk/CNID/$v/. + + + + + vol dbnest = BOOLEAN (default: + no) (G) + + + Setting this option to true brings back Netatalk 2 + behaviour of storing the CNID database in a folder called + .AppleDB inside the volume root of each share. @@ -1131,7 +1320,7 @@ mode. You can adjust this behaviour with the configuration option : - + map acls = none|rights|mode (G) @@ -1314,6 +1503,16 @@ + + ldap group attr = dn + (G) + + + Name of the LDAP attribute with the groups short + name. + + + ldap uuid string = STRING (G) @@ -1339,7 +1538,8 @@ 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. - + See also the options and + . string @@ -1361,14 +1561,27 @@ - ldap group attr = dn + ldap user filter = STRING (default: unused) (G) - 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. + Recommended setting for Active Directory: objectClass=user. + + + ldap group filter = STRING (default: unused) + (G) + + + 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. + Recommended setting for Active Directory: objectClass=group. + + + @@ -1685,7 +1898,8 @@ hide files and directories,where the path matches one of the '/' delimited vetoed names. The veto string must always be - terminated with a '/', eg. "veto1/", "veto1/veto2/". + terminated with a '/', eg. "veto files = veto1/", "veto files = + veto1/veto2/". @@ -1759,6 +1973,10 @@ Setting the option to true causes afpd to follow symlinks on the server. symlinks may point outside of the AFP volume, currently afpd doesn't do any checks for "wide symlinks". + + This option will subtly break when the symlinks point + across filesystem boundaries. +