remove-administration-reference-20080627

[openafs.git] / doc / xml / AdminReference / sect8 / bos_exec.xml

diff --git a/doc/xml/AdminReference/sect8/bos_exec.xml b/doc/xml/AdminReference/sect8/bos_exec.xml
deleted file mode 100644 (file)
index 7c2d436..0000000
--- a/doc/xml/AdminReference/sect8/bos_exec.xml
+++ /dev/null
@@ -1,119 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<refentry id="bos_exec8">
-  <refmeta>
-    <refentrytitle>bos exec</refentrytitle>
-    <manvolnum>8</manvolnum>
-  </refmeta>
-  <refnamediv>
-    <refname>bos exec</refname>
-    <refpurpose>Executes a command on a remote server machine</refpurpose>
-  </refnamediv>
-  <refsect1>
-    <title>Synopsis</title>
-    <para><emphasis role="bold">bos exec</emphasis> <emphasis role="bold">-server</emphasis> &lt;<emphasis>machine name</emphasis>&gt; <emphasis role="bold">-cmd</emphasis> &lt;<emphasis>command to execute</emphasis>&gt;
-        [<emphasis role="bold">-cell</emphasis> &lt;<emphasis>cell name</emphasis>&gt;] [<emphasis role="bold">-noauth</emphasis>] [<emphasis role="bold">-localauth</emphasis>] [<emphasis role="bold">-help</emphasis>]</para>
-
-    <para><emphasis role="bold">bos e</emphasis> <emphasis role="bold">-s</emphasis> &lt;<emphasis>machine name</emphasis>&gt; <emphasis role="bold">-cm</emphasis> &lt;<emphasis>command to execute</emphasis>&gt;
-        [<emphasis role="bold">-ce</emphasis> &lt;<emphasis>cell name</emphasis>&gt;] [<emphasis role="bold">-n</emphasis>] [<emphasis role="bold">-l</emphasis>] [<emphasis role="bold">-h</emphasis>]</para>
-
-  </refsect1>
-  <refsect1>
-    <title>Description</title>
-    <para>The <emphasis role="bold">bos exec</emphasis> command executes the indicated command on the file server
-    machine named by the <emphasis role="bold">-server</emphasis> argument. Its intended use is to reboot
-    the machine, using the <replaceable>/sbin/reboot</replaceable> command or equivalent.</para>
-
-  </refsect1>
-  <refsect1>
-    <title>Options</title>
-    <variablelist>
-      <varlistentry>
-        <term><emphasis role="bold">-server</emphasis> &lt;<emphasis>machine name</emphasis>&gt;</term>
-        <listitem>
-          <para>Indicates the server machine on which to execute the command.  Identify
-          the machine by IP address or its host name (either fully-qualified or
-          abbreviated unambiguously). For details, see <link linkend="bos8">bos(8)</link>.</para>
-
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><emphasis role="bold">-cmd</emphasis> &lt;<emphasis>command to execute</emphasis>&gt;</term>
-        <listitem>
-          <para>Specifies the complete local disk pathname of the command to execute (for
-          example, <replaceable>/sbin/reboot</replaceable>). Surround this argument with double quotes
-          (<computeroutput>""</computeroutput>) if the command contains one or more spaces.</para>
-
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><emphasis role="bold">-cell</emphasis> &lt;<emphasis>cell name</emphasis>&gt;</term>
-        <listitem>
-          <para>Names the cell in which to run the command. Do not combine this argument
-          with the <emphasis role="bold">-localauth</emphasis> flag. For more details, see <link linkend="bos8">bos(8)</link>.</para>
-
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><emphasis role="bold">-noauth</emphasis></term>
-        <listitem>
-          <para>Assigns the unprivileged identity <computeroutput>anonymous</computeroutput> to the issuer. Do not
-          combine this flag with the <emphasis role="bold">-localauth</emphasis> flag. For more details, see
-          <link linkend="bos8">bos(8)</link>.</para>
-
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><emphasis role="bold">-localauth</emphasis></term>
-        <listitem>
-          <para>Constructs a server ticket using a key from the local
-          <replaceable>/usr/afs/etc/KeyFile</replaceable> file. The <emphasis role="bold">bos</emphasis> command interpreter presents the
-          ticket to the BOS Server during mutual authentication. Do not combine this
-          flag with the <emphasis role="bold">-cell</emphasis> or <emphasis role="bold">-noauth</emphasis> options. For more details, see
-          <link linkend="bos8">bos(8)</link>.</para>
-
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><emphasis role="bold">-help</emphasis></term>
-        <listitem>
-          <para>Prints the online help for this command. All other valid options are
-          ignored.</para>
-
-        </listitem>
-      </varlistentry>
-    </variablelist>
-  </refsect1>
-  <refsect1>
-    <title>Examples</title>
-    <para>The following command reboots the machine <computeroutput>fs2.abc.com</computeroutput>. The issuer has
-    previously issued the <emphasis role="bold">bos shutdown</emphasis> command to shutdown all processes
-    cleanly.</para>
-
-<programlisting>
-   % bos exec -server fs2.abc.com -cmd /sbin/shutdown -r now
-
-</programlisting>
-    </refsect1>
-    <refsect1>
-      <title>Privilege Required</title>
-      <para>The issuer must be listed in the <replaceable>/usr/afs/etc/UserList</replaceable> file on the
-      machine named by the <emphasis role="bold">-server</emphasis> argument, or must be logged onto a server
-      machine as the local superuser <computeroutput>root</computeroutput> if the <emphasis role="bold">-localauth</emphasis> flag is
-      included.</para>
-
-    </refsect1>
-    <refsect1>
-      <title>See Also</title>
-      <para><link linkend="bos8">bos(8)</link></para>
-
-    </refsect1>
-    <refsect1>
-      <title>Copyright</title>
-      <para>IBM Corporation 2000. &lt;http://www.ibm.com/&gt; All Rights Reserved.</para>
-
-      <para>This documentation is covered by the IBM Public License Version 1.0.  It was
-      converted from HTML to POD by software written by Chas Williams and Russ
-      Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.</para>
-
-    </refsect1>
-  </refentry>