sbin/rcrun/rcrun.8

   1 .\"
   2 .\" Copyright (c) 2007 The DragonFly Project.  All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\"
   8 .\" 1. Redistributions of source code must retain the above copyright
   9 .\"    notice, this list of conditions and the following disclaimer.
  10 .\" 2. Redistributions in binary form must reproduce the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer in
  12 .\"    the documentation and/or other materials provided with the
  13 .\"    distribution.
  14 .\" 3. Neither the name of The DragonFly Project nor the names of its
  15 .\"    contributors may be used to endorse or promote products derived
  16 .\"    from this software without specific, prior written permission.
  17 .\"
  18 .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  19 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  20 .\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  21 .\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE
  22 .\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
  23 .\" INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
  24 .\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  25 .\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
  26 .\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  27 .\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  28 .\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  29 .\" SUCH DAMAGE.
  30 .\"
  31 .Dd October 13, 2007
  32 .Dt RCRUN 8
  33 .Os
  34 .Sh NAME
  35 .Nm rcrun ,
  36 .Nm rcstart ,
  37 .Nm rcforce ,
  38 .Nm rcfast ,
  39 .Nm rcone ,
  40 .Nm rcstop ,
  41 .Nm rcrestart ,
  42 .Nm rcvar ,
  43 .Nm rcdisable ,
  44 .Nm rcenable ,
  45 .Nm rclist
  46 .Nd rc script control utility
  47 .Sh SYNOPSIS
  48 .Nm rcrun
  49 .Cm command Ar script ...
  50 .Nm rcstart
  51 .Ar script ...
  52 .Nm rcforce
  53 .Ar script ...
  54 .Nm rcfast
  55 .Ar script ...
  56 .Nm rcone
  57 .Ar script ...
  58 .Nm rcstop
  59 .Ar script ...
  60 .Nm rcrestart
  61 .Ar script ...
  62 .Nm rcvar
  63 .Ar script ...
  64 .Nm rcdisable
  65 .Ar script ...
  66 .Nm rcenable
  67 .Ar script ...
  68 .Nm rclist
  69 .Op Ar script ...
  70 .Sh DESCRIPTION
  71 The
  72 .Nm
  73 utility provides a number of commands for controlling
  74 .Xr rc 8
  75 scripts.
  76 .Pp
  77 The
  78 .Cm start ,
  79 .Cm forcestart ,
  80 .Cm faststart ,
  81 .Cm onestart ,
  82 .Cm stop ,
  83 .Cm restart ,
  84 and
  85 .Cm rcvar
  86 commands are just passed to the scripts.
  87 See
  88 .Xr rc 8
  89 for more information on these commands.
  90 .Pp
  91 The remaining commands are:
  92 .Bl -tag -width ".Cm disable"
  93 .It Cm disable
  94 Sets the corresponding
  95 .Va _enable
  96 variable in
  97 .Xr rc.conf 5
  98 to
  99 .Dq Li NO
 100 and runs the
 101 .Cm stop
 102 command.
 103 .It Cm enable
 104 Sets the corresponding
 105 .Va _enable
 106 variable in
 107 .Xr rc.conf 5
 108 to
 109 .Dq Li YES
 110 and runs the
 111 .Cm start
 112 command.
 113 .It Cm list
 114 Shows the status of the specified scripts.
 115 If no argument is specified, the status of all scripts is shown.
 116 .El
 117 .Pp
 118 .Nm Rcstart ,
 119 .Nm rcforce ,
 120 .Nm rcfast ,
 121 .Nm rcone ,
 122 .Nm rcstop ,
 123 .Nm rcrestart ,
 124 .Nm rcvar ,
 125 .Nm rcdisable ,
 126 .Nm rcenable
 127 and
 128 .Nm rclist
 129 are shortcuts for
 130 .Nm Ap s
 131 commands.
 132 .Sh SEE ALSO
 133 .Xr rc.conf 5 ,
 134 .Xr rc 8 ,
 135 .Xr rc.subr 8
 136 .Sh HISTORY
 137 The
 138 .Nm
 139 script first appeared in
 140 .Dx 1.0 .
 141 .Sh AUTHORS
 142 .An Matt Dillon