<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<refentry id="re-drbdadm">
  <refentryinfo>
    <date>17 January 2018</date>

    <productname>DRBD</productname>

    <productnumber>9.0.x</productnumber>
  </refentryinfo>

  <refmeta>
    <refentrytitle>drbdadm</refentrytitle>

    <manvolnum>8</manvolnum>

    <refmiscinfo class="manual">System Administration</refmiscinfo>
  </refmeta>

  <refnamediv>
    <refname>drbdadm</refname>

    <refpurpose>Utility for DRBD administration<indexterm significance="normal">
        <primary>drbdadm</primary>
      </indexterm></refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis sepchar=" ">
      <command moreinfo="none">drbdadm</command>

      <arg choice="opt" rep="repeat">options</arg>

      <arg choice="opt" rep="norepeat">--<arg choice="opt"
      rep="repeat"><replaceable>backend-options</replaceable></arg></arg>

      <arg choice="req" rep="norepeat"><replaceable>command</replaceable></arg>

      <arg choice="req" rep="repeat"><replaceable>context</replaceable></arg>

      <!--
      <group choice="opt" rep="norepeat">
        <arg choice="req" rep="norepeat">all</arg>

        <arg choice="req" rep="repeat"><replaceable>resource<arg choice="opt"
        rep="norepeat">/volume</arg></replaceable></arg>
      </group>
      -->
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1>
    <title>Description</title>

    <para>The <option>drbdadm</option> utility is used for managing DRBD based
      on its configuration files, see <citerefentry>
      <refentrytitle>drbd.conf</refentrytitle> <manvolnum>5</manvolnum>
      </citerefentry>.  It translates high-level commands into one or more
      lower-level commands for the <option>drbdsetup</option> and
      <option>drbdmeta</option> utilities, which control the kernel module
      and manipulate the on-disk metadata.</para>

    <para>Depending on the command, the <option>drbdadm</option> utility
      operates on one or more resources, devices, connections, or peer devices.
      The following command contexts are defined:</para>

    <para>
      <variablelist>
	<varlistentry>
	  <term><replaceable>resource</replaceable></term>

	  <listitem>
	    <para>A resource specified by name, or the keyword
	      <option>all</option> for all defined resources.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><replaceable>device</replaceable></term>

	  <listitem>
	    <para>A device, specified by minor number
	      (<option>minor-</option><replaceable>minornumber</replaceable>, e.g. <option>minor-</option><replaceable>0</replaceable>) or by resource and
	      volume number
	      (<replaceable>resource</replaceable>/<replaceable>volume</replaceable>).
	      If only a <replaceable>resource</replaceable> is
	      specified, the command iterates over all devices of that resource.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><replaceable>connection</replaceable></term>

	  <listitem>
	    <para>A connection, specified by resource and connection name
	      (<replaceable>resource</replaceable>:<replaceable>connection-name</replaceable>).
	      If only a <replaceable>resource</replaceable> is specified, the
	      command iterates over all connections of that resource.
	    </para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term><replaceable>peer_device</replaceable></term>

	  <listitem>
	    <para>A peer device, specified by resource, connection name, and
	      volume number
	      (<replaceable>resource</replaceable>:<replaceable>connection-name</replaceable>/<replaceable>volume</replaceable>).
	      If only a <replaceable>resource</replaceable>,
	      <replaceable>device</replaceable>, or
	      <replaceable>connection</replaceable> is specified, the command
	      iterates over all peer devices of that resource, device, or
	      connection.</para>
	  </listitem>
	</varlistentry>
      </variablelist>
    </para>

    <para>All options following a double-dash are passed through to the
      lower-level utilities as specified.  In addition,
      <option>drbdadm</option> understands most of the options of
      <option>drbdsetup</option>, and will pass them through even without the
      double-dash.
    </para>
  </refsect1>

  <refsect1>
    <title>Options</title>

    <variablelist>
      <varlistentry>
        <term><option>-d</option>, <option>--dry-run</option></term>

        <listitem>
	  <para>Show which commands <option>drbdadm</option> would execute
	    instead of actually executing them (for example, <command
	      moreinfo="none">drbdadm -d up <replaceable>resource</replaceable></command>).
	    This can be a useful way to learn how <command
	      moreinfo="none">drbdsetup</command> and <command
	      moreinfo="none">drbdmeta</command> are used.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-c</option>, <option>--config-file</option>
        <replaceable>file</replaceable></term>

        <listitem>
	  <para>Use an alternative configuration file.  By default,
	    <option>drbdadm</option> will use the the first of the following
	    files that exists: <option>/etc/drbd-90.conf</option>,
	    <option>/etc/drbd-84.conf</option>,
	    <option>/etc/drbd-83.conf</option>,
	    <option>/etc/drbd-82.conf</option>,
	    <option>/etc/drbd-08.conf</option>,
	    <option>/etc/drbd.conf</option>.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-t</option>, <option>--config-to-test</option>
        <replaceable>file</replaceable></term>

        <listitem>
	  <para>Check an additional configuration file.  This option is only
	    allowed with the dump and the sh-nop commands.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-s</option>, <option>--drbdsetup</option>
        <replaceable>file</replaceable></term>

        <listitem>
          <para>Specifies the full path to the <option>drbdsetup</option> program. If this option
          is omitted, drbdadm will look for it beneath itself first, and then in the PATH.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-m</option>, <option>--drbdmeta</option>
        <replaceable>file</replaceable></term>

        <listitem>
          <para>Specifies the full path to the <option>drbdmeta</option> program. If this option
          is omitted, drbdadm will look for it beneath itself first, and then in the PATH.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>-S</option>, <option>--stacked</option></term>

        <listitem>
          <para>Perform the command on a stacked resource.</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsect1>

  <refsect1>
    <title>Commands</title>
    <variablelist>
      <varlistentry>
	<term>adjust
	  <arg choice="req" rep="norepeat"><replaceable>resource</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

              <secondary>adjust</secondary>
	    </indexterm> Adjust the configuration of the kernel module so that
	    it matches the configuration files.  The result should be the same
	    as when stopping and restarting all resources (<command
	      moreinfo="none">drbdadm down all</command> followed by <command
	      moreinfo="none">drbdadm up all</command>), but without the
	    interruptions.</para>

	  <para>Note that the adjust command can misinterpret the configuration
	    change in some cases.  To be safe, check what the command would do
	    (with the <option>--dry-run</option> option) before running the
	    actual command.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>adjust-with-progress
	  <arg choice="req" rep="norepeat"><replaceable>resource</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

              <secondary>adjust-with-progress</secondary>
	    </indexterm> The same as <option>adjust</option>, but with some
	    more information about the command's progress.
	  </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>apply-al
	  <arg choice="req" rep="norepeat"><replaceable>device</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

              <secondary>apply-al</secondary>
	      </indexterm> Apply the activity log of the specified device.  See
	      <citerefentry> <refentrytitle>drbdmeta</refentrytitle>
		<manvolnum>8</manvolnum> </citerefentry> for details.
	  </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>attach
	  <arg choice="req" rep="norepeat"><replaceable>device</replaceable></arg>
	</term>

        <listitem>
	  <para>Attach a lower-level device to an existing replicated device.
	    See <citerefentry> <refentrytitle>drbdsetup</refentrytitle>
	      <manvolnum>8</manvolnum> </citerefentry> for details.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>check-resize
	  <arg choice="req" rep="norepeat"><replaceable>device</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

              <secondary>check-resize</secondary>
            </indexterm> Call drbdmeta to eventually move internal meta data. If the backing
          device was resized, while DRBD was not running, meta data has to be moved to the end of
          the device, so that the next <option>attach</option> command can succeed.</para>
        </listitem>
	<!-- FIXME: This is not very clear.  When does the end user need to
	     call this command? -->
      </varlistentry>

      <varlistentry>
        <term>connect
	  <arg choice="req" rep="norepeat"><replaceable>connection</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

	      <secondary>connect</secondary> </indexterm> Activate an exisiting
	      connection to a peer. The connection needs to be created first
	      with the <option>new-peer</option> command, and have at least
	      one path created with the <option>new-path</option> command.
	      See <citerefentry>
	      <refentrytitle>drbdsetup</refentrytitle> <manvolnum>8</manvolnum>
	    </citerefentry> for details.
	  </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>create-md
	  <arg choice="req" rep="norepeat"><replaceable>device</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

              <secondary>create-md</secondary>
	    </indexterm> Initialize the metadata of a device. This is necessary
	    before a device can be attached; see <citerefentry>
	      <refentrytitle>drbdmeta</refentrytitle> <manvolnum>8</manvolnum>
	  </citerefentry> for details.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>cstate
	  <arg choice="req" rep="norepeat"><replaceable>connection</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

              <secondary>cstate</secondary>
	    </indexterm> Show the current state of a connection.  See
	    <citerefentry> <refentrytitle>drbdsetup</refentrytitle>
	      <manvolnum>8</manvolnum> </citerefentry> for details.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>detach
	  <arg choice="req" rep="norepeat"><replaceable>device</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

	      <secondary>detach</secondary> </indexterm> Detach the lower-level
	    device of a replicated device. See <citerefentry>
	      <refentrytitle>drbdsetup</refentrytitle> <manvolnum>8</manvolnum>
	  </citerefentry> for details.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>disconnect
	  <arg choice="req" rep="norepeat"><replaceable>connection</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

	      <secondary>disconnect</secondary> </indexterm> Remove a
	    connection to a peer host.  See <citerefentry>
	      <refentrytitle>drbdsetup</refentrytitle> <manvolnum>8</manvolnum>
	  </citerefentry> for details.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>disk-options
	  <arg choice="req" rep="norepeat"><replaceable>device</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>
              <secondary>disk-options</secondary>
	      </indexterm> Change the disk options of an attached lower-level
	      device.  See <citerefentry>
		<refentrytitle>drbdsetup</refentrytitle>
		<manvolnum>8</manvolnum> </citerefentry> for details.
	  </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>down
	  <arg choice="req" rep="norepeat"><replaceable>resource</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

	      <secondary>down</secondary> </indexterm> Take a resource down by
	    removing all volumes, connections, and the resource itself.
	    See <citerefentry> <refentrytitle>drbdsetup</refentrytitle>
	      <manvolnum>8</manvolnum> </citerefentry> for details.
	  </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>dstate
	  <arg choice="req" rep="norepeat"><replaceable>device</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

	      <secondary>dstate</secondary>
	    </indexterm> Show the current disk
	    state of a lower-level device.  See <citerefentry>
	      <refentrytitle>drbdsetup</refentrytitle> <manvolnum>8</manvolnum>
	    </citerefentry> for details.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>dump
	  <arg choice="req" rep="norepeat"><replaceable>resource</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

              <secondary>dump</secondary>
	    </indexterm> Parse the configuration file and dump it to stdout.
	    This will fail if the configuration file is syntactically
	    incorrect.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>dump-md
	  <arg choice="req" rep="norepeat"><replaceable>device</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

              <secondary>dump-md</secondary>
	  </indexterm> Dump the metadata of a device in text form, including
	  the bitmap and activity log.  See <citerefentry>
	    <refentrytitle>drbdmeta</refentrytitle> <manvolnum>8</manvolnum>
	</citerefentry> for details.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>get-gi
	  <arg choice="req" rep="norepeat"><replaceable>peer_device</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

              <secondary>get-gi</secondary>
	    </indexterm> Show the data generation identifiers for a device on a
	    particular connection.  Uses <option>drbdsetup</option> for
	    attached devices and <option>drbdmeta</option> for unattached
	    devices.  See <citerefentry>
	      <refentrytitle>drbdsetup</refentrytitle> <manvolnum>8</manvolnum>
	    </citerefentry> for details.
	  </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>hidden-commands
	</term>

        <listitem>
          <para>Shows all commands which are not explicitly documented.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>invalidate
	  <arg choice="req" rep="norepeat"><replaceable>peer_device</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

	      <secondary>invalidate</secondary> </indexterm> Replace the local
	    data of a device with that of a peer.  See <citerefentry>
	      <refentrytitle>drbdsetup</refentrytitle> <manvolnum>8</manvolnum>
	    </citerefentry> for details.
	  </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>invalidate-remote
	  <arg choice="req" rep="norepeat"><replaceable>peer_device</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

	      <secondary>invalidate-remote</secondary> </indexterm> Replace a
	    peer device's data of a resource with the local data.  See
	    <citerefentry> <refentrytitle>drbdsetup</refentrytitle>
	      <manvolnum>8</manvolnum> </citerefentry> for details.
	  </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>net-options
	  <arg choice="req" rep="norepeat"><replaceable>connection</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>
              <secondary>net-options</secondary>
	    </indexterm> Change the network options of an existing connection.
	    See <citerefentry> <refentrytitle>drbdsetup</refentrytitle>
	      <manvolnum>8</manvolnum> </citerefentry> for details.
	  </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>new-current-uuid
	  <arg choice="req" rep="norepeat"><replaceable>device</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

	      <secondary>new-current-uuid</secondary> </indexterm> Generate a
	    new currend UUID.  See <citerefentry>
	      <refentrytitle>drbdsetup</refentrytitle> <manvolnum>8</manvolnum>
	    </citerefentry> for details.
	  </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>outdate
	  <arg choice="req" rep="norepeat"><replaceable>device</replaceable></arg>
	</term>

        <listitem>
	  <para><indexterm significance="normal"> <primary>drbdadm</primary>

	      <secondary>outdate</secondary> </indexterm> Mark the data on a
	    lower-level device as outdated.  See <citerefentry>
	      <refentrytitle>drbdsetup</refentrytitle> <manvolnum>8</manvolnum>
	    </citerefentry> for details.
	  </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>pause-sync
	  <arg choice="req" rep="norepeat"><replaceable>peer_device</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

              <secondary>pause-sync</secondary>
	    </indexterm> Stop resynchronizing between a local and a peer device
	    by setting the local pause flag.  See <citerefentry>
	      <refentrytitle>drbdsetup</refentrytitle> <manvolnum>8</manvolnum>
	    </citerefentry> for details.
	  </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>primary
	  <arg choice="req" rep="norepeat"><replaceable>resource</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

	      <secondary>primary</secondary> </indexterm> Change the role of a
	    node in a resource to primary.  See <citerefentry>
	      <refentrytitle>drbdsetup</refentrytitle> <manvolnum>8</manvolnum>
	    </citerefentry> for details.
	  </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>resize
	  <arg choice="req" rep="norepeat"><replaceable>device</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

	      <secondary>resize</secondary> </indexterm> Resize the lower-level
	    devices of a replicated device on all nodes.  This combines the
	    <option>check-resize</option> and <option>resize</option>
	    lower-level commands; see <citerefentry>
	      <refentrytitle>drbdsetup</refentrytitle> <manvolnum>8</manvolnum>
	    </citerefentry> for details.
	  </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>resource-options
	  <arg choice="req" rep="norepeat"><replaceable>resource</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

              <secondary>resource-options</secondary>
	  </indexterm> Change the resource options of an existing
	  resource.  See <citerefentry>
	    <refentrytitle>drbdsetup</refentrytitle> <manvolnum>8</manvolnum>
	    </citerefentry> for details.
	  </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>resume-sync
	  <arg choice="req" rep="norepeat"><replaceable>peer_device</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

	      <secondary>resume-sync</secondary> </indexterm> Allow
	    resynchronization to resume by clearing the local sync pause flag.
	    See <citerefentry> <refentrytitle>drbdsetup</refentrytitle>
	      <manvolnum>8</manvolnum> </citerefentry> for details.
	  </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>role
	  <arg choice="req" rep="norepeat"><replaceable>resource</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

              <secondary>role</secondary>
	    </indexterm> Show the current role of a resource.
	  </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>secondary
	  <arg choice="req" rep="norepeat"><replaceable>resource</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

              <secondary>secondary</secondary>
	    </indexterm> Change the role of a node in a resource to secondary.
	    This command fails if the replicated device is in use.
	  </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>show-gi
	  <arg choice="req" rep="norepeat"><replaceable>peer_device</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

              <secondary>show-gi</secondary>
	    </indexterm> Show the data generation identifiers for a device on a
	    particular connection. In addition, explain the output.  See
	    <citerefentry> <refentrytitle>drbdsetup</refentrytitle>
	      <manvolnum>8</manvolnum> </citerefentry> for details.
	  </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>state
	  <arg choice="req" rep="norepeat"><replaceable>resource</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

              <secondary>state</secondary>
	    </indexterm> This is an alias for <command
	    moreinfo="none">drbdsetup role</command>. Deprecated.
	  </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>up
	  <arg choice="req" rep="norepeat"><replaceable>resource</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

              <secondary>up</secondary>
	    </indexterm> Bring up a resource by applying the activity log of
	    all volumes, creating the resource, creating the replicated
	    devices, attaching the lower-level devices, and connecting to all
	    peers.  See the <option>apply-al</option> drbdmeta command and the
	    <option>new-resource</option>, <option>new-device</option>,
	    <option>new-minor</option>, <option>attach</option>, and
	    <option>connect</option> drbdsetup commands.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>verify
	  <arg choice="req" rep="norepeat"><replaceable>peer_device</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

              <secondary>verify</secondary>
	    </indexterm> Start online verification, change which part of the
	    device will be verified, or stop online verification.  See
	    <citerefentry> <refentrytitle>drbdsetup</refentrytitle>
	      <manvolnum>8</manvolnum> </citerefentry> for details.
	  </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>wait-connect
	  <group choice="req">
	    <arg><replaceable>device</replaceable></arg>
	    <arg><replaceable>connection</replaceable></arg>
	    <arg><replaceable>resource</replaceable></arg>
	  </group>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

	      <secondary>wait-connect</secondary> </indexterm> Wait until a
	    device on a peer, all devices over a connection, or all devices on
	    all peers are visible. See <citerefentry>
	      <refentrytitle>drbdsetup</refentrytitle> <manvolnum>8</manvolnum>
	    </citerefentry> for details.
	  </para>
        </listitem>
      </varlistentry>


      <varlistentry>
        <term>wait-sync
	  <group choice="req">
	    <arg><replaceable>device</replaceable></arg>
	    <arg><replaceable>connection</replaceable></arg>
	    <arg><replaceable>resource</replaceable></arg>
	  </group>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

	      <secondary>wait-sync</secondary> </indexterm> Wait until a
	    device is connected and has finished eventual resync operation. Also
	    available on connection and resource level.  See <citerefentry>
	      <refentrytitle>drbdsetup</refentrytitle> <manvolnum>8</manvolnum>
	    </citerefentry> for details.
	  </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>wipe-md
	  <arg choice="req" rep="norepeat"><replaceable>device</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

	      <secondary>wipe-md</secondary> </indexterm> Wipe out the DRBD
	    metadata of a device.  See <citerefentry>
	      <refentrytitle>drbdmeta</refentrytitle> <manvolnum>8</manvolnum>
	    </citerefentry> for details.
	  </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>forget-peer
	  <arg choice="req" rep="norepeat"><replaceable>connection</replaceable></arg>
	</term>

        <listitem>
          <para><indexterm significance="normal">
              <primary>drbdadm</primary>

	      <secondary>forget-peer</secondary> </indexterm> Completely remove any
	      reference to a unconnected peer from meta-data.
	      See <citerefentry>
	      <refentrytitle>drbdmeta</refentrytitle> <manvolnum>8</manvolnum>
	    </citerefentry> for details.
	  </para>
        </listitem>
      </varlistentry>

    </variablelist>
  </refsect1>

  <refsect1>
    <title>Version</title>

    <simpara>This document was revised for version 9.0.0 of the DRBD distribution.</simpara>
  </refsect1>

  <refsect1>
    <title>Author</title>

    <simpara>Written by Philipp Reisner <email>philipp.reisner@linbit.com</email> and Lars
    Ellenberg <email>lars.ellenberg@linbit.com</email></simpara>
  </refsect1>

  <refsect1>
    <title>Reporting Bugs</title>

    <simpara>Report bugs to <email>drbd-user@lists.linbit.com</email>.</simpara>
  </refsect1>

  <refsect1>
    <title>Copyright</title>

    <simpara>Copyright 2001-2018 LINBIT Information Technologies, Philipp Reisner, Lars Ellenberg.
    This is free software; see the source for copying conditions. There is NO warranty; not even
    for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</simpara>
  </refsect1>

  <refsect1>
    <title>See Also</title>

    <para><citerefentry>
        <refentrytitle>drbd.conf</refentrytitle>

        <manvolnum>5</manvolnum>
      </citerefentry>, <citerefentry>
        <refentrytitle>drbd</refentrytitle>

        <manvolnum>8</manvolnum>
      </citerefentry>, <citerefentry>
        <refentrytitle>drbdsetup</refentrytitle>

        <manvolnum>8</manvolnum>
      </citerefentry>, <citerefentry>
        <refentrytitle>drbdmeta</refentrytitle>

        <manvolnum>8</manvolnum>
      </citerefentry> and the
      <ulink url="http://www.drbd.org/"><citetitle>DRBD project web site</citetitle></ulink></para>

  </refsect1>
</refentry>