<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
<refentry>
  <refmeta>
    <refentrytitle>krb5_newrealm</refentrytitle>
    <manvolnum>8</manvolnum>
  </refmeta>
  <refnamediv>
    <refname>krb5_newrealm</refname>
    <refpurpose>Create a new Kerberos Realm</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <!-- one of (CALLOUTLIST GLOSSLIST ITEMIZEDLIST ORDEREDLIST SEGMENTEDLIST SIMPLELIST VARIABLELIST CAUTION IMPORTANT NOTE TIP WARNING LITERALLAYOUT PROGRAMLISTING PROGRAMLISTINGCO SCREEN SCREENCO SCREENSHOT SYNOPSIS CMDSYNOPSIS FUNCSYNOPSIS FORMALPARA PARA SIMPARA ADDRESS BLOCKQUOTE GRAPHIC GRAPHICCO MEDIAOBJECT MEDIAOBJECTCO INFORMALEQUATION INFORMALEXAMPLE INFORMALFIGURE INFORMALTABLE EQUATION EXAMPLE FIGURE TABLE MSGSET PROCEDURE SIDEBAR QANDASET ANCHOR BRIDGEHEAD COMMENT HIGHLIGHTS ABSTRACT AUTHORBLURB EPIGRAPH INDEXTERM REFSECT2) -->
    <cmdsynopsis>
      <!-- one of (SBR GROUP ARG COMMAND) -->
      <command>krb5_newrealm</command>
    </cmdsynopsis>
  </refsynopsisdiv>
  <refsect1>
    <title>Description</title> <para>This script attempts to create a
    Kerberos realm.  It assumes that none of the realm components
    exists, except for the /etc/krb5.conf file. (Normally this file
    is automatically generated at package installation, but if you
    skipped the configuration step, you will need to manually generate
    this file before running krb5_newrealm.)
    It creates the database, initializes the stash file in
    <filename>/etc/krb5kdc/stash</filename> containing the master key for
    the database, starts the KDC and Kerberos admin server,
    and creates a stub <filename>/etc/krb5kdc/kadm5.acl</filename> file.
    </para>
</refsect1> 
</refentry>

