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