*/
package jcifs.internal;

import jcifs.internal.fscc.FileSystemInformation;

/**
 * Interface for file system allocation information providing capacity and free space details.
 * Used in SMB protocol operations to query disk space information from remote SMB shares.
 *
 * @author mbechler
 */
public interface AllocInfo extends FileSystemInformation {

    /**
     * Gets the total capacity of the allocation.

	// TODO(dsnet): Re-enable this when adding sparse support.
	// See https://golang.org/issue/22735
	/*
		// Handle sparse files.
		var spd sparseDatas
		var spb []byte
		if len(hdr.SparseHoles) > 0 {
			sph := append([]sparseEntry{}, hdr.SparseHoles...) // Copy sparse map
			sph = alignSparseEntries(sph, hdr.Size)
			spd = invertSparseEntries(sph, hdr.Size)

			// Format the sparse map.

import java.util.Map.Entry;
import org.jspecify.annotations.Nullable;

/**
 * Simple helper class to build a "sparse" array of objects based on the indexes that were added to
 * it. The array will be from 0 to the maximum index given. All non-set indexes will contain null
 * (so it's not really a sparse array, just a pseudo sparse array). The builder can also return a
 * CharEscaper based on the generated array.
 *
 * @author Sven Mawson

import jcifs.internal.dtyp.SecurityDescriptor;

/**
 * MSRPC implementation for retrieving share information.
 * This class provides functionality to get detailed information about
 * a specific share using the Server Service RPC interface.
 */
public class MsrpcShareGetInfo extends srvsvc.ShareGetInfo {

    /**
     * Creates a new request to get share information.
     *
     * @param server the server name

        testImplementation.setFullUNCPath(expectedDomain, "server", "\\\\server\\share\\path");
        assertEquals(expectedDomain, testImplementation.getDomain());
    }

    @Test
    @DisplayName("Test getFullUNCPath returns complete UNC path")
    void testGetFullUNCPath() {
        // Test with mock
        String expectedUNCPath = "\\\\server\\share\\folder\\file.txt";

        assertTrue(tree.matches("testshare", "TESTSERVICE"));

        // Test matching share with null service
        assertTrue(tree.matches("testShare", null));

        // Test matching share with service starting with "??"
        assertTrue(tree.matches("testShare", "??otherService"));

        // Test non-matching share
        assertFalse(tree.matches("otherShare", "testService"));

        // Test non-matching service

        }

        /** The percentage of used space on the filesystem. */
        public short percent;
        /** Used space in bytes */
        public long used;
        /** Filesystem path */
        public String path;
        /** Free space in bytes */
        public long free;
        /** Total space in bytes */
        public long total;
        /** Usable space in bytes */
        public long usable;
    }

        void testGetShare() {
            // Act & Assert
            assertEquals("share", smbFile.getShare());
        }

        @Test
        void testGetUncPath() {
            // Arrange
            doReturn("\\localhost\share\file.txt").when(smbFile).getUncPath();

            // Act & Assert
            assertEquals("\\localhost\share\file.txt", smbFile.getUncPath());
        }
    }

    @Nested

    @DisplayName("Test getType with different share types")
    @CsvSource({ "1, " + SmbConstants.TYPE_PRINTER, // Printer share
            "3, " + SmbConstants.TYPE_NAMED_PIPE, // Named pipe
            "0, " + SmbConstants.TYPE_SHARE, // Standard share
            "2, " + SmbConstants.TYPE_SHARE, // Unknown type defaults to share
            "4, " + SmbConstants.TYPE_SHARE, // Unknown type defaults to share

    private int pathConsumed;
    private long ttl;
    private String server; // Server
    private String share; // Share
    private String link;
    private String path; // Path relative to tree from which this referral was thrown

    private long expiration;
    private int rflags;

    private boolean resolveHashes;

    private DfsReferralDataImpl next;