unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



bindconfig(8)							bindconfig(8)



NAME

  bindconfig - Configures BIND services	for a single system or cluster

SYNOPSIS

  /usr/sbin/bindconfig	[-ui cui  [clioptions] | gui  [x resources]]

  /usr/sbin/sysman dns	[-ui cui  [clioptions] | gui  [x resources]]

OPTIONS

  -ui Specifies	the user interface to be invoked.  The choices are:

      cui     Specifies	command	line interface.

      gui     Specifies	graphical user interface.

  [clioptions]
      Specific command line options that will be used to interact with
      netconfig.  The syntax is	as follows:

      -Help
	  Provides a brief help	message, listing all the configurable com-
	  ponents along	with the actions that can be performed on those	com-
	  ponents.  Configurable components are	indicated in Help output by a
	  "-" prefix.

      -<&lt;component>&gt;Help
	  Provides a detailed help message on how to configure the specified
	  configurable component.  Each	action will be listed on a separate
	  line with the	attributes that	can be used for	the action.  The con-
	  figurable components are:

	  client
	      Sets the respective variables in the /etc/rc.config.common file
	      to denote	that the system	is configured as a BIND	client.

	  server
	      Sets the respective BIND variables in the	/etc/rc.config.common
	      file to denote that the system is	configured as a	BIND server,
	      and allows the user to specify the boot, cache, and BIND data-
	      base directory.  The named daemon	can be started and stopped
	      during this configuration.

	  resolver
	      Sets the resolution order	in the /etc/svc.conf and
	      /etc/svcorder files. Also	sets the resolution parameters such
	      as domain	and name server	in the /etc/resolv.conf	file.  This
	      item must	be configured in order for your	system to run any
	      BIND service as either a client or server.

	  zone
	      Configured only when the BIND service type is Server.  Sets the
	      domains of the zones the system has authority over in the
	      /etc/namedb/named.boot file and creates files for	the BIND
	      database to be stored in.

	  resource
	      Resource records are specified for every zone configured,	and
	      the resource record data is stored in the	respective zone	data-
	      base files.

	  all Used primarily to	deconfigure BIND on a system, this removes
	      all traces of BIND from the /etc/rc.config.common,
	      /etc/namedb/named.boot, /etc/resolv.conf,	/etc/svcorder and
	      /etc/svc.conf files and kills the	named daemon if	it is run-
	      ning.

      -<&lt;component>&gt;<&lt;action>&gt;[attr=value...]
	  Used to perform a specific action on the selected component,
	  optionally by	altering the attribute's value for the selected	com-
	  ponent.  A list of actions and their specific	attribute-value	pair
	  will be listed by the	clioption -configurable_component>&gt;Help.	 The
	  actions are:

	  create
	      Causes a new configuration to be created on the system for the
	      selected component

	  modify
	      Modifies an existing configuration for the selected component

	  add Adds a new value to an attribute on an existing configuration
	      for the selected component

	  remove
	      Deletes a	value of an attribute on an existing configuration
	      for the selected component

	  purge
	      Removes an existing configuration	for the	selected component

	  list
	      Lists all	the attribute-value pairs for the selected component
	      on the system

  The x	resources are standard X11 resource options.  For more information,
  see the X(1X)	reference page.

