- **MS-SMB2 Section 3.3.5.9.11**: Directory Leasing and Caching

## 3. Directory Lease Types

### 3.1 Directory-Specific Lease States
```java
public class DirectoryLeaseState extends Smb2LeaseState {
    // Standard lease states apply, plus directory-specific semantics:
    
    // READ_CACHING for directories means:
    // - Can cache directory enumeration results
    // - Can cache file existence queries

    /**
     * Directory change types
     */
    public enum DirectoryChangeType {
        /**
         * File was added to the directory
         */
        FILE_ADDED,
        /**
         * File was removed from the directory
         */
        FILE_REMOVED,
        /**
         * File was modified in the directory
         */
        FILE_MODIFIED,
        /**

            lock.writeLock().unlock();
        }
    }

    /**
     * Gets the directory path for this cache entry
     * @return the directory path
     */
    public String getDirectoryPath() {
        return directoryPath;
    }

    /**
     * Gets the lease key associated with this directory cache
     * @return the lease key
     */
    public Smb2LeaseKey getLeaseKey() {

            if (logger.isInfoEnabled()) {
                logger.info("SuggestCreator: \nDirectory={}\nOptions={}", baseDir, cmdList);
            }

            final JobProcess jobProcess = processHelper.startProcess(sessionId, cmdList, pb -> {
                pb.directory(baseDir);
                pb.redirectErrorStream(true);
            });

     * @return the Path object pointing to the site directory
     */
    public static Path getSitePath(final String... names) {
        return getPath("WEB-INF/", "site", names);
    }

    /**
     * Gets the path to plugin files directory.
     *
     * @param names the path components to append to the plugin directory
     * @return the Path object pointing to the plugin directory
     */

            if (logger.isInfoEnabled()) {
                logger.info("ThumbnailGenerator: \nDirectory={}\nOptions={}", baseDir, cmdList);
            }

            final JobProcess jobProcess = processHelper.startProcess(sessionId, cmdList, pb -> {
                pb.directory(baseDir);
                pb.redirectErrorStream(true);
            });

        assertFalse(cacheEntry.isComplete());

        // Step 3: Verify can cache directory listing
        assertTrue(directoryLeaseManager.canCacheDirectoryListing(directoryPath));

        // Step 4: Initially no cached listing
        assertNull(directoryLeaseManager.getCachedDirectoryListing(directoryPath));

        // Step 5: Simulate directory enumeration and update cache

        if (value != null) {
            return value;
        }
        return super.prepareWebappPath();
    }

    /**
     * Returns the directory path for temporary mark files.
     *
     * @return the absolute path to the fessboot directory in the system temp directory
     */
    @Override
    protected String getMarkDir() {
        return new File(System.getProperty(JAVA_IO_TMPDIR), "fessboot").getAbsolutePath();

        buffer[offset++] = (byte) 1; // directory = true

        // Decode
        int bytesDecoded = fileStandardInfo.decode(buffer, bufferIndex, 22);

        // Verify
        assertEquals(22, bytesDecoded);
        assertEquals(expectedEndOfFile, fileStandardInfo.getSize());
    }

    @Test
    @DisplayName("Test decode with delete pending false and directory false")

    /**
     * Validates that a given path is safe and does not attempt path traversal attacks.
     * <p>
     * This method checks if the resolved absolute path starts with the allowed base directory,
     * preventing access to files outside the intended directory through path traversal
     * techniques like "../../../etc/passwd".
     * </p>
     * <p>
     * Example usage:
     * </p>
     * <pre>