Dfsutil Remarks

  • Article

Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2

DfsUtil Remarks

DFSUtil Parameter Usage (Administration, Debugging/Monitoring, Troubleshooting/Disaster Recovery)

The following is an overview of when an administrator would typically use a specific DfsUtil parameters, as well as the parameters' general area of impact.

Parameter Use for Routine Administration Use for Debugging And Monitoring Use for Troubleshooting And Disaster Recovery   Impact: View (Passive) Impact: Server Modification (Active) Impact: Client Modification (Active)

AddStdRoot

yes

-

-

 

-

DFS Namespace modification

-

CheckBlob

-

yes

-

 

Verify blob stored in a file

-

-

Clean

-

-

yes

 

-

DFS Namespace modification

-

DisplayBlob

-

yes

-

 

Display blob contents to standard output

-

-

Export

yes

yes

yes

 

Save DFS namespace to a file

-

-

ExportBlob

-

yes

-

 

Export blob to a file

-

-

Import

yes

-

yes

 

-

DFS Namespace modification

-

ImportRoot

-

-

yes

 

-

DFS Namespace modification

-

Insite

yes

-

-

 

-

DFS Operations, Client behavior

-

PKTFlush

-

-

yes

 

-

-

Client behavior

PKTInfo

-

yes

-

 

Display target referrals and active target for a link (Client)

-

-

PurgeMupCache

-

-

yes

 

-

-

Client behavior

PurgeWin2kStaticSiteTable

-

-

yes

 

-

DFS metadata site information

-

RemFtRoot

yes

-

-

 

-

DFS Namespace modification

-

RemoveReparse

-

-

-

 

-

DFS related directories on the server

-

AddFTRoot

-

-

yes

 

-

DFS related directories on the server

-

RemStdRoot

yes

-

-

 

-

DFS Namespace modification

-

RenameFtRoot

yes

-

-

 

-

DFS Namespace modification

-

RootScalability

yes

-

-

 

-

DFS Sensitivity

-

ShowWin2kStaticSiteTable

yes

yes

yes

 

Display Windows 2000 Server DFS site information when in mixed mode

-

-

SiteCosting

yes

-

-

 

-

DFS Operations, Client behavior

-

SiteName

yes

yes

-

 

View Site name of a computer

-

-

SPCFlush

-

-

yes

 

-

-

Client behavior

SPCInfo

-

yes

-

 

Display trusted domains and its DCs known on client

-

-

UnmapFtRoot

-

-

yes

 

-

DFS Namespace modification

-

UpdateWin2kStaticSiteTable

yes

-

yes

 

-

DFS metadata site information

-

View

-

yes

-

 

View DFS Namespace

-

-

ViewDfsDirs

-

yes

yes

 

Displays DFS related directories in a volume

Displays DFS related directories in a volume

-

Output Description for /PktInfo

Current Partition Knowledge Table (PKT) information can be displayed by using the /pktinfo parameter. The following describes the type of output produced when /pktinfo is used. The description numbers correspond to the numbers in the sample output.

1.  The initial entry specifies how many entries are included in the output.

2.  Every entry has both a full (Entry) and a short (ShortEntry) name.

3.  Expires or Time To Live (TTL) is the length of time a DFS client stores referral information from the PKT in its local cache. The DFS client requests new information from the PKT if the TTL expires or the client is restarted. The TTL is reset if the shared folder is accessed before it expires.

4.  UseCount is the number of times it's used since got this referral. Type specifies the type of referral being made.

5.  Each entry contains a sequentially numbered target list. A referral is a list of targets a DFS client receives from the PKT when a user attempts to access a root or a link in the namespace. Referrals are cached locally on the client for a time specified by time indicated in Expires. The referral information can tell you which target is active for your DFS client. The number after each target name indicates the state of the target. Attempts to access an inactive target will be referred to the currently active target.

  • State 0x21:inactive or not responding

  • State 0x31:responding and an active target

6.  An ACTIVE target status indicates it is currently being accessed by the client. If access to this target fails, the client will try to access the next target in the list. In this entry, the client would try to access the 12th target, \dom-dc-12.dom.company.com\SysVol.

dfsutil /pktinfo

Microsoft(R) Windows(TM) Dfs Utility Version 4.0
Copyright (C) Microsoft Corporation 1991-2001. All Rights Reserved.

--mup.sys--

1.

4 entries...

2.

Entry: \dom.company.com\SysVol
ShortEntry: \dom.company.com\SysVol

3.

Expires in 3014020 seconds

4.

UseCount:  Type:0x1 ( DFS )

5.

0:[\dom-dc-04.dom.company.com\SysVol] State:0x21 ( )   
1:[\dom-dc-08.dom.company.com\SysVol] State:0x21 ( )   
2:[\dom-dc-10.dom.company.com\SysVol] State:0x21 ( )   
3:[\dom-dc-07.dom.company.com\SysVol] State:0x21 ( )   
4:[\dom-dc-03.dom.company.com\SysVol] State:0x21 ( )   
5:[\dom-dc-02.dom.company.com\SysVol] State:0x21 ( )   
6:[\dom-dc-05.dom.company.com\SysVol] State:0x21 ( )   
7:[\dom-dc-09.dom.company.com\SysVol] State:0x21 ( )   
8:[\dom-dc-06.dom.company.com\SysVol] State:0x21 ( )   
9:[\dom-dc-13.dom.company.com\SysVol] State:0x21 ( )  
10:[\dom-dc-11.dom.company.com\SysVol] State:0x21 ( )

6.

11:[\dom-dc-01.dom.company.com\SysVol] State: 0x31 ( ACTIVE )  
12:[\dom-dc-12.dom.company.com\SysVol] State:0x21 ( ) 

Entry: \dom.company.com\netlogon
ShortEntry: \dom.company.com\netlogon
Expires in 0 seconds
UseCount: 0 Type:0x1 ( DFS )   
0:[\dom-dc-08.dom.company.com\netlogon] State:0x31 ( ACTIVE )   
1:[\dom-dc-05.dom.company.com\netlogon] State:0x21 ( )   
2:[\dom-dc-07.dom.company.com\netlogon] State:0x21 ( )   
3:[\dom-dc-03.dom.company.com\netlogon] State:0x21 ( )   
4:[\dom-dc-09.dom.company.com\netlogon] State:0x21 ( )   
5:[\dom-dc-10.dom.company.com\netlogon] State:0x21 ( )   
6:[\dom-dc-04.dom.company.com\netlogon] State:0x21 ( )   
7:[\dom-dc-11.dom.company.com\netlogon] State:0x21 ( )   
8:[\dom-dc-02.dom.company.com\netlogon] State:0x21 ( )   
9:[\dom-dc-13.dom.company.com\netlogon] State:0x21 ( )  
10:[\dom-dc-06.dom.company.com\netlogon] State:0x21 ( ) 

Entry: \dom\public
ShortEntry: \dom\public
Expires in 0 seconds
UseCount: 0 Type:0x81 ( REFERRAL_SVC DFS )   
0:[\ntdsdfs2\Public] State:0x19 ( ACTIVE )   
1:[\ntdsdfs1\Public] State:0x09 ( ) 

Entry: \dom\public\Desktop\Office2000
ShortEntry: \dom\public\Desktop\Office2000
Expires in 0 secondsUseCount: 0 Type:0x1 ( DFS )   
0:[\imself-ia64-02\office2000] State:0x31 ( ACTIVE )   
1:[\apzawsrv2ß\office2000] State:0x21 ( )   
2:[\apzawsrv3\office2000] State:0x21 ( )

DfsUtil command completed successfully.

Output Description for /SpcInfo

SPC table information can be displayed by using the /spcinfo parameter. The following describes the type of output produced when /spcinfo is used. The description numbers correspond to the numbers in the sample output.

1.   Entries beginning with [*] are not expanded, and are local to the domain.

2.   Entries beginning with [+] are expanded into the DC list due to access.

3.   Indented entries are expanded entries of the domain entry of the domain1.companydom.com domain.

4.   Unexpanded domains which have not been accessed or required to expand by the client. The local client cache contains no further information about these domains. Only trusted domains are listed.

dfsutil /spcinfo

Microsoft(R) Windows(TM) Dfs Utility Version 4.0
Copyright (C) Microsoft Corporation 1991-2001. All Rights Reserved.

1.

[*] [domain1-dc-08.domain1.companydom.com]
[*][DOMAIN1]
[*][domain1.companydom.com]

2.

[+] [domain1.companydom.com]

3.

[-domain1-dc-05.domain1.companydom.com]
[-domain1-dc-13.domain1.companydom.com]
[-domain1-dc-04.domain1.companydom.com]
[-domain1-dc-rn.ntwksta.domain1.companydom.com]
[-domain1-dc-02.domain1.companydom.com]

[+][DOMAIN1]
[-DOMAIN1-DC-07]
[-NTDEV-DC-11]
[-NTDEV-DC-05]
[+NTDEV-DC-08]

4.

[-][stressdsdom.nttest.companydom.com]
[-][STRESSDSDOM]
[-][vbl03stressdom.nttest.companydom.com]
[-][VBL03STRESSDOM]

DfsUtil command completed successfully.

See Also

Concepts

Dfsutil Overview
Dfsutil Syntax
Dfsutil Examples
Alphabetical List of Tools
Topchk.cmd
Rsdir Overview
Rsdiag Overview
Iologsum Overview
Health_chk Overview
Ftonline Overview
Filever Overview
Efsinfo Overview
Dmdiag Overview
Dskprobe Overview
Diruse Overview
Connstat Overview
Cabarc Overview
Bitsadmin Overview