[net-next-2.6.git] / fs / cifs / TODO

version 1.32 April 3, 2005

A Partial List of Missing Features
==================================

Contributions are welcome.  There are plenty of opportunities
for visible, important contributions to this module.  Here
is a partial list of the known problems and missing features:

a) Support for SecurityDescriptors for chmod/chgrp/chown so
these can be supported for Windows servers

b) Better pam/winbind integration (e.g. to handle uid mapping
better)

c) multi-user mounts - multiplexed sessionsetups over single vc
(ie tcp session) - more testing needed

d) Kerberos/SPNEGO session setup support - (started)

e) NTLMv2 authentication (mostly implemented)

f) MD5-HMAC signing SMB PDUs when SPNEGO style SessionSetup 
used (Kerberos or NTLMSSP). Signing alreadyimplemented for NTLM
and raw NTLMSSP already. This is important when enabling
extended security and mounting to Windows 2003 Servers

f) Directory entry caching relies on a 1 second timer, rather than 
using FindNotify or equivalent.  - (started)

g) A few byte range testcases fail due to POSIX vs. Windows/CIFS
style byte range lock differences

h) quota support

j) finish writepages support (multi-page write behind for improved
performance) and syncpage

k) hook lower into the sockets api (as NFS/SunRPC does) to avoid the
extra copy in/out of the socket buffers in some cases.

l) finish support for IPv6.  This is mostly complete but
needs a simple conversion of ipv6 to sin6_addr from the
address in string representation.

m) Better optimize open (and pathbased setfilesize) to reduce the
oplock breaks coming from windows srv.  Piggyback identical file
opens on top of each other by incrementing reference count rather
than resending (helps reduce server resource utilization and avoid
spurious oplock breaks).

o) Improve performance of readpages by sending more than one read
at a time when 8 pages or more are requested. In conjuntion
add support for async_cifs_readpages.

p) Add support for storing symlink and fifo info to Windows servers 
in the Extended Attribute format their SFU clients would recognize.

q) Finish fcntl D_NOTIFY support so kde and gnome file list windows
will autorefresh (started)

r) Add GUI tool to configure /proc/fs/cifs settings and for display of
the CIFS statistics (started)

q) implement support for security and trusted categories of xattrs
(requires minor protocol extension) to enable better support for SELINUX

r) Implement O_DIRECT flag on open (already supported on mount)

s) Allow remapping of last remaining character (\) to +0xF000 which
(this character is valid for POSIX but not for Windows)

KNOWN BUGS (updated April 3, 2005)
====================================
See http://bugzilla.samba.org - search on product "CifsVFS" for
current bug list.

1) existing symbolic links (Windows reparse points) are recognized but
can not be created remotely. They are implemented for Samba and those that
support the CIFS Unix extensions, although earlier versions of Samba
overly restrict the pathnames.
2) follow_link and readdir code does not follow dfs junctions
but recognizes them
3) create of new files to FAT partitions on Windows servers can
succeed but still return access denied (appears to be Windows 
server not cifs client problem) and has not been reproduced recently.
NTFS partitions do not have this problem.
4) debug connectathon lock test case 10 which fails against
Samba (may be unmappable due to POSIX to Windows lock model
differences but worth investigating).  Also debug Samba to 
see why lock test case 7 takes longer to complete to Samba
than to Windows.

Misc testing to do
==================
1) check out max path names and max path name components against various server
types. Try nested symlinks (8 deep). Return max path name in stat -f information

2) Modify file portion of ltp so it can run against a mounted network
share and run it against cifs vfs.

3) Additional performance testing and optimization using iozone and similar - 
there are some easy changes that can be done to parallelize sequential writes,
and when signing is disabled to request larger read sizes (larger than 
negotiated size) and send larger write sizes to modern servers.

4) More exhaustively test against less common servers.  More testing
against Windows 9x, Windows ME servers.
Commit	Line	Data
6a0b4824	1	version 1.32 April 3, 2005
1da177e4 LT	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) Support for SecurityDescriptors for chmod/chgrp/chown so
	11	these can be supported for Windows servers
	12
	13	b) Better pam/winbind integration (e.g. to handle uid mapping
	14	better)
	15
	16	c) multi-user mounts - multiplexed sessionsetups over single vc
