// Then
        assertEquals(0, bytesRead);
    }

    @ParameterizedTest
    @ValueSource(strings = { "\\\\server\\share", "\\\\192.168.1.1\\share", "\\\\server.domain.com\\share", "\\\\server\\share\\subfolder",
            "\\\\s\\s" // Minimum path
    })
    @DisplayName("Should handle various valid path formats")
    void testVariousPathFormats(String path) throws Exception {

    RESOURCE_CHANGE(1),        // Resource state changed
    CLIENT_MOVE(2),           // Client should move to different node
    SHARE_MOVE(3),            // Share moved to different node
    IP_CHANGE(4),             // IP address changed
    SHARE_DELETE(5),          // Share deleted
    NODE_UNAVAILABLE(6),      // Cluster node unavailable
    NODE_AVAILABLE(7);        // Cluster node available
    
    private final int value;
    

      "control" means (i) the power, direct or indirect, to cause the
      direction or management of such entity, whether by contract or
      otherwise, or (ii) ownership of fifty percent (50%) or more of the
      outstanding shares, or (iii) beneficial ownership of such entity.

      "You" (or "Your") shall mean an individual or Legal Entity
      exercising permissions granted by this License.

    }

    @Test
    void testGetReferral_Success() throws IOException, SmbAuthException {
        String domain = "domain.com";
        String root = "share";
        String path = "\\folder";
        String fullPath = "\\" + domain + "\\" + root + path; // Should be "\domain.com\share\folder"

        lenient().when(smbTransport.getDfsReferrals(auth, fullPath, 0)).thenReturn(dfsReferral);

    class HappyPath {
        @Test
        void testBasicProperties() throws Exception {
            String url = "smb://server/share/path/file.txt";
            DummySmbResourceLocator loc = new DummySmbResourceLocator(url);
            assertEquals("file.txt", loc.getName());
            assertEquals("smb://server/share/path/", loc.getParent());
            assertEquals(url, loc.getPath());
            // canonicalisation simply removes '.' and '..'

        when(mockReferral.getPathConsumed()).thenReturn(15); // e.g., "\\\\server\\share".length()
        when(mockReferral.next()).thenReturn(mockReferral); // Simple loop for the do-while
        assertDoesNotThrow(() -> dfsImpl.cache(mockContext, "\\\\server\\share\\path", mockReferral));
    }

        return this.service;
    }

    /**
     * Returns the native file system type of the connected share.
     *
     * @return the nativeFileSystem
     */
    public final String getNativeFileSystem() {
        return this.nativeFileSystem;
    }

    /**
     * Indicates whether the share supports search operations with search bits.
     *
     * @return the supportSearchBits
     */

     * this file is open. This constant may be logically OR'd with other share
     * access flags.
     */
    int FILE_SHARE_READ = 0x01;
    /**
     * When specified as the <code>shareAccess</code> constructor parameter,
     * other SMB clients will be permitted to write to the target file while
     * this file is open. This constant may be logically OR'd with other share
     * access flags.
     */
    int FILE_SHARE_WRITE = 0x02;

    void testToString() {
        // Given
        exception = new SmbOperationException(SmbOperationException.ErrorCode.ACCESS_DENIED, "Cannot access share");
        exception.withContext("share", "\\\\server\\share");
        exception.withContext("user", "john");

        // When
        String str = exception.toString();

        // Then
        assertNotNull(str);

 the version number 2.1.)

                            Preamble

  The licenses for most software are designed to take away your
freedom to share and change it.  By contrast, the GNU General Public
Licenses are intended to guarantee your freedom to share and change
free software--to make sure the software is free for all its users.

  This license, the Lesser General Public License, applies to some