Manual Pages
Table of Contents
na_cifs_prefdc - configure and display CIFS preferred
Domain Controller information
cifs prefdc print [ domain ]
cifs prefdc add domain address [ address ... ]
cifs prefdc delete domain
cifs prefdc allows control over the order in which CIFS
chooses Domain Controllers for domain authentication.
cifs prefdc displays one or more preferred Domain Controller
(DC) lists, adds a preferred DC list for a domain,
or deletes a preferred DC list for a domain.
When CIFS needs a Domain Controller to authenticate domain
users it uses a combination of WINS and DNS to discover a
set of candidate DCs. It then orders the DCs based on
site membership (if Windows 2000), and local vs. remote
subnet. When a preferred DC list has been specified for
the matching domain, those addresses are appended to the
front of the list in the order specified, and are tried
first. If no preferred DCs can be contacted, then the
remaining discovered DCs are tried.
This preferred list is also used to control the order in
which Active Directory LDAP servers are chosen.
Listing preferred DCs
To display preferred DC lists, use the print option:
cifs prefdc print [ domain ]
-
domain
- name of the domain whose preferred DC
list to print. If not present, print
preferred DC lists of all domains.
Adding a preferred DC list
To specify a preferred DC list for a domain, use the add
option:
cifs prefdc add domain address [ address ... ]
-
domain
- the domain whose preferred DC list is
being set.
-
address
- IP address for a Domain Controller. At
least one address must be specified.
Multiple addresses must be separated by
spaces.
Deleting a preferred DC list
To delete a deferred DC list for a domain, use the delete
option:
cifs prefdc delete domain
toaster> cifs prefdc add mydom 10.10.10.10 10.10.10.20
Preferred DC list for domain MYDOM:
1. 10.10.10.10
2. 10.10.10.20
toaster> cifs prefdc add otherdomain 10.10.30.10
Preferred DC list for domain OTHERDOMAIN:
1. 10.10.30.10
toaster> cifs prefdc print
Preferred DC lists per domain:
MYDOM:
1. 10.10.10.10
2. 10.10.10.20
OTHERDOMAIN:
1. 10.10.30.10
Any changes take effect after a `cifs resetdc' command or
after a domain controller discovery (within 4 hours).
Changes are persistent across system reboots.
na_cifs_resetdc(1), na_cifs_testdc(1)
Table of Contents