6a0b4824	17	(ie tcp session) - more testing needed
1da177e4 LT	18
	19	d) Kerberos/SPNEGO session setup support - (started)
	20
	21	e) NTLMv2 authentication (mostly implemented)
	22
	23	f) MD5-HMAC signing SMB PDUs when SPNEGO style SessionSetup
	24	used (Kerberos or NTLMSSP). Signing alreadyimplemented for NTLM
	25	and raw NTLMSSP already. This is important when enabling
	26	extended security and mounting to Windows 2003 Servers
	27
	28	f) Directory entry caching relies on a 1 second timer, rather than
	29	using FindNotify or equivalent. - (started)
	30
	31	g) A few byte range testcases fail due to POSIX vs. Windows/CIFS
	32	style byte range lock differences
	33
	34	h) quota support
	35
	36	j) finish writepages support (multi-page write behind for improved
	37	performance) and syncpage
	38
	39	k) hook lower into the sockets api (as NFS/SunRPC does) to avoid the
	40	extra copy in/out of the socket buffers in some cases.
	41
	42	l) finish support for IPv6. This is mostly complete but
	43	needs a simple conversion of ipv6 to sin6_addr from the
	44	address in string representation.
	45
	46	m) Better optimize open (and pathbased setfilesize) to reduce the
	47	oplock breaks coming from windows srv. Piggyback identical file
	48	opens on top of each other by incrementing reference count rather
	49	than resending (helps reduce server resource utilization and avoid
	50	spurious oplock breaks).
	51
	52	o) Improve performance of readpages by sending more than one read
	53	at a time when 8 pages or more are requested. In conjuntion
	54	add support for async_cifs_readpages.
	55
	56	p) Add support for storing symlink and fifo info to Windows servers
	57	in the Extended Attribute format their SFU clients would recognize.
	58
	59	q) Finish fcntl D_NOTIFY support so kde and gnome file list windows
	60	will autorefresh (started)
	61
	62	r) Add GUI tool to configure /proc/fs/cifs settings and for display of
	63	the CIFS statistics (started)
	64
	65	q) implement support for security and trusted categories of xattrs
	66	(requires minor protocol extension) to enable better support for SELINUX
	67
	68	r) Implement O_DIRECT flag on open (already supported on mount)
	69
737b758c SF	70	s) Allow remapping of last remaining character (\) to +0xF000 which
	71	(this character is valid for POSIX but not for Windows)
	72
6a0b4824	73	KNOWN BUGS (updated April 3, 2005)
1da177e4	74	====================================
6a0b4824 SF	75	See http://bugzilla.samba.org - search on product "CifsVFS" for
	76	current bug list.
	77
1da177e4 LT	78	1) existing symbolic links (Windows reparse points) are recognized but
1da177e4 LT	79	can not be created remotely. They are implemented for Samba and those that
6a0b4824 SF	80	support the CIFS Unix extensions, although earlier versions of Samba
6a0b4824 SF	81	overly restrict the pathnames.
1da177e4 LT	82	2) follow_link and readdir code does not follow dfs junctions
	83	but recognizes them
	84	3) create of new files to FAT partitions on Windows servers can
	85	succeed but still return access denied (appears to be Windows
	86	server not cifs client problem) and has not been reproduced recently.
	87	NTFS partitions do not have this problem.
	88	4) debug connectathon lock test case 10 which fails against
	89	Samba (may be unmappable due to POSIX to Windows lock model
	90	differences but worth investigating). Also debug Samba to
	91	see why lock test case 7 takes longer to complete to Samba
	92	than to Windows.
	93
	94	Misc testing to do
	95	==================
	96	1) check out max path names and max path name components against various server
	97	types. Try nested symlinks (8 deep). Return max path name in stat -f information
	98
	99	2) Modify file portion of ltp so it can run against a mounted network
	100	share and run it against cifs vfs.
	101
	102	3) Additional performance testing and optimization using iozone and similar -
	103	there are some easy changes that can be done to parallelize sequential writes,
	104	and when signing is disabled to request larger read sizes (larger than
	105	negotiated size) and send larger write sizes to modern servers.
	106
6a0b4824 SF	107	4) More exhaustively test against less common servers. More testing
6a0b4824 SF	108	against Windows 9x, Windows ME servers.