VFS_FRUIT(8) System Administration tools VFS_FRUIT(8)NAMEvfs_fruit - Enhanced OS X and Netatalk interoperability
SYNOPSIS
vfs objects = fruit
DESCRIPTION
This VFS module is part of the samba(7) suite.
The vfs_fruit module provides enhanced compatibility with Apple SMB
clients and interoperability with a Netatalk 3 AFP fileserver.
The module should be stacked with vfs_catia if enabling character
conversion and must be stacked with vfs_streams_xattr, see the example
section for the correct config.
The module enables alternate data streams (ADS) support for a share,
intercepts the OS X special streams "AFP_AfpInfo" and "AFP_Resource"
and handles them in a special way. All other named streams are deferred
to vfs_streams_xattr which must be loaded together with vfs_fruit.
Having shares with ADS support enabled for OS X client is worthwhile
because it resembles the behaviour of Apple's own SMB server
implementation and it avoids certain severe performance degradations
caused by Samba's case sensitivity semantics.
The OS X metadata and resource fork stream can be stored in a way
compatible with Netatalk 3 by setting fruit:resource = file and
fruit:metadata = netatalk.
OS X maps NTFS illegal characters to the Unicode private range in SMB
requests. By setting fruit:encoding = native, all mapped characters are
converted to native ASCII characters.
Finally, share access modes are optionally checked against Netatalk AFP
sharing modes by setting fruit:locking = netatalk.
This module is not stackable other then described in this manpage.
OPTIONS
fruit:resource = [ file | xattr | stream ]
Controls where the OS X resource fork is stored:
· file (default) - use a ._ AppleDouble file compatible with OS X
and Netatalk
· xattr - use a xattr, requires a filesystem with large xattr
support and a file IO API compatible with xattrs, this boils
down to Solaris and derived platforms and ZFS
· stream - pass the stream on to the next module in the VFS stack
fruit:metadata = [ stream | netatalk ]
Controls where the OS X metadata stream is stored:
· netatalk (default) - use Netatalk compatible xattr
· stream - pass the stream on to the next module in the VFS stack
fruit:locking = [ netatalk | none ]
· none (default) - no cross protocol locking
· netatalk - use cross protocol locking with Netatalk
fruit:encoding = [ native | private ]
Controls how the set of illegal NTFS ASCII character, commonly used
by OS X clients, are stored in the filesystem:
· private (default) - store characters as encoded by the OS X
client: mapped to the Unicode private range
· native - store characters with their native ASCII value
fruit:aapl = yes | no
A global option whether to enable Apple's SMB2+ extension codenamed
AAPL. Default yes. This extension enhances several deficiencies
when connecting from Macs:
· directory enumeration is enriched with Mac relevant filesystem
metadata (UNIX mode, FinderInfo, resource fork size and
effective permission), as a result the Mac client doesn't need
to fetch this metadata individuallly per directory entry
resulting in an often tremendous performance increase.
· The ability to query and modify the UNIX mode of directory
entries.
There's a set of per share options that can be used to disable the
computation of specific Mac metadata in the directory enumeration
context, all are enabled by default:
· readdir_attr:aapl_rsize = true | false
· readdir_attr:aapl_finder_info = true | false
· readdir_attr:aapl_max_access = true | false
fruit:nfs_aces = yes | no
Whether support for querying and modifying the UNIX mode of
directory entries via NFS ACEs is enabled, default yes.
fruit:veto_appledouble = yes | no
Whether ._ AppleDouble files are vetoed which prevents the client
from seing and accessing internal AppleDouble files created by
vfs_fruit itself for the purpose of storing a Mac resource fork.
Vetoing ._ files may break some applications, eg extracting Mac ZIP
archives from Mac clients failes, because they contain ._ files.
Setting this option to false will fix this, but the abstraction
leak of exposing the internally created ._ files may have other
unknown side effects.
The default is yes.
fruit:copyfile = yes | no
Whether to enable OS X specific copychunk ioctl that requests a
copy of a whole file along with all attached metadata.
WARNING: the copyfile request is blocking the client while the
server does the copy.
. The default is no.
EXAMPLES
[share]
vfs objects = catia fruit streams_xattr
fruit:resource = file
fruit:metadata = netatalk
fruit:locking = netatalk
fruit:encoding = native
AUTHOR
The original Samba software and related utilities were created by
Andrew Tridgell. Samba is now developed by the Samba Team as an Open
Source project similar to the way the Linux kernel is developed.
Samba 4.2 12/10/2015 VFS_FRUIT(8)