1
0
mirror of https://github.com/samba-team/samba.git synced 2024-12-22 13:34:15 +03:00
samba-mirror/examples/VFS
Ralph Boehme 8fa7848b4a vfs: Add flags and xferlen args to SMB_VFS_OFFLOAD_READ_RECV
We missed these values which follow from MS-FSCC 2.3.80 “FSCTL_OFFLOAD_READ
Reply”:

  Flags (4 bytes):

    A 32-bit unsigned integer that indicates which flags were returned for this
    operation. Possible values for the flags follow. All unused bits are reserved
    for future use, SHOULD be set to 0, and MUST be ignored.

    OFFLOAD_READ_FLAG_ALL_ZERO_BEYOND_CURRENT_RANGE (0x00000001)
    => The data beyond the current range is logically equivalent to zero.

  TransferLength (8 bytes):

    A 64-bit unsigned integer that contains the amount, in bytes, of data that the
    Token logically represents. This value indicates a contiguous region of the
    file from the beginning of the requested offset in the FileOffset field in the
    FSCTL_OFFLOAD_READ_INPUT data element (section 2.3.79). This value can be
    smaller than the CopyLength field specified in the FSCTL_OFFLOAD_READ_INPUT
    data element, which indicates that less data was logically
    represented (logically read) with the Token than was requested. The value of
    this field MUST be greater than 0x0000000000000000 and MUST be aligned to a
    logical sector boundary on the volume.

As we currently only implement COPY_CHUNK over the OFFLOAD VFS interface, the
VFS COPY_CHUNK backend in vfs_default just sets both values to 0 and they are
unused in the SMB frontend.

Signed-off-by: Ralph Boehme <slow@samba.org>
Reviewed-by: Jeremy Allison <jra@samba.org>
2021-10-08 19:28:32 +00:00
..
README examples/VFS: fix a typo in the README 2011-10-08 01:42:33 +02:00
shadow_copy_test.c lib: modules: Change XXX_init interface from XXX_init(void) to XXX_init(TALLOC_CTX *) 2017-04-22 01:17:00 +02:00
skel_opaque.c vfs: Add flags and xferlen args to SMB_VFS_OFFLOAD_READ_RECV 2021-10-08 19:28:32 +00:00
skel_transparent.c vfs: Add flags and xferlen args to SMB_VFS_OFFLOAD_READ_RECV 2021-10-08 19:28:32 +00:00
wscript_build s3-waf: make sure we build example vfs modules with --enable-developer. 2011-10-11 21:22:55 +02:00

README for Samba Virtual File System (VFS) Example
===================================================

This directory contains skeleton VFS modules.  When used,
this module simply passes all requests back to the disk functions
(i.e it operates as a passthrough filter).  It should be
useful as a starting point for developing new VFS
modules. 

Please look at skel_opaque.c when you want your module to provide
final functions, like a database filesystem.

Please look at skel_transparent.c when you want your module to provide
passthrough functions, like audit modules. 

Please read the VFS chapter in the HOWTO collection for general help 
on the usage of VFS modules.

Further documentation on writing VFS modules for Samba can be found in
Samba Developers Guide.