src/WINNT/doc/install/Documentation/en_US/html/CmdRef/auarf122.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
   2 <HTML><HEAD>
   3 <TITLE>Administration Reference</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3190/auarf000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 5 Nov 1999 at 13:58:29                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Fri, 05 Nov 1999 13:58:29">
   8 <META HTTP-EQUIV="review" CONTENT="Sun, 05 Nov 2000 13:58:29">
   9 <META HTTP-EQUIV="expires" CONTENT="Mon, 05 Nov 2001 13:58:29">
  10 </HEAD><BODY>
  11 <!-- (C) IBM Corporation 2000. All Rights Reserved    -->
  12 <BODY bgcolor="ffffff">
  13 <!-- End Header Records  ============================================ -->
  14 <A NAME="Top_Of_Page"></A>
  15 <H1>Administration Reference</H1>
  16 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf121.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auarf123.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
  17 <P>
  18 <H2><A NAME="HDRBOS_STOP" HREF="auarf002.htm#ToC_136">bos stop</A></H2>
  19 <A NAME="IDX4663"></A>
  20 <A NAME="IDX4664"></A>
  21 <A NAME="IDX4665"></A>
  22 <A NAME="IDX4666"></A>
  23 <A NAME="IDX4667"></A>
  24 <A NAME="IDX4668"></A>
  25 <A NAME="IDX4669"></A>
  26 <A NAME="IDX4670"></A>
  27 <P><STRONG>Purpose</STRONG>
  28 <P>Stops a process after changing its status flag in the
  29 <B>/usr/afs/local/BosConfig</B> file
  30 <P><STRONG>Synopsis</STRONG>
  31 <PRE><B>bos stop -server</B> &lt;<VAR>machine&nbsp;name</VAR>>  <B>-instance</B> &lt;<VAR>server&nbsp;process&nbsp;name</VAR>><SUP>+</SUP>
  32          [<B>-wait</B>]  [<B>-cell</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-noauth</B>]  [<B>-localauth</B>]  [<B>-help</B>]
  33
  34 <B>bos sto -s</B> &lt;<VAR>machine&nbsp;name</VAR>>  <B>-i</B> &lt;<VAR>server&nbsp;process&nbsp;name</VAR>><SUP>+</SUP>
  35         [<B>-w</B>]  [<B>-c</B> &lt;<VAR>cell&nbsp;name</VAR>>]  [<B>-n</B>]  [<B>-l</B>]  [<B>-h</B>]
  36 </PRE>
  37 <P><STRONG>Description</STRONG>
  38 <P>The <B>bos stop</B> command sets the status flag for each process
  39 specified with the <B>-instance</B> argument to <TT>NotRun</TT> in the
  40 <B>/usr/afs/local/BosConfig</B> file on the server machine named by the
  41 <B>-server</B> argument, then stops it.
  42 <P>To stop a process without changing its <B>BosConfig</B> status flag,
  43 use the <B>bos shutdown</B> command instead.
  44 <P><STRONG>Options</STRONG>
  45 <DL>
  46 <P><DT><B><B>-server</B>
  47 </B><DD>Indicates the server machine on which to stop processes. Identify
  48 the machine by IP address or its host name (either fully-qualified or
  49 abbreviated unambiguously). For details, see the introductory reference
  50 page for the <B>bos</B> command suite.
  51 <P><DT><B><B>-instance</B>
  52 </B><DD>Names each process to stop. Use the process name assigned with the
  53 <B>-instance</B> argument to the <B>bos create</B> command. The
  54 output from the <B>bos status</B> command lists the names.
  55 <P><DT><B><B>-wait</B>
  56 </B><DD>Delays the return of the command shell prompt until all processes actually
  57 stop. If this argument is omitted, the prompt returns almost
  58 immediately even if all processes are not stopped.
  59 <P><DT><B><B>-cell</B>
  60 </B><DD>Names the cell in which to run the command. Do not combine this
  61 argument with the <B>-localauth</B> flag. For more details, see the
  62 introductory <B>bos</B> reference page.
  63 <P><DT><B><B>-noauth</B>
  64 </B><DD>Assigns the unprivileged identity <B>anonymous</B> to the
  65 issuer. Do not combine this flag with the <B>-localauth</B>
  66 flag. For more details, see the introductory <B>bos</B> reference
  67 page.
  68 <P><DT><B><B>-localauth</B>
  69 </B><DD>Constructs a server ticket using a key from the local
  70 <B>/usr/afs/etc/KeyFile</B> file. The <B>bos</B> command
  71 interpreter presents the ticket to the BOS Server during mutual
  72 authentication. Do not combine this flag with the <B>-cell</B> or
  73 <B>-noauth</B> options. For more details, see the introductory
  74 <B>bos</B> reference page.
  75 <P><DT><B>-help
  76 </B><DD>Prints the online help for this command. All other valid options
  77 are ignored.
  78 </DL>
  79 <P><STRONG>Examples</STRONG>
  80 <P>The following example command stops the <B>upserver</B> and
  81 <B>runntp</B> on the machine <B>fs7.abc.com</B>.
  82 <PRE>   % <B>bos stop -server fs7.abc.com -instance upserver runntp</B>
  83
  84 </PRE>
  85 <P><STRONG>Privilege Required</STRONG>
  86 <P>The issuer must be listed in the <B>/usr/afs/etc/UserList</B> file on
  87 the machine named by the <B>-server</B> argument, or must be logged onto a
  88 server machine as the local superuser <B>root</B> if the
  89 <B>-localauth</B> flag is included.
  90 <P><STRONG>Related Information</STRONG>
  91 <P><A HREF="auarf016.htm#HDRBOSCONFIG">BosConfig</A>
  92 <P><A HREF="auarf023.htm#HDRKEYFILE">KeyFile</A>
  93 <P><A HREF="auarf035.htm#HDRUSERLIST">UserList</A>
  94 <P><A HREF="auarf093.htm#HDRBOS_INTRO">bos</A>
  95 <P><A HREF="auarf098.htm#HDRBOS_CREATE">bos create</A>
  96 <P><A HREF="auarf118.htm#HDRBOS_SHUTDOWN">bos shutdown</A>
  97 <P><A HREF="auarf121.htm#HDRBOS_STATUS">bos status</A>
  98 <P>
  99 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf121.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auarf123.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
 100 <!-- Begin Footer Records  ========================================== -->
 101 <P><HR><B>
 102 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 103 </B>
 104 <!-- End Footer Records  ============================================ -->
 105 <A NAME="Bot_Of_Page"></A>
 106 </BODY></HTML>