1 <?xml version="1.0" encoding="UTF-8"?>
2 <refentry id="bos_shutdown8">
4 <refentrytitle>bos shutdown</refentrytitle>
5 <manvolnum>8</manvolnum>
8 <refname>bos shutdown</refname>
9 <refpurpose>Stops a process without changing its status flag</refpurpose>
12 <title>Synopsis</title>
13 <para><emphasis role="bold">bos shutdown</emphasis> <emphasis role="bold">-server</emphasis> <<emphasis>machine name</emphasis>>
14 [<emphasis role="bold">-instance</emphasis> <<emphasis>instances</emphasis>>+] [<emphasis role="bold">-wait</emphasis>] [<emphasis role="bold">-cell</emphasis> <<emphasis>cell name</emphasis>>]
15 [<emphasis role="bold">-noauth</emphasis>] [<emphasis role="bold">-localauth</emphasis>] [<emphasis role="bold">-help</emphasis>]</para>
17 <para><emphasis role="bold">bos sh</emphasis> <emphasis role="bold">-s</emphasis> <<emphasis>machine name</emphasis>> [<emphasis role="bold">-i</emphasis> <<emphasis>instances</emphasis>>+] [<emphasis role="bold">-w</emphasis>]
18 [<emphasis role="bold">-c</emphasis> <<emphasis>cell name</emphasis>>] [<emphasis role="bold">-n</emphasis>] [<emphasis role="bold">-l</emphasis>] [<emphasis role="bold">-h</emphasis>]</para>
22 <title>Description</title>
23 <para>The <emphasis role="bold">bos shutdown</emphasis> command stops, on the server machine named by the
24 <emphasis role="bold">-server</emphasis> argument, either</para>
28 <para>All of the currently running AFS server processes, except the BOS Server.</para>
32 <para>Only the processes specified by the <emphasis role="bold">-instance</emphasis> argument.</para>
36 <para>This command does not change a process's status flag in the
37 <replaceable>/usr/afs/local/BosConfig</replaceable> file, but only in the BOS Server's memory. To
38 stop a process and change its <replaceable>BosConfig</replaceable> status flag, use the <emphasis role="bold">bos
39 stop</emphasis> command instead.</para>
41 <para>Once stopped with this command, a process does not run again until an
42 administrator starts it by using the <emphasis role="bold">bos start</emphasis>, <emphasis role="bold">bos startup</emphasis>, or
43 <emphasis role="bold">bos restart</emphasis> command, or until the BOS Server restarts (assuming that
44 the process's <replaceable>BosConfig</replaceable> status flag is <computeroutput>Run</computeroutput>).</para>
48 <title>Options</title>
51 <term><emphasis role="bold">-server</emphasis> <<emphasis>machine name</emphasis>></term>
53 <para>Indicates the server machine on which to stop processes. Identify the
54 machine by IP address or its host name (either fully-qualified or
55 abbreviated unambiguously). For details, see <link linkend="bos8">bos(8)</link>.</para>
60 <term><emphasis role="bold">-instance</emphasis> <<emphasis>instances</emphasis>>+</term>
62 <para>Names each process to stop. Use the process name assigned with the
63 <emphasis role="bold">-instance</emphasis> argument to the <emphasis role="bold">bos create</emphasis> command. The output from the
64 <emphasis role="bold">bos status</emphasis> command lists the names. Omit this argument to stop all
65 processes other than the BOS Server.</para>
70 <term><emphasis role="bold">-wait</emphasis></term>
72 <para>Delays the return of the command shell prompt until all processes actually
73 stop. If this argument is omitted, the prompt returns almost immediately
74 even if all processes are not stopped.</para>
79 <term><emphasis role="bold">-cell</emphasis> <<emphasis>cell name</emphasis>></term>
81 <para>Names the cell in which to run the command. Do not combine this argument
82 with the <emphasis role="bold">-localauth</emphasis> flag. For more details, see <link linkend="bos8">bos(8)</link>.</para>
87 <term><emphasis role="bold">-noauth</emphasis></term>
89 <para>Assigns the unprivileged identity <computeroutput>anonymous</computeroutput> to the issuer. Do not
90 combine this flag with the <emphasis role="bold">-localauth</emphasis> flag. For more details, see
91 <link linkend="bos8">bos(8)</link>.</para>
96 <term><emphasis role="bold">-localauth</emphasis></term>
98 <para>Constructs a server ticket using a key from the local
99 <replaceable>/usr/afs/etc/KeyFile</replaceable> file. The <emphasis role="bold">bos</emphasis> command interpreter presents the
100 ticket to the BOS Server during mutual authentication. Do not combine this
101 flag with the <emphasis role="bold">-cell</emphasis> or <emphasis role="bold">-noauth</emphasis> options. For more details, see
102 <link linkend="bos8">bos(8)</link>.</para>
107 <term><emphasis role="bold">-help</emphasis></term>
109 <para>Prints the online help for this command. All other valid options are
117 <title>Examples</title>
118 <para>The following command stops all processes other than the BOS Server on the
119 machine <computeroutput>fs3.abc.com</computeroutput>.</para>
122 % bos shutdown fs3.abc.com
125 <para>The following command stops the <computeroutput>upserver</computeroutput> process (server portion of the
126 Update Server) on the machine <computeroutput>fs5.abc.com</computeroutput>.</para>
129 % bos shutdown -server fs5.abc.com -instance upserver
134 <title>Privilege Required</title>
135 <para>The issuer must be listed in the <replaceable>/usr/afs/etc/UserList</replaceable> file on the
136 machine named by the <emphasis role="bold">-server</emphasis> argument, or must be logged onto a server
137 machine as the local superuser <computeroutput>root</computeroutput> if the <emphasis role="bold">-localauth</emphasis> flag is
142 <title>See Also</title>
143 <para><link linkend="BosConfig5">BosConfig(5)</link>,
144 <link linkend="KeyFile5">KeyFile(5)</link>,
145 <link linkend="UserList5">UserList(5)</link>,
146 <link linkend="bos8">bos(8)</link>,
147 <link linkend="bos_create8">bos_create(8)</link>,
148 <link linkend="bos_restart8">bos_restart(8)</link>,
149 <link linkend="bos_start8">bos_start(8)</link>,
150 <link linkend="bos_startup8">bos_startup(8)</link>,
151 <link linkend="bos_status8">bos_status(8)</link></para>
155 <title>Copyright</title>
156 <para>IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.</para>
158 <para>This documentation is covered by the IBM Public License Version 1.0. It was
159 converted from HTML to POD by software written by Chas Williams and Russ
160 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.</para>