* aka OPEN_ALWAYS
     */

    static final int FILE_OPEN_IF = 0x3;

    /*
     * Open the file and overwrite it's contents or fail if it does not exist
     * aka TRUNCATE_EXISTING
     */

    static final int FILE_OVERWRITE = 0x4;

    /*
     * Open the file and overwrite it's contents or create it if it does not exist
     * aka CREATE_ALWAYS (according to the wire when calling CreateFile)
     */

     * @param <T> the target ASN.1 primitive type
     * @param type the target class type
     * @param tagged the ASN.1 tagged object
     * @return tagged object contents cast to type
     * @throws PACDecodingException if types are incompatible
     */
    public static <T extends ASN1Primitive> T as(final Class<T> type, final ASN1TaggedObject tagged) throws PACDecodingException {

 * both <code>FILE_READ_DATA</code> and <code>FILE_WRITE_DATA</code> access.
 */
public interface ACE {

    /**
     * Permission to read data from a file or list directory contents
     */
    int FILE_READ_DATA = 0x00000001; // 1
    /**
     * Permission to write data to a file or add files to a directory
     */
    int FILE_WRITE_DATA = 0x00000002; // 2
    /**

            CloseableUtil.close(os);
        }
    }

    // ////////////////////////////////////////////////////////////////
    // internal methods
    //
    /**
     * Copies the contents of an input stream to an output stream.
     * <p>
     * Neither the input stream nor the output stream is closed.
     * </p>
     *
     * @param in the input stream
     * @param out the output stream

import java.util.concurrent.atomic.AtomicInteger;
import java.util.concurrent.locks.ReadWriteLock;
import java.util.concurrent.locks.ReentrantReadWriteLock;

/**
 * Cache entry for directory contents with thread-safe operations
 */
public class DirectoryCacheEntry {

    private final String directoryPath;
    private final Smb2LeaseKey leaseKey;
    private final long createTime;

            throw new ThemeException("Theme name is empty: " + artifact);
        }
        return themeName;
    }

    /**
     * Recursively deletes a directory and all its contents.
     * Does not throw exceptions, only logs warnings if deletion fails.
     *
     * @param dir the directory to delete
     */
    protected void closeQuietly(final Path dir) {

        try {
            return new JarFile(file);
        } catch (final IOException e) {
            throw new IORuntimeException(e);
        }
    }

    /**
     * Returns an input stream to read the contents of the specified JAR file entry.
     *
     * @param file the JAR file (must not be {@literal null})
     * @param entry the JAR file entry (must not be {@literal null})
     * @return the input stream to read the entry

suggest.update.doc.per.request=2
# Percentage limit for suggestion update contents.
suggest.update.contents.limit.num.percentage=50%
# Maximum number of suggestion update contents.
suggest.update.contents.limit.num=10000
# Maximum document size for suggestion update.
suggest.update.contents.limit.doc.size=50000
# Scroll size for suggestion source reader.
suggest.source.reader.scroll.size=1

    /**
     * Enhanced listFiles method that uses directory leasing for caching when available
     *
     * @param smbFile the SmbFile directory to list
     * @return array of SmbFile objects representing the directory contents
     * @throws SmbException if an error occurs
     */
    public static SmbFile[] listFilesWithLeasing(SmbFile smbFile) throws SmbException {
        if (!smbFile.isDirectory()) {

    }

    // Happy path: get -> release -> get returns same instance, zeroed on release
    @Test
    @DisplayName("Release stores buffer for reuse and zeroes its contents")
    void releaseStoresAndZeroesBuffer() {
        BufferCacheImpl impl = new BufferCacheImpl(2, 10);

        byte[] b = new byte[10];
        // Fill with non-zero to verify zeroing on release