*/
package org.apache.maven.api.plugin;

import java.util.List;

import org.apache.maven.api.annotations.Consumer;
import org.apache.maven.api.annotations.Experimental;
import org.apache.maven.api.plugin.descriptor.lifecycle.Lifecycle;

/**
 * Interface that can be provided by the plugin to wire in custom lifecycles
 * leveraged using the {@link org.apache.maven.api.plugin.annotations.Execute}

            return resp.getAvailable();
        } catch (final SmbException se) {
            throw seToIoe(se);
        }
    }

    @Override
    public void close() {
        // ignore, the shared file descriptor is closed by the pipe handle
    }

            assertEquals(0, in.readDirect(buf, 0, 0));
            assertEquals(0, in.read(new byte[0]));
        }

        @Test
        @DisplayName("read after close throws 'Bad file descriptor'")
        void readAfterCloseThrows() throws Exception {
            SmbFileInputStream in = newStream();
            // closing should null tmp; subsequent readDirect should fail
            in.close();

     */
    public int getFid() throws SmbException {
        if (!isValid()) {
            throw new SmbException("Descriptor is no longer valid");
        }
        return this.fid;
    }

    public byte[] getFileId() throws SmbException {
        if (!isValid()) {
            throw new SmbException("Descriptor is no longer valid");
        }
        return this.fileId;
    }

    /**

        } else {
            this.req = new SmbComWrite(th.getConfig());
            this.rsp = new SmbComWriteResponse(th.getConfig());
        }
    }

    /**
     * Ensures that the file descriptor is openend
     *
     * @throws CIFSException if an error occurs opening the file
     */
    public void open() throws CIFSException {
        try (SmbFileHandleImpl fh = ensureOpen()) {}
    }

  xml.schemaLocation="https://maven.apache.org/xsd/toolchains-${version}.xsd">
  <id>toolchains</id>
  <name>MavenToolchains</name>
  <description><![CDATA[
    This is a reference for the Maven Toolchains descriptor.
    <p>The default location for the toolchains file is {@code ~/.m2/toolchains.xml}
    <p>A Toolchain is a preconfigured object that Maven plugins can use for tool configuration retrieval (location and other information).

        // invalidate
        h.markClosed();

        SmbException ex1 = assertThrows(SmbException.class, h::getFid);
        assertEquals("Descriptor is no longer valid", ex1.getMessage());
        SmbException ex2 = assertThrows(SmbException.class, h::getFileId);
        assertEquals("Descriptor is no longer valid", ex2.getMessage());
    }

    @Test
    @DisplayName("close(long) sends SMB2 close request and releases tree when SMB2")

        /**
         * The share password (if any).
         */
        public String password;
        /**
         * The size of the security descriptor.
         */
        public int sd_size;
        /**
         * The security descriptor bytes.
         */
        public byte[] security_descriptor;

        @Override
        public void encode(NdrBuffer _dst) throws NdrException {

        }

        if (log.isDebugEnabled()) {
            log.debug("Negotiated file read size is " + this.readSizeFile);
        }
    }

    /**
     * Ensures that the file descriptor is openend
     *
     * @throws CIFSException if an error occurs while opening the file
     */
    public void open() throws CIFSException {
        try (SmbFileHandleImpl fh = ensureOpen()) {}
    }

    public static final int FILE_NOTIFY_CHANGE_CREATION = 0x40;
    /**
     * Notify when extended attributes change
     */
    public static final int FILE_NOTIFY_CHANGE_EA = 0x80;
    /**
     * Notify when security descriptor changes
     */
    public static final int FILE_NOTIFY_CHANGE_SECURITY = 0x100;
    /**
     * Notify when alternate data stream name changes
     */
    public static final int FILE_NOTIFY_CHANGE_STREAM_NAME = 0x200;