home | help
SystemStarter(8)	     System Manager's Manual		SystemStarter(8)

NAME
     SystemStarter -- Start, stop, and restart system services

SYNOPSIS
     SystemStarter [-gvxdDqn] [action [service]]

DESCRIPTION
     The  SystemStarter utility may be used to start, stop, and restart the sys-
     tem  services  which  are	described  in  the  /Library/StartupItems/   and
     /System/Library/StartupItems/ paths.

     The  optional action argument specifies which action SystemStarter performs
     on the startup  items.   The  optional  service  argument	specifies  which
     startup  items  to  perform the action on.  If no service is specified, all
     startup items will be acted on; otherwise,  only  the  item  providing  the
     service,  any  items  it  requires,  or any items that depend on it will be
     acted on.

     During boot SystemStarter is invoked by rc (see rc(8)) and  is  responsible
     for  starting  all startup items in an order that satisfies each item's re-
     quirements.

ACTIONS
     start    start all items, or start the item  that	provides  the  specified
	      service and all items providing services it requires.

     stop     stop  all  items,  or  stop  the	item that provides the specified
	      service and all items that depend on it.

     restart  restart all items, or restart the  item  providing  the  specified
	      service.

OPTIONS
     -g       (ignored)

     -v       verbose (text mode) startup

     -x       (ignored)

     -r       (ignored)

     -d       print debugging output

     -D       print debugging output and dependencies

     -q       be quiet (disable debugging output)

     -n       don't actually perform action on items (no-run mode)

NOTES
     Unless  an  explicit call to ConsoleMessage is made, SystemStarter examines
     the exit status of the startup item scripts to  determine	the  success  or
     failure of the services provided by that script.

     In  Darwin  it  is preferable to create custom startup items than to modify
     rc, and at some point SystemStarter may entirely encompass the role of rc.

FILES
     /Library/StartupItems/	    User-installed startup items.
     /System/Library/StartupItems/  System-provided startup items.

SEE ALSO
     ConsoleMessage(8)

     rc(8)

HISTORY
     The SystemStarter utility appeared in Darwin 1.0

     SystemStarter was extended in Darwin 6.0 to support partial startup and in-
     terprocess communication.

Darwin				 April 12, 2002 		SystemStarter(8)

home | help