<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
  "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
<!ENTITY date SYSTEM "date.xml">
<!ENTITY version SYSTEM "version.xml">
]>

<refentry id="nss-config">

  <refentryinfo>
    <date>&date;</date>
    <title>Network Security Services</title>
    <productname>nss</productname>
    <productnumber>&version;</productnumber>
  </refentryinfo>

  <refmeta>
    <refentrytitle>nss-config</refentrytitle>
    <manvolnum>1</manvolnum>
  </refmeta>

  <refnamediv>
    <refname>nss-config</refname>
    <refpurpose>Return meta information about nss libraries</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis>
      <command>nss-config</command>
      <arg><option>--prefix</option></arg>
      <arg><option>--exec-prefix</option></arg>
      <arg><option>--includedir</option></arg>
      <arg><option>--libs</option></arg>
      <arg><option>--cflags</option></arg>
      <arg><option>--libdir</option></arg>
      <arg><option>--version</option></arg>
    </cmdsynopsis>
  </refsynopsisdiv>

<refsection id="description">
    <title>Description</title>

    <para><command>nss-config</command> is a shell scrip
    tool which can be used to obtain gcc options for building client pacakges of nspt. </para>

  </refsection>
  
  <refsection>
    <title>Options</title>
    
    <variablelist>
      <varlistentry>
        <term><option>--prefix</option></term>
        <listitem><simpara>Returns the top level system directory under which the nss libraries are installed.</simpara></listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--exec-prefix</option></term>
        <listitem><simpara>returns the top level system directory under which any nss binaries would be installed.</simpara></listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--includedir</option> <replaceable>count</replaceable></term>
        <listitem><simpara>returns the path to the directory were the nss libraries are installed.</simpara></listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--version</option></term>
        <listitem><simpara>returns the upstream version of nss in the form major_version-minor_version-patch_version.</simpara></listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--libs</option></term>
        <listitem><simpara>returns the compiler linking flags.</simpara></listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--cflags</option></term>
        <listitem><simpara>returns the compiler include flags.</simpara></listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--libdir</option></term>
        <listitem><simpara>returns the path to the directory were the nss libraries are installed.</simpara></listitem>
      </varlistentry>

    </variablelist>
  </refsection>

  <refsection>
    <title>Examples</title>

    <para>The following example will query for both include path and linkage flags:
    
      <programlisting>
        /usr/bin/nss-config --cflags --libs
      </programlisting>

    </para>

   
  </refsection>

  <refsection>
    <title>Files</title>

    <para><filename>/usr/bin/nss-config</filename></para>

  </refsection>

  <refsection>
    <title>See also</title>
    <para>pkg-config(1)</para>
  </refsection>

  <refsection id="authors">
    <title>Authors</title>
    <para>The nss liraries were written and maintained by developers with Netscape, Red Hat,  Sun, Oracle, Mozilla, and Google.</para>
    <para>
	Authors: Elio Maldonado &lt;emaldona@redhat.com>.
    </para>
  </refsection>

<!-- don't change -->
  <refsection id="license">
    <title>LICENSE</title>
    <para>Licensed under the Mozilla Public License, v. 2.0.  If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
    </para>
  </refsection>

</refentry>