<?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="setup-nsssysinit">

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

  <refmeta>
    <refentrytitle>setup-nsssysinit</refentrytitle>
    <manvolnum>1</manvolnum>
  </refmeta>

  <refnamediv>
    <refname>setup-nsssysinit</refname>
    <refpurpose>Query or enable the nss-sysinit module</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis>
      <command>setup-nsssysinit</command>
      <arg><option>on</option></arg>
      <arg><option>off</option></arg>
      <arg><option>status</option></arg>
    </cmdsynopsis>
  </refsynopsisdiv>

<refsection id="description">
    <title>Description</title>
    <para><command>setup-nsssysinit</command> is a shell script to query the status of the nss-sysinit module and when run with root priviledge it can enable or disable it. </para>
  <para>Turns on or off the nss-sysinit module db by editing the global PKCS #11 configuration file. Displays the status. This script can be invoked by the user as super user. It is invoked at nss-sysinit post install time with argument on.
  </para>
  </refsection>
  
  <refsection>
    <title>Options</title>
    
    <variablelist>
      <varlistentry>
        <term><option>on</option></term>
        <listitem><simpara>Turn on nss-sysinit.</simpara></listitem>
      </varlistentry>

      <varlistentry>
        <term><option>off</option></term>
        <listitem><simpara>Turn on nss-sysinit.</simpara></listitem>
      </varlistentry>

      <varlistentry>
        <term><option>status</option></term>
        <listitem><simpara>returns whether nss-syinit is enabled or not.</simpara></listitem>
      </varlistentry>

    </variablelist>
  </refsection>

  <refsection>
    <title>Examples</title>

    <para>The following example will query for the status of nss-sysinit:
      <programlisting>
        /usr/bin/setup-nsssysinit status
      </programlisting>
    </para>

    <para>The following example, when run as superuser, will turn on nss-sysinit:
      <programlisting>
        /usr/bin/setup-nsssysinit on
      </programlisting>
    </para>

  </refsection>

  <refsection>
    <title>Files</title>
    <para><filename>/usr/bin/setup-nsssysinit</filename></para>
  </refsection>

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

  <refsection id="authors">
    <title>Authors</title>
    <para>The nss libraries 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>

