*/
    boolean ensureConnected() throws IOException;

    /**
     * Gets DFS referrals for the specified path.
     *
     * @param ctx the CIFS context
     * @param name the DFS path to resolve
     * @param targetHost the target host name
     * @param targetDomain the target domain
     * @param rn the referral number
     * @return dfs referral
     * @throws SmbException if an SMB error occurs

     */
    public static final int SMB2_SHAREFLAG_VDO_CACHING = 0x20;
    /**
     * Share flag indicating the share is in a DFS namespace.
     */
    public static final int SMB2_SHAREFLAG_DFS = 0x1;
    /**
     * Share flag indicating the share is a DFS root.
     */
    public static final int SMB2_SHAREFLAG_DFS_ROOT = 0x2;
    /**

    /**
     *
     *
     * Property {@code jcifs.smb.client.dfs.ttl} (int, default 300)
     *
     * @return title to live, in seconds, for DFS cache entries
     */
    long getDfsTtl();

    /**
     *
     * Property {@code jcifs.smb.client.dfs.strictView} (boolean, default false)
     *
     * @return whether a authentication failure during DFS resolving will throw an exception
     */
    boolean isDfsStrictView();

    @DisplayName("Should set capabilities based on configuration")
    @CsvSource({ "true, true, SMB311, 2", // DFS + Encryption
            "false, true, SMB311, 1", // Encryption only
            "true, false, SMB311, 1", // DFS only
            "false, false, SMB311, 0", // Neither
            "true, true, SMB210, 1", // DFS only (no encryption for SMB2)
            "false, true, SMB210, 0" // Neither (no encryption for SMB2)
    })

     * this method will return the referral path to which it maps. Otherwise
     * <code>null</code> is returned.
     */

    /**
     * Returns the DFS path for this file if it resides in a DFS share
     *
     * @return the DFS path or null if not in DFS
     * @throws SmbException if an error occurs while resolving the DFS path
     */

     *
     * @return whether the server requires signing
     */
    boolean isSigningRequired();

    /**
     * Checks whether the server supports Distributed File System (DFS).
     *
     * @return whether the server supports DFS
     */
    boolean isDFSSupported();

    /**
     * Sets up the given request with negotiated parameters.
     *
     * @param request the request to configure
     */

     * @throws CIFSException if an error occurs during comparison
     */
    boolean overlaps(SmbResourceLocator other) throws CIFSException;

    /**
     * Internal: for testing only
     *
     * @param dr the DFS referral data to process
     * @param reqPath the requested path to resolve
     * @return resolved unc path
     */
    String handleDFSReferral(DfsReferralData dr, String reqPath);

    void getDfsReferrals_happy() throws Exception {
        when(transport.getDfsReferrals(any(), any(), any(), any(), anyInt())).thenReturn(referral);

        String name = "\\\\server\\\\share\\\\path"; // UNC-like DFS path
        String host = "server.example";
        String domain = "EXAMPLE";
        int rn = 0;

        jcifs.DfsReferralData result = transport.getDfsReferrals(ctx, name, host, domain, rn);

    }

    /**
     * @return whether this is a DFS share
     */
    public boolean isDfs() {
        return this.inDfs;
    }

    /**
     *
     */
    void markDomainDfs() {
        this.inDomainDfs = true;
    }

    /**
     * @return whether this tree was accessed using domain DFS
     */
    public boolean isInDomainDfs() {
        return this.inDomainDfs;

 *
 * @author mbechler
 */
public class BaseContext extends AbstractCIFSContext {

    private final Configuration config;
    private final DfsResolver dfs;
    private final SidResolver sidResolver;
    private final Handler urlHandler;
    private final NameServiceClient nameServiceClient;
    private final BufferCache bufferCache;