logo

Manual Pages


Table of Contents

NAME

na_cifs_prefdc - configure and display CIFS preferred Domain Controller information

SYNOPSIS

cifs prefdc print [ domain ]

cifs prefdc add domain address [ address ... ]

cifs prefdc delete domain

DESCRIPTION

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

EXAMPLES

  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

EFFECTIVE

Any changes take effect after a `cifs resetdc' command or after a domain controller discovery (within 4 hours).

PERSISTENCE

Changes are persistent across system reboots.

SEE ALSO

na_cifs_resetdc(1), na_cifs_testdc(1)


Table of Contents