isc-config.sh.docbook revision 87a58323be6bc89b50c216ac01c3e92f4721ab7c
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
11e9368a226272085c337e9e74b79808c16fbdbaTinderbox User "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews [<!ENTITY mdash "&#8212;">]>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<!--
4a14ce5ba00ab7bc55c99ffdcf59c7a4ab902721Automatic Updater - Copyright (C) 2009 Internet Systems Consortium, Inc. ("ISC")
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews -
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - Permission to use, copy, modify, and/or distribute this software for any
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - purpose with or without fee is hereby granted, provided that the above
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - copyright notice and this permission notice appear in all copies.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews -
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews - PERFORMANCE OF THIS SOFTWARE.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews-->
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews<!-- $Id: isc-config.sh.docbook,v 1.2 2009/02/18 23:47:48 tbox Exp $ -->
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt<refentry id="man.isc-config.sh">
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <refentryinfo>
cd32f419a8a5432fbb139f56ee73cbf68b9350ccTinderbox User <date>December 19, 2008</date>
0c6ada0a814f3c5417daa1654129bc2af56ed504Automatic Updater </refentryinfo>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <refmeta>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <refentrytitle><application>isc-config.sh</application></refentrytitle>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <manvolnum>1</manvolnum>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <refmiscinfo>BIND9</refmiscinfo>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </refmeta>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <docinfo>
0c6ada0a814f3c5417daa1654129bc2af56ed504Automatic Updater <copyright>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <year>2009</year>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <holder>Internet Systems Consortium, Inc. ("ISC")</holder>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </copyright>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </docinfo>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <refnamediv>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <refname><application>isc-config.sh</application></refname>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <refpurpose>Get information about the installed version of ISC BIND</refpurpose>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </refnamediv>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <refsynopsisdiv>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <cmdsynopsis>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <command>isc-config.sh</command>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <arg><option>--cflags</option></arg>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <arg><option>--exec-prefix</option></arg>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <arg><option>--libs</option></arg>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <arg><option>--prefix</option></arg>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <arg><option>--version</option></arg>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <arg choice="opt" rep="repeat">libraries</arg>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </cmdsynopsis>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </refsynopsisdiv>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <refsect1>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <title>DESCRIPTION</title>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <para><command>isc-config.sh</command>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews prints information related to the installed version of ISC BIND,
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt such as the compiler and linker flags required to compile
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt and link programs that use ISC BIND libraries.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </para>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <para>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt The optional libraries are used to report specific details
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt for compiling and linking for the listed libraries.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt The allowed choices are:
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <option>isc</option>,
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <option>isccc</option>,
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <option>isccfg</option>,
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <option>dns</option>,
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <option>lwres</option>, and
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <option>bind9</option>.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Multiple libraries may be listed on the command line.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt (Some libraries require other libraries, so are implied.)
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </para>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </refsect1>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <refsect1>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <title>OPTIONS</title>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <variablelist>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <varlistentry>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <term>--cflags</term>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <listitem>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <para>
b2f07642fd712c8fda81a116bcdde229ab291f33Tinderbox User Prints the compiler command line options required to
b2f07642fd712c8fda81a116bcdde229ab291f33Tinderbox User compile files that use ISC BIND.
b2f07642fd712c8fda81a116bcdde229ab291f33Tinderbox User Use the <option>libraries</option> command line argument(s)
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt to print additional specific flags to pass to the C compiler.
b2f07642fd712c8fda81a116bcdde229ab291f33Tinderbox User </para>
b2f07642fd712c8fda81a116bcdde229ab291f33Tinderbox User </listitem>
b2f07642fd712c8fda81a116bcdde229ab291f33Tinderbox User </varlistentry>
b2f07642fd712c8fda81a116bcdde229ab291f33Tinderbox User
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <varlistentry>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <term>--exec-prefix</term>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <listitem>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <para>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Prints the directory prefix used in the ISC BIND installation
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt for architecture dependent files to standard output.
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </para>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </listitem>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </varlistentry>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <varlistentry>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <term>--libs</term>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <listitem>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <para>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Prints the linker command line options used to
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt link with the ISC BIND libraries.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Use the <option>libraries</option> command line argument(s)
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews to print additional specific flags.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </para>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </listitem>
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User </varlistentry>
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User <varlistentry>
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User <term>--prefix</term>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <listitem>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <para>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews Prints the directory prefix used in the ISC BIND installation
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt for architecture independent files to standard output.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </para>
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User </listitem>
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User </varlistentry>
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <varlistentry>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <term>--version</term>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <listitem>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <para>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt Prints the version of the installed ISC BIND suite.
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User </para>
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User </listitem>
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User </varlistentry>
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User </variablelist>
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User </refsect1>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <refsect1>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews <title>RETURN VALUES</title>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <para><command>isc-config.sh</command>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt returns an exit status of 1 if
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User invoked with invalid arguments or no arguments at all.
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User It returns 0 if information was successfully printed.
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </para>
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User </refsect1>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User <refsect1>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <title>AUTHOR</title>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt <para><corpauthor>Internet Systems Consortium</corpauthor>
5a4557e8de2951a2796676b5ec4b6a90caa5be14Mark Andrews </para>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt </refsect1>
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User</refentry><!--
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User - Local variables:
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User - mode: sgml
659d063f23a35d77ad5826e6556d3137672bb937Tinderbox User - End:
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt-->
14a656f94b1fd0ababd84a772228dfa52276ba15Evan Hunt