diff -Npur --exclude=CVS --exclude=*.bak --exclude=*.o --exclude=*.po --exclude=*.so --exclude=.#* --exclude=Makefile --exclude=stamp-h --exclude=configure --exclude=findsmb --exclude=*proto*.h --exclude=build_env.h --exclude=tdbsam2_parse_info.h --exclude=config.* --exclude=bin --exclude=*.configure --exclude=autom4te.cache --exclude=build_options.c* 3_0/docs/docbook/projdoc/VFS.xml 3_0-vfs/docs/docbook/projdoc/VFS.xml --- 3_0/docs/docbook/projdoc/VFS.xml Thu May 1 15:57:30 2003 +++ 3_0-vfs/docs/docbook/projdoc/VFS.xml Mon May 19 08:08:27 2003 @@ -26,15 +26,15 @@ They currently have been tested against To use the VFS modules, create a share similar to the one below. The -important parameter is the vfs object parameter which must point to -the exact pathname of the shared library objects. For example, to log all access +important parameter is the vfs objects parameter where +you can list one or more VFS modules by name. For example, to log all access to files and use a recycle bin: [audit] comment = Audited /data directory path = /data - vfs object = /path/to/audit.so /path/to/recycle.so + vfs objects = audit recycle writeable = yes browseable = yes @@ -45,6 +45,29 @@ The modules are used in the order they a +The modules can be static or shared samba modules. +If no module with the specified name can be found, +a shared module in $LIBDIR/vfs/name.so will be loaded. + + + +Some modules allow multiple instances of them. +You can specify this similar to the example below: + + + [test] + comment = VFS TEST + path = /data + writeable = yes + browseable = yes + vfs objects = example:example1 example example:test + example1: log level = 1 + example: log level = 5 + test: log level = 7 + + + + Further documentation on writing VFS modules for Samba can be found in the Samba Developers Guide. @@ -72,77 +95,72 @@ facility. The following operations are This module is identical with the audit module above except that it sends audit logs to both syslog as well as the smbd log file/s. The -loglevel for this module is set in the smb.conf file. +loglevel for this module is set in the smb.conf file. This module has its own +DEBUG_CLASS named "extd_audit". At loglevel = extd_audit:0, only file +and directory deletions and directory and file creations are logged. At loglevel = extd_audit:1 +file opens are renames and permission changes are logged , while at loglevel = extd_audit:2 file +open and close calls are logged also. + + +fake_perms -The logging information that will be written to the smbd log file is controlled by -the log level parameter in smb.conf. The -following information will be recorded: - - -Extended Auditing Log Information - - - Log LevelLog Details - File and Directory Operations - - - 0Creation / Deletion - 1Create / Delete / Rename / Permission Changes - 2Create / Delete / Rename / Perm Change / Open / Close - - -
- +This module fakes the owner uid and primary group gid to the uid/gid of the current user. +This is usefull when you provide roaming profiles for Windows XP clients +and you didn't want the user to change his profile. +Windows XP clients require that the currently logged in user is the owner of his +roaming profile and that the user has write permissions. +
recycle -A recycle-bin like module. When used any unlink call +A recycle-bin like modules. When used any unlink call will be intercepted and files moved to the recycle -directory instead of being deleted. +directory instead of beeing deleted. Supported options: - vfs_recycle_bin:repository + recycle:repository FIXME - vfs_recycle_bin:keeptree + recycle:keeptree FIXME - vfs_recycle_bin:versions + recycle:versions FIXME - vfs_recycle_bin:touch + recycle:touch FIXME - vfs_recycle_bin:maxsize + recycle:maxsize FIXME - vfs_recycle_bin:exclude + recycle:exclude FIXME - vfs_recycle_bin:exclude_dir + recycle:exclude_dir FIXME - vfs_recycle_bin:noversions + recycle:noversions FIXME diff -Npur --exclude=CVS --exclude=*.bak --exclude=*.o --exclude=*.po --exclude=*.so --exclude=.#* --exclude=Makefile --exclude=stamp-h --exclude=configure --exclude=findsmb --exclude=*proto*.h --exclude=build_env.h --exclude=tdbsam2_parse_info.h --exclude=config.* --exclude=bin --exclude=*.configure --exclude=autom4te.cache --exclude=build_options.c* 3_0/docs/docbook/smbdotconf/vfs/vfsobject.xml 3_0-vfs/docs/docbook/smbdotconf/vfs/vfsobject.xml --- 3_0/docs/docbook/smbdotconf/vfs/vfsobject.xml Thu May 1 16:04:06 2003 +++ 3_0-vfs/docs/docbook/smbdotconf/vfs/vfsobject.xml Thu Jan 1 01:00:00 1970 @@ -1,12 +0,0 @@ - - - This parameter specifies a shared object files that - are used for Samba VFS I/O operations. By default, normal - disk I/O operations are used but these can be overloaded - with one or more VFS objects. - - Default: no value - - diff -Npur --exclude=CVS --exclude=*.bak --exclude=*.o --exclude=*.po --exclude=*.so --exclude=.#* --exclude=Makefile --exclude=stamp-h --exclude=configure --exclude=findsmb --exclude=*proto*.h --exclude=build_env.h --exclude=tdbsam2_parse_info.h --exclude=config.* --exclude=bin --exclude=*.configure --exclude=autom4te.cache --exclude=build_options.c* 3_0/docs/docbook/smbdotconf/vfs/vfsobjects.xml 3_0-vfs/docs/docbook/smbdotconf/vfs/vfsobjects.xml --- 3_0/docs/docbook/smbdotconf/vfs/vfsobjects.xml Thu Jan 1 01:00:00 1970 +++ 3_0-vfs/docs/docbook/smbdotconf/vfs/vfsobjects.xml Mon May 19 12:06:40 2003 @@ -0,0 +1,18 @@ + + vfs objects (S) + This parameter specifies the backend names which + are used for Samba VFS I/O operations. By default, normal + disk I/O operations are used but these can be overloaded + with one or more VFS objects. + + Default : no value + + + + + vfs object (S) + An alias for + vfs objects. + + + diff -Npur --exclude=CVS --exclude=*.bak --exclude=*.o --exclude=*.po --exclude=*.so --exclude=.#* --exclude=Makefile --exclude=stamp-h --exclude=configure --exclude=findsmb --exclude=*proto*.h --exclude=build_env.h --exclude=tdbsam2_parse_info.h --exclude=config.* --exclude=bin --exclude=*.configure --exclude=autom4te.cache --exclude=build_options.c* 3_0/docs/docbook/smbdotconf/vfs/vfsoptions.xml 3_0-vfs/docs/docbook/smbdotconf/vfs/vfsoptions.xml --- 3_0/docs/docbook/smbdotconf/vfs/vfsoptions.xml Thu May 1 16:04:06 2003 +++ 3_0-vfs/docs/docbook/smbdotconf/vfs/vfsoptions.xml Thu Jan 1 01:00:00 1970 @@ -1,12 +0,0 @@ - - - This parameter allows parameters to be passed - to the vfs layer at initialization time. - See also - vfs object. - - Default: no value - - diff -Npur --exclude=CVS --exclude=*.bak --exclude=*.o --exclude=*.po --exclude=*.so --exclude=.#* --exclude=Makefile --exclude=stamp-h --exclude=configure --exclude=findsmb --exclude=*proto*.h --exclude=build_env.h --exclude=tdbsam2_parse_info.h --exclude=config.* --exclude=bin --exclude=*.configure --exclude=autom4te.cache --exclude=build_options.c* 3_0/docs/docbook/smbdotconf/vfs/vfspath.xml 3_0-vfs/docs/docbook/smbdotconf/vfs/vfspath.xml --- 3_0/docs/docbook/smbdotconf/vfs/vfspath.xml Thu May 1 16:04:06 2003 +++ 3_0-vfs/docs/docbook/smbdotconf/vfs/vfspath.xml Thu Jan 1 01:00:00 1970 @@ -1,13 +0,0 @@ - - - This parameter specifies the directory - to look in for vfs modules. The name of every vfs object - will be prepended by this directory. - - Default: vfs path = - - Example: vfs path = /usr/lib/samba/vfs - -