Module jcifs

Package org.codelibs.jcifs.smb1

Class Dfs

java.lang.Object

org.codelibs.jcifs.smb1.Dfs

public class Dfs
extends Object

Implements DFS (Distributed File System) referral caching and resolution. This class manages DFS referral cache and provides DFS path resolution functionality.

Field Summary

Fields

Modifier and Type	Field	Description
protected org.codelibs.jcifs.smb1.Dfs.CacheEntry	_domains	Cache of trusted domains for DFS resolution
protected static org.codelibs.jcifs.smb1.Dfs.CacheEntry	FALSE_ENTRY	Sentinel cache entry indicating a negative cache result
protected org.codelibs.jcifs.smb1.Dfs.CacheEntry	referrals	Cache of DFS referrals

Constructor Summary

Constructors

Constructor	Description
Dfs()	Default constructor for Dfs.

Method Summary

Modifier and Type	Method	Description
SmbTransport	getDc(String domain, NtlmPasswordAuthentication auth)	Gets a domain controller transport for the specified domain
DfsReferral	getReferral(SmbTransport trans, String domain, String root, String path, NtlmPasswordAuthentication auth)	Gets a DFS referral for the specified path
HashMap	getTrustedDomains(NtlmPasswordAuthentication auth)	Gets the map of trusted domains for DFS resolution
boolean	isTrustedDomain(String domain, NtlmPasswordAuthentication auth)	Checks if a domain is trusted for DFS operations
DfsReferral	resolve(String domain, String root, String path, NtlmPasswordAuthentication auth)	Resolves a DFS path to obtain referral information

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

FALSE_ENTRY

protected static org.codelibs.jcifs.smb1.Dfs.CacheEntry FALSE_ENTRY

Sentinel cache entry indicating a negative cache result

_domains

protected org.codelibs.jcifs.smb1.Dfs.CacheEntry _domains

Cache of trusted domains for DFS resolution

referrals

protected org.codelibs.jcifs.smb1.Dfs.CacheEntry referrals

Cache of DFS referrals

Constructor Details

Dfs

public Dfs()

Default constructor for Dfs. Initializes the DFS referral system.

Method Details

getTrustedDomains

public HashMap getTrustedDomains(NtlmPasswordAuthentication auth)
                          throws SmbAuthException

Gets the map of trusted domains for DFS resolution

Parameters:

auth - the authentication credentials

Returns:

a map of trusted domain names to domain controllers

Throws:

SmbAuthException - if authentication fails

isTrustedDomain

public boolean isTrustedDomain(String domain,
 NtlmPasswordAuthentication auth)
                        throws SmbAuthException

Checks if a domain is trusted for DFS operations

Parameters:

domain - the domain name to check

auth - the authentication credentials

Returns:

true if the domain is trusted, false otherwise

Throws:

SmbAuthException - if authentication fails

getDc

public SmbTransport getDc(String domain,
 NtlmPasswordAuthentication auth)
                   throws SmbAuthException

Gets a domain controller transport for the specified domain

Parameters:

domain - the domain name

auth - the authentication credentials

Returns:

an SMB transport to the domain controller

Throws:

SmbAuthException - if authentication fails

getReferral

public DfsReferral getReferral(SmbTransport trans,
 String domain,
 String root,
 String path,
 NtlmPasswordAuthentication auth)
                        throws SmbAuthException

Gets a DFS referral for the specified path

Parameters:

trans - the SMB transport to use

domain - the domain name

root - the DFS root

path - the path to resolve

auth - the authentication credentials

Returns:

a DFS referral or null if not found

Throws:

SmbAuthException - if authentication fails

resolve

public DfsReferral resolve(String domain,
 String root,
 String path,
 NtlmPasswordAuthentication auth)
                    throws SmbAuthException

Resolves a DFS path to obtain referral information

Parameters:

domain - the domain name

root - the DFS root

path - the path to resolve

auth - the authentication credentials

Returns:

a DFS referral for the resolved path

Throws:

SmbAuthException - if authentication fails