DESCRIPTION

  The Bind Configuration application, bindconfig, allows a system to be	con-
  figured as a Berkeley	Internet Name Domain (BIND) Client, which queries a
  BIND server for host name and	address	information, interprets	responses,
  and passes the information to	requesting applications, or as a BIND Server,
  which	is the authoritative source for	information about a zone or zones.
  The BIND server either maintains the master copy of the hosts	database for
  the zone or zones, or	obtains	the required information.

  Before using bindconfig, be sure to configure	Network	Interfaces using the
  Network Configuration	Manager	application.  You can access netconfig from
  the Configuration Checklist.	If the Network Interfaces are down when	you
  configure your system	as either a BIND client	or a BIND server, the named
  daemon will not start.

  Use bindconfig to:

    +  Configure the host system as a master nameserver	for one	or more
       zones, as a caching-only	nameserver, or as a nameservice	client

    +  Initialize and maintain BIND data files and generate resource records
       to manage areas such as:	host name to address/address to	host name
       mapping,	host information, host name aliasing, name servers, mail
       exchange, and the cache file root server	list

    +  Manage the BIND boot files, including creation of multiple zones	of
       authority, designation of forwarders, and indication of slave confi-
       gurations

    +  Maintain	the resolver configuration file, specify queriable name
       servers,	and specify an alternate domain	search list

  The bindconfig application provides a	host name and address lookup service
  for the Internet Network. The	application distributes	only the hosts data-
  base in the Tru64 UNIX operating system.

  You must have	root privileges	to run this application.

  The bindconfig command has three user	interface options:

    +  Graphical user interface	(GUI)

    +  Command line interface (CLI)

    +  Menu interface (Menu)

  Running the Graphical	User Interface Option:


  To start bindconfig from the graphical user interface, do the	following:

   1.  Click on	the Application	Manager	icon on	the CDE	front panel.

   2.  Double click on the System_Admin	application group icon.

   3.  Double click on the Configuration application group icon.

   4.  Double click on the BIND	icon.

  To start bindconfig from the xterm, enter the	following command from the
  xterm:

       /usr/sbin/sysman	dns

  Running the Command Line Interface Option:


  To start the bindconfig command line interface, enter	the following command
  from the xterm:

       sysman dns -ui cui [clioptions]

  Running the Menu Interface Option:


  To start the bindconfig menu interface, enter	the following command from
  the xterm:

       sysman dns

  This option starts the setup script for bindsetup.  For more information,
  see the bindsetup(8) reference page.



  Running Online Help:


  You can view online help for this application	by entering the	following at
  the command line:

       /usr/dt/bin/dthelpview -helpVolume \
       /usr/dt/appconfig/help/C/BindConfig.sdl

  You can also view online help	for this application by	choosing Help from
  the menu bar in the GUI version.  The	Help pulldown menu is displayed, pro-
  viding the following options:

  Overview: Displays the Overview section of the help volume, which describes
  the purpose of the application, how to run the application, and how to exit
  the application.

  Tasks: Displays the Tasks section of the help	volume,	which describes	how
  to use the application to perform various tasks.

  Reference: Displays the Reference section of the help	volume,	which
  describes all	dialog boxes and dialog	box components in the application.

  On Item: Activates the On Item help functionality by displaying a question
  mark as the cursor.  When the	cursor is positioned on	any component in the
  application and you click on the component, a	Help Viewer window is opened
  and the help for the selected	component is displayed in the window.

  Using	Help: Displays the standard CDE	instructions on	how to use the Help
  Viewer.

  About: Displays version, copyright, and trademark information	for the
  application.

EXAMPLES

   1.  The following example shows how to configure the	system for a BIND
       client configuration using the command line interface:
	    sysman dns -ui cui -resolver create	domain=x.y.com ns=1.1.1.1
	    sysman dns -ui cui -client create

   2.  The following example shows how to add an additional name server	using
       the command line	interface:
	    sysman dns -ui cui -resolver add ns=1.1.1.2	search=y.y.com

   3.  The following example shows how to configure the	system as a BIND
       server using the	command	line interface:
	    bindconfig -ui cui -server create domain=x.y.com \
	    boot=/etc/namedb/named.boot	cache=/etc/namedb/named.ca \
	    dir=/etc/namedb active=yes

   4.  The following example shows how to deconfigure all BIND services	using
       the command line	interface:
	    bindconfig -ui cui -all purge



FILES

  /etc/hosts
      Lists locally maintained host names and IP addresses

  /etc/svc.conf
      The database name	with the selected naming services

  /etc/rc.config.common
      Specifies	the environment	variables that define the BIND configuration
      on your system

  Default BIND Files:

  /etc/namedb
      BIND server data file directory

  /etc/namedb/named.boot
      BIND server boot file

  /etc/namedb/named.ca
      BIND server cache	file

  /etc/namedb/named.local
      BIND server local	host reverse address host file

  /etc/namedb/hosts.db
      BIND primary server hosts	file

  /etc/namedb/hosts.rev
      BIND primary server reverse address hosts	file

  /etc/resolv.conf
      BIND data	file

SEE ALSO

  Commands: named(8), nslookup(8), rc.config(8), svcsetup(8), xauth(1X)

  Files: resolv.conf(4), svc.conf(4)

  Network Services: bind_intro(7)