Documentation/filesystems/cifs/TODO

   1 Version 2.14 December 21, 2018
   2
   3 A Partial List of Missing Features
   4 ==================================
   5
   6 Contributions are welcome.  There are plenty of opportunities
   7 for visible, important contributions to this module.  Here
   8 is a partial list of the known problems and missing features:
   9
  10 a) SMB3 (and SMB3.1.1) missing optional features:
  11    - multichannel (started), integration with RDMA
  12    - directory leases (improved metadata caching), started (root dir only)
  13    - T10 copy offload ie "ODX" (copy chunk, and "Duplicate Extents" ioctl
  14      currently the only two server side copy mechanisms supported)
  15
  16 b) improved sparse file support
  17
  18 c) Directory entry caching relies on a 1 second timer, rather than
  19 using Directory Leases, currently only the root file handle is cached longer
  20
  21 d) quota support (needs minor kernel change since quota calls
  22 to make it to network filesystems or deviceless filesystems)
  23
  24 e) Additional use cases where we use "compoounding" (e.g. open/query/close
  25 and open/setinfo/close) to reduce the number of roundtrips, and also
  26 open to reduce redundant opens (using deferred close and reference counts more).
  27
  28 f) Finish inotify support so kde and gnome file list windows
  29 will autorefresh (partially complete by Asser). Needs minor kernel
  30 vfs change to support removing D_NOTIFY on a file.
  31
  32 g) Add GUI tool to configure /proc/fs/cifs settings and for display of
  33 the CIFS statistics (started)
  34
  35 h) implement support for security and trusted categories of xattrs
  36 (requires minor protocol extension) to enable better support for SELINUX
  37
  38 i) Add support for tree connect contexts (see MS-SMB2) a new SMB3.1.1 protocol
  39    feature (may be especially useful for virtualization).
  40
  41 j) Create UID mapping facility so server UIDs can be mapped on a per
  42 mount or a per server basis to client UIDs or nobody if no mapping
  43 exists. Also better integration with winbind for resolving SID owners
  44
  45 k) Add tools to take advantage of more smb3 specific ioctls and features
  46 (passthrough ioctl/fsctl for sending various SMB3 fsctls to the server
  47 is in progress, and a passthrough query_info call is already implemented
  48 in cifs.ko to allow smb3 info levels queries to be sent from userspace)
  49
  50 l) encrypted file support
  51
  52 m) improved stats gathering tools (perhaps integration with nfsometer?)
  53 to extend and make easier to use what is currently in /proc/fs/cifs/Stats
  54
  55 n) allow setting more NTFS/SMB3 file attributes remotely (currently limited to compressed
  56 file attribute via chflags) and improve user space tools for managing and
  57 viewing them.
  58
  59 o) mount helper GUI (to simplify the various configuration options on mount)
  60
  61 p) Add support for witness protocol (perhaps ioctl to cifs.ko from user space
  62    tool listening on witness protocol RPC) to allow for notification of share
  63    move, server failover, and server adapter changes.  And also improve other
  64    failover scenarios, e.g. when client knows multiple DFS entries point to
  65    different servers, and the server we are connected to has gone down.
  66
  67 q) Allow mount.cifs to be more verbose in reporting errors with dialect
  68 or unsupported feature errors.
  69
  70 r) updating cifs documentation, and user guide.
  71
  72 s) Addressing bugs found by running a broader set of xfstests in standard
  73 file system xfstest suite.
  74
  75 t) split cifs and smb3 support into separate modules so legacy (and less
  76 secure) CIFS dialect can be disabled in environments that don't need it
  77 and simplify the code.
  78
  79 v) POSIX Extensions for SMB3.1.1 (started, create and mkdir support added
  80 so far).
  81
  82 w) Add support for additional strong encryption types, and additional spnego
  83 authentication mechanisms (see MS-SMB2)
  84
  85 KNOWN BUGS
  86 ====================================
  87 See http://bugzilla.samba.org - search on product "CifsVFS" for
  88 current bug list.  Also check http://bugzilla.kernel.org (Product = File System, Component = CIFS)
  89
  90 1) existing symbolic links (Windows reparse points) are recognized but
  91 can not be created remotely. They are implemented for Samba and those that
  92 support the CIFS Unix extensions, although earlier versions of Samba
  93 overly restrict the pathnames.
  94 2) follow_link and readdir code does not follow dfs junctions
  95 but recognizes them
  96
  97 Misc testing to do
  98 ==================
  99 1) check out max path names and max path name components against various server
 100 types. Try nested symlinks (8 deep). Return max path name in stat -f information
 101
 102 2) Improve xfstest's cifs/smb3 enablement and adapt xfstests where needed to test
 103 cifs/smb3 better
 104
 105 3) Additional performance testing and optimization using iozone and similar -
 106 there are some easy changes that can be done to parallelize sequential writes,
 107 and when signing is disabled to request larger read sizes (larger than
 108 negotiated size) and send larger write sizes to modern servers.
 109
 110 4) More exhaustively test against less common servers
 111
 112 5) Continue to extend the smb3 "buildbot" which does automated xfstesting
 113 against Windows, Samba and Azure currently - to add additional tests and
 114 to allow the buildbot to execute the tests faster. The URL for the
 115 buildbot is: http://smb3-test-rhel-75.southcentralus.cloudapp.azure.com
 116
 117 6) Address various coverity warnings (most are not bugs per-se, but
 118 the more warnings are addressed, the easier it is to spot real
 119 problems that static analyzers will point out in the future).