1  .Dd April 12, 2002
  2  .Dt SystemStarter 8 
  3  .Os Darwin
  4  .Sh NAME
  5  .Nm SystemStarter
  6  .\" The following lines are read in generating the apropos(man -k) database. Use only key
  7  .\" words here as the database is built based on the words here and in the .ND line. 
  8  .\" Use .Nm macro to designate other names for the documented program.
  9  .Nd Start, stop, and restart system services
 10  .Sh SYNOPSIS
 11  .Nm
 12  .Op Fl gvxdDqn
 13  .Op Ar action Op Ar service
 14  .Sh DESCRIPTION
 15  The
 16  .Nm
 17  utility is deprecated.  System services should instead be described by a
 18  .Xr launchd.plist 5 .
 19  See
 20  .Xr launchd 8
 21  for more details.
 22  The
 23  .Nm launchd
 24  utility is available on Mac OS X 10.4 and later.
 25  .Pp
 26  In earlier versions of Mac OS X, the 
 27  .Nm 
 28  utility is used to start, stop, and restart the system services which
 29  are described in the
 30  .Pa /Library/StartupItems/
 31  and
 32  .Pa /System/Library/StartupItems/
 33  paths.
 34  .Pp
 35  The optional
 36  .Ar action
 37  argument specifies which action 
 38  .Nm
 39  performs on the startup items.  The optional
 40  .Ar service
 41  argument specifies which startup items to perform the action on.  If no
 42  .Ar service
 43  is specified, all startup items will be acted on; otherwise, only the item providing the 
 44  .Ar service ,
 45  any items it requires, or any items that depend on it will be acted on.
 46  .Pp
 47  During boot 
 48  .Nm
 49  is invoked by
 50  .Xr launchd 8
 51  and is responsible for
 52  starting all startup items in an order that satisfies each item's 
 53  requirements.
 54  .Sh ACTIONS
 55  .Bl -tag -width -indent
 56  .It Nm start
 57  start all items, or start the item that provides the specified
 58  .Ar service
 59  and all items providing services it requires.
 60  .It Nm stop
 61  stop all items, or stop the item that provides the specified
 62  .Ar service
 63  and all items that depend on it.
 64  .It Nm restart
 65  restart all items, or restart the item providing the specified
 66  .Ar service .
 67  .El
 68  .Sh OPTIONS
 69  .Bl -tag -width -indent
 70  .It Fl g
 71  (ignored)
 72  .It Fl v
 73  verbose (text mode) startup
 74  .It Fl x
 75  (ignored)
 76  .It Fl r
 77  (ignored)
 78  .It Fl d
 79  print debugging output
 80  .It Fl D
 81  print debugging output and dependencies
 82  .It Fl q
 83  be quiet (disable debugging output)
 84  .It Fl n
 85  don't actually perform action on items (no-run mode)
 86  .El
 87  .Sh NOTES
 88  Unless an explicit call to
 89  .Nm ConsoleMessage
 90  is made,
 91  .Nm
 92  examines the exit status of the startup item scripts to determine the success or failure of the services provided by that script.
 93  .Pp
 94  .Sh FILES
 95  .Bl -tag -width -/System/Library/StartupItems -compact
 96  .It Pa /Library/StartupItems/
 97  User-installed startup items.
 98  .It Pa /System/Library/StartupItems/
 99  System-provided startup items.
100  .El
101  .Sh SEE ALSO 
102  .\" List links in ascending order by section, alphabetically within a section.
103  .\" Please do not reference files that do not exist without filing a bug report
104  .Xr ConsoleMessage 8 ,
105  .Xr launchd 8 ,
106  .Xr launchd.plist 5 ,
107  .Xr rc 8
108  .\" .Sh BUGS              \" Document known, unremedied bugs 
109  .Sh HISTORY
110  The
111  .Nm
112  utility appeared in Darwin 1.0 and
113  was extended in Darwin 6.0 to support partial startup and interprocess communication.
114  .Nm
115  was deprecated by
116  .Xr launchd 8
117  in Darwin 8.0.