systemstarter(8) [osx man page]

SystemStarter(8)					    BSD System Manager's Manual 					  SystemStarter(8)

NAME

     SystemStarter -- Start, stop, and restart system services

SYNOPSIS

     SystemStarter [-gvxdDqn] [action [service]]

DESCRIPTION

     The SystemStarter utility is deprecated.  System services should instead be described by a launchd.plist(5).  See launchd(8) for more
     details.  The launchd utility is available on Mac OS X 10.4 and later.

     In earlier versions of Mac OS X, the SystemStarter utility is used to start, stop, and restart the system 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 pro-
     viding the service, any items it requires, or any items that depend on it will be acted on.

     During boot SystemStarter is invoked by launchd(8) and is responsible for starting all startup items in an order that satisfies each item's
     requirements.

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 suc-
     cess or failure of the services provided by that script.

FILES

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

SEE ALSO

     ConsoleMessage(8), launchd(8), launchd.plist(5), rc(8)

HISTORY

     The SystemStarter utility appeared in Darwin 1.0 and was extended in Darwin 6.0 to support partial startup and interprocess communication.
     SystemStarter was deprecated by launchd(8) in Darwin 8.0.

Darwin								  April 12, 2002							    Darwin

launchd(8)						    BSD System Manager's Manual 						launchd(8)

NAME

     launchd -- System wide and per-user daemon/agent manager

DESCRIPTION

     launchd manages processes, both for the system as a whole and for individual users.

     The primary and preferred interface to launchd is via the launchctl(1) tool which (among other options) allows the user or administrator to
     load and unload jobs. Where possible, it is preferable for jobs to launch on demand based on criteria specified in their respective configu-
     ration files.

     launchd also manages XPC services that are bundled within applications and frameworks on the system.

     During boot launchd is invoked by the kernel to run as the first process on the system and to further bootstrap the rest of the system.

     You cannot invoke launchd directly.

NOTES

     On Darwin operating systems, the canonical way to launch a daemon is through launchd as opposed to traditional POSIX and POSIX-like mecha-
     nisms or mechanisms provided in earlier versions of OS X. These alternate methods should be considered deprecated and not suitable for new
     projects.

     In the launchd lexicon, a daemon is, by definition, a system-wide service of which there is one instance for all clients. An agent is a ser-
     vice that runs on a per-user basis.  Daemons should not attempt to display UI or interact directly with a user's login session. Any and all
     work that involves interacting with a user should be done through agents.

     XPC services which are marked with a ServiceType of System are functionally equivalent to daemons and run in the same environment, sharing
     the same Mach bootstrap namespace. XPC services which are marked with a ServiceType of User are equivalent to agents with the LimitLoadToSes-
     sionType key specifying the Background session and run in the same environment, sharing the same Mach bootstrap namespace. See
     launchd.plist(5) for more information about user sessions.

     On Darwin platforms, a user environment includes a specific Mach bootstrap subset, audit session and other characteristics not recognized by
     POSIX.  Therefore, making the appropriate setuid(2) and setgid(2) system calls is not sufficient to completely assume the identity for a
     given user. Running a service as a launchd agent or a per-user XPC service is the only way to run a process with a complete identity of that
     user.

FILES

     ~/Library/LaunchAgents	    Per-user agents provided by the user.
     /Library/LaunchAgents	    Per-user agents provided by the administrator.
     /Library/LaunchDaemons	    System-wide daemons provided by the administrator.
     /System/Library/LaunchAgents   Per-user agents provided by Apple.
     /System/Library/LaunchDaemons  System-wide daemons provided by Apple.

SEE ALSO

     launchctl(1), launchd.plist(5),

DEVELOPER DOCUMENTATION

     The Daemons and Services Programming Guide can be found at the following URL:

     https://developer.apple.com/library/content/documentation/MacOSX/Conceptual/BPSystemStartup/Chapters/Introduction.html

Darwin								 25 November, 2013							    Darwin