# SMB3 Lease Feature - Detailed Design Document

## 1. Overview

SMB3 leases provide a client caching mechanism that replaces the traditional oplock mechanism. Leases enable better performance through client-side caching while maintaining cache coherency across multiple clients.

## 2. Protocol Specification Reference

- **MS-SMB2 Section 2.2.13**: SMB2 CREATE Request with Lease Context
- **MS-SMB2 Section 2.2.14**: SMB2 CREATE Response with Lease State

        if (len <= 0) {
            return 0;
        }
        final long start = this.fp;

        if (this.tmp == null) {
            throw new IOException("Bad file descriptor");
        }
        // ensure file is open
        try (SmbFileHandleImpl fd = ensureOpen(); SmbTreeHandleImpl th = fd.getTree()) {

            if (log.isTraceEnabled()) {
                log.trace("read: fid=" + fd + ",off=" + off + ",len=" + len);

            /* Yes, there is the potential to drop packets
             * because we might close the socket during a
             * request. However the chances are slim and the
             * retry code should ensure the overall request
             * is serviced. The alternative complicates things
             * more than I think is worth it.
             */

            if (socket != null) {
                socket.close();

      TestByteSource okSource = new TestByteSource(bytes);
      assertThrows(IOException.class, () -> okSource.copyTo(new TestByteSink(option)));
      // ensure stream was closed IF it was opened (depends on implementation whether or not it's
      // opened at all if sink.newOutputStream() throws).
      assertTrue(

operating system, as well as its variant, the GNU/Linux operating
system.

  Although the Lesser General Public License is Less protective of the
users' freedom, it does ensure that the user of a program that is
linked with the Library has the freedom and the wherewithal to run
that program using a modified version of the Library.

  The precise terms and conditions for copying, distribution and

errors.design_file_is_unsupported_type = This file type is unsupported.
errors.failed_to_create_crawling_config_at_wizard = Failed to create a crawling config at a wizard.
errors.design_editor_disabled = This feature is disabled.
errors.not_found_on_file_system = Not found. Cause: {0}
errors.could_not_open_on_system = Could not open {0}.<br>Please check if the file is associated with an application.

errors.design_file_is_unsupported_type = This file type is unsupported.
errors.failed_to_create_crawling_config_at_wizard = Failed to create a crawling config at a wizard.
errors.design_editor_disabled = This feature is disabled.
errors.not_found_on_file_system = Not found. Cause: {0}
errors.could_not_open_on_system = Could not open {0}.<br>Please check if the file is associated with an application.

     * This verifies that the ThreadLocal implementation doesn't cause issues
     */
    @Test
    public void test_threadLocalKryo() {
        // Perform multiple serializations to ensure ThreadLocal works
        for (int i = 0; i < 10; i++) {
            String original = "Test " + i;
            byte[] serialized = serializer.fromObjectToBinary(original);

		// More than maxConfigSize bytes were available
		writeErrorResponseJSON(ctx, w, errorCodes.ToAPIErr(ErrAdminConfigTooLarge), r.URL)
		return
	}

	// Ensure body content type is opaque to ensure that request body has not
	// been interpreted as form data.
	contentType := r.Header.Get("Content-Type")
	if contentType != "application/octet-stream" {

    // Confirm that the connection was reused.
    assertThat(server.takeRequest().exchangeIndex).isEqualTo(0)
    assertThat(server.takeRequest().exchangeIndex).isEqualTo(1)
  }

  /**
   * Test to ensure we don't  throw a read timeout on responses that are progressing.  For this
   * case, we take a 4KiB body and throttle it to 1KiB/second.  We set the read timeout